Debian PHP日志管理策略

在Debian系统上做PHP日志管理，其实是个系统工程。它不光是调几个配置文件那么简单，得把PHP-FPM的日志、Web服务器（Apache或Nginx）的日志、业务代码里自定义的日志，还有日志轮转这事，都串起来想清楚。目标很明确：保证日志完整、随手可查、别把磁盘撑爆，同时性能别受影响。

一、PHP-FPM日志管理

PHP-FPM的日志，是PHP进程运行时的“黑匣子”。怎么管？核心就两个：错误日志和慢日志。

• 错误日志配置：编辑PHP-FPM池配置文件，通常位于 /etc/php/{version}/fpm/pool.d/www.conf。启用错误日志并指定路径，这几行是关键：

  catch_workers_output = yes
  php_admin_value[error_log] = /var/log/php-fpm/error.log
  php_admin_flag[log_errors] = on

  保存后，别忘了重启PHP-FPM服务：sudo systemctl restart php{version}-fpm。
• 慢日志配置：通过 slowlog_timeout 参数设置阈值（单位：秒），记录执行时间超过阈值的脚本。举个例子：

  slowlog = /var/log/php-fpm/slow.log
  slowlog_timeout = 5s  # 记录执行时间超过5秒的脚本

  慢日志最好和错误日志分开存放，这样分析性能问题时，路径清晰，不纠缠。

二、Web服务器日志管理

Web服务器（Apache或Nginx）的日志，记录的是PHP请求的“访问轨迹”和“错误痕迹”。它和PHP-FPM的日志是互补关系，缺一不可。

• Apache配置：
  • 错误日志：修改 /etc/apache2/apache2.conf 或虚拟主机配置，设置日志级别（比如 warn）和路径：

    ErrorLog ${APACHE_LOG_DIR}/error.log
    LogLevel warn

  • 访问日志：使用 combined 格式，记录IP、方法、URI、状态码等详细信息：

    CustomLog ${APACHE_LOG_DIR}/access.log combined

• Nginx配置：
  • 错误日志：在 /etc/nginx/nginx.conf 或服务器块中设置，类似：

    error_log /var/log/nginx/error.log warn;

  • 访问日志：自定义日志格式，比如包含客户端IP、请求时间、响应大小，然后指定路径：

    http {
        log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                        '$status $body_bytes_sent "$http_referer" '
                        '"$http_user_agent"';
        access_log /var/log/nginx/access.log main;
    }

  修改后记得重启Web服务器：sudo systemctl restart apache2（Apache）或 sudo systemctl restart nginx（Nginx）。

三、PHP脚本自定义日志

业务逻辑层面的日志，就需要开发者自己通过代码来记录了。比如用户登录失败、支付状态变更，这些信息，应用层自己最清楚。

• 使用 error_log() 函数：这是最直接的方式，把日志写入指定文件（确保目录有写入权限）：

  error_log("User login failed: username={$username}", 3, "/var/log/php/custom.log");

  参数说明：3 表示写入文件，第三个参数是日志路径。
• 使用Monolog库：如果项目规模不小，Monolog是更专业的方案。它支持多渠道输出（文件、数据库、邮件）、日志分级（DEBUG/INFO/ERROR）和格式自定义。示例配置：

  use Monolog\Logger;
  use Monolog\Handler\StreamHandler;
  
  $log = new Logger('app');
  $log->pushHandler(new StreamHandler('/var/log/php/app.log', Logger::ERROR));
  $log->error('Database connection failed: ' . $e->getMessage());

  Monolog需要先通过Composer安装：composer require monolog/monolog。

四、日志轮转配置

日志如果不加限制，会一直膨胀下去，直到把磁盘占满。所以，日志轮转是必不可少的环节。Debian系统自带的 logrotate 工具，就是干这事的。

• 默认配置：Debian已经为PHP-FPM、Apache、Nginx提供了默认的轮转配置，放在 /etc/logrotate.d/ 目录下。比如PHP-FPM的默认配置（/etc/logrotate.d/php-fpm）：

  /var/log/php-fpm.log {
      copytruncate      # 复制日志文件后清空原文件（避免重启服务）
      daily             # 每天轮转一次
      rotate 7          # 保留7个旧日志文件
      compress          # 压缩旧日志（如.gz格式）
      missingok         # 日志文件不存在时不报错
      notifempty        # 日志为空时不轮转
      create 640 root adm  # 创建新日志文件的权限和属主
  }

• 自定义配置：如果默认策略不满足需求，可以自己创建配置文件。比如按大小轮转（/etc/logrotate.d/php-custom）：

  /var/log/php/custom.log {
      daily
      rotate 30           # 保留30天日志
      compress
      size 100M           # 当日志文件超过100MB时轮转
      missingok
      notifempty
      sharedscripts
      postrotate
          systemctl reload php{version}-fpm > /dev/null 2>&1 || true
      endscript
  }

  配置写好后，可以测试一下：sudo logrotate -f /etc/logrotate.d/php-custom。

五、日志安全与管理优化

日志里记录了大量系统运行细节，敏感信息泄露可不是闹着玩的。所以，权限控制是第一道防线。

• 权限控制：确保日志文件只允许必要用户访问（比如root和日志所属组），避免敏感信息泄露：

  sudo chown root:adm /var/log/php-fpm/error.log
  sudo chmod 640 /var/log/php-fpm/error.log

• 敏感信息过滤：在日志中避免记录用户密码、API密钥等敏感信息。可以通过代码过滤，或者通过Web服务器配置（比如Apache的 SetEnvIf 指令）来实现。
• 实时监控：简单的需求，用 tail -f 命令直接看：tail -f /var/log/php-fpm/error.log。如果日志量大了，还是得上ELK（Elasticsearch+Logstash+Kibana）或Graylog这类集中化日志分析工具，效率完全不一样。

把上面这些点串起来，Debian环境下的PHP日志管理就能做到规范、有序。既保证了日志的完整性、可访问性，也兼顾了性能和安全性，为后续的问题排查和系统优化打下扎实基础。