PHP动态网页日志记录系统_PHP动态网页操作日志记录功能教程

file_put_contents()

logs

Logger::info('用户登录成功', ['user_id' => $userId, 'ip' => $_SERVER['REMOTE_ADDR']])

echo

var_dump

<?php

class OperationLogger
{
    const DEBUG = 'DEBUG';
    const INFO = 'INFO';
    const WARNING = 'WARNING';
    const ERROR = 'ERROR';
    const CRITICAL = 'CRITICAL';

    private $logFilePath;
    private $minLogLevel; // 最低记录级别

    public function __construct(string $logFilePath, string $minLogLevel = self::INFO)
    {
        $this->logFilePath = $logFilePath;
        $this->minLogLevel = $minLogLevel;

        // 确保日志目录存在
        $logDir = dirname($logFilePath);
        if (!is_dir($logDir)) {
            mkdir($logDir, 0775, true);
        }
    }

    /**
     * 记录日志
     * @param string $level 日志级别
     * @param string $message 日志消息
     * @param array $context 额外上下文数据
     */
    public function log(string $level, string $message, array $context = [])
    {
        if (!$this->shouldLog($level)) {
            return; // 不符合最低记录级别，不记录
        }

        $timestamp = date('Y-m-d H:i:s');
        $logEntry = [
            'timestamp' => $timestamp,
            'level' => $level,
            'message' => $message,
            'context' => $context,
            'ip_address' => $_SERVER['REMOTE_ADDR'] ?? 'N/A', // 尝试获取IP
            'user_agent' => $_SERVER['HTTP_USER_AGENT'] ?? 'N/A', // 尝试获取User-Agent
        ];

        $formattedLog = json_encode($logEntry, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT) . PHP_EOL;

        // 使用文件锁避免并发写入问题
        $fileHandle = fopen($this->logFilePath, 'a');
        if ($fileHandle) {
            if (flock($fileHandle, LOCK_EX)) { // 独占锁定
                fwrite($fileHandle, $formattedLog);
                flock($fileHandle, LOCK_UN); // 解锁
            }
            fclose($fileHandle);
        } else {
            // 如果日志文件无法打开，可以尝试 fallback 到 PHP 内置的 error_log
            error_log("Failed to write to log file: {$this->logFilePath}. Original message: " . $message, 0);
        }
    }

    // 快捷方法
    public function debug(string $message, array $context = []) { $this->log(self::DEBUG, $message, $context); }
    public function info(string $message, array $context = []) { $this->log(self::INFO, $message, $context); }
    public function warning(string $message, array $context = []) { $this->log(self::WARNING, $message, $context); }
    public function error(string $message, array $context = []) { $this->log(self::ERROR, $message, $context); }
    public function critical(string $message, array $context = []) { $this->log(self::CRITICAL, $message, $context); }

    /**
     * 判断当前级别是否应该被记录
     * @param string $level
     * @return bool
     */
    private function shouldLog(string $level): bool
    {
        $levels = [
            self::DEBUG => 0,
            self::INFO => 1,
            self::WARNING => 2,
            self::ERROR => 3,
            self::CRITICAL => 4,
        ];

        return ($levels[$level] ?? 0) >= ($levels[$this->minLogLevel] ?? 0);
    }
}

// --- 使用示例 ---

// 假设你的日志文件在项目的 logs 目录下
$logFile = __DIR__ . '/../logs/operations_' . date('Y-m-d') . '.log';
$logger = new OperationLogger($logFile, OperationLogger::INFO); // 生产环境通常从INFO级别开始记录

// 用户登录成功
$logger->info('用户登录成功', ['user_id' => 123, 'username' => 'john.doe', 'session_id' => 'abcde12345']);

// 用户更新了个人资料
$logger->info('用户更新个人资料', [
    'user_id' => 123,
    'field_changed' => 'email',
    'old_value' => 'old@example.com',
    'new_value' => 'new@example.com'
]);

// 尝试进行未授权操作
$logger->warning('尝试访问未授权资源', ['user_id' => 456, 'resource' => '/admin/settings']);

// 发生了一个错误
try {
    // 模拟一个可能出错的操作
    $result = 1 / 0;
} catch (Throwable $e) {
    $logger->error('发生系统错误', [
        'error_message' => $e->getMessage(),
        'file' => $e->getFile(),
        'line' => $e->getLine(),
        'trace' => $e->getTraceAsString()
    ]);
}

// 调试信息（如果 minLogLevel 设置为 DEBUG 才会记录）
$logger->debug('变量值检查', ['data' => $_POST]);

?>

OperationLogger