PHP 怎么PHP 错误日志记录

wen PHP项目 2026-07-30 92

本文目录导读：

PHP 怎么PHP 错误日志记录

php.ini 配置
运行时设置错误日志
使用 error_log() 函数
自定义错误处理函数
使用异常处理记录错误
完整的日志类示例
日志文件管理
最佳实践
注意事项

我来详细介绍 PHP 错误日志记录的几种方法：

php.ini 配置

基本配置

# 开启错误日志
log_errors = On
# 指定错误日志文件路径
error_log = /var/log/php_errors.log
# 设置错误报告级别
error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED
# 显示错误（开发环境开启，生产环境关闭）
display_errors = Off
# 记录最大错误数
log_errors_max_len = 1024

常用错误级别

// 所有错误
error_reporting(E_ALL);
// 除了提示信息
error_reporting(E_ALL & ~E_NOTICE);
// 严格模式（推荐）
error_reporting(E_ALL | E_STRICT);

运行时设置错误日志

// 开启错误日志
ini_set('log_errors', 1);
// 设置日志文件路径
ini_set('error_log', '/path/to/error.log');
// 设置错误报告级别
ini_set('error_reporting', E_ALL);

使用 error_log() 函数

// 简单记录
error_log("发生了一个错误");
// 记录到指定文件
error_log("数据库连接失败", 3, "/var/log/db_errors.log");
// 发送到系统日志
error_log("系统错误", 0);
// 发送到邮件（不推荐）
error_log("严重错误", 1, "[email protected]");

自定义错误处理函数

// 自定义错误处理
function customErrorHandler($errno, $errstr, $errfile, $errline) {
    $logMessage = sprintf(
        "[%s] 错误级别: %d - %s 在文件 %s 第 %d 行\n",
        date('Y-m-d H:i:s'),
        $errno,
        $errstr,
        $errfile,
        $errline
    );
    // 写入日志
    error_log($logMessage, 3, '/var/log/custom_errors.log');
    // 返回 true 阻止 PHP 默认错误处理
    return true;
}
// 注册自定义错误处理器
set_error_handler("customErrorHandler");

使用异常处理记录错误

try {
    // 可能出错的代码
    $result = 10 / 0;
} catch (Exception $e) {
    // 记录错误信息
    error_log("捕获异常: " . $e->getMessage());
    error_log("文件: " . $e->getFile() . " 行: " . $e->getLine());
}

完整的日志类示例

class Logger {
    private $logFile;
    private $logLevel;
    const DEBUG = 1;
    const INFO = 2;
    const WARNING = 3;
    const ERROR = 4;
    public function __construct($logFile, $logLevel = self::INFO) {
        $this->logFile = $logFile;
        $this->logLevel = $logLevel;
    }
    public function log($message, $level = self::INFO) {
        if ($level < $this->logLevel) {
            return;
        }
        $levelNames = [
            self::DEBUG => 'DEBUG',
            self::INFO => 'INFO',
            self::WARNING => 'WARNING',
            self::ERROR => 'ERROR'
        ];
        $logMessage = sprintf(
            "[%s] [%s] %s\n",
            date('Y-m-d H:i:s'),
            $levelNames[$level],
            $message
        );
        error_log($logMessage, 3, $this->logFile);
    }
    public function debug($message) {
        $this->log($message, self::DEBUG);
    }
    public function info($message) {
        $this->log($message, self::INFO);
    }
    public function warning($message) {
        $this->log($message, self::WARNING);
    }
    public function error($message) {
        $this->log($message, self::ERROR);
    }
}
// 使用示例
$logger = new Logger('/var/log/app.log', Logger::INFO);
$logger->debug("这条不会被记录");
$logger->info("应用启动成功");
$logger->warning("内存使用过高");
$logger->error("数据库连接失败");

日志文件管理

class LogManager {
    private $logFile;
    private $maxSize;
    private $backupCount;
    public function __construct($logFile, $maxSize = 10485760, $backupCount = 5) {
        $this->logFile = $logFile;
        $this->maxSize = $maxSize;
        $this->backupCount = $backupCount;
    }
    public function write($message) {
        // 检查文件大小并轮转
        $this->rotateIfNeeded();
        return error_log($message, 3, $this->logFile);
    }
    private function rotateIfNeeded() {
        if (!file_exists($this->logFile)) {
            return;
        }
        if (filesize($this->logFile) < $this->maxSize) {
            return;
        }
        // 删除最旧的备份
        $oldestBackup = $this->logFile . '.' . $this->backupCount;
        if (file_exists($oldestBackup)) {
            unlink($oldestBackup);
        }
        // 重命名现有备份
        for ($i = $this->backupCount - 1; $i >= 1; $i--) {
            $oldFile = $this->logFile . '.' . $i;
            $newFile = $this->logFile . '.' . ($i + 1);
            if (file_exists($oldFile)) {
                rename($oldFile, $newFile);
            }
        }
        // 重命名当前日志文件
        rename($this->logFile, $this->logFile . '.1');
    }
}

最佳实践

// 生产环境配置
ini_set('display_errors', 0);
ini_set('log_errors', 1);
ini_set('error_reporting', E_ALL & ~E_NOTICE & ~E_STRICT);
// 记录带上下文的错误
$context = [
    'user_id' => 123,
    'ip' => $_SERVER['REMOTE_ADDR'],
    'url' => $_SERVER['REQUEST_URI']
];
error_log("登录失败，上下文：" . json_encode($context));
// 使用框架的日志系统（如 Monolog）
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
$logger = new Logger('app');
$logger->pushHandler(new StreamHandler('/var/log/app.log', Logger::WARNING));
$logger->error('数据库错误', ['exception' => $e]);