在PHP开发中，文件操作是非常常见的需求，创建文件后获取对应的操作句柄，能够让我们更灵活地控制文件的读写、追加等操作，掌握句柄操作的方法是PHP开发者的必备技能。
什么是PHP文件句柄
文件句柄是操作系统为打开的文件分配的一个唯一标识符，在PHP中，当我们通过fopen函数打开或创建文件时，函数会返回一个资源类型的句柄，后续所有的文件读写、关闭等操作都需要通过这个句柄来完成。
使用fopen创建文件并获取句柄
fopen是PHP中用于打开文件或者创建文件的核心函数，它的第一个参数是文件路径，第二个参数是打开模式，当文件不存在且模式支持创建时，就会自动创建新文件。
常用创建文件的打开模式
- w：写入模式，打开文件并将文件指针指向文件开头，如果文件不存在则尝试创建，如果文件已存在会清空原有内容
- w+：读写模式，和w模式类似，区别是同时支持读取和写入操作
- a：追加模式，打开文件并将文件指针指向文件末尾，如果文件不存在则尝试创建，写入内容会追加到原有内容之后
- a+：读写追加模式，和a模式类似，同时支持读取和写入操作
创建文件并获取句柄示例
下面的代码演示了使用w模式创建文件并获取句柄的过程：
<?php
// 定义要创建的文件路径
$filePath = 'test.txt';
// 使用w模式打开文件，不存在则创建，返回句柄
$handle = fopen($filePath, 'w');
// 判断句柄是否获取成功
if ($handle) {
echo '文件创建成功，句柄为：' . (int)$handle;
} else {
echo '文件创建失败';
}
?>
句柄的常用操作方法
拿到文件句柄之后，我们可以通过一系列函数对文件进行操作，以下是几个最常用的操作：
写入内容到文件
使用fwrite函数可以向句柄对应的文件写入内容，第一个参数是文件句柄，第二个参数是要写入的字符串。
<?php
$filePath = 'test.txt';
$handle = fopen($filePath, 'w');
if ($handle) {
// 写入内容到文件
$writeResult = fwrite($handle, "这是第一行内容n这是第二行内容");
if ($writeResult) {
echo '内容写入成功，写入字节数：' . $writeResult;
} else {
echo '内容写入失败';
}
// 关闭文件句柄
fclose($handle);
}
?>
读取文件内容
如果打开模式支持读取，我们可以使用fread函数读取文件内容，第一个参数是句柄，第二个参数是要读取的最大字节数，也可以使用fgets逐行读取。
<?php
$filePath = 'test.txt';
// 使用r模式打开文件用于读取
$handle = fopen($filePath, 'r');
if ($handle) {
// 读取全部内容，filesize获取文件大小
$content = fread($handle, filesize($filePath));
echo '文件内容：' . $content;
// 重置文件指针到开头，再次读取
rewind($handle);
echo '<br/>逐行读取结果：<br/>';
// 逐行读取直到文件末尾
while (!feof($handle)) {
$line = fgets($handle);
echo $line . '<br/>';
}
fclose($handle);
}
?>
关闭文件句柄
操作完成之后，一定要使用fclose函数关闭文件句柄，释放系统资源，虽然PHP脚本执行结束后会自动关闭打开的句柄，但手动关闭是更好的编程习惯。
fopen与file_put_contents的对比
除了fopen创建文件之外，PHP还提供了file_put_contents函数，可以一步完成文件创建和内容写入，不需要手动获取和操作句柄，适合简单的写入场景。
| 对比项 | fopen+句柄操作 | file_put_contents |
|---|---|---|
| 操作复杂度 | 较高，需要手动打开、操作、关闭 | 较低，一行代码完成创建和写入 |
| 灵活性 | 高，支持逐行读写、指针移动、追加等多种操作 | 低，仅支持整体写入、追加等简单操作 |
| 适用场景 | 复杂的文件读写、大文件处理、需要多次操作同一文件的场景 | 简单的文件创建、一次性写入内容的场景 |
下面是file_put_contents创建文件的示例：
<?php
$filePath = 'test2.txt';
$content = "这是通过file_put_contents创建的文件内容";
// 直接创建文件并写入内容，返回写入的字节数，失败返回false
$result = file_put_contents($filePath, $content);
if ($result) {
echo '文件创建并写入成功，字节数：' . $result;
} else {
echo '操作失败';
}
?>
注意事项
- 创建文件时需要确保目标目录有写入权限，否则会创建失败
- 使用
fopen创建文件后，一定要检查返回的句柄是否为false，避免后续操作报错 - 不要忘记关闭文件句柄，尤其是在处理多个文件的场景下，避免资源泄露
- 如果需要创建多级目录下的文件，需要先使用
mkdir函数创建目录，再创建文件
文件句柄操作是PHP文件处理的核心基础，熟练掌握fopen、fwrite、fread、fclose等函数的使用，能够应对大部分文件操作需求，开发者可以根据实际场景选择适合的创建文件方式。
PHP文件句柄fopenfile_put_contents文件操作修改时间：2026-07-16 19:21:33