PHP 怎么PHP 错误追踪

wen PHP项目 2026-07-29 74

本文目录导读：

PHP 怎么PHP 错误追踪

基础错误显示设置
自定义错误处理函数
异常处理（try-catch）
使用 debug_backtrace()
错误日志记录
使用 Xdebug 扩展
完整错误处理示例
常用调试函数
使用建议

PHP 错误追踪是开发中非常重要的技能，能帮你快速定位问题，以下是几种常用的 PHP 错误追踪方法：

基础错误显示设置

开发环境配置

// 显示所有错误
error_reporting(E_ALL);
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
// 生产环境建议关闭显示，记录到日志
ini_set('display_errors', 0);
ini_set('log_errors', 1);
ini_set('error_log', '/path/to/error.log');

php.ini 配置

error_reporting = E_ALL
display_errors = On
log_errors = On
error_log = /var/log/php_errors.log

自定义错误处理函数

// 自定义错误处理
function customErrorHandler($errno, $errstr, $errfile, $errline) {
    $message = "Error [$errno]: $errstr in $errfile on line $errline";
    // 记录到日志
    error_log($message);
    // 格式化输出
    echo "<pre>";
    echo "Error: " . $errstr . "\n";
    echo "File: " . $errfile . "\n";
    echo "Line: " . $errline . "\n";
    echo "</pre>";
    // 根据错误级别决定是否终止脚本
    if ($errno == E_USER_ERROR) {
        die("Fatal error occurred");
    }
}
set_error_handler("customErrorHandler");
// 触发错误测试
trigger_error("Test warning", E_USER_WARNING);

异常处理（try-catch）

try {
    // 可能抛出异常的代码
    $result = 10 / 0;
} catch (DivisionByZeroError $e) {
    echo "除零错误: " . $e->getMessage();
    echo "文件: " . $e->getFile();
    echo "行号: " . $e->getLine();
    echo "堆栈跟踪: " . $e->getTraceAsString();
} catch (Exception $e) {
    echo "其他异常: " . $e->getMessage();
}

使用 debug_backtrace()

function traceFunction() {
    // 获取调用堆栈
    $trace = debug_backtrace();
    echo "<pre>";
    foreach ($trace as $index => $call) {
        echo "#{$index} ";
        if (isset($call['file'])) {
            echo $call['file'] . ":" . $call['line'];
        }
        echo " - " . $call['function'] . "(";
        if (isset($call['args'])) {
            echo implode(", ", $call['args']);
        }
        echo ")\n";
    }
    echo "</pre>";
}
function testFunction() {
    traceFunction();
}
testFunction();

错误日志记录

// 手动记录错误
error_log("用户登录失败: " . $username, 3, "/var/log/app_errors.log");
// 记录到系统日志
error_log("数据库连接失败", 0);
// 记录到邮箱（生产环境慎用）
error_log("严重错误", 1, "admin@example.com");

使用 Xdebug 扩展

Xdebug 提供强大的调试功能：

// php.ini 配置
[xdebug]
xdebug.mode = debug,develop
xdebug.start_with_request = yes
xdebug.log = /var/log/xdebug.log
xdebug.idekey = "PHPSTORM"
// 代码中启用
xdebug_break(); // 设置断点
var_dump($variable); // 增强的 var_dump

完整错误处理示例

<?php
// 完整错误处理类
class ErrorHandler {
    private static $instance = null;
    private $logFile;
    private function __construct() {
        $this->logFile = __DIR__ . '/error.log';
        $this->registerHandlers();
    }
    public static function getInstance() {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }
    private function registerHandlers() {
        // 设置错误处理
        set_error_handler([$this, 'handleError']);
        // 设置异常处理
        set_exception_handler([$this, 'handleException']);
        // 注册关闭函数
        register_shutdown_function([$this, 'handleShutdown']);
        // 设置错误报告级别
        error_reporting(E_ALL);
        ini_set('display_errors', 0);
        ini_set('log_errors', 1);
    }
    public function handleError($errno, $errstr, $errfile, $errline) {
        $message = sprintf(
            "[%s] Error %d: %s in %s:%d\n%s\n",
            date('Y-m-d H:i:s'),
            $errno,
            $errstr,
            $errfile,
            $errline,
            $this->getBacktrace()
        );
        $this->log($message);
        // 根据错误类型决定是否终止
        if (in_array($errno, [E_ERROR, E_USER_ERROR, E_PARSE, E_CORE_ERROR])) {
            die("Fatal error occurred. Check error log.");
        }
        return true;
    }
    public function handleException($exception) {
        $message = sprintf(
            "[%s] Exception: %s in %s:%d\nStack trace:\n%s\n",
            date('Y-m-d H:i:s'),
            $exception->getMessage(),
            $exception->getFile(),
            $exception->getLine(),
            $exception->getTraceAsString()
        );
        $this->log($message);
        // 显示友好的错误页面
        if (php_sapi_name() !== 'cli') {
            http_response_code(500);
            echo "Internal Server Error";
        }
    }
    public function handleShutdown() {
        $error = error_get_last();
        if ($error !== null && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
            $this->handleError(
                $error['type'],
                $error['message'],
                $error['file'],
                $error['line']
            );
        }
    }
    private function getBacktrace() {
        $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 10);
        $output = "Backtrace:\n";
        foreach ($trace as $index => $call) {
            if ($index === 0) continue; // 跳过当前函数
            $output .= sprintf(
                "  #%d %s%s%s (%s:%d)\n",
                $index - 1,
                isset($call['class']) ? $call['class'] . '->' : '',
                $call['function'],
                isset($call['file']) ? '' : ' [internal]',
                $call['file'] ?? 'unknown',
                $call['line'] ?? 0
            );
        }
        return $output;
    }
    private function log($message) {
        file_put_contents($this->logFile, $message, FILE_APPEND | LOCK_EX);
    }
}
// 初始化错误处理
ErrorHandler::getInstance();
// 测试代码
try {
    // 故意触发错误
    echo $undefinedVariable;
    throw new Exception("测试异常");
} catch (Exception $e) {
    // 异常会被全局异常处理器捕获
}

常用调试函数

// 变量调试
var_dump($variable);  // 显示变量类型和值
print_r($variable);   // 打印可读的数组信息
debug_zval_refs($variable); // 显示引用信息
// 内存和性能调试
echo memory_get_usage(); // 当前内存使用
echo memory_get_peak_usage(); // 峰值内存使用
microtime(); // 时间测量
// 堆栈跟踪
debug_print_backtrace(); // 打印当前调用堆栈
echo (new Exception())->getTraceAsString(); // 异常风格的堆栈