README

此包实现了一个解决方案，以提供 eZ Publish 平台 / eZ 平台 URL 别名转换配置，以便将创建或修改的新内容 URL 别名转换为下划线或破折号分隔的小写形式。

版本

BC 小写 URL 别名的当前版本是 0.1.2
上次主要更新：2017 年 3 月 9 日

版权

BC 小写 URL 别名版权所有 1999 - 2017 Brookins Consulting
更多信息请参阅：COPYRIGHT.md

许可证

BC 小写 URL 别名采用 GNU 通用公共许可证。

完整的许可证协议包含在 LICENSE 文件中。

BC 小写 URL 别名是免费软件：您可以在 GNU 通用公共许可证的条款下重新分发和/或修改它，该许可证由自由软件基金会发布，许可证版本为 2 或您选择的后续版本。

BC 小写 URL 别名在分发时希望它是有用的，但没有任何保证；甚至没有隐含的适销性保证或针对特定目的的适用性保证。有关详细信息，请参阅 GNU 通用公共许可证。

GNU GPL 在某些条件下赋予您使用、修改和重新分发 BC 小写 URL 别名的权利。GNU GPL 许可证与软件一起分发，请参阅 LICENSE 文件。

它也可在 https://gnu.ac.cn/licenses/gpl.txt 找到。

您应该已经收到了一份 GNU 通用公共许可证的副本，它与 BC 小写 URL 别名一起在 LICENSE 文件中。

如果没有，请参阅 https://gnu.ac.cn/licenses/。

根据 GNU GPL 的条款使用 BC 小写 URL 别名是免费的（指自由）。

如需更多信息或咨询，请联系： license@brookinsconsulting.com

要求

使用 BC 小写 URL 别名包需要以下要求

eZ Publish 版本

请确保您使用 eZ Publish 版本 5.x（必需）或更高版本。
设计与测试均基于 eZ Publish 平台（含Legacy）2015.01.03 和 PHP 5.6.30+

PHP 版本

请确保您有 PHP 5.x 或更高版本。

功能

SlugConverter 类

此解决方案提供以下 ezplatform slug 转换器类

BrookinsConsulting\BcLowerCaseUrlAliasBundle\Core\Persistence\Legacy\Content\UrlAlias\BcLowerCaseUnderscoreUrlAliasSlugConverter
BrookinsConsulting\BcLowerCaseUrlAliasBundle\Core\Persistence\Legacy\Content\UrlAlias\BcLowerCaseDashUrlAliasSlugConverter

依赖项

此解决方案依赖于eZ Platform
此解决方案依赖于symfony/symfony

这些依赖关系在包的composer.json文件中有更详细的文档

用例

此解决方案是为了提供与eZ Publish Legacy 3.x URL别名类似的内容URL别名，这些别名是小写字母且由下划线分隔。

安装

通过Composer安装Bundle

从您的项目根目录运行以下命令来安装该Bundle

bash$ composer require brookinsconsulting/bclowercaseurlaliasbundle dev-master;

Bundle激活

在文件app/AppKernel.php的registerBundles方法中，将以下内容添加到$bundles = array(变量定义中。

// Brookins Consulting : BcGitHubStarsBundle Requirements
new BrookinsConsulting\BcLowerCaseUrlAliasBundle\BcLowerCaseUrlAliasBundle(),

清除缓存

清除Symfony缓存（必需）。

php bin/console cache:clear;

使用方法

一旦正确安装，此解决方案默认配置为虚拟工作。

警告

在使用此解决方案之前，请务必备份您的安装数据库、源代码和var目录内容！

记住，就像旧实现一样，此解决方案应在从干净安装创建内容之前使用。

否则，您可能需要通过脚本或手动重新发布所有内容对象，以确保所有内容对象都使用相同的URL别名转换约定。

eZ Publish Platform Legacy安装/站点访问也可能非常需要相应的URL别名转换约定，这可以通过ini设置实现。

备用配置（可选）

如果您更喜欢由下划线分隔的小写URL，则无需执行任何操作，因为一旦激活此Bundle，这就是支持的默认设置。

但是，如果您更喜欢由破折号分隔的小写URL（一个可选的配置），则需要使用以下内容覆盖默认参数类配置，在您的app/config或您自己的优先级较高的Bundle配置（分开）中。

示例：按如下方式更改从参数yaml配置的类

 parameters:
    ezpublish.persistence.slug_converter.class: BrookinsConsulting\BcLowerCaseUrlAliasBundle\Core\Persistence\Legacy\Content\UrlAlias\BcLowerCaseDashUrlAliasSlugConverter

进一步扩展和配置

值得注意的是，此Bundle提供了一个不错的示例实现，可以简单地复制和/或修改以满足您自己的具体需求和需求。

您可以将此Bundle用作如何覆盖yaml参数、类覆盖和URL别名slug转换配置的示例。

有了这些知识，您可以创建自己的URL别名slug转换配置类，以代表不同的网站/应用程序需求。

测试

一旦正确安装和配置，此解决方案将配置为工作。

注意：在撰写本文时，尚未实现xss测试和适当的单元测试。

故障排除

阅读FAQ

某些问题比其他问题更常见。最常见的问题列在Resources/doc/FAQ.md中。

支持

如果您发现此文档或FAQ中没有处理的问题，您可以通过支持系统联系Brookins Consulting：[http://brookinsconsulting.com/contact](http://brookinsconsulting.com/contact)

brookinsconsulting / bclowercaseurlaliasbundle

维护者

详细信息