PHPackages                             yiisoft/yii-runner-http - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. yiisoft/yii-runner-http

ActiveLibrary[Framework](/categories/framework)

yiisoft/yii-runner-http
=======================

HTTP application runner

3.2.1(5mo ago)10172.0k—2.1%5[1 issues](https://github.com/yiisoft/yii-runner-http/issues)7BSD-3-ClausePHPPHP 8.1 - 8.5CI passing

Since Jan 17Pushed 5mo ago16 watchersCompare

[ Source](https://github.com/yiisoft/yii-runner-http)[ Packagist](https://packagist.org/packages/yiisoft/yii-runner-http)[ Docs](https://www.yiiframework.com/)[ GitHub Sponsors](https://github.com/sponsors/yiisoft)[ OpenCollective](https://opencollective.com/yiisoft)[ RSS](/packages/yiisoft-yii-runner-http/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (21)Versions (16)Used By (7)

 [ ![Yii](https://camo.githubusercontent.com/8317c17418b39410a660f5149071d26c5023c0d5fb2b7ebb771324812f666d73/68747470733a2f2f796969736f66742e6769746875622e696f2f646f63732f696d616765732f7969695f6c6f676f2e737667) ](https://github.com/yiisoft)

Yii HTTP Runner
===============

[](#yii-http-runner)

[![Latest Stable Version](https://camo.githubusercontent.com/35c752d987ef8185f9bd444777d422cee0bcf566d1b12d9667631609c69153c7/68747470733a2f2f706f7365722e707567782e6f72672f796969736f66742f7969692d72756e6e65722d687474702f76)](https://packagist.org/packages/yiisoft/yii-runner-http)[![Total Downloads](https://camo.githubusercontent.com/1f0100733c8c59848409bbaab6e347574e25afb8a92947c30b1206ec39c5c9e2/68747470733a2f2f706f7365722e707567782e6f72672f796969736f66742f7969692d72756e6e65722d687474702f646f776e6c6f616473)](https://packagist.org/packages/yiisoft/yii-runner-http)[![Build status](https://github.com/yiisoft/yii-runner-http/actions/workflows/build.yml/badge.svg)](https://github.com/yiisoft/yii-runner-http/actions/workflows/build.yml)[![Code coverage](https://camo.githubusercontent.com/09a152c1163c32e8d952718aeb5788ba220048c0669947bcc74560ba0918a56a/68747470733a2f2f636f6465636f762e696f2f67682f796969736f66742f7969692d72756e6e65722d687474702f67726170682f62616467652e7376673f746f6b656e3d43317578515536694c70)](https://codecov.io/gh/yiisoft/yii-runner-http)[![Mutation testing badge](https://camo.githubusercontent.com/a98940b52d0d944c7d6cdb4276338a1bdb7229cbe67b355a03403a83372bc3d8/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f7374796c653d666c61742675726c3d687474707325334125324625324662616467652d6170692e737472796b65722d6d757461746f722e696f2532466769746875622e636f6d253246796969736f66742532467969692d72756e6e65722d687474702532466d6173746572)](https://dashboard.stryker-mutator.io/reports/github.com/yiisoft/yii-runner-http/master)[![Static analysis](https://github.com/yiisoft/yii-runner-http/actions/workflows/static.yml/badge.svg?branch=master)](https://github.com/yiisoft/yii-runner-http/actions/workflows/static.yml?query=branch%3Amaster)[![type-coverage](https://camo.githubusercontent.com/cc2b65846732dc1a31aae43ff0c02bd41f1166944977052ff84e7f3509851cac/68747470733a2f2f73686570686572642e6465762f6769746875622f796969736f66742f7969692d72756e6e65722d687474702f636f7665726167652e737667)](https://shepherd.dev/github/yiisoft/yii-runner-http)

The package contains a bootstrap for running Yii3 HTTP application.

Requirements
------------

[](#requirements)

- PHP 8.1 - 8.5.

Installation
------------

[](#installation)

The package could be installed with [Composer](https://getcomposer.org):

```
composer require yiisoft/yii-runner-http
```

General usage
-------------

[](#general-usage)

In your HTTP entry script do the following:

```
use Yiisoft\Yii\Runner\Http\HttpApplicationRunner;

require_once __DIR__ . '/autoload.php';

(new HttpApplicationRunner(
    rootPath: __DIR__,
    debug: $_ENV['YII_DEBUG'],
    checkEvents: $_ENV['YII_DEBUG'],
    environment: $_ENV['YII_ENV']
))->run();
```

### Additional configuration

[](#additional-configuration)

By default, the `HttpApplicationRunner` is configured to work with Yii application templates and follows the [config groups convention](https://github.com/yiisoft/docs/blob/master/022-config-groups.md).

You can override the default configuration using constructor parameters and immutable setters.

#### Constructor parameters

[](#constructor-parameters)

`$rootPath` — the absolute path to the project root.

`$debug` — whether the debug mode is enabled.

`$checkEvents` — whether check events' configuration.

`$environment` — the environment name.

`$bootstrapGroup` — the bootstrap configuration group name.

`$eventsGroup` — the events' configuration group name.

`$diGroup` — the container definitions' configuration group name.

`$diProvidersGroup` — the container providers' configuration group name.

`$diDelegatesGroup` — the container delegates' configuration group name.

`$diTagsGroup` — the container tags' configuration group name.

`$paramsGroup` — the config parameters group name.

`$nestedParamsGroups` — configuration group names that are included into config parameters group. This is needed for recursive merge parameters.

`$nestedEventsGroups` — configuration group names that are included into events' configuration group. This is needed for reverse and recursive merge events' configurations.

`$configModifiers` — [configuration modifiers](https://github.com/yiisoft/config#configuration-modifiers).

`$configDirectory` — the relative path from `$rootPath` to the configuration storage location.

`$vendorDirectory` — the relative path from `$rootPath` to the vendor directory.

`$configMergePlanFile` — the relative path from `$configDirectory` to merge plan.

`$logger` — the logger to collect errors while container is building.

`$bufferSize` — the size of the buffer in bytes to send the content of the message body (default, 8Mb).

`$temporaryErrorHandler` — a temporary error handler that is needed to handle creating of configuration and container instances.

`$emitter` — an emitter to send the response.

`$useRemoveBodyByStatusMiddleware` — whether to remove the body of the response for specific response status codes.

`$useContentLengthMiddleware` — whether to manage the `Content-Length` header to the response.

`$useHeadRequestMiddleware` — whether to remove the body of the response for HEAD requests.

#### Immutable setters

[](#immutable-setters)

If the configuration instance settings differ from the default you can specify a customized configuration instance:

```
/**
 * @var Yiisoft\Config\ConfigInterface $config
 * @var Yiisoft\Yii\Runner\Http\HttpApplicationRunner $runner
 */

$runner = $runner->withConfig($config);
```

The default container is `Yiisoft\Di\Container`. But you can specify any implementation of the `Psr\Container\ContainerInterface`:

```
/**
 * @var Psr\Container\ContainerInterface $container
 * @var Yiisoft\Yii\Runner\Http\HttpApplicationRunner $runner
 */

$runner = $runner->withContainer($container);
```

In addition to the error handler that is defined in the container, the runner uses a temporary error handler. A temporary error handler is needed to handle the creation of configuration and container instances, then the error handler configured in your application configuration will be used.

By default, the temporary error handler uses HTML renderer and logging to a file. You can override this as follows:

```
/**
 * @var Psr\Log\LoggerInterface $logger
 * @var Yiisoft\ErrorHandler\Renderer\PlainTextRenderer $renderer
 * @var Yiisoft\Yii\Runner\Http\HttpApplicationRunner $runner
 */

$runner = $runner->withTemporaryErrorHandler(
    new Yiisoft\ErrorHandler\ErrorHandler($logger, $renderer),
);
```

Documentation
-------------

[](#documentation)

- [Internals](docs/internals.md)

If you need help or have a question, the [Yii Forum](https://forum.yiiframework.com/c/yii-3-0/63) is a good place for that. You may also check out other [Yii Community Resources](https://www.yiiframework.com/community).

License
-------

[](#license)

The Yii HTTP Runner is free software. It is released under the terms of the BSD License. Please see [`LICENSE`](./LICENSE.md) for more information.

Maintained by [Yii Software](https://www.yiiframework.com/).

Support the project
-------------------

[](#support-the-project)

[![Open Collective](https://camo.githubusercontent.com/a2b15f8e2268d4e3842e00d41ff7a57cce2ad8bd8d8769c5dc4fa05a546a4f62/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4f70656e253230436f6c6c6563746976652d73706f6e736f722d3765616466313f6c6f676f3d6f70656e253230636f6c6c656374697665266c6f676f436f6c6f723d376561646631266c6162656c436f6c6f723d353535353535)](https://opencollective.com/yiisoft)

Follow updates
--------------

[](#follow-updates)

[![Official website](https://camo.githubusercontent.com/d6b0929173e28cc627430d2519ca1853466a70f37395877eaf4820cb3e1e1909/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f506f77657265645f62792d5969695f4672616d65776f726b2d677265656e2e7376673f7374796c653d666c6174)](https://www.yiiframework.com/)[![Twitter](https://camo.githubusercontent.com/d077c362ac639792171af8bc002ee827816733dfc0925f70b557e6d151022226/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f747769747465722d666f6c6c6f772d3144413146323f6c6f676f3d74776974746572266c6f676f436f6c6f723d314441314632266c6162656c436f6c6f723d3535353535353f7374796c653d666c6174)](https://twitter.com/yiiframework)[![Telegram](https://camo.githubusercontent.com/4e38dd12535575c39c65bea7119b95e663abb2d1f4e3d669a27bbda07ef603f0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f74656c656772616d2d6a6f696e2d3144413146323f7374796c653d666c6174266c6f676f3d74656c656772616d)](https://t.me/yii3en)[![Facebook](https://camo.githubusercontent.com/48204e301b34b29b0815854544f04c337fc0692096cab35e9a1f8c53a42c2307/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f66616365626f6f6b2d6a6f696e2d3144413146323f7374796c653d666c6174266c6f676f3d66616365626f6f6b266c6f676f436f6c6f723d666666666666)](https://www.facebook.com/groups/yiitalk)[![Slack](https://camo.githubusercontent.com/1a3645ba1c97e6684d0349bc478201e1621ba0d3efad516d81035364d442bad7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f736c61636b2d6a6f696e2d3144413146323f7374796c653d666c6174266c6f676f3d736c61636b)](https://yiiframework.com/go/slack)

###  Health Score

58

—

FairBetter than 98% of packages

Maintenance71

Regular maintenance activity

Popularity42

Moderate usage in the ecosystem

Community33

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~119 days

Recently: every ~162 days

Total

13

Last Release

150d ago

Major Versions

1.1.2 → 2.0.02023-02-19

2.3.0 → 3.0.02024-07-16

PHP version history (3 changes)1.0.0PHP ^8.0

3.1.0PHP ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0

3.2.1PHP 8.1 - 8.5

### Community

Maintainers

![](https://www.gravatar.com/avatar/261a6249c6f605f3956a2fae40fbb813f6b2e1e6f2bf806180c851a965426e54?d=identicon)[cebe](/maintainers/cebe)

![](https://www.gravatar.com/avatar/fc29e4e7068a00fe9b9db37b8aadda1db6020adcacef810461e47b99c2b150e6?d=identicon)[samdark](/maintainers/samdark)

![](https://www.gravatar.com/avatar/ccb75e3312d6bd454ea445ea308139fd185a4ca906ca5df21cc66e6a35de25a3?d=identicon)[SilverFire](/maintainers/SilverFire)

![](https://www.gravatar.com/avatar/99106256c24a8cb23871b99fa90e48f37f1aa71608c185759b7d2a88683a5918?d=identicon)[hiqsol](/maintainers/hiqsol)

---

Top Contributors

[![vjik](https://avatars.githubusercontent.com/u/525501?v=4)](https://github.com/vjik "vjik (55 commits)")[![devanych](https://avatars.githubusercontent.com/u/20116244?v=4)](https://github.com/devanych "devanych (26 commits)")[![xepozz](https://avatars.githubusercontent.com/u/6815714?v=4)](https://github.com/xepozz "xepozz (26 commits)")[![samdark](https://avatars.githubusercontent.com/u/47294?v=4)](https://github.com/samdark "samdark (10 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")[![rustamwin](https://avatars.githubusercontent.com/u/16498265?v=4)](https://github.com/rustamwin "rustamwin (3 commits)")[![luizcmarin](https://avatars.githubusercontent.com/u/67489841?v=4)](https://github.com/luizcmarin "luizcmarin (3 commits)")[![terabytesoftw](https://avatars.githubusercontent.com/u/42547589?v=4)](https://github.com/terabytesoftw "terabytesoftw (3 commits)")[![sankaest](https://avatars.githubusercontent.com/u/21160342?v=4)](https://github.com/sankaest "sankaest (1 commits)")[![arogachev](https://avatars.githubusercontent.com/u/8326201?v=4)](https://github.com/arogachev "arogachev (1 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (1 commits)")[![thenotsoft](https://avatars.githubusercontent.com/u/44147615?v=4)](https://github.com/thenotsoft "thenotsoft (1 commits)")

---

Tags

hacktoberfesthttprunneryii3httpyiirunner

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm, Rector

Type Coverage Yes

### Embed Badge

![Health badge](/badges/yiisoft-yii-runner-http/health.svg)

```
[![Health](https://phpackages.com/badges/yiisoft-yii-runner-http/health.svg)](https://phpackages.com/packages/yiisoft-yii-runner-http)
```

###  Alternatives

[cakephp/cakephp

The CakePHP framework

8.8k18.5M1.6k](/packages/cakephp-cakephp)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[yiisoft/yii-middleware

Yii Middleware

21151.3k1](/packages/yiisoft-yii-middleware)[yiisoft/app

Yii3 web application template

35512.3k](/packages/yiisoft-app)[yiisoft/yii-runner-roadrunner

Web application runner for RoadRunner

3410.4k](/packages/yiisoft-yii-runner-roadrunner)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

81733.7k](/packages/flow-php-flow)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)