ThinkPHP 5.6 不支持直接执行 SQL 文件，批量更新推荐三种方式：一、Db::execute 分段执行原生 SQL；二、模型 where+update 或 saveAll 安全更新；三、自定义命令行指令封装事务与日志。
ThinkPHP 5.6 本身不提供直接执行 SQL 文件（如 .sql 脚本）的内置命令或方法，它面向的是 ORM 查询和 Query Builder 操作，而非数据库迁移或脚本导入场景。但如果你需要“批量更新”数据，核心目标其实是：高效、安全地执行多条 UPDATE 语句——这可以通过以下三种方式实现，按推荐度排序：
✅ 方式一：用 Db 类批量执行原生 SQL（最常用、可控性强）
适用于已有 .sql 文件内容（含多条 UPDATE），需手动读取并分段执行：
use think\Db;
// 1. 读取 SQL 文件（假设路径为 database/updates/v2.1.sql）
$sqlContent = file_get_contents(ROOT_PATH . 'database/updates/v2.1.sql');
// 2. 按分号分割（简单粗暴，不处理注释/引号内分号；生产环境建议用更健壮的 SQL 解析器）
$statements = array_filter(array_map('trim', explode(';', $sqlContent)));
// 3. 遍历执行（仅限 UPDATE / INSERT / DELETE 等写操作，请确保无 CREATE / DROP 等高危语句）
foreach ($statements as $sql) {
if (stripos($sql, 'update') === 0 || stripos($sql, 'insert') === 0 || stripos($sql, 'delete') === 0) {
Db::execute($sql);
}
}⚠️ 注意：
- 此方式绕过模型事件和验证，不触发
before_update等钩子；- 不支持事务自动包裹，如需原子性，需手动加
Db::transaction()；- 建议开发环境测试后，再在部署脚本中使用。
✅ 方式二：用模型批量更新（推荐用于结构化业务逻辑）
当批量更新有明确条件和字段时，优先走模型层，更安全、可审计：
立即学习“PHP免费学习笔记（深入）”；
use app\common\model\User;
// 批量更新：将 status=1 的用户积分 +100
User::where('status', 1)
->inc('score', 100)
->update();
// 或按 ID 列表更新不同值（需逐条 or 使用 saveAll + foreach）
$data = [
['id' => 1, 'name' => '张三', 'status' => 2],
['id' => 2, 'name' => '李四', 'status' => 3],
];
User::saveAll($data, ['replace' => true]); // replace=true 表示存在则更新✅ 优势：走模型验证、自动时间戳、事件触发、软删除兼容；
❌ 局限：不适合超大规模（如 10 万+ 行），此时应改用原生 SQL 分批处理。
✅ 方式三：命令行 + 自定义指令（适合上线部署）
创建一个 BatchUpdateCommand，把 SQL 文件执行封装成 php think batch:update v2.1：
# 在命令行运行 php think batch:update v2.1
实现要点：
- 在
app/command/BatchUpdate.php中读取对应 SQL 文件； - 支持
--dry-run预览不执行； - 自动开启事务，失败回滚；
- 记录执行日志到
runtime/log/batch/。
这是团队协作和 CI/CD 场景下的最佳实践，避免人工执行出错。
❌ 不推荐的方式
- 直接用
mysqli_multi_query()或 PDOexec(file_get_contents())：TP5.6 未封装该能力，且极易因 SQL 注入、编码、事务失控引发线上事故； - 把 SQL 文件扔进
public/install/自动执行：5.6 的安装模块早已废弃，且无权限校验，极度危险。
TP5.6 是稳定版，但已停止官方维护（last update 为 2023 年）。若项目涉及微信支付回调、小程序登录态等新需求，建议评估升级至 ThinkPHP 8.x ——其 think-migration 扩展原生支持 SQL 文件迁移、版本回滚与依赖管理，批量更新更规范、更可靠。
