mezzio/mezzio-skeleton

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

资助包维护!
社区桥梁

安装次数: 22 219

依赖项: 0

建议者: 0

安全性: 0

星标: 115

关注者: 19

分支: 31

开放问题: 9

类型:项目


README

Build Status

🇷🇺 俄罗斯公民

我们Laminas的成员来自不同的国家。我们中有许多人在俄罗斯和乌克兰都有朋友、亲戚和同事。有些人出生在俄罗斯。有些人目前居住在俄罗斯。有些人有祖父母在第二次世界大战中与法西斯战斗过。在这里,没有人支持法西斯主义。

我们其中一位成员有一位乌克兰亲戚,她带着儿子逃离了家园。火车因为前方路上的轰炸而延误。我们有朋友躲在防空洞里。我们在空袭后焦急地等待他们的消息,空袭无差别地攻击医院、学校、幼儿园和住宅。我们不是从任何媒体中得知这些的。这是我们亲身体验到的。

您足够信任我们,愿意使用我们的程序,我们请求您再次信任我们。我们需要帮助。走出家门,抗议这场毫无意义的战争。停止杀戮。说“停止战争!”

🇺🇸 致俄罗斯公民

Laminas的我们来自世界各地。我们中许多人在俄罗斯和乌克兰都有朋友、家人和同事。有些人出生在俄罗斯。有些人目前居住在俄罗斯。有些人有祖父母在第二次世界大战中与纳粹战斗过。在这里,没有人支持法西斯主义。

我们团队成员中有一位乌克兰亲戚,她带着儿子逃离了家园。火车因为前方路上的轰炸而延误。我们有朋友躲在防空洞里。我们在空袭后焦急地等待他们的消息,空袭无差别地攻击医院、学校、幼儿园和住宅。我们不是从任何媒体中得知这些的。这是我们亲身体验到的。

您足够信任我们,愿意使用我们的软件。我们请求您信任我们,说出真相。我们需要您的帮助。走出家门,抗议这场毫无意义的战争。停止杀戮。说“停止战争!”

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

mezzio基于laminas-stratigility构建,为PHP提供最小化的PSR-15中间件框架,具有路由、DI容器、可选模板和可选错误处理功能。

此安装程序将根据以下截图所示的用户输入选择可选包,设置基于mezzio的骨架应用程序

screenshot-installer

用户选择的包将保存到composer.json中,以便所有参与项目的人都安装相同的包。已准备好配置文件和模板以供首次使用。在设置成功后,安装命令将从composer.json中删除,并删除所有与安装相关的文件。

入门

使用Composer开始您的Mezzio新项目

$ composer create-project mezzio/mezzio-skeleton <project-path>

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

$ composer serve

然后您可以通过http://localhost:8080进行浏览。

安装替代包

有一个功能可以安装替代包:您实际上可以输入包名和版本,而不是选择其中的一个

  Which template engine do you want to use?
  [1] Plates
  [2] Twig
  [3] zend-view installs zend-servicemanager
  [n] None of the above
  Make your selection or type a composer package name and version (n): infw/pug:0.1
  - Searching for infw/pug:0.1
  - Adding package infw/pug (0.1)

该功能允许您安装任何想要的替代包。尽管如此,它也有一些限制

  • 替代包必须遵循以下格式 命名空间/包:1.0。它需要正确的版本。
  • 模板不会复制,但是ConfigProvider可以被配置为直接使用包本身中的默认模板。
  • 对于容器来说,这是不行的,因为需要复制container.php文件。

故障排除

如果在composer create-project阶段安装程序失败,请在创建新问题之前查阅以下列表。我们迄今为止看到的大部分问题都可以通过self-updateclear-cache来解决。

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

如果以上两种方法都无法解决问题,您可能面临更严重的问题

应用程序开发模式工具

此骨架包含laminas-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 ...安装mezzio时。

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

$ composer update --no-scripts
$ composer test

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

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