symfony 5.4 推荐使用 filesystem 组件的 dumpfile() 方法安全写入文件，采用“写临时文件+原子重命名”策略，确保原子性、权限控制与错误防护，需预先创建父目录并注意权限、路径、磁盘及 selinux 等环境配置。

在 Symfony 5.4 中，推荐使用 Filesystem 组件进行安全、可控的文件写入操作，尤其适合日志、缓存、配置生成等场景。它不依赖 Flysystem 或外部存储抽象，专为本地文件系统设计，核心优势是原子性、权限控制和错误防护。

用 dumpFile 实现安全写入

dumpFile() 是最常用也最可靠的方法，它自动采用“写临时文件 + 原子重命名”策略，避免写入中断导致文件损坏或脏数据。

• 目标路径必须是本地可写目录，且父目录需已存在（dumpFile 不创建上级目录）
• 内容直接传字符串或二进制数据，无需手动处理编码或换行
• 可选第三个参数设置文件权限，如 0600（仅所有者读写）或 0644

示例：

$filesystem->dumpFile('/var/cache/app/version.json', '{"build": "20261012"}', 0644);

Kadence Theme Design System

使用 Kadence 主题作为 WordPress 项目的设计系统，涵盖设计令牌、布局系统、页头/页脚/导航设置以及页面/归档/单篇文章模板。

下载

确保父目录存在

若写入路径含多级目录（如 /var/log/myapp/2026/10/），必须提前创建。调用 mkdir() 即可，它默认支持递归：

• 传入完整路径字符串，如 $filesystem->mkdir('/var/log/myapp/2026/10');
• 不要先用 is_dir() 判断再调用，会干扰其内部递归逻辑
• 失败通常因权限不足：确认 PHP 进程用户（如 www-data）对首个缺失目录的直接父目录有写权限

处理常见写入异常

写入失败往往不是代码问题，而是环境配置疏漏：

• 检查目标路径是否为绝对路径（相对路径易出错）
• 确认磁盘空间充足、inode 未耗尽
• SELinux 或 Docker 挂载卷可能限制写入，需额外配置上下文或挂载选项
• 捕获 IOException 并记录具体消息，例如 “Permission denied” 或 “No such file or directory”

不推荐直接用 file_put_contents

虽然 PHP 原生函数能快速写入，但它不具备原子性保障，高并发下可能出现部分写入、覆盖丢失等问题。而 dumpFile 内置同步刷盘（fsync）、临时文件清理和重命名原子操作，更适合生产环境。