PHP8.3 文件句柄 fopen 打开后忘记关闭，长时间运行脚本句柄泄露处理-php教程-PHP中文网

fopen后不fclose会导致句柄耗尽：因系统限制单进程可打开文件数（windows约16k，linux受ulimit-n约束），php不自动回收未关闭句柄，尤其在cli长任务、循环或异常退出时持续累积，最终触发“too many open files”错误。

php8.3 文件句柄 fopen 打开后忘记关闭，长时间运行脚本句柄泄露处理

为什么 fopen 后不 fclose 会导致句柄耗尽

Windows 默认单进程最多打开约 16K 个句柄，Linux 也有 ulimit -n 限制（通常 1024）。fopen() 每次成功调用都会占用一个系统级文件描述符，而 PHP 不会自动回收——哪怕脚本结束，若没显式 fclose($handle)，该句柄在进程生命周期内就一直挂着。尤其在 CLI 长任务、循环处理文件、或异常提前退出时，fclose() 被跳过，句柄数会线性增长。等达到上限，连 fopen('php://output') 都失败，报错 Unable to open file: Too many open files。

如何快速定位未关闭的句柄

PHP 7.3+ 提供 get_resources()，可直接列出当前所有打开资源：

print_r(array_keys(get_resources('stream')));

输出类似 [0 => "stream", 1 => "stream", ...]，数字就是句柄 ID。配合日志，在关键循环前后打点：

$before = count(get_resources('stream'));
// ... 一堆 fopen() ...
$after = count(get_resources('stream'));
if ($after - $before > 1) {
    error_log("疑似泄漏：+ ".($after - $before)." 个 stream");
}

更稳妥的做法是注册关机回调，在脚本意外终止时兜底检查：

register_shutdown_function(function () {
    $streams = get_resources('stream');
    if (!empty($streams)) {
        error_log('Shutdown: '.count($streams).' stream(s) still open');
        // 可选：遍历并 fclose 所有，但需注意 handle 是否已失效
    }
});

用 file_put_contents 替代 fopen + fwrite + fclose 组合

绝大多数写文件场景根本不需要手动管理句柄。file_put_contents() 是原子封装：自动打开、写入、关闭，且支持 LOCK_EX 和 FILE_NO_CREATE（PHP 8.1+）等关键标志。例如确保只写入已有文件：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

file_put_contents($path, $data, LOCK_EX | FILE_NO_CREATE);

若要新建文件且拒绝覆盖，PHP 8.1+ 推荐用 fopen($path, 'x') —— 它只在文件不存在时成功，失败返回 false，不会报 Permission denied；老版本则用 tempnam() + rename() 组合，后者在同分区下是原子操作，且 rename() 会直接覆盖目标。

try/finally 是 fclose 最小安全单元

只要用了 fopen()，就必须配对 fclose()，且不能依赖 __destruct() 或脚本结束自动清理。最简健壮写法是：

$handle = fopen($path, 'r');
try {
    // 处理逻辑，可能 throw Exception
    $content = fread($handle, 8192);
} finally {
    if (is_resource($handle)) {
        fclose($handle);
    }
}

注意三点：