README

Yii HTTP 运行器

该包包含运行 Yii3 HTTP 应用的引导程序。

要求

PHP 8.0 或更高版本。

安装

可以使用 Composer 安装此包。

composer require yiisoft/yii-runner-http

通用用法

在您的 HTTP 入口脚本中执行以下操作

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();

附加配置

默认情况下，HttpApplicationRunner 配置为与 Yii 应用程序模板一起工作，并遵循配置组约定。

您可以使用构造函数参数和不可变设置器覆盖默认配置。

构造函数参数

$rootPath — 项目根的绝对路径。

$debug — 是否启用调试模式。

$checkEvents — 是否检查事件配置。

$environment — 环境名称。

$bootstrapGroup — 引导配置组名称。

$eventsGroup — 事件配置组名称。

$diGroup — 容器定义配置组名称。

$diProvidersGroup — 容器提供者配置组名称。

$diDelegatesGroup — 容器代理配置组名称。

$diTagsGroup — 容器标签配置组名称。

$paramsGroup — 配置参数组名称。

$nestedParamsGroups — 包含到配置参数组的配置组名称。这是递归合并参数所需的。

$nestedEventsGroups — 包含到事件配置组的配置组名称。这是反向和递归合并事件配置所需的。

$configModifiers — 配置修改器。

$configDirectory — 从 $rootPath 到配置存储位置的相对路径。

$vendorDirectory — 从 $rootPath 到供应商目录的相对路径。

$configMergePlanFile — 从 $configDirectory 到合并计划的相对路径。

$logger — 收集容器构建时的错误记录器。

$bufferSize — 发送消息体内容的大小（默认，8Mb）。

不可变设置器

如果配置实例设置与默认设置不同，您可以指定自定义配置实例

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

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

默认容器是 Yiisoft\Di\Container。但您可以指定任何实现 Psr\Container\ContainerInterface 的实现。

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

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

除了容器中定义的错误处理器外，运行器还使用临时错误处理器。需要临时错误处理器来处理配置和容器实例的创建，然后使用您在应用程序配置中配置的错误处理器。

默认情况下，临时错误处理器使用 HTML 渲染器和将日志记录到文件。您可以按以下方式覆盖此设置

/**
 * @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),
);

文档

内部

如果您需要帮助或有任何问题，Yii 论坛是一个不错的选择。您还可以查看其他 Yii 社区资源。

许可

Yii HTTP 运行器是免费软件。它遵循BSD许可证的条款发布。请参阅更多信息：LICENSE。

由 Yii 软件维护。

yiisoft / yii-runner-http

维护者

详细信息