异常教程
PHP Error 和 Logging 函数（保姆级教程）
💡一则或许对你有用的小广告
欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论
- 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于
Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;- 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;
截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观
前言
在 PHP 开发中，错误处理和日志记录是构建健壮应用程序的基石。无论是初学者还是中级开发者，理解如何有效管理错误、记录关键信息，都能显著提升代码的可靠性与可维护性。本文将从基础概念逐步深入，结合实际案例和代码示例，系统讲解 PHP 错误类型、内置函数及最佳实践，帮助读者掌握这一核心技能。
错误类型概述
PHP 中的错误分为多种类型，每种类型代表不同的严重程度和应用场景。理解这些类型是处理问题的第一步。
1. 通知（Notice）
通知类错误通常不会中断程序执行，但提示潜在的代码问题。例如：
$var = "Hello";
echo $undefined_var; // 会触发 "Undefined variable: undefined_var" 的 Notice
比喻：通知如同交通信号灯的黄色警示灯，提醒开发者可能存在风险，但程序仍可继续运行。
2. 警告（Warning）
警告类错误可能影响程序的预期行为，但通常不会立即终止脚本。例如：
file_get_contents("nonexistent_file.txt"); // 触发 "Failed to open stream" 的 Warning
比喻：警告如同车辆仪表盘的故障指示灯，表明系统存在需要解决的问题。
3. 致命错误（Fatal Error）
致命错误会直接终止脚本执行，常见于语法错误或资源耗尽等场景：
echo 100 / 0; // 触发 "Division by zero" 的致命错误
比喻：致命错误如同汽车引擎故障，程序无法继续运行，必须立即修复。
PHP 错误处理函数
PHP 提供了多种函数来捕获和处理错误，开发者可通过自定义逻辑增强程序的容错能力。
1. set_error_handler()
此函数允许定义自定义错误处理函数，替代默认的错误行为：
function customErrorHandler($errno, $errstr, $errfile, $errline) {
// 记录错误到日志文件
error_log("Error: [$errno] $errstr in $errfile on line $errline");
// 返回 true 表示错误已处理，程序继续执行
return true;
}
// 设置自定义错误处理器，屏蔽 Notice 类型
set_error_handler("customErrorHandler", E_ALL & ~E_NOTICE);
关键点：通过 $errno 参数过滤错误类型，避免干扰非关键问题。
2. error_reporting()
此函数控制显示哪些类型的错误信息：
// 只报告致命错误和警告，屏蔽 Notice
error_reporting(E_ERROR | E_WARNING);
实际场景：在生产环境中，通常设置为 error_reporting(0) 并记录错误到日志，避免暴露敏感信息。
PHP 日志记录函数
日志记录是排查问题、监控系统状态的重要手段。PHP 内置 error_log() 函数，支持多种输出方式。
1. 基础用法
// 记录到服务器的默认错误日志（通常为 Apache 或 PHP-FPM 日志）
error_log("User login failed");
// 指定日志文件路径
error_log("Invalid input data", 3, "/var/log/myapp.log");
// 发送错误到邮件（需配置 PHP 邮件设置）
error_log("High-priority alert", 1, "admin@example.com");
参数说明：第二个参数 $message_type 决定日志的输出方式（3 表示写入文件，1 表示发送邮件）。
2. 自定义日志类（进阶）
通过封装日志功能，可实现更灵活的记录逻辑：
class Logger {
private $logFile;
public function __construct($file) {
$this->logFile = $file;
}
public function log($message) {
// 添加时间戳和上下文信息
$entry = date("Y-m-d H:i:s") . " - " . $message . PHP_EOL;
error_log($entry, 3, $this->logFile);
}
}
// 使用示例
$logger = new Logger("/var/log/app.log");
$logger->log("User registered with ID 123");
优势：通过类封装，可轻松扩展日志级别、文件轮转等功能。
错误处理与日志记录的最佳实践
1. 分离开发与生产环境配置
在开发环境中，启用详细错误提示以快速调试：
// 开发环境配置
ini_set("display_errors", 1);
error_reporting(E_ALL);
而在生产环境，关闭错误显示并记录到文件：
// 生产环境配置
ini_set("display_errors", 0);
error_reporting(E_ALL);
2. 规范日志格式
统一日志格式便于后续分析。例如：
$logEntry = sprintf(
"[%s] %s: %s",
date("c"),
$_SERVER["REMOTE_ADDR"],
$message
);
error_log($logEntry, 3, "application.log");
3. 结合异常处理（Exception）
对于可预见的逻辑错误（如用户输入验证失败），优先使用异常机制：
class InvalidInputException extends Exception {}
function validateEmail($email) {
if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
throw new InvalidInputException("Invalid email format");
}
}
try {
validateEmail("user@example");
} catch (InvalidInputException $e) {
error_log($e->getMessage());
echo "Error: " . $e->getMessage();
}
优势：异常能更清晰地分隔业务逻辑与错误处理流程。
实际案例：用户注册功能的错误处理
以下是一个完整的用户注册流程示例，演示如何结合错误处理和日志记录：
// 配置日志记录器
$logger = new Logger("/var/log/user-registration.log");
try {
// 验证输入数据
if (empty($_POST["email"])) {
throw new Exception("Email is required");
}
// 检查邮箱是否已存在
if (checkExistingEmail($_POST["email"])) {
throw new Exception("Email already registered");
}
// 保存用户到数据库
$userId = saveUser($_POST);
$logger->log("User registered successfully (ID: $userId)");
} catch (Exception $e) {
// 记录错误并返回友好提示
$logger->log($e->getMessage());
echo "Registration failed: " . htmlspecialchars($e->getMessage());
}
结论
PHP Error 和 Logging 函数是开发者构建可靠应用的必备工具。通过合理配置错误级别、自定义错误处理器、规范日志格式，并结合异常机制，开发者可以显著提升代码的健壮性和可维护性。无论是调试开发中的小问题，还是监控生产环境的异常，掌握这些技能将帮助你更高效地应对复杂场景。
最后提醒：在真实项目中，建议结合日志分析工具（如 ELK 栈）或第三方服务（如 Sentry）进一步优化日志管理，但基础的 PHP 函数始终是构建这一切的核心。