PHP脚本结束前清理与日志记录方法

PHP的`register_shutdown_function`是一个强大而易被忽视的机制，它能在脚本无论正常结束还是因致命错误崩溃时自动执行清理任务——从写入运行日志、释放数据库连接和文件句柄，到捕获常规try-catch无法拦截的parse error和fatal error，甚至统计执行耗时，一并搞定；它兼容Web与CLI环境，支持函数名、匿名函数等多种回调形式，按注册顺序可靠执行，虽无法应对kill -9等强制中断，却为无人值守的后台服务和关键业务脚本提供了至关重要的最后一道防线，是提升PHP应用健壮性与可观测性的实用利器。

在PHP中，register_shutdown_function 用于注册一个回调函数，该函数会在脚本执行完毕或调用 exit() 时自动执行。无论脚本是正常结束还是因错误终止，这个注册的函数都会被触发，非常适合用来做资源清理、日志记录、错误捕获等操作。

作用与使用场景

register_shutdown_function 的主要用途是在 PHP 脚本生命周期的最后阶段执行一些收尾工作。常见应用场景包括：

• 写入日志：记录脚本运行完成的时间、状态或关键信息。
• 释放资源：关闭文件句柄、数据库连接或其他打开的资源。
• 捕获致命错误：结合 error_get_last() 捕获 parse error、fatal error 等无法通过常规 try-catch 捕获的错误。
• 统计执行时间：计算脚本从开始到结束的总耗时。

基本语法与示例

可以传入函数名、匿名函数或带有 __invoke 方法的对象。支持传递额外参数。

示例1：简单日志写入

示例2：捕获致命错误

注意事项

虽然 register_shutdown_function 功能强大，但使用时需注意以下几点：

• 多个调用会按注册顺序执行，而非先进后出。
• 不能阻止已发送的输出内容，也不能修改 HTTP 响应头（头部已发送）。
• 在 CLI 模式和 Web 模式下均有效，适合长时间运行的脚本监控。
• 如果脚本被强制中断（如 kill -9），可能不会执行。
• 避免在 shutdown 函数中再次调用 exit 或 die，可能导致递归调用。

基本上就这些。合理利用 register_shutdown_function 可以提升程序健壮性，尤其在无人值守的后台任务中非常实用。不复杂但容易忽略。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~