在ThinkPHP 6.7中，不能直接用Db::execute()批量执行含多条语句的SQL文件，应优先使用迁移机制添加字段；若必须执行原始SQL文件，需手动解析、过滤并逐条执行ALTER TABLE ... ADD COLUMN语句。
在 ThinkPHP 6.7 中，执行 SQL 文件（如数据库结构升级脚本）来添加字段，**不能直接用 Db::execute() 批量运行含多条语句的 SQL 文件内容**（因 PDO 默认不支持多语句执行，且存在安全与兼容性风险）。正确做法是：解析 SQL 文件、逐条执行 DDL 语句，或更推荐——使用迁移（Migration）机制管理字段变更。
✅ 推荐方式：用迁移命令添加字段
ThinkPHP 6.7 内置迁移系统，安全、可追溯、支持回滚：
- 生成迁移文件：
php think migrate:create AddStatusToUsersTable - 编辑生成的 PHP 迁移类，在
up()方法中用 Schema 构建器添加字段：
public function up(MigrationBuilder $builder)
{
$builder->table('users')
->addColumn('status', 'tinyint', ['default' => 1, 'comment' => '状态：1启用0禁用'])
->save();
}
- 执行迁移：
php think migrate:run - 如需回滚：
php think migrate:rollback
⚠️ 若必须执行原始 SQL 文件（如 legacy 脚本）
需手动读取、拆分并过滤执行（仅限单条 DDL，如 ALTER TABLE ... ADD COLUMN）：
- 读取 SQL 文件：
$sqlContent = file_get_contents('upgrade_v2.1.sql'); - 按分号简单分割（注意规避注释和字符串内的分号，生产环境建议用专业 SQL 解析器）：
- 遍历每条语句，跳过空行、注释行（
--或/*...*/），仅执行以ALTER TABLE ... ADD COLUMN开头的语句：
$statements = array_filter(array_map('trim', explode(';', $sqlContent)));
foreach ($statements as $stmt) {
if (empty($stmt) || str_starts_with($stmt, '--') || str_starts_with(trim($stmt), '/*')) {
continue;
}
if (stripos($stmt, 'ALTER TABLE') !== false && stripos($stmt, 'ADD COLUMN') !== false) {
try {
Db::execute($stmt);
} catch (\Exception $e) {
echo "执行失败：{$stmt}\n" . $e->getMessage() . "\n";
}
}
}
? 注意字段添加的关键细节
-
字段类型要匹配驱动：MySQL 用
tinyint，SQLite 可能需用integer；TP6 的 Schema 构建器会自动适配 -
避免重复添加：迁移类自带
hasColumn()检查，原始 SQL 需自行加IF NOT EXISTS（MySQL 8.0.19+ 支持，但非所有版本兼容） -
索引与默认值同步设置：迁移中可链式调用
->addIndex('status')或->setDefault(1) -
字符集与排序规则：若添加 varchar 字段，建议显式指定：
->setCharset('utf8mb4')->setCollation('utf8mb4_unicode_ci')
? 补充：快速测试字段是否添加成功
执行后可用以下代码验证：
立即学习“PHP免费学习笔记（深入）”；
// 查看表结构
print_r(Db::query("DESCRIBE users"));
// 或用 Schema 获取字段列表
$fields = Db::getSchema()->getTableFields('users');
var_dump(array_keys($fields)); 
