README

在几秒钟内开始开发PSR-7中间件应用程序！

zend-expressive 基于 zend-stratigility，提供了一个具有路由、DI容器、可选模板和可选错误处理能力的最小化PSR-7中间件框架。

此安装程序将根据用户输入选择可选包，并根据以下截图设置基于 zend-expressive 的基本应用程序。

用户选择的包将保存到 composer.json 中，以便所有其他在此项目上工作的人都能安装相同的包。为首次使用准备配置文件和模板。设置成功后，将从 composer.json 中删除安装程序命令，并删除所有与安装程序相关的文件。

入门指南

使用 composer 开始新的 Expressive 项目

$ composer create-project zendframework/zend-expressive-skeleton <project-path>

选择并安装所需的包后，转到 <项目路径> 并启动 PHP 内置的 web 服务器以验证安装。

$ composer run --timeout=0 serve

然后您可以浏览到 https://:8080。

设置超时

Composer 命令在 300 秒（5 分钟）后超时。在基于 Linux 的系统上，由 composer serve 启动的 php -S 命令作为后台进程继续运行，但在其他系统上，当发生超时时会停止。

因此，我们建议使用超时运行 serve 脚本。这可以通过使用具有 --timeout 选项的 composer run 来执行 serve 脚本完成。当设置为 0 时，如上一个示例中所示，将不使用超时，并且它将一直运行，直到您取消进程（通常通过 Ctrl-C）。或者，您可以指定一个有限的超时；例如，以下示例将超时扩展到整整一天

$ composer run --timeout=86400 serve

故障排除

如果在 composer create-project 阶段安装程序失败，请在打开新问题之前先通过以下列表进行检查。我们迄今为止遇到的大多数问题都可以通过 self-update 和 clear-cache 解决。

1. 请确保通过运行 composer self-update 使用最新的 composer 版本。
2. 尝试通过运行 composer clear-cache 清除 Composer 的缓存。

如果上述两种方法都不奏效，您可能面临更严重的问题。

• zlib_decode 错误 的信息。
• composer 降级模式 的信息和解决方案。

应用程序开发模式工具

此基本应用程序包含 zf-development-mode。它提供了一个 composer 脚本，允许您启用和禁用开发模式。

要启用开发模式

注意：不要在生产服务器上运行开发模式！

$ composer development-enable

注意：启用开发模式也将清除您的配置缓存，以安全地更新依赖项，并确保新的配置被应用程序识别。

要禁用开发模式

$ composer development-disable

开发模式状态

$ composer development-status

配置缓存

默认情况下，骨架将在data/config-cache.php中创建一个配置缓存。在开发模式下，配置缓存被禁用，进出开发模式将删除配置缓存。

如果您在同一目录下部署，则可能需要在生产环境中清除配置缓存。您可以使用以下方法：

$ composer clear-config-cache

您还可以通过编辑config/config.php文件并更改本地$cacheConfig变量的config_cache_path条目来更改配置缓存的存储位置。

骨架开发

本节仅适用于您使用git clone克隆此仓库的情况，而不是使用composer create-project ...安装expressive时。

如果您想要运行针对安装程序的测试，您需要克隆此仓库并使用composer设置所有依赖项。请确保您使用--no-scripts来阻止composer运行脚本，否则它将删除安装程序和所有测试。

$ composer update --no-scripts
$ composer test

请注意，安装程序测试在运行测试前后会删除已安装的配置文件和模板。

在贡献之前，请阅读贡献指南。