README

此扩展是一个简单的 eZ Publish 平台（Legacy）内核覆盖扩展，它覆盖了默认的 ezchartransform 类，以提供简单功能：允许所有内容 URL 通过破折号字符而不是默认的下划线字符分隔。非常适合高级开发者！

使用此内核类覆盖安装并启用后，您可以在所有内容中使用破折号字符作为 URL 分隔符。

这对于使用仅通过在 URL 中使用下划线字符的默认 urlalias_compat 配置来区分网站非常有用。

版本

BC Url Alias With Dash 的当前版本是 0.1.1
最后主要更新：2023 年 3 月 24 日

版权

BC Url Alias With Dash 版权所有 1999 - 2023 Brookins Consulting 和 eZ Systems AS
有关版权和许可条款的更多信息，请参阅 COPYRIGHT.md

许可

BC Url Alias With Dash 在 GNU 通用公共许可证下授权。

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

BC Url Alias With Dash 是免费软件：您可以在自由软件基金会发布的 GNU 通用公共许可证条款下重新分发和/或修改它，无论是许可证的第 2 版还是您选择的任何后续版本。

GNU GPL 使您有权在特定条件下使用、修改和重新分发 BC Url Alias With Dash。GNU GPL 许可证与软件一起分发，请参阅 LICENSE 文件。

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

您应该已经收到了 BC Url Alias With Dash 中的 GNU 通用公共许可证副本，请参阅 LICENSE。

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

在 GNU GPL 条件下使用 BC Url Alias With Dash 是免费的（作为自由）。

有关更多信息或疑问，请联系： license@brookinsconsulting.com

要求

使用 BC Url Alias With Dash 扩展需要以下要求

eZ Publish 版本

请确保您使用 eZ Publish 版本 5.x（必需）或更高版本。
设计与 eZ Publish Legacy 5.99alpha1 测试

PHP 版本

请确保您安装了PHP 5.x或更高版本。

功能

本解决方案提供以下功能

内核模块类覆盖类：eZCharTransform

依赖项

本解决方案依赖于eZ Publish Legacy和config.php中启用的内核类覆盖

内核类覆盖

本解决方案覆盖以下内核类

PHP类：eZCharTransform - 默认位于：lib/ezutils/classes/ezchartransform.php

本解决方案提供以下内核类覆盖

PHP类：eZCharTransform - 位于：extension/bcurlaliaswithdash/classes/kerneloverride/v2023.03.24/lib/ezutils/classes/ezchartransform.php

注意：本解决方案只需要一个类（该类非常稳定，且每个版本的变化（如果有的话）不大，这对于可维护性非常重要）的旧版内核类覆盖。该类自2017年初以来未进行过修改或需要修复错误。

安装

通过Composer安装包

从您的项目根目录运行以下命令以安装包

bash$ composer require brookinsconsulting/bcurlaliaswithdash dev-master;

扩展激活

可选。通过将以下内容添加到您的settings/override/site.ini.append.php来激活此扩展

[ExtensionSettings]
# <snip existing active extensions list />
ActiveExtensions[]=bcurlaliaswithdash

内核类覆盖扩展不通过ini设置激活。使用此扩展及其解决方案不需要常规的site.ini扩展激活设置。

启用eZ Publish内核覆盖

只有在您将以下内容添加到eZ Publish Legacy的config.php配置文件后，内核类覆盖才能使用。

cp -va config.php-RECOMMENDED config.php;
# Edit config.php to set 'EZP_AUTOLOAD_ALLOW_KERNEL_OVERRIDE' to true. It should look like this:
define( 'EZP_AUTOLOAD_ALLOW_KERNEL_OVERRIDE', true );

重新生成内核类覆盖自动加载

重新生成内核类覆盖自动加载（必需）。

php ./bin/php/ezpgenerateautoloads.php --kernel-override;

清除缓存

可选。清除eZ Publish平台 / eZ Publish Legacy缓存（必需）。

php ./bin/php/ezcache.php --clear-all;

使用方法

默认情况下，安装后，解决方案配置为虚拟工作。

注意：安装后，请清除缓存并运行bin/php/updateniceurls.php脚本来将URL转换为带有短划线的URL。

注意：本解决方案依赖于site.ini.append.php中的设置'[URLTranslator] TransformationGroup=urlalias_compat'。

注意：在某些安装中，在运行上述脚本后，需要重新发布内容树中的所有节点。这通过管理员在不到10分钟内完成。

故障排除

阅读常见问题解答

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

支持

如果您发现此文档或常见问题解答中未处理的问题，您可以通过支持系统联系Brookins Consulting：http://brookinsconsulting.com/contact

se7enxweb / bcurlaliaswithdash

维护者

详细信息