PHP: 错误处理与调试

Notice      ← "你可能有疏忽"（未定义变量、偏移量）
Warning     ← "代码有问题但能继续跑"（include找不到文件）
Fatal Error ← "代码有严重错误，必须停"（调用了不存在的函数）

<?php
// Notice：未定义变量（PHP 继续执行）
echo $undefinedVar;  // Notice: Undefined variable $undefinedVar

// Warning：文件不存在（PHP 继续执行）
include 'nonexistent.php';  // Warning: Failed opening...

// Fatal Error：调用不存在的函数（PHP 停止）
thisFunctionDoesNotExist();  // Fatal Error: Call to undefined function
?>

<?php
// 开发环境：显示所有错误
error_reporting(E_ALL);
ini_set('display_errors', '1');

// 生产环境：记录但不显示
error_reporting(E_ALL);
ini_set('display_errors', '0');
ini_set('log_errors', '1');
ini_set('error_log', __DIR__ . '/php-errors.log');
?>

<?php
$isDev = ($_SERVER['SERVER_NAME'] ?? '') === 'localhost';

if ($isDev) {
    error_reporting(E_ALL);
    ini_set('display_errors', '1');
} else {
    error_reporting(E_ALL);
    ini_set('display_errors', '0');
    ini_set('log_errors', '1');
    ini_set('error_log', '/var/log/php/errors.log');
}
?>

<?php
function divide(float $a, float $b): float {
    if ($b === 0.0) {
        throw new Exception("除数不能为 0！");
    }
    return $a / $b;
}

try {
    echo divide(10, 2) . "<br>";  // 5
    echo divide(10, 0) . "<br>";  // 抛出异常
} catch (Exception $e) {
    echo "【捕获异常】{$e->getMessage()}<br>";
    echo "文件：{$e->getFile()}<br>";
    echo "行号：{$e->getLine()}<br>";
} finally {
    echo "无论成功失败，finally 都会执行（如关闭文件、释放资源）<br>";
}
?>

<?php
class ValidationException extends Exception {
    private array $errors;
    
    public function __construct(array $errors, string $message = "验证失败") {
        parent::__construct($message);
        $this->errors = $errors;
    }
    
    public function getErrors(): array {
        return $this->errors;
    }
}

class UserNotFoundException extends Exception {}

// 使用自定义异常
function findUser(int $id): array {
    $users = [1 => ['name' => '小明'], 2 => ['name' => '小红']];
    
    if (!isset($users[$id])) {
        throw new UserNotFoundException("用户 ID {$id} 不存在");
    }
    return $users[$id];
}

function validateUsername(string $name): void {
    $errors = [];
    if ($name === '') $errors[] = '用户名不能为空';
    if (strlen($name) > 50) $errors[] = '用户名过长';
    if (!empty($errors)) throw new ValidationException($errors);
}

// 统一异常处理
try {
    validateUsername('');
    $user = findUser(99);
} catch (ValidationException $e) {
    echo "【验证失败】<br>" . implode("<br>", $e->getErrors());
} catch (UserNotFoundException $e) {
    echo "【用户未找到】{$e->getMessage()}";
} catch (Exception $e) {
    echo "【未知错误】{$e->getMessage()}";
}
?>

<?php
class AppLogger {
    public function __construct(
        private string $logDir
    ) {
        if (!is_dir($logDir)) {
            mkdir($logDir, 0755, true);
        }
    }
    
    public function info(string $message, array $context = []): void {
        $this->log('INFO', $message, $context);
    }
    
    public function error(string $message, array $context = []): void {
        $this->log('ERROR', $message, $context);
    }
    
    private function log(string $level, string $message, array $context): void {
        $date = date('Y-m-d');
        $time = date('H:i:s');
        
        $line = "[{$time}] [{$level}] {$message}";
        if (!empty($context)) {
            $line .= ' ' . json_encode($context, JSON_UNESCAPED_UNICODE);
        }
        $line .= "\n";
        
        $file = "{$this->logDir}/app-{$date}.log";
        file_put_contents($file, $line, FILE_APPEND | LOCK_EX);
    }
}

$log = new AppLogger(__DIR__ . '/logs');
$log->info('用户登录', ['username' => '小明', 'ip' => $_SERVER['REMOTE_ADDR'] ?? '']);
$log->error('支付失败', ['order_id' => 12345, 'reason' => '余额不足']);
?>

<?php
// 最常用的调试输出
$data = ['name' => '小明', 'skills' => ['PHP', 'MySQL']];

var_dump($data);  // 详细输出（类型+值）
// array(2) { ["name"]=> string(6) "小明" ["skills"]=> ... }

print_r($data);   // 简洁输出
// Array ( [name] => 小明 [skills] => Array ( [0] => PHP [1] => MySQL ) )

// 格式化 var_dump（推荐）
echo '<pre>'; print_r($data); echo '</pre>';

// 调试并终止
var_dump($data); exit;  // 或 die(var_dump($data));
?>

<?php
// 值 + 类型
var_dump($variable);

// 只在开发环境显示
if ($isDev) {
    echo '<pre>'; var_dump($data); echo '</pre>';
}

// 记录到日志
error_log("调试信息：" . print_r($data, true));

// 检查是否到达某行代码
echo "HERE"; exit;  // 或 error_log("执行到了这里");

// 查看调用栈
debug_print_backtrace();

// 检查变量是否设置
var_dump(isset($var), empty($var));
?>

<?php
// 输出缓冲：捕获 echo/print 等输出
ob_start();
echo "这些文字不会直接发送到浏览器。";
$content = ob_get_clean();  // 获取并清除缓冲区
// $content 现在是 "这些文字不会直接发送到浏览器。"

// 自定义错误处理器
function myErrorHandler(int $errno, string $errstr, string $errfile, int $errline): bool {
    $message = "[{$errno}] {$errstr} in {$errfile}:{$errline}";
    error_log($message);
    
    if (ini_get('display_errors')) {
        echo "<div style='background:#ffebee;padding:10px;margin:10px'>
            <strong>PHP Error:</strong> {$message}
        </div>";
    }
    return true;  // 阻止 PHP 默认处理
}
set_error_handler('myErrorHandler');

// 测试自定义错误处理器
echo $undefined;  // 现在会显示在漂亮的 HTML 框里
?>