zfmastery / ze-static-pages
在Zend Expressive应用程序中渲染静态页面的简单、几乎无痛的方式。
Requires
- php: ^5.6 || ^7.0
- roave/security-advisories: dev-master
- zendframework/zend-expressive: ^2.0.2
This package is not auto-updated.
Last update: 2024-09-29 02:49:45 UTC
README
在Zend Expressive应用程序中渲染静态页面的简单、几乎无痛的方式。
许多项目都会有大量的静态页面,这些页面不需要模板变量插值或任何其他形式的逻辑。考虑到只需以最简单的方式渲染所需的所有页面,而无需太多的麻烦和努力。然而,默认情况下,你必须自己编写代码;最糟糕的情况是,你可能会编写大量的代码,只是为了渲染静态内容。该模块的目的是消除所有这些努力。你所需要做的就是
- 创建内容本身
- 根据您的最佳判断在模板目录中组织文件
- 创建与相应模板链接的路由
目前,该项目仍在进行大量的开发。因此,没有进一步的说明。但是,它们将很快跟进。
工作原理
本模块旨在尽可能简化静态内容的组织和渲染。它通过使用路由的名称来确定要渲染的模板来实现这一点。在下面的示例中,你可以看到它定义了一个新的路由,称为 /disclosure。该路由使用 StaticPagesAction::class 作为处理中间件,并且具有名称 static.disclosure。
$app->get('/disclosure', \StaticPages\Action\StaticPagesAction::class, 'static.disclosure');
名称很重要,因为它暗示了 StaticPagesAction 将尝试渲染的模板名称。具体来说,它将尝试渲染 disclosure.phtml。所以你可以看到,路由的名称是模板的名称,减去 .phtml 扩展名,并以前缀 static. 开头。
到目前为止,由于模块相当新,所以搜索的模板目录 templates/static-pages 是固定的,并且所有模板都必须位于该目录的顶级。此外,它尚未与其他模板渲染引擎进行测试。然而,预计这些将在未来的版本中改变。
入门/安装
要安装此模块,请通过运行 composer require zfmastery/ze-static-pages 使用Composer。当前版本不支持自动创建所需的模块配置文件或模板目录。但是,计划在未来版本中实现这一点。
鉴于
- 将默认配置文件
config/static-pages.global.php复制到您的Zend Expressive的config/autoload/目录。 - 在根目录中,创建目录结构
templates/static-pages/并在那里创建您的静态模板文件。 - 添加路由以使用您的新静态模板。
运行测试
要运行单元测试,请运行 composer test。