fearthec/ftc-discord-website

This package is not auto-updated.

Last update: 2024-09-19 15:55:08 UTC


README

Build Status Coverage Status

几秒钟内开始开发PSR-15中间件应用!

zend-expressive 基于 zend-stratigility 构建,提供了一个具有路由、DI容器、可选模板和可选错误处理能力的PHP PSR-15中间件框架。

此安装程序将根据以下截图中的用户输入选择可选包来设置基于zend-expressive的骨架应用程序

screenshot-installer

用户选择的包被保存到 composer.json 中,以确保所有其他参与项目的成员安装相同的包。为首次使用准备了配置文件和模板。在设置成功后,从 composer.json 中删除安装程序命令,并删除所有相关安装程序文件。

入门

使用composer开始新的Expressive项目

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

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

$ composer run --timeout=0 serve

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

Linux用户

在PHP 7.1.14和7.2.2之前的版本上,此命令可能无法按预期工作,因为PHP中的一个仅影响Linux环境的错误。在这种情况下,您需要自己启动 内置Web服务器,使用以下命令

$ php -S 0.0.0.0:8080 -t public/ public/index.php

设置超时

Composer命令在300秒(5分钟)后超时。在基于Linux的系统上,php -S 命令,该命令由 composer serve 启动,作为后台进程继续运行,但在其他系统上在超时时停止。

因此,我们建议使用带有超时的 serve 脚本。这可以通过使用 composer run 来执行 serve 脚本并带有 --timeout 选项来完成。当设置为 0 时,如前例所示,不使用超时,它将一直运行,直到您取消进程(通常通过 Ctrl-C)。或者,您可以指定一个有限的超时;例如,以下将超时延长到整整一天

$ composer run --timeout=86400 serve

故障排除

composer create-project 阶段安装程序失败时,在打开新问题之前,请先查看以下列表。我们迄今为止看到的多数问题都可以通过 self-updateclear-cache 解决。

  1. 请确保使用最新版本的composer,通过运行 composer self-update
  2. 尝试通过运行 composer clear-cache 清除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

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

在贡献之前,请阅读 贡献指南