ThinkPHP中文件写入依赖PHP原生函数，常用file_put_contents覆盖或追加内容，高并发用fopen+flock加锁，结构化配置需生成合法PHP语法，路径应使用app()->getRuntimePath()等方法获取并确保权限安全。
ThinkPHP 中写入文件内容，核心是调用 PHP 原生的文件操作函数，框架本身不封装专门的“文件写入”类，但提供了路径获取、目录权限控制和安全建议等便利支持。关键在于选对方式——覆盖、追加还是结构化写入（如配置文件），并注意并发与路径安全。
直接用 file_put_contents 写入（最常用）
适合日志记录、临时数据保存等场景，简洁高效，自动创建目录（需父目录可写）：
- 覆盖写入（清空原内容）：
file_put_contents($filePath, $content) - 追加写入（末尾新增一行）：
file_put_contents($filePath, $content . PHP_EOL, FILE_APPEND) - 确保换行清晰：追加时手动加
PHP_EOL，避免多条日志挤在同一行 - 写入前建议检查路径目录是否存在，例如：
is_dir(dirname($filePath)) || mkdir(dirname($filePath), 0755, true)
用 fopen + fwrite 手动控制（需加锁防并发）
适用于高并发日志场景，能精确控制指针位置和加锁行为，避免多进程写乱：
- 以追加模式打开：
$fp = fopen($filePath, 'a'); - 加排他锁（阻塞等待）：
flock($fp, LOCK_EX); - 写入后立即解锁：
fwrite($fp, $content . PHP_EOL); flock($fp, LOCK_UN); - 务必 fclose 关闭句柄，否则可能缓存未刷盘
- 注意：
'a+'模式虽可读可写，但写入始终在末尾，无需 fseek
写入 PHP 配置数组（结构化保存）
常用于后台修改系统配置后持久化到 .php 文件，需生成合法 PHP 返回语句：
立即学习“PHP免费学习笔记（深入）”；
- 封装一个写数组函数：
file_put_contents($file, '<?php' . PHP_EOL . 'return ' . var_export($arr, true) . ';'); - 目标文件路径建议放在
config/或自定义目录下，避免被 Web 直接访问 - 写入前可先
is_writable()判断目录权限，失败时提示明确错误 - 不推荐直接写入
app/config/下的原始配置文件，应走独立配置管理逻辑
ThinkPHP 6/8 中获取安全路径的写法
避免硬编码相对路径，用框架方法获取真实绝对路径：
- 项目根目录：
app()->getRootPath()（返回类似/var/www/myapp/） - 运行时目录（推荐存日志）：
app()->getRuntimePath() . 'log/' - 公共目录（需 Web 可访问）：
app()->getPublicPath() . 'uploads/' - 拼路径时统一用
DS或DIRECTORY_SEPARATOR，兼容 Windows/Linux - 示例日志路径：
$logPath = app()->getRuntimePath() . 'log/' . date('Ym') . '.log';
