PHP get_resource_id 怎样为文件句柄记录日志标识

在 PHP 8 及以上版本，文件打开成功后调用 get_resource_id($handle)，把返回的整数保存到日志上下文的 resource_id 字段即可。先判断 fopen 是否失败，再获取标识；关闭时记录先前保存的整数。这个编号用于关联资源操作，不应当作文件路径、操作系统文件描述符或跨请求的业务主键。

PHP 官方手册：https://www.php.net/manual/en/function.get-resource-id.php

PHP 8 提供了明确的资源标识函数

旧代码常用 (int) $handle 提取资源编号。PHP 8 的 get_resource_id 把这个意图表达为明确的函数调用，返回类型为 int。官方手册说明，它本质上相当于资源到整数的转换；因此更换写法的理由是可读性与参数语义，不是生成了另一套全局编号。

这里讨论 fopen 返回的文件资源，不把所有扩展连接都视为 resource。如果某个扩展返回对象，应使用该扩展支持的诊断方式。维护仍支持 PHP 7 的库时，也不能不调整最低版本要求就直接调用 PHP 8 函数。

打开成功后保存整数，不把句柄塞进日志

先看只包含资源标识的最小写法。示例读取当前脚本文件，避免另找测试文件；没有打印文件内容，也没有把资源本体交给 JSON 编码器。

 'file_opened',
        'resource_id' => $rid,
    ], JSON_THROW_ON_ERROR));
} finally {
    // 当前代码拥有该句柄，结束时负责关闭。
    if (!fclose($handle)) {
        error_log('示例文件句柄关闭失败');
    }
}

应看到的结构是 event 字符串和 resource_id 整数，而不是某个固定编号。数字由当前运行环境分配，读者不需要与文档示例数字相同。以上是可复用示例及预期解释，不是本机运行记录。

日志还要携带请求与操作范围

单独搜索 resource_id 容易把不同请求的日志混在一起。工程上可以沿用应用已有的 request_id，并增加本次文件操作的 operation_id；它们是应用自己定义的关联字段，不是 get_resource_id 的返回信息。

同一路径可以被打开多次，路径相同不说明句柄相同。编号相同也不应脱离进程与请求范围解释。对长期日志，我更建议以应用的操作关联键为主，资源编号作为辅助字段，避免把实现细节变成持久化协议。

关闭句柄后沿用已保存的标识

需要关联打开与关闭日志时，提前保存 rid，关闭后使用这个普通整数。关闭成功与否来自 fclose 的返回值，不来自编号是否存在。下面把上下文固定下来，finally 中仍能使用。

 'demo-request',
    'operation_id' => 'read-script',
];
$handle = fopen(__FILE__, 'rb');
if ($handle === false) {
    error_log(json_encode(
        $context + ['event' => 'file_open_failed'],
        JSON_THROW_ON_ERROR
    ));
    throw new RuntimeException('无法打开示例文件');
}
$context['resource_id'] = get_resource_id($handle);
try {
    error_log(json_encode(
        $context + ['event' => 'file_opened'],
        JSON_THROW_ON_ERROR
    ));
    // 在这里放置实际读取逻辑；日志不要包含敏感文件内容。
} finally {
    $closed = fclose($handle);
    // 关闭之后只使用已保存的整数，不再依赖句柄执行读取。
    error_log(json_encode(
        $context + ['event' => 'file_close', 'closed' => $closed],
        JSON_THROW_ON_ERROR
    ));
}

这里的固定演示 request_id 不可原样用于线上所有请求。JSON_THROW_ON_ERROR 让编码失败显式暴露，实际应用可交给已有日志组件统一处理，避免日志异常掩盖原始业务异常。拥有句柄的代码负责关闭；如果句柄由调用方借给当前函数，关闭职责应遵循调用契约，不能随意代为关闭。

is_resource 对已经关闭的资源返回 false，可以辅助判断当前变量是否仍为活动资源。不过它不是文件读取权限、可读性或健康状态的完整检查，也不能通过保留一个 rid 让文件重新变为可用。

替换旧写法时确认这些预期

替换旧的整数强制转换时，先确认该变量确实是 resource，再统一日志字段名和关联范围。给读者的最小检查清单是：成功打开有整数编号；打开失败不调用 get_resource_id；同一次操作的打开和关闭记录保留同一个已保存编号；closed 字段如实来自 fclose；新请求不依靠裸编号与旧日志合并。无需要求不同机器产生相同数字。

能通过编号重新得到句柄吗？这个函数只返回整数标识，不提供按编号恢复文件句柄的接口；实际读写仍需要保留有效资源。

能用它判断是否泄漏吗？单个编号不够。需要结合打开、关闭事件和代码所有权分析，不能把编号增大当作泄漏证据。

关闭后还要重新取编号吗？日志关联直接使用关闭前保存的整数。资源状态与历史标识分开管理，代码更容易理解。

相关官方资料：https://www.php.net/manual/en/function.fopen.php；https://www.php.net/manual/en/function.fclose.php；https://www.php.net/manual/en/function.is-resource.php。