如何在写入文件时为数组内容添加首行文本

本文介绍如何使用 file_put_contents() 将字符串（如标题或说明）与循环生成的数组数据合并写入文件，并确保首行为自定义单行文本、后续每项占一行。

在 php 中，file_put_contents() 默认将整个字符串作为整体写入文件。原代码中直接传入数组 $emails 会导致类型转换异常（PHP 会将其转为字符串 “Array”），而非逐行输出。正确做法是手动构建带换行符的字符串，而非依赖数组自动序列化。

以下为推荐实现方式：

$a = "one line"; $emails = $a . "n"; // 首行：自定义文本 + 换行  while ($row = $data->fetch(PDO::FETCH_ASSOC)) {     $emails .= $row['id'] . "n"; // 每次追加 ID + 换行 }  // 注意：文件路径应包含完整文件名，如 "uploads/ids.txt" file_put_contents("uploads/ids.txt", $emails, FILE_appEND | LOCK_EX);

✅ 关键要点说明：

• “n” 是 unix/linux/macOS 标准换行符；若需兼容 windows，可使用 PHP_EOL（推荐用于跨平台场景）；
• 文件路径 “uploads/” 是目录，必须指定具体文件名（如 “uploads/log.txt”），否则会报错或写入失败；
• FILE_APPEND 表示追加写入，若需每次覆盖原文件，请移除该标志；
• 若数据量较大（如上万条记录），建议改用 fopen() + fwrite() 流式写入，避免内存占用过高。

? 进阶建议（可选）：
如需更灵活控制格式（例如添加时间戳、过滤空值），可在循环中加入判断：

$emails = date('Y-m-d H:i:s') . " - " . $a . "n"; while ($row = $data->fetch(PDO::FETCH_ASSOC)) {     if (!empty($row['id'])) {         $emails .= $row['id'] . "n";     } } file_put_contents("uploads/ids.txt", $emails, FILE_APPEND | LOCK_EX);

通过主动拼接字符串，你完全掌控输出结构——首行为任意文本，后续为结构化数据，简洁、可靠且易于维护。