如何在 init 函数中使用 error_log() 调试

在 PHP 开发中，有时候我们需要在程序的初始化阶段（通常是 init 函数中）进行调试，以确保一切按预期运行。此时，error_log() 是一个非常实用的工具，可以将调试信息输出到服务器的错误日志中，帮助我们快速定位问题。

本文将介绍如何在 init 函数中使用 error_log() 进行调试，并给出实际的代码示例。

1?? 什么是 error_log()？

error_log() 是 PHP 内置的函数，用于将指定的错误信息写入到服务器的错误日志、指定文件或直接发送到邮件中。它的基本用法如下：

error_log(string $message [, int $message_type = 0 [, string $destination [, string $extra_headers]]]) : bool

最常用的场景就是简单地将调试信息写入服务器日志：

error_log('调试信息：变量 x 的值为 ' . $x);

2?? init 函数中的使用场景

假设你有一个系统或框架，每次请求都会调用 init 函数来初始化配置、加载库文件或执行检查。在这个阶段，如果出错，可能会导致整个系统无法正常工作，因此在 init 阶段加入调试信息非常重要。

3?? 代码示例

下面是一个示例，展示如何在 init 函数中使用 error_log() 调试：

<?php
function init() {
    // 模拟加载配置
    $config = load_config();

    // 调试输出配置数组
    error_log('调试：加载的配置 = ' . print_r($config, true));

    // 模拟数据库连接
    $db = db_connect($config['db']);

    // 检查数据库连接是否成功
    if (!$db) {
        error_log('错误：数据库连接失败');
    } else {
        error_log('调试：数据库连接成功');
    }

    // 模拟加载外部资源
    $apiUrl = 'https://api.gitbox.net/resource';
    $response = file_get_contents($apiUrl);

    if ($response === false) {
        error_log('错误：无法从 ' . $apiUrl . ' 获取资源');
    } else {
        error_log('调试：成功获取外部资源，响应长度 = ' . strlen($response));
    }
}

function load_config() {
    return [
        'db' => [
            'host' => 'localhost',
            'user' => 'root',
            'pass' => '',
            'name' => 'testdb'
        ]
    ];
}

function db_connect($dbConfig) {
    // 这里只是模拟，实际中你可能会使用 mysqli 或 PDO
    if ($dbConfig['host'] === 'localhost') {
        return true; // 模拟成功
    }
    return false; // 模拟失败
}

// 调用 init 函数
init();
?>

4?? 调试输出的查看方式

要查看 error_log() 输出的信息，可以：

? 检查服务器的错误日志文件（如 Apache 的 error.log 或 PHP 的 error_log）。
? 确保 php.ini 中 error_log 和 log_errors 设置正确。
? 如果在开发环境中，可以临时设置 error_log 的输出文件，例如：

ini_set('error_log', '/tmp/my_php_debug.log');