Debian PHP如何实现日志记录

在Debian系统上做PHP开发，日志记录是个绕不开的基础操作。不管你是排查线上问题，还是监控应用运行状态，日志都是第一手情报来源。那么，在Debian环境下，PHP日志到底该怎么写才规范、高效？下面梳理了几种常见且实用的方案，供你参考。

1. 使用PHP内置的日志函数

PHP自带的error_log()函数是最直接的日志记录方式，无需额外安装任何库。它的用法很灵活，既能写入服务器错误日志，也能指定到自定义文件。

服务器的错误日志文件
error_log("This is an info message", 0);
// 记录一条错误信息到服务器的错误日志文件
error_log("This is an error message", 0);
?>

默认情况下，error_log()会把消息发往服务器错误日志文件。如果你想控制日志存放位置，可以在php.ini里配置：

; php.ini
error_log = /var/log/php_errors.log

这种方式适合快速记录少量信息，但生产环境下的复杂需求往往需要更强大的日志管理能力。

2. 使用Monolog库

Monolog是目前PHP生态中最流行的日志库，没有之一。它提供了丰富的处理器（Handler）和格式化器（Formatter），可以轻松将日志写入文件、数据库、邮件甚至第三方服务。

安装Monolog

通过Composer一行命令即可搞定：

composer require monolog/monolog

使用Monolog记录日志

下面是一个典型的用法示例，创建一个日志通道，指定日志文件路径，然后按不同级别写入日志：

pushHandler(new StreamHandler('/var/log/myapp.log', Logger::DEBUG));

// 记录不同级别的日志
$log->debug('Debug message');
$log->info('Info message');
$log->warning('Warning message');
$log->error('Error message');
?>

Monolog的灵活之处在于，你可以根据需要叠加多个处理器，比如同时写入文件并发送告警邮件。它的日志级别控制也相当精细，便于按严重程度过滤。

3. 使用系统日志

有些场景下，希望PHP日志与系统日志（如syslog、journald）统一管理，这样便于运维人员使用标准工具（如journalctl）集中查看和分析。

使用syslog

通过openlog()、syslog()、closelog()这套函数，可以直接写入系统日志：

使用journald

如果系统使用systemd，可以借助JournaldJournal类（需安装相应扩展）将日志发送到journald：

setPriority(JournaldJournal::PRIORITY_INFO);
$journal->addExtra(['app' => 'myapp']);
$journal->log('This is an info message');

$journal->setPriority(JournaldJournal::PRIORITY_ERR);
$journal->log('This is an error message');
?>

这种方式的好处是日志与系统服务深度集成，支持结构化数据，并且可以享受journald自带的日志轮转和索引功能。

4. 配置日志轮转

日志文件如果不加限制，会随着时间无限膨胀，最终撑爆磁盘。Linux上推荐使用logrotate工具来管理日志轮转，它是Debian系统的标配。

配置logrotate

创建一个配置文件，比如/etc/logrotate.d/myapp，内容如下：

/var/log/myapp.log {
    daily
    missingok
    rotate 7
    compress
    notifempty
    create 640 root adm
}

这个配置的意思是：每天轮转一次，保留最近7天的日志，旧日志压缩保存，如果日志为空则不轮转，轮转后自动创建新文件并设置权限为640，属主为root，组为adm。

完成配置后，logrotate会按计划自动执行，无需手动干预。你可以通过logrotate -d /etc/logrotate.d/myapp来调试验证配置是否正确。

以上几种方法覆盖了从简单到复杂的日志需求。日常开发中，用PHP内置函数快速调试没问题；但到了生产环境，建议认真考虑Monolog或系统日志方案，配合logrotate做好日志管理。毕竟，日志不仅是调试工具，更是系统健康和安全的晴雨表。