PHP文件操作如何读写文本与处理CSV文件-php教程-PHP中文网

fopen模式选错会导致数据丢失或乱码，读写需匹配编码、换行符及权限；csv操作须显式指定分隔符、引号、转义符并处理bom；大文件应流式处理，路径与换行符需跨平台兼容。

php文件操作如何读写文本与处理csv文件

用 `fopen` 读写文本文件时，模式选错会导致数据丢失或乱码

PHP 的 fopen 是最基础也最容易出错的文本操作入口。关键不是“能不能打开”，而是“用什么模式打开”。比如用 'w' 写入时会清空原文件，而 'a' 才是追加；读取中文内容却用了 'r' 而没指定编码，结果返回乱码字符串——这其实不是 PHP 的 bug，是底层流没按 UTF-8 解释字节。

读纯文本：优先用 'r'，但确保文件本身是 UTF-8 编码；若不确定，先用 mb_detect_encoding(file_get_contents($path)) 检查
写文本：用 'w' 前务必确认是否允许覆盖；想保留原内容就改用 'a' 或 'c'（后者可读可写但不截断）
避免直接用 fgets() 逐行读大文件——它默认按切割，Windows 换行符可能导致最后一行读不全；更稳妥的是 stream_get_line($fp, 0, " ")

`fgetcsv` 和 `fputcsv` 处理 CSV 时，分隔符与引号规则必须显式对齐

CSV 看似简单，但实际中字段含逗号、换行、双引号时，fgetcsv 默认行为极易出错。它不会自动识别 Excel 导出的 BOM 头，也不处理字段里嵌套的双引号转义——这些都得靠参数控制。

QuickBooks Mileage CSV

使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。

下载

读 CSV：调用 fgetcsv($fp, 0, ',', '"', '\') 显式传入分隔符、封装符、转义符；省略第三个参数（即用默认逗号）在字段含中文顿号、分号时会切错列
写 CSV：用 fputcsv($fp, $row, ';', '"', '\') 时，如果目标系统是 Excel for Mac，分隔符得换成 " "（制表符），否则打开后所有字段挤在一列
注意 BOM：UTF-8 文件开头若有 BOM（），fgetcsv 会把第一个字段头识别成乱码；读之前先 fseek($fp, 0)，再用 fread($fp, 3) === "" 判断并跳过

大文件 CSV 导入导出别硬扛，用 `yield` 流式处理防内存溢出

单次读 file_get_contents 一个 200MB CSV，PHP 进程大概率直接 OOM。与其调高 memory_limit，不如用生成器把每行当独立单元处理——fgetcsv 本身不占内存，瓶颈在你是否把所有行存进数组。

写流式读取函数：function csvRows($path) { $fp = fopen($path, 'r'); while (($row = fgetcsv($fp)) !== false) yield $row; fclose($fp); }
导出时同样避免拼接整个 CSV 字符串：每处理一行就 fputcsv($fp, $row)，而不是 $all .= implode(...) 再一次性写入
注意资源释放：即使用了 yield，fclose($fp) 仍必须手动调用；PHP 7.4+ 支持 finally 块，建议包裹在 try/finally 里

Windows 和 Linux 下路径、换行、权限差异会让文件操作突然失败

本地开发用 Windows 写的脚本，部署到 Linux 服务器后 fopen 返回 false，十有八九不是代码问题，而是路径斜杠、换行符或目录权限没对齐。

路径拼接别用 "./data/file.csv"：统一用 __DIR__ . DIRECTORY_SEPARATOR . 'data' . DIRECTORY_SEPARATOR . 'file.csv'，或更简单的 dirname(__FILE__) . '/data/file.csv'
写 CSV 后在 Windows 打开显示所有内容在一行？那是 Linux 写入用了，而 Excel 只认；解决方法是写完后用 str_replace(" ", " ", $content) 替换（仅对小文件），或在 fputcsv 后手动 fwrite($fp, " ")
fopen 失败时，先运行 var_dump(is_writable(dirname($path))) 和 var_dump(error_get_last())，比猜“是不是路径错了”快得多