删除数据库记录时必须同步安全删除关联图片文件,先用file_exists()校验绝对路径有效性,再通过事务(InnoDB)或先删文件后删库(MyISAM)确保一致性,unlink()失败需抛异常并回滚。

PHP 删除数据库记录时如何同步删除关联的图片文件
直接删数据库记录却不删服务器上的图片,很快就会积累大量“僵尸文件”——占磁盘、拖慢备份、还可能被误访问。关键不是“能不能删”,而是“删得安全不丢图、不报错、不漏删”。
unlink() 前必须确认文件存在且路径正确
很多人写 unlink($path) 后报 Warning: unlink(): No such file or directory,本质是路径拼错了,或数据库里存的是相对路径但 PHP 当前工作目录变了。
- 永远用
file_exists(检查再删,别信数据库字段值$full_path) - 图片路径建议存绝对路径(如
/var/www/uploads/abc123.jpg),或统一基于一个根目录拼接:__DIR__ . '/uploads/' . $row['image_name'] - 注意 Windows 和 Linux 路径分隔符差异,用
DIRECTORY_SEPARATOR或直接写/(PHP 内部会自动兼容)
从 MySQL 删除记录 + 删除文件必须加事务或至少做错误兜底
数据库删成功了,unlink() 却失败(比如权限不足、NFS 挂载异常),就会导致“图还在,记录没了”——前端显示空白,数据不一致。
- MyISAM 表不支持事务,那就先
unlink(),成功后再删 DB;失败则中止,抛异常或记录日志 - InnoDB 表推荐用事务:开启
beginTransaction()→ 删文件 → 删 DB 记录 →commit();任一环节失败就rollback() - 删文件后务必检查
unlink()返回值:if (unlink($path) === false) { /* 记录日志,告警 */ }
实际操作示例:带路径校验和事务的安全删除
假设用 PDO 连接 MySQL,图片存放在 /var/www/html/uploads/ 目录下,表 articles 有字段 cover_image 存文件名:
立即学习“PHP免费学习笔记(深入)”;
$pdo->beginTransaction();
try {
$stmt = $pdo->prepare("SELECT cover_image FROM articles WHERE id = ?");
$stmt->execute([$id]);
$row = $stmt->fetch(PDO::FETCH_ASSOC);
if ($row && !empty($row['cover_image'])) {
$file_path = '/var/www/html/uploads/' . $row['cover_image'];
if (file_exists($file_path) && is_file($file_path)) {
if (unlink($file_path) === false) {
throw new Exception("Failed to delete file: " . $file_path);
}
}
}
$stmt = $pdo-youjiankuohaophpcnprepare("DELETE FROM articles WHERE id = ?");
$stmt-youjiankuohaophpcnexecute([$id]);
$pdo-youjiankuohaophpcncommit();} catch (Exception $e) {
$pdo->rollback();
error_log("Delete failed: " . $e->getMessage());
throw $e;
}
真正容易被忽略的不是语法,是删文件那行执行时的上下文:用户权限、SELinux 策略、挂载卷是否只读、甚至 NFS 的 stale file handle —— 这些不会报 PHP 错,但会让 unlink() 静静失败。











