在php中处理文件的两种主要方式是fopen系列函数和file_get_contents/file_put_contents函数。1. fopen系列函数适用于需要精细控制的场景，如处理大文件、分块读写、文件锁定等，它提供了打开文件（fopen）、读取（fread）、写入（fwrite）和关闭（fclose）文件的完整流程；2. file_get_contents与file_put_contents则适合快速读写小型文件，它们内部封装了打开、读写和关闭文件的操作，使用简单但缺乏对大文件的高效处理能力。选择时应根据具体需求权衡简洁性与控制力：若需处理大文件或实现高级功能（如文件锁、分块读写），优先使用fopen系列函数；若仅需快速读写小型文件，则可选用file_get_contents和file_put_contents。
在PHP里要和文件打交道，最直接的两种方式就是fopen和file_get_contents系列函数。简单来说，如果你只是想快速把文件内容读出来或者把一些数据写进去，file_get_contents和file_put_contents这对搭档会是你的首选，它们用起来特别省心。但要是你需要更精细的控制，比如处理大文件、分块读写、或者需要对文件进行锁定，那fopen配合fread、fwrite、fclose这些函数，就显得不可或缺了。选择哪个，说白了就是看你的具体需求和对性能、控制力的权衡。
PHP提供了多种函数来处理文件的读写操作，它们各有侧重，适用于不同的场景。
1. fopen 系列函数：精细控制的基石
fopen函数是文件操作的起点，它以指定模式打开一个文件，并返回一个文件指针（资源）。后续的所有操作，如读、写、定位，都将围绕这个指针进行。
打开文件：fopen(string $filename, string $mode)
写入文件：fwrite(resource $handle, string $string, int $length = null)
读取文件：fread(resource $handle, int $length)
关闭文件：fclose(resource $handle)
示例：使用 fopen 读写文件
<?php
$filename = 'my_log.txt';
$content_to_write = "这是一行新的日志。\n";
// 写入文件（追加模式）
$handle = fopen($filename, 'a');
if ($handle) {
fwrite($handle, $content_to_write);
fclose($handle);
echo "内容已写入到 {$filename}\n";
} else {
echo "无法打开文件 {$filename} 进行写入。\n";
}
// 读取文件
$handle = fopen($filename, 'r');
if ($handle) {
$file_content = fread($handle, filesize($filename)); // 读取整个文件
fclose($handle);
echo "文件 {$filename} 的内容是：\n";
echo $file_content;
} else {
echo "无法打开文件 {$filename} 进行读取。\n";
}
?>2. file_get_contents 与 file_put_contents：简洁高效的快车道
这对函数是PHP为了简化常见文件读写操作而提供的。它们内部封装了fopen、fread/fwrite和fclose的逻辑，让你一行代码就能搞定。
读取整个文件：file_get_contents(string $filename, bool $use_include_path = false, resource $context = null, int $offset = -1, int $maxlen = -1)
写入整个文件：file_put_contents(string $filename, mixed $data, int $flags = 0, resource $context = null)
示例：使用 file_get_contents 和 file_put_contents
<?php
$filename = 'config.json';
$config_data = json_encode(['version' => '1.0', 'env' => 'production'], JSON_PRETTY_PRINT);
// 写入文件（覆盖模式）
if (file_put_contents($filename, $config_data) !== false) {
echo "配置数据已写入到 {$filename}\n";
} else {
echo "写入 {$filename} 失败。\n";
}
// 读取文件
$read_config = file_get_contents($filename);
if ($read_config !== false) {
echo "从 {$filename} 读取到的配置是：\n";
echo $read_config;
} else {
echo "读取 {$filename} 失败。\n";
}
// 追加内容
file_put_contents($filename, "\n// 额外注释", FILE_APPEND);
echo "\n已追加额外注释。\n";
?>何时选择哪个？
file_get_contents/file_put_contents:
fopen 系列:
我的经验是，大部分日常的配置读写、日志记录（单条小日志）用file_put_contents的FILE_APPEND模式就够了。但凡是涉及到用户上传大文件、处理CSV或大型数据库导出文件、或者需要并发写入的场景，我一定会优先考虑fopen。
在文件操作中，错误和权限问题是家常便饭，如果处理不好，程序分分钟崩溃或者留下安全隐患。我们通常会遇到文件不存在、没有读写权限、或者写入失败等情况。
首先，最基础的防护就是检查函数返回值。fopen在失败时会返回false，file_get_contents和file_put_contents在失败时也同样返回false。所以，一个简单的if ($handle === false)或者if ($result === false)是必不可少的。
$handle = fopen('non_existent_file.txt', 'r');
if ($handle === false) {
echo "错误：无法打开文件，可能是文件不存在或权限不足。\n";
// 进一步获取错误信息
$error = error_get_last();
if ($error && isset($error['message'])) {
echo "详细错误信息: " . $error['message'] . "\n";
}
}其次，在尝试读写之前，可以预先检查文件或目录的状态。
这些函数能帮你提前判断，避免不必要的错误发生。比如，如果你要写入一个文件，但目标目录不存在，那file_put_contents肯定会失败。你可以先用is_writable检查目录，甚至用mkdir去创建目录。
$log_dir = './logs/';
$log_file = $log_dir . 'app.log';
if (!file_exists($log_dir)) {
if (!mkdir($log_dir, 0755, true)) { // 尝试创建目录，true表示递归创建
die("错误：无法创建日志目录 {$log_dir}，请检查权限。\n");
}
}
if (!is_writable($log_file) && file_exists($log_file)) {
die("错误：日志文件 {$log_file} 不可写，请检查文件权限。\n");
}
if (file_put_contents($log_file, "程序启动。\n", FILE_APPEND) === false) {
echo "错误：写入日志失败。\n";
}权限问题是最常见的痛点。在Linux/Unix系统上，文件和目录都有权限设置（读、写、执行），以及所有者和所属组。PHP脚本通常以Web服务器用户（如www-data、apache、nginx）的身份运行。如果这个用户对目标文件或目录没有足够的权限，那么读写操作就会失败。
在实际开发中，我通常会把文件操作封装起来，加上多层检查和错误日志记录，这样即使出问题，也能快速定位。那种“我的代码在本地跑得好好的，一到服务器就出问题”的场景，十有八九就是权限或者路径搞不定。
毫无疑问，处理大文件时，fopen系列函数是更优的选择。
file_get_contents的本质是把整个文件的内容一次性读取到内存中。如果文件只有几MB，这通常不是问题。但当文件达到几十MB、几百MB甚至GB级别时，你的服务器内存就可能撑不住了，直接导致内存溢出（Out Of Memory，OOM）错误，程序也就挂了。
想象一下，你有一个1GB的日志文件，如果用file_get_contents去读，PHP进程就需要至少1GB的内存来存储这个字符串。这对于一个Web服务器来说，是非常奢侈甚至不可能的。
而fopen配合fread则可以实现分块读取（chunked reading）。这意味着你可以一次只读取文件的一部分内容（比如8KB、1MB），处理完这部分数据后再读取下一部分，这样内存中始终只保留文件的一小部分内容，极大地降低了内存消耗。
示例：分块读取大文件
<?php
$large_file = 'large_log_file.txt'; // 假设这是一个非常大的文件
$chunk_size = 8192; // 每次读取8KB
$handle = fopen($large_file, 'r');
if ($handle) {
$line_count = 0;
while (!feof($handle)) { // 循环直到文件末尾
$buffer = fread($handle, $chunk_size);
if ($buffer === false) {
echo "读取文件时发生错误。\n";
break;
}
// 在这里处理 $buffer 中的数据
// 例如，你可以按行分割处理，或者进行其他分析
$lines = explode("\n", $buffer);
foreach ($lines as $line) {
if (trim($line) !== '') {
// echo "处理行: " . $line . "\n";
$line_count++;
}
}
// 如果最后一行不完整，需要把剩余部分拼接到下一个buffer的开头
// 实际应用中需要更复杂的逻辑来处理不完整的行
}
fclose($handle);
echo "文件 {$large_file} 处理完成，总共处理了约 {$line_count} 行。\n";
} else {
echo "无法打开文件 {$large_file}。\n";
}
?>同样，写入大文件时，如果你需要生成一个很大的文件，也应该使用fwrite进行分块写入，而不是一次性构建一个巨大的字符串再用file_put_contents写入。
当然，file_get_contents和file_put_contents也有一些高级用法，比如通过stream_context_create创建流上下文来设置超时、代理等，但这并不能解决它们一次性加载整个文件到内存的根本问题。所以，面对大文件，我的第一反应永远是fopen。
文件操作远不止简单的读写，PHP提供了一系列函数来处理更复杂、更精细的文件和目录操作。这些“高级技巧”在特定场景下能大大提升程序的健壮性和功能性。
1. 文件锁定（flock）
在多进程或多线程环境下，当多个脚本同时尝试写入同一个文件时，可能会出现数据损坏或覆盖的问题，这就是所谓的“竞态条件”。flock函数可以为文件提供读锁或写锁，确保在某个进程操作文件时，其他进程要么等待，要么得到通知。
<?php
$lock_file = 'data.lock';
$fp = fopen($lock_file, 'w+'); // 以读写模式打开文件
if (flock($fp, LOCK_EX)) { // 获取独占写锁
// 成功获取锁，可以安全地写入文件
fwrite($fp, "这是被锁定的数据。\n");
sleep(5); // 模拟耗时操作
fflush($fp); // 确保数据写入磁盘
flock($fp, LOCK_UN); // 释放锁
echo "文件已写入并释放锁。\n";
} else {
echo "无法获取文件锁，文件可能正在被其他进程使用。\n";
}
fclose($fp);
?>LOCK_EX是独占锁，任何其他进程都不能读或写。LOCK_SH是共享锁，多个进程可以同时持有读锁，但不能有写锁。
2. 文件指针定位（fseek、ftell、rewind）
当你需要从文件的特定位置开始读写，或者想知道当前读写到了哪里时，这些函数就派上用场了。
这在处理特定格式的文件（如日志文件，你可能只想从某个时间点开始读取）时非常有用。
3. 处理CSV文件（fputcsv、fgetcsv）
PHP内置了专门用于处理CSV（逗号分隔值）文件的函数，这比你自己手动解析或拼接字符串要高效和健壮得多，因为它能正确处理字段中的逗号、引号等特殊字符。
<?php
$csv_file = 'users.csv';
$list = [
['John Doe', 'john@example.com', 'New York'],
['Jane Smith', 'jane@example.com', 'London'],
['Peter Jones', 'peter@example.com', 'Paris, France'] // 包含逗号的字段
];
$fp = fopen($csv_file, 'w');
if ($fp) {
foreach ($list as $fields) {
fputcsv($fp, $fields);
}
fclose($fp);
echo "CSV文件写入完成。\n";
}
// 读取CSV文件
$fp = fopen($csv_file, 'r');
if ($fp) {
while (($data = fgetcsv($fp)) !== false) {
print_r($data);
}
fclose($fp);
}
?>4. 临时文件操作（tmpfile、sys_get_temp_dir）
有时你需要在程序执行期间创建一些临时文件，用完就销毁。tmpfile()函数会创建一个临时文件，并返回一个文件指针。这个文件在文件指针关闭或者脚本结束时会自动删除。sys_get_temp_dir()则可以获取系统默认的临时文件目录。
<?php
$temp_fp = tmpfile(); // 创建一个临时文件
if ($temp_fp) {
fwrite($temp_fp, "这是一些临时数据。\n");
fseek($temp_fp, 0); // 将指针移回开头
echo stream_get_contents($temp_fp); // 读取所有内容
// 文件在脚本结束时会自动删除
fclose($temp_fp); // 也可以手动关闭，提前删除
}
echo "临时文件操作完成。\n";
?>5. 目录操作（mkdir、rmdir、scandir等）
除了文件，PHP也提供了丰富的目录操作函数：
这些函数构成了PHP文件系统操作的完整工具集。掌握它们，可以让你在处理文件和目录时更加
以上就是如何读写文件？fopen与file_get_contents的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
289
收藏
