仅加 is_del 字段不能实现可靠软删除，因易遗漏过滤、破坏框架功能、引发数据一致性问题；须配合全局查询约束、字段初始化、索引优化及全链路改造。
PHP 软删除为什么不能只加 is_del 字段就完事？
加一个 is_del 字段只是软删除的起点，不是终点。直接在所有查询里手动加 WHERE is_del = 0 极易遗漏，尤其在关联查询、统计、分页或第三方库调用时。一旦漏写，用户就能看到“已删除”数据，或者误删未标记的数据。
怎么让 Laravel 的 Eloquent 自动过滤软删除记录？
Laravel 原生支持软删除，但必须用 SoftDeletes trait + deleted_at 字段，而不是自定义 is_del。强行用 is_del 会导致 delete() 不生效、restore() 报错、withTrashed() 失效——因为框架底层只识别 deleted_at。
如果你必须用 is_del（比如 legacy 表结构不允许改字段），就得手动重写模型行为：
class User extends Model
{
protected $casts = [
'is_del' => 'boolean',
];
<pre class="brush:php;toolbar:false;">public function scopeActive($query)
{
return $query->where('is_del', false);
}
public function delete()
{
$this->is_del = true;
return $this->save();
}
}
使用时必须显式调用：User::active()->find(123)，否则 User::find(123) 仍会查出已“删除”的记录。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
MySQL 查询中漏掉 is_del = 0 的典型场景
- 原始 SQL 拼接：比如
"SELECT * FROM user WHERE id = {$id}"完全没判断is_del - JOIN 查询：左表加了条件，右表没加，导致“已删除用户”的订单仍被查出来
- COUNT 统计：写
SELECT COUNT(*) FROM user得到的是总行数，不是有效用户数 - 缓存键未包含
is_del状态：缓存了含已删除数据的结果，后续请求一直读脏数据
硬切换到软删除时最常踩的坑
已有线上数据，is_del 字段默认值是 NULL 或 1，会导致历史数据全被当成“已删除”。必须在加字段后立刻执行初始化：
ALTER TABLE `user` ADD COLUMN `is_del` TINYINT(1) DEFAULT 0 NOT NULL; UPDATE `user` SET `is_del` = 0 WHERE `is_del` IS NULL;
另外，所有索引都要重新评估——如果高频查询都带 is_del = 0，建议把 is_del 加进联合索引，例如：INDEX idx_status_id (is_del, id)。否则 MySQL 可能全表扫描过滤掉大量已删除记录。
真正麻烦的不是加字段，而是让所有读写路径都意识到这个字段的存在。哪怕 ORM 层封装好了，原生 SQL、定时任务、数据分析脚本、ES 同步逻辑，都得逐个对齐。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
