使用 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("uploads/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 字符串处理的最佳实践。