PHP 8.2中log4php正确启用方法及废弃警告解决

问题根源 #

log4php官方版本未适配PHP 8.2的严格类型检查，当日志布局生成的内容为null时，LoggerAppenderFile.php第137行的fwrite()调用会触发「传递null给string类型参数」的废弃警告。

正确启动/修复方式 #

方法1：修改log4php源码（最直接有效） #

找到D:\inc\log4php\appenders\LoggerAppenderFile.php文件，定位到第137行，将原代码：

fwrite($this->fp, $data);

修改为：

fwrite($this->fp, $data ?? '');

通过??空合并运算符确保传入fwrite的内容始终是字符串类型，避免null触发警告。

方法2：调整日志布局配置 #

将原配置中的LoggerLayoutSimple替换为LoggerLayoutPattern，指定明确的日志格式，确保输出内容不会为null：

<?xml version="1.0" encoding="UTF-8"?>
<configuration xmlns="http://logging.apache.org/log4php/">
    <appender name="default" class="LoggerAppenderFile">
        <layout class="LoggerLayoutPattern">
            <param name="conversionPattern" value="%d{Y-m-d H:i:s} [%p] %c - %m%n" />
        </layout>
        <param name="file" value="test.log" />
        <param name="append" value="true" />
    </appender>
    <root>
        <appender_ref ref="default" />
    </root>
</configuration>

方法3：临时屏蔽废弃警告（不推荐） #

仅作为临时应急方案，在初始化log4php前添加代码屏蔽该类警告：

error_reporting(E_ALL ^ E_DEPRECATED);
require ROOT . "/inc/log4php/Logger.php";
// 后续初始化代码不变

初始化代码说明 #

你的初始化代码本身无问题，修复警告后即可正常使用：

require ROOT . "/inc/log4php/Logger.php";
Logger::configure(ROOT . 'log-config.xml');
$logger = Logger::getLogger('main');
define('LOG', $logger);
LOG->debug('utils.php');

内容的提问来源于stack exchange，提问作者theking2