PHP创建文件并获取资源句柄的正确方式是fopen()函数。它返回resource|false，支持'w'（清空写入）、'a'（追加创建）、'c'（仅创建或打开）等模式，需配对fclose()，高频单次写入推荐file_put_contents()。
PHP 创建文件并获取资源句柄的正确方式
PHP 中没有所谓“_php句柄操作创文件法”这种命名规范或内置函数，fopen() 是创建/打开文件并返回资源句柄（resource，PHP 8.0+ 为 resource|false）的标准且唯一可靠方式。所谓“_php句柄”是误解，PHP 不提供下划线前缀的私有句柄 API。
fopen() 的三种典型用法与对应句柄行为
句柄本质是 PHP 内部对打开文件的引用，必须通过 fopen() 获取；直接写文件名或路径不会产生可操作句柄：
-
fopen('log.txt', 'w')：清空并写入，成功返回句柄，失败返回false -
fopen('data.json', 'a')：追加模式，文件不存在时自动创建，返回有效句柄 -
fopen('/tmp/cache.bin', 'c')：仅创建或打开（不截断），适合需要保留原内容又确保文件存在的情况
注意：'x' 模式（独占创建）失败时也返回 false，但会触发 E_WARNING，需配合 @ 抑制或用 error_get_last() 捕获。
拿到句柄后必须配对使用 fclose()
资源句柄不是普通变量，不显式关闭会导致文件锁残留、磁盘空间泄漏、并发写入异常：
立即学习“PHP免费学习笔记（深入）”；
- 写入后立即
fclose($fp)，不要依赖脚本结束自动释放 - 若中间可能出错，用
try...finally确保关闭：$fp = fopen('out.txt', 'w'); try { fwrite($fp, 'data'); } finally { if (is_resource($fp)) fclose($fp); } - 避免在循环中反复
fopen/fclose，高频操作应复用句柄或改用file_put_contents()
替代方案：何时不该用句柄？
如果只是单次写入字符串，file_put_contents() 更安全简洁，它内部封装了 fopen/fwrite/fclose，且默认原子写入（配合 FILE_APPEND 或 LOCK_EX 可控）：
-
file_put_contents('config.ini', $content)—— 覆盖写入，无须管理句柄 -
file_put_contents('log.txt', $line . "\n", FILE_APPEND | LOCK_EX)—— 线程安全追加 - 但无法实现部分读写、指针定位（如
fseek()）、二进制流控制等精细操作
句柄的核心价值在于可控性，而不是“更底层”或“更高级”——该用就用，不该用别硬套。
