README

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

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

这对于使用默认的 urlalias_compat 配置（在 URL 中使用下划线）来区分网站非常有帮助且实用。

版本

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 版还是您选择的后续版本。

BC Url Alias With Dash 以希望它将是有用的，但没有任何保证；甚至没有对适销性或特定用途的隐含保证。有关详细信息，请参阅 GNU 通用公共许可证。

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 );

重新生成内核类覆盖的autoloads

重新生成内核类覆盖的autoloads（必需）。

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

清除缓存

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

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

使用方法

安装正确后，此解决方案默认通过虚拟方式配置为运行。

注意：安装后，请清除缓存并运行bin/php/updateniceurls.php脚本来将url转换为带连字符的分隔符。

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

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

故障排除

阅读FAQ

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

支持

如果您在此文档或FAQ中找不到任何问题，可以通过以下支持系统联系Brookins Consulting：http://brookinsconsulting.com/contact

brookinsconsulting / bcurlaliaswithdash

维护者

详细信息