README

此扩展是一个简单的 eZ Publish 平台（Legacy）内核覆盖扩展，它覆盖默认的 ezmodule 类以提供简单功能。它允许基于扩展的模块视图覆盖默认内核模块视图。非常适合高级开发者！

在安装并启用此内核类覆盖后，您可以覆盖任何默认内核模块和内核模块视图。

这有助于覆盖默认模块，如用户/登录模块视图或信息汇总系统等其他模块视图或您希望覆盖的任何其他内核模块。

版本

BC Kernel Module Override 的当前版本为 0.1.1
上次主要更新：2017 年 3 月 12 日

版权

BC Kernel Module Override 版权所有 1999 - 2017 Brookins Consulting 和 eZ Systems AS
请参阅 COPYRIGHT.md 了解版权和许可条款的更多信息

许可

BC Kernel Module Override 根据 GNU 通用公共许可证授权。

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

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

BC Kernel Module Override 以希望它会有所帮助的方式分发，但没有任何保证；甚至没有隐含的适销性或特定用途的适用性保证。有关详细信息，请参阅 GNU 通用公共许可证。

GNU GPL 许可让您在某些条件下使用、修改和重新分发 BC Kernel Module Override。GNU GPL 许可证与软件一起分发，请参阅 LICENSE 文件。

它还可在 https://gnu.ac.cn/licenses/gpl.txt 获取

您应已收到与 BC Kernel Module Override 一起分发的 GNU 通用公共许可证副本，其中包含在 LICENSE 中。

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

在 GNU GPL 许可下使用 BC Kernel Module Override 是免费的（在自由的意义上）。

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

需求

使用 BC Kernel Module Override 扩展需要以下需求

eZ Publish 版本

请确保您使用 eZ Publish 版本 4.x（必需）或更高版本。
设计和测试与 eZ Publish Community Project 2014.11

PHP 版本

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

功能

此解决方案提供以下功能

内核模块类覆盖类：eZModule

依赖关系

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

内核类覆盖

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

PHP 类： eZModule - 默认位置：lib/ezutils/classes/ezmodule.php

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

PHP 类： eZModule - 位置：extension/bckernelmoduleoverride/classes/kerneloverride/v2014.11.07/lib/ezutils/classes/ezmodule.php

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

安装

通过 Composer 安装软件包

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

bash$ composer require brookinsconsulting/bckernelmoduleoverride dev-master;

扩展激活

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

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

内核类覆盖扩展不是通过 ini 设置激活的。使用此扩展及其解决方案不需要正常站点.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;

使用

此解决方案在正确安装后默认配置为虚拟工作。

注意：如果您有其他扩展模块，其模块名与默认模块相同，则扩展模块将默认覆盖默认模块。这可能会引起关注，因此请在部署到生产/实时环境之前检查您的模块。