netglue / public-website-defaults-module
一个为公共网站提供常用功能的ZF2模块
Requires
- php: >=5.3.3
- zendframework/zendframework: ~2.3
Requires (Dev)
- phpunit/phpunit: 3.*
- zendframework/zend-developer-tools: dev-master
This package is auto-updated.
Last update: 2021-09-02 12:04:07 UTC
README
工作进度
如果您使用此包,请注意,它主要是为我们在Netglue的自用而开发的,因此小版本升级很可能会有BC Breaks。通常,补丁版本将与之前一样稳定。
简介
这是一个简单的模块,用于配置我大多数公共网站使用的工具功能。
只需使用composer安装,添加到您的模块列表,您就有了一个用于常见文件的正常路由。
视图渲染策略
纯文本和XML视图渲染策略已通过视图管理器注册,以便您可以使用标准模板系统轻松地模板化这些类型的内容。
从您的控制器,您要使用的所有操作就是返回一个 NetglueDefaults\View\Model\TextModel
或 XmlModel
,并确保有一个模板可用于渲染,该模板可以在您的路径堆栈或模板映射中找到。
XML和文本视图模型被标记为终端,因此不会渲染布局。模型还适当地设置了默认的 content-type
标头,并默认使用UTF-8。
默认控制器和初始路由
有几个路由对简单的公共站点很有用。
- 在
/google[a-z0-9]+\.html
进行Google验证 - 默认导航容器中的XML站点地图
/sitemap.xml
- HTML站点地图在
/sitemap
- Robots Text在
/robots.txt
Google验证端点使用 SiteData
视图助手,这是一个简单的包装 Zend\Stdlib\AbstractOptions
实例的包装器。
视图管理器模板和错误视图
我经常不从一个骨架应用程序开始,所以已经设置好这个功能对我很有帮助。
错误监听器,布局切换器
默认情况下,已配置了一个监听器,用于监视事件 MvcEvent::EVENT_DISPATCH_ERROR
和 MvcEvent::EVENT_RENDER_ERROR
,并在发生错误时设置视图布局模板。
以下配置选项与此相关
$config['view_manager']['use_error_layout'] = true;
$config['view_manager']['error_layout'] = 'layout/error';
设置的任何布局模板都必须可以在模板路径堆栈或映射中解析。
安装
使用composer安装:将 netglue/public-website-defaults-module
作为ZF2应用程序中的一个依赖项。
将 NetglueDefaults
添加到您的模块列表中
查看 config/module.config.php
变更日志
1.1.0
- 修复了一个严重的问题,其中自定义渲染器会窃取视图助手插件管理器,从而使得
$this->partial()
无法找到任何预期的模板。通过丢弃自定义渲染器和模板解析器解决了此问题。 - Google验证控制器操作将在没有配置验证代码或请求的url与配置的文件不匹配时适当地抛出404。
- 已删除所有关于Nibbler验证的引用,因为它已被取消。
- 添加了一个默认的错误监听器,在存在
MvcEvent::EVENT_DISPATCH_ERROR
或MvcEvent::EVENT_RENDER_ERROR
之一的情况下切换布局,前提是我们有一个常规视图模型,而不是控制台视图模型。
1.0.1
- 修复了composer和repo标记的错误
1.0.0
- 首次发布