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

使用 file_put_contents 向文件追加内容时，可通过字符串拼接方式将单行文本（如标题或标识）置于数组数据之前，再统一写入，避免多次 i/o 操作。

在实际开发中，我们常需将数据库查询结果（如用户 ID 列表）以换行格式追加到日志或导出文件中，同时希望在每次写入前添加一个描述性标题（例如时间戳、操作说明或分隔标识）。但直接向 file_put_contents 传入数组会导致 PHP 尝试将整个数组转为字符串 "Array"，而原代码中 $emails 被误声明为数组后又当作字符串拼接，存在类型错误和逻辑缺陷。

正确的做法是：初始化为字符串，并在循环中逐行追加带换行符的内容。示例如下：

$a = "one line";
$emails = $a . "\n"; // 初始化为带换行的首行

while ($row = $data->fetch(PDO::FETCH_ASSOC)) {
    $emails .= $row['id'] . "\n"; // 每个 ID 后追加换行符
}

// 注意：文件路径应包含完整文件名，如 "uploads/ids.log"
file_put_contents("uplo
ads/ids.log", $emails, FILE_APPEND | LOCK_EX);

⚠️ 关键注意事项：

• 路径必须指定具体文件名："uploads/" 是目录，不是有效文件路径，否则会触发警告或写入失败；
• 避免混合类型操作：不要先声明 $emails = array() 再尝试用 .= 拼接字符串，PHP 会报错（Array to string conversion）；
• 性能考量：对大量数据，字符串拼接仍属内存友好方案；若数据量极大（如百万级），建议改用 fopen + fwrite 流式写入；
• 换行符兼容性：\n 在 Unix/Linux/macOS 下通用；如需 Windows 兼容，可用 PHP_EOL 替代。

最终生成的文件内容将严格符合预期格式：

one line
1
2
3
4
5
6
7
8

此方法简洁、高效，且完全符合 PHP 字符串处理的最佳实践。