0

0

如何读写文件?fopen与file_get_contents

雪夜

雪夜

发布时间:2025-07-08 15:58:01

|

1120人浏览过

|

来源于php中文网

原创

在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。

如何读写文件?fopen与file_get_contents

在PHP里要和文件打交道,最直接的两种方式就是fopenfile_get_contents系列函数。简单来说,如果你只是想快速把文件内容读出来或者把一些数据写进去,file_get_contentsfile_put_contents这对搭档会是你的首选,它们用起来特别省心。但要是你需要更精细的控制,比如处理大文件、分块读写、或者需要对文件进行锁定,那fopen配合freadfwritefclose这些函数,就显得不可或缺了。选择哪个,说白了就是看你的具体需求和对性能、控制力的权衡。

如何读写文件?fopen与file_get_contents

解决方案

PHP提供了多种函数来处理文件的读写操作,它们各有侧重,适用于不同的场景。

如何读写文件?fopen与file_get_contents

1. fopen 系列函数:精细控制的基石

fopen函数是文件操作的起点,它以指定模式打开一个文件,并返回一个文件指针(资源)。后续的所有操作,如读、写、定位,都将围绕这个指针进行。

如何读写文件?fopen与file_get_contents
  • 打开文件:fopen(string $filename, string $mode)

    • $filename: 要操作的文件路径。
    • $mode: 打开模式,这很重要,决定了你能对文件做什么。
      • 'r': 只读模式,文件指针在文件开头。
      • 'w': 只写模式,如果文件不存在则创建,如果存在则截断(清空)文件。指针在文件开头。
      • 'a': 只写模式,文件指针在文件末尾。如果文件不存在则创建。用于追加内容。
      • 'x': 只写模式,如果文件已存在则失败(fopen返回false)。用于创建新文件并确保它不存在。
      • 'c': 只写模式,如果文件不存在则创建。如果存在,它不截断文件,只是把指针放在文件开头。
      • 模式后面可以加+,表示同时支持读写,例如'r+', 'w+', 'a+', 'x+', 'c+'
  • 写入文件:fwrite(resource $handle, string $string, int $length = null)

    • $handle: fopen返回的文件指针。
    • $string: 要写入的字符串。
    • $length: 可选,最大写入字节数。
  • 读取文件:fread(resource $handle, int $length)

    • $handle: fopen返回的文件指针。
    • $length: 要读取的字节数。
  • 关闭文件:fclose(resource $handle)

    • $handle: fopen返回的文件指针。务必在操作完成后关闭文件,释放资源。

示例:使用 fopen 读写文件

2. file_get_contentsfile_put_contents:简洁高效的快车道

这对函数是PHP为了简化常见文件读写操作而提供的。它们内部封装了fopenfread/fwritefclose的逻辑,让你一行代码就能搞定。

  • 读取整个文件:file_get_contents(string $filename, bool $use_include_path = false, resource $context = null, int $offset = -1, int $maxlen = -1)

    • 最常用的是只提供$filename。它会把整个文件的内容读入一个字符串。
  • 写入整个文件:file_put_contents(string $filename, mixed $data, int $flags = 0, resource $context = null)

    • $data: 要写入的数据,可以是字符串、数组或流资源。
    • $flags: 可选,用于控制写入行为。
      • FILE_APPEND: 将数据追加到文件末尾,而不是覆盖。
      • LOCK_EX: 在写入时获取独占锁。
      • FILE_USE_INCLUDE_PATH: 在include_path中搜索文件。

示例:使用 file_get_contentsfile_put_contents

 '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:

    • 优点:代码简洁,易于理解和使用。适合处理小型文件,或者你确定文件内容可以一次性加载到内存中而不会导致内存溢出。
    • 缺点:对于非常大的文件(几百MB甚至GB级别),一次性加载到内存可能导致内存耗尽(OOM)。缺乏细粒度的控制,例如不能在文件中间插入内容,或者不能在读写过程中暂停。
  • fopen 系列:

    • 优点:提供了对文件操作的最高级别控制。可以分块读写,非常适合处理大文件,避免内存溢出。支持文件指针定位(fseek)、文件锁定(flock)等高级功能,对于并发写入或者需要确保数据完整性的场景非常有用。
    • 缺点:代码相对繁琐,需要手动管理文件句柄的打开和关闭。如果忘记关闭文件,可能会导致资源泄露或文件被占用。

我的经验是,大部分日常的配置读写、日志记录(单条小日志)用file_put_contentsFILE_APPEND模式就够了。但凡是涉及到用户上传大文件、处理CSV或大型数据库导出文件、或者需要并发写入的场景,我一定会优先考虑fopen

文件读写中常见的错误处理和权限问题怎么解决?

在文件操作中,错误和权限问题是家常便饭,如果处理不好,程序分分钟崩溃或者留下安全隐患。我们通常会遇到文件不存在、没有读写权限、或者写入失败等情况。

首先,最基础的防护就是检查函数返回值fopen在失败时会返回falsefile_get_contentsfile_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_exists($filename): 检查文件或目录是否存在。
  • is_readable($filename): 检查文件是否可读。
  • is_writable($filename): 检查文件是否可写。

这些函数能帮你提前判断,避免不必要的错误发生。比如,如果你要写入一个文件,但目标目录不存在,那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-dataapachenginx)的身份运行。如果这个用户对目标文件或目录没有足够的权限,那么读写操作就会失败。

高级Bash脚本编程指南 chm版
高级Bash脚本编程指南 chm版

这本书假定你没有任何关于脚本或一般程序的编程知识, 但是如果你具备相关的知识, 那么你将很容易就能够达到中高级的水平. . . 所有这些只是UNIX®浩瀚知识的一小部分. 你可以把本书作为教材, 自学手册, 或者是关于shell脚本技术的文档. 书中的练习和样例脚本中的注释将会与读者进行更好的互动, 但是最关键的前提是: 想真正学习脚本编程的唯一途径就是亲自动手编写脚本. 这本书也可作为教材来讲解一般的编程概念. 向伟大的中华民族的Linux用户致意! 我希望这本书能够帮助你们学习和理解L

下载
  • 解决方案
    • chmod: 使用chmod命令(或PHP的chmod()函数)修改文件或目录的权限。例如,chmod 777 /path/to/your/dir(不推荐用于生产环境,权限过大,有安全风险),或者更安全的chmod 755 /path/to/your/dir(目录)和chmod 644 /path/to/your/file(文件)。
    • chown / chgrp: 修改文件或目录的所有者和所属组,确保它们属于Web服务器用户。例如,chown www-data:www-data /path/to/your/dir
    • SELinux/AppArmor: 在一些安全增强的系统上,即使文件权限看起来没问题,也可能因为SELinux或AppArmor的策略限制了Web服务器进程的访问。这时需要调整这些安全模块的策略。这通常需要系统管理员的介入。

在实际开发中,我通常会把文件操作封装起来,加上多层检查和错误日志记录,这样即使出问题,也能快速定位。那种“我的代码在本地跑得好好的,一到服务器就出问题”的场景,十有八九就是权限或者路径搞不定。

处理大文件时,fopenfile_get_contents哪个更优?

毫无疑问,处理大文件时,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),处理完这部分数据后再读取下一部分,这样内存中始终只保留文件的一小部分内容,极大地降低了内存消耗。

示例:分块读取大文件

同样,写入大文件时,如果你需要生成一个很大的文件,也应该使用fwrite进行分块写入,而不是一次性构建一个巨大的字符串再用file_put_contents写入。

当然,file_get_contentsfile_put_contents也有一些高级用法,比如通过stream_context_create创建流上下文来设置超时、代理等,但这并不能解决它们一次性加载整个文件到内存的根本问题。所以,面对大文件,我的第一反应永远是fopen

除了基本读写,文件操作还有哪些高级技巧?

文件操作远不止简单的读写,PHP提供了一系列函数来处理更复杂、更精细的文件和目录操作。这些“高级技巧”在特定场景下能大大提升程序的健壮性和功能性。

1. 文件锁定(flock

在多进程或多线程环境下,当多个脚本同时尝试写入同一个文件时,可能会出现数据损坏或覆盖的问题,这就是所谓的“竞态条件”。flock函数可以为文件提供读锁或写锁,确保在某个进程操作文件时,其他进程要么等待,要么得到通知。

LOCK_EX是独占锁,任何其他进程都不能读或写。LOCK_SH是共享锁,多个进程可以同时持有读锁,但不能有写锁。

2. 文件指针定位(fseekftellrewind

当你需要从文件的特定位置开始读写,或者想知道当前读写到了哪里时,这些函数就派上用场了。

  • fseek($handle, $offset, $whence): 移动文件指针。$offset是偏移量,$whence可以是SEEK_SET(从文件开头),SEEK_CUR(从当前位置),SEEK_END(从文件末尾)。
  • ftell($handle): 返回当前文件指针的位置。
  • rewind($handle): 将文件指针重置到文件开头。

这在处理特定格式的文件(如日志文件,你可能只想从某个时间点开始读取)时非常有用。

3. 处理CSV文件(fputcsvfgetcsv

PHP内置了专门用于处理CSV(逗号分隔值)文件的函数,这比你自己手动解析或拼接字符串要高效和健壮得多,因为它能正确处理字段中的逗号、引号等特殊字符。

4. 临时文件操作(tmpfilesys_get_temp_dir

有时你需要在程序执行期间创建一些临时文件,用完就销毁。tmpfile()函数会创建一个临时文件,并返回一个文件指针。这个文件在文件指针关闭或者脚本结束时会自动删除。sys_get_temp_dir()则可以获取系统默认的临时文件目录。

5. 目录操作(mkdirrmdirscandir等)

除了文件,PHP也提供了丰富的目录操作函数:

  • mkdir($path, $mode, $recursive): 创建目录。
  • rmdir($path): 删除空目录。
  • unlink($filename): 删除文件。
  • rename($oldname, $newname): 重命名文件或目录。
  • copy($source, $dest): 复制文件。
  • scandir($directory): 列出目录中的文件和子目录。
  • glob($pattern): 查找匹配特定模式的文件路径。

这些函数构成了PHP文件系统操作的完整工具集。掌握它们,可以让你在处理文件和目录时更加

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

232

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

502

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

500

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

233

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

338

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3517

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

29

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

30

2026.01.13

Python 自然语言处理(NLP)基础与实战
Python 自然语言处理(NLP)基础与实战

本专题系统讲解 Python 在自然语言处理(NLP)领域的基础方法与实战应用,涵盖文本预处理(分词、去停用词)、词性标注、命名实体识别、关键词提取、情感分析,以及常用 NLP 库(NLTK、spaCy)的核心用法。通过真实文本案例,帮助学习者掌握 使用 Python 进行文本分析与语言数据处理的完整流程,适用于内容分析、舆情监测与智能文本应用场景。

10

2026.01.27

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.9万人学习

Git 教程
Git 教程

共21课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号