推荐使用 PHP 原生 file_put_contents() 配合 FILE_APPEND | LOCK_EX 标志实现追加写入，轻量高效；Symfony Filesystem 无内置 appendToFile 方法，手动读写不适用于大文件；日志场景应优先使用 Monolog。
在 Symfony 5.4 中，appendToFile 并不是 Symfony 自带的内置方法（如 Filesystem 组件中没有这个命名的方法），但你可以通过 Symfony\Component\Filesystem\Filesystem 的 dumpFile() 方法配合读取+追加逻辑实现，或更简单、推荐地直接使用 PHP 原生的 file_put_contents() 配合 FILE_APPEND 标志。
✅ 推荐方式：用 file_put_contents() 追加内容
这是最轻量、最直接的方式，无需额外依赖，语义清晰，适合日志、调试信息等追加场景：
// 追加一行文本到文件末尾（自动创建文件，如果不存在）
file_put_contents('/var/log/app.log', "[INFO] User logged in\n", FILE_APPEND | LOCK_EX);
// 追加多行或变量内容
$message = sprintf("[%s] Request processed\n", date('Y-m-d H:i:s'));
file_put_contents('/var/log/app.log', $message, FILE_APPEND | LOCK_EX);
✅ 使用 Symfony Filesystem + 手动读写（不推荐，仅作了解）
虽然 Filesystem 不提供原生 append 方法，但可组合实现。注意：该方式需先读取全部内容，再写入，对大文件不友好，仅适用于小数据：
use Symfony\Component\Filesystem\Filesystem;
$fs = new Filesystem();
$filePath = '/path/to/data.txt';
// 读取现有内容（若文件不存在则为空字符串）
$content = $fs->exists($filePath) ? file_get_contents($filePath) : '';
// 追加新内容
$newContent = $content . "New line at " . date('c') . "\n";
// 覆盖写入
$fs->dumpFile($filePath, $newContent);
⚠️ 注意事项
- 权限问题：确保 Web 服务器用户（如 www-data）对目标目录有写权限；
-
并发安全：使用
FILE_APPEND | LOCK_EX可避免多进程写入错乱； -
换行符：手动添加
\n（Unix）或\r\n（Windows）保证格式一致； -
路径安全：避免用户输入直接拼接路径，防止路径遍历（如
../）； - 性能考虑：高频追加建议用 Monolog 等日志库，它已内置缓冲、轮转、异步写入等优化。
? 补充：用 Monolog 追加日志（生产推荐）
如果你实际想做的是“记录日志”，Symfony 默认集成 Monolog，它默认就是追加模式：
// 在控制器或服务中
use Psr\Log\LoggerInterface;
public function __construct(private LoggerInterface $logger) {}
public function someAction()
{
$this->logger->info('User accessed dashboard');
// 自动追加到 var/log/prod.log 或 dev.log，无需手动处理文件操作
}
不复杂但容易忽略：追加写入的核心是 FILE_APPEND 标志，用原生函数即可干净解决，不必绕路封装。
