PHP脚本终止回调函数注册方法详解
在PHP开发中，有时我们需要在脚本执行完毕或意外终止时执行一些特定的操作，例如清理临时文件、记录运行日志、释放数据库连接或发送统计数据。PHP提供了一个非常实用的内置机制来实现这一需求，即脚本终止回调函数注册。
一、register_shutdown_function() 函数介绍
PHP提供了 register_shutdown_function() 函数，用于注册一个或多个在脚本执行完毕或遇到致命错误终止时自动调用的回调函数。这意味着无论脚本是正常走完生命周期结束，还是因为调用了 exit() 或 die() 提前终止，亦或是发生了致命错误导致脚本崩溃，注册的回调函数都会被执行。
二、基本用法示例
下面是一个最基础的用法，注册一个普通的函数作为回调：
<?php
function shutdownCallback() {
echo "脚本执行完毕，正在执行回调函数！n";
}
// 注册回调函数
register_shutdown_function('shutdownCallback');
echo "脚本正在运行...n";
// 脚本正常结束时，会自动调用 shutdownCallback
?>三、高级用法
1. 注册类方法
如果回调函数是一个类的方法，可以传递一个数组，数组的第一个元素为类实例，第二个元素为方法名：
<?php
class MyShutdown {
public function onShutdown() {
echo "类方法作为回调函数执行。n";
}
}
$obj = new MyShutdown();
register_shutdown_function([$obj, 'onShutdown']);
echo "脚本运行中...n";
?>2. 使用匿名函数（闭包）
PHP支持匿名函数，这使得回调注册更加简洁灵活：
<?php
register_shutdown_function(function() {
echo "匿名函数作为回调执行。n";
});
echo "脚本运行中...n";
?>3. 注册多个回调函数
可以多次调用 register_shutdown_function() 来注册多个回调函数，它们将按照注册的顺序依次执行：
<?php
register_shutdown_function(function() {
echo "第一个回调函数执行。n";
});
register_shutdown_function(function() {
echo "第二个回调函数执行。n";
});
echo "脚本运行中...n";
?>四、重要注意事项
触发时机：回调函数在脚本结束时调用，包括正常结束、调用
exit()或die()、以及发生致命错误时。但如果进程被操作系统的kill -9命令强行杀掉，或发生段错误等，回调函数将无法触发。无法传递参数：注册的回调函数无法接收来自脚本终止时的参数。如果需要传递数据，可以使用全局变量、类属性或常量。
输出缓冲：在回调函数中输出内容时，要注意PHP的输出缓冲机制。如果在回调中输出HTML内容，注意使用 <br> 标签换行而非 n，因为浏览器解析时需要对应的HTML标签。同时
<br>在代码说明中也要注意转义。工作目录：在回调函数执行时，如果脚本发生致命错误，工作目录可能会发生变化，建议在回调中使用绝对路径。
五、实战应用场景
1. 捕获致命错误并记录日志
当程序发生致命错误时，常规的错误处理机制可能已经失效，此时可以利用关闭回调结合 error_get_last() 来捕获并记录错误信息：
<?php
function catchFatalError() {
$error = error_get_last();
if ($error !== null && in_array($error['type'], [E_ERROR, E_CORE_ERROR, E_COMPILE_ERROR, E_PARSE])) {
// 记录到日志文件
error_log("发生致命错误: " . print_r($error, true));
echo "系统发生错误，请稍后再试。";
}
}
register_shutdown_function('catchFatalError');
// 模拟致命错误（例如调用未定义的函数）
// undefined_function();
echo "程序正常运行结束。n";
?>2. 统计脚本执行耗时
在脚本开头记录开始时间，在结束时利用闭包回调计算并输出耗时，这在性能调优时非常有用：
<?php
$startTime = microtime(true);
register_shutdown_function(function() use (&$startTime) {
$endTime = microtime(true);
$costTime = round(($endTime - $startTime) * 1000, 2);
echo "脚本执行耗时: {$costTime} 毫秒n";
});
// 模拟业务逻辑耗时
usleep(500000);
echo "业务逻辑处理完成。n";
?>3. 清理临时资源
在处理大文件或生成临时缓存时，如果脚本中途崩溃，可能会留下垃圾文件。通过注册回调可以确保临时文件被删除：
<?php
$tempFile = '/tmp/my_temp_data.tmp';
register_shutdown_function(function() use (&$tempFile) {
if (file_exists($tempFile)) {
unlink($tempFile);
echo "临时文件已清理。n";
}
});
// 写入临时文件
file_put_contents($tempFile, 'some data');
echo "临时文件已生成。n";
?>六、处理连接中断
如果用户在脚本执行期间关闭了浏览器连接，PHP脚本默认仍会继续执行直到完成。你可以通过 connection_aborted() 或 connection_status() 来判断客户端是否已经断开，并在回调中进行针对性处理，例如取消未完成的数据库写入或记录用户中断行为。