zfmastery/ze-static-pages

在Zend Expressive应用程序中渲染静态页面的简单、几乎无痛的方式。

0.0.3 2017-07-18 07:33 UTC

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。当前版本不支持自动创建所需的模块配置文件或模板目录。但是,计划在未来版本中实现这一点。

鉴于

  1. 将默认配置文件 config/static-pages.global.php 复制到您的Zend Expressive的 config/autoload/ 目录。
  2. 在根目录中,创建目录结构 templates/static-pages/ 并在那里创建您的静态模板文件。
  3. 添加路由以使用您的新静态模板。

运行测试

要运行单元测试,请运行 composer test