technobureau/mezzio

Laminas mezzio 骨架。立即开始开发 PSR-15 中间件应用!

dev-main 2023-07-16 17:56 UTC

This package is auto-updated.

Last update: 2024-09-12 00:20:45 UTC


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

然后您可以浏览到 https://: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

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

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