关键在于用事务+确定性文件名+失败清理保障同步：先数据库插入获取ID或生成UUID，再创建文件，失败则回滚并删除文件，成功才提交，同时校验返回值、加锁防并发、定时修复异常状态。
PHP 创建文件时如何确保与数据库记录一致
关键不是“先创建文件还是先写数据库”，而是用事务或原子操作保证两者状态同步。MySQL 的 InnoDB 支持事务，但文件系统不支持回滚，所以必须手动控制失败路径。
- 先插入数据库记录（含唯一标识如
file_id或uuid），获取自增 ID 或生成确定性文件名（如sha256($user_id . $timestamp)） - 再用该 ID/哈希值创建文件，路径建议包含业务上下文，例如
/uploads/user_123/{uuid}.pdf - 若文件写入失败（
file_put_contents()返回false），立即执行数据库回滚或软删除（如更新status = 'failed'） - 避免用时间戳直接作文件名——并发请求可能撞名；也别依赖
tempnam()后重命名，中间状态难追踪
用 PDO 事务包裹数据库 + 文件操作的实操要点
PDO 本身不能把文件 I/O 纳入事务，但可以用 try/catch 模拟原子性。重点是失败后清理要彻底，否则留下脏数据。
- 开启事务：
$pdo->beginTransaction()，插入记录并获取$fileId = $pdo->lastInsertId() - 生成确定性路径：
$path = __DIR__ . '/storage/' . $fileId . '.json'，用file_put_contents($path, $content, LOCK_EX)加锁防止并发覆盖 - 写入失败时调用
$pdo->rollback()，并检查file_exists($path)是否需unlink() - 成功后才提交：
$pdo->commit()；不要在 commit 后再做文件操作——万一崩溃就脱节
为什么 file_put_contents() + INSERT 不加控制会出问题
典型错误是顺序写死、无异常捕获、忽略权限和磁盘满等系统级失败。这些不会抛 PHP 异常，但返回值为 false。
-
file_put_contents()在磁盘满、目录不可写、SELinux 限制下静默失败，必须检查返回值 - 数据库插入成功但文件未写出 → 前端查不到文件，用户重试又产生重复记录
- 文件写出成功但数据库插入失败 → 文件变成孤儿，无主键、无元数据、无法清理
- 没加
LOCK_EX时，并发请求可能让两个进程同时写同一个临时路径，后者覆盖前者
上线前必须验证的三个边界场景
真实环境中最容易暴露同步断裂的不是主流程，而是这些边缘情况。
MVM mall 网上购物系统
下载
采用 php+mysql 数据库方式运行的强大网上商店系统，执行效率高速度快，支持多语言，模板和代码分离，轻松创建属于自己的个性化用户界面 v3.5更新： 1).进一步静态化了活动商品. 2).提供了一些重要UFT-8转换文件 3).修复了除了网银在线支付其它支付显示错误的问题. 4).修改了LOGO广告管理,增加LOGO链接后主页LOGO路径错误的问题 5).修改了公告无法发布的问题,可能是打压
立即学习“PHP免费学习笔记（深入）”；
- 磁盘空间突然耗尽：模拟方法是
dd if=/dev/zero of=/tmp/fill bs=1M count=1000占满测试盘，看是否触发回滚逻辑 - 数据库连接中途断开：在
INSERT后故意 kill 对应 MySQL 连接线程，确认 catch 能捕获PDOException并清理文件 - 文件路径含中文或特殊字符：用
mb_convert_encoding($name, 'UTF-8', 'auto')统一编码，否则fopen()可能失败且不报错
同步的本质是接受“文件和数据库不可能 100% 同时成功”，转而设计可检测、可修复的状态机。比如加一个定时任务扫描 status = 'pending' 且文件不存在的记录，或反过来扫孤立文件并尝试匹配元数据。
