PHP函数之错误处理：如何捕捉、记录和显示错误信息？

PHP 是一门流行的服务器端脚本语言，用于构建 Web 应用程序和动态网站。在编写 PHP 代码时，可能会出现错误，例如语法错误、运行时错误和逻辑错误等。为了有效地调试和管理代码，需要使用错误处理方法来捕获、记录和显示错误信息。

一、错误级别

PHP 错误分为严重错误（fatal error）、警告（warning）、注意（notice）和弱提示（strict warning）等四个级别。

严重错误（fatal error）：将导致脚本停止运行，并显示致命性错误信息。 示例：

<?php
echo “Hello world”;
undefined_function();
?>

警告（warning）：不会导致脚本停止运行，但是会在页面的底部提示出错信息。示例：

<?php
echo “Hello world”;
$var = $undefined_var;
?>

注意（notice）：不会影响程序的正常运行，但是会在页面底部输出提示信息。示例：

<?php
echo "Hello world!”;
$str = "PHP";
echo $str[10];
?>

弱提示（strict warning）：会在出现不符合标准的代码或不推荐的使用方法时给出警告。示例：

<?php
declare(strict_types=1);
function add(int $a, int $b) {
  return $a + $b;
}
echo add(2, "3");
?>

二、错误处理函数

在 PHP 中，有一些用于处理错误和异常的预定义函数。以下是一些通用的错误处理函数：

1. error_reporting() 函数：用于指定 PHP 错误报告级别。语法为：

error_reporting(error_level);

其中，error_level 参数指定要显示哪些错误，可以是以下选项之一：

- E_ALL：显示所有错误和警告信息

- E_ERROR：仅显示致命错误信息

- E_WARNING：仅显示警告信息

- E_NOTICE：仅显示注意信息

2. set_error_handler() 函数：用于设置自定义错误处理函数。语法为：

set_error_handler(error_handler);

其中，error_handler 参数指定要处理错误的函数名。例如：

<?php
function custom_error_handler($errno, $errstr, $errfile, $errline) {
    echo "<b>Error:</b> [$errno] $errstr<br>";
    echo "Error on line $errline in $errfile<br>";
}

set_error_handler("custom_error_handler");
?>

3. error_log() 函数：用于将错误消息记录到服务器上的日志文件中。语法为：

error_log(message, type, destination, extra_headers);

其中，message 参数指定要记录的错误消息；type 参数指定消息的记录方式，可以是以下选项之一：

- 0：将消息记录到 PHP 的系统日志中

- 1：将消息记录到指定的文件中

- 2：将消息发送到指定的电子邮件地址

destination 参数指定将消息记录到的文件或电子邮件地址，extra_headers 参数指定邮件头信息。

4. trigger_error() 函数：用于手动触发错误，并将错误消息记录到错误日志中。语法为：

trigger_error(error_message, error_type);

其中，error_message 参数指定要触发的错误消息，error_type 参数指定错误类型（例如，E_USER_NOTICE 或 E_USER_WARNING 等）。

5. debug_backtrace() 函数：用于获取当前代码中所有函数调用的调用位置。示例如下：

<?php
function foo() {
  bar();
}

function bar() {
  var_dump(debug_backtrace());
}

foo();
?>

三、异常处理

和错误处理类似，异常处理可以用于捕获并处理 PHP 中的异常情况。以下是一些常用的异常处理函数：

1. try-catch 语句块：用于捕获和处理异常。示例如下：

<?php
try {
  $result = 1/0;
} catch (Exception $e) {
  echo "Caught exception:", $e->getMessage();
}

echo "Hello world!";
?>

2. throw 语句：用于手动引发异常。示例如下：

<?php
function divide($a, $b) {
  if ($b == 0) {
    throw new Exception("Division by zero");
  } else {
    return $a / $b;
  }
}

try {
  echo divide(5, 0);
} catch (Exception $e) {
  echo "Caught exception:", $e->getMessage();
}

echo "Hello world!";
?>

四、总结

在 PHP 中，通过设置错误级别、自定义错误处理函数、记录错误日志、手动触发错误和使用异常处理等方式，可以有效地管理和调试代码。同时，我们还需注意代码的安全性和优化性，例如使用密码保护错误日志、优化数据库查询和避免过度调试等。