本文详解在 laravel 迁移中通过 `db::statement()` 安全创建 mysql 存储函数（如地理距离计算函数）的完整方法，纠正误用 `db::raw()` 导致函数未生效的常见问题，并提供可直接运行的迁移代码与关键注意事项。
在 Laravel 应用中，当需要复用复杂 SQL 逻辑（例如基于经纬度计算球面距离的 calculate_distance 函数）时，将其实现为 MySQL 自定义函数是一种高效且可维护的方案。但许多开发者在迁移中误用 DB::raw()，导致函数看似“迁移成功”，实则未被数据库执行——这是因为 DB::raw() 仅生成原始 SQL 表达式对象，不会触发实际查询执行，它专为 select()、where() 等查询构建场景设计。
要真正执行 DDL（如 CREATE FUNCTION）或 DCL 语句，必须使用 DB::statement()。该方法会直接向数据库发送并执行原生 SQL，支持多语句（需确保 PDO 配置允许，见后文说明）。
以下是修正后的迁移类完整实现：
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Support\Facades\DB;
return new class extends Migration
{
public function up(): void
{
// 先安全删除已存在函数（避免重复创建报错）
DB::statement('DROP FUNCTION IF EXISTS calculate_distance');
// 创建函数：计算两点间近似球面距离（单位：公里）
DB::statement(<<<'SQL'
CREATE FUNCTION calculate_distance(
lat1 FLOAT, lon1 FLOAT,
lat2 FLOAT, lon2 FLOAT
) RETURNS FLOAT
READS SQL DATA
DETERMINISTIC
BEGIN
RETURN 111.111 * DEGREES(
ACOS(
COS(RADIANS(lat1)) * COS(RADIANS(lat2)) * COS(RADIANS(lon1 - lon2)) +
SIN(RADIANS(lat1)) * SIN(RADIANS(lat2))
)
);
END
SQL
);
}
public function down(): void
{
DB::statement('DROP FUNCTION IF EXISTS calculate_distance');
}
};✅ 关键改进说明：
解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
- 使用 DB::statement() 替代 DB::raw()，确保 SQL 被真实执行；
- 将 CREATE FUNCTION 拆分为独立调用，避免单次 DB::statement() 中混用多语句（部分 MySQL 驱动/配置下不支持分号分隔的多语句）；
- 采用 PHP Heredoc 语法（
- 函数声明显式指定 READS SQL DATA 和 DETERMINISTIC，符合 MySQL 严格模式要求，避免因 log_bin_trust_function_creators 限制导致创建失败。
⚠️ 重要注意事项：
- MySQL 权限：执行函数创建需具备 CREATE ROUTINE 权限，请确认 Laravel 数据库用户已授权；
- 二进制日志兼容性：若 MySQL 启用了二进制日志（binlog），需设置 log_bin_trust_function_creators = 1，或为用户授予 SUPER 权限（生产环境建议前者）；
- 迁移回滚可靠性：down() 方法中务必包含 DROP FUNCTION IF EXISTS，防止重复回滚报错；
- Laravel 版本适配：上述代码兼容 Laravel 8+（含 8.65），若使用 Laravel 9+，请确保 up() 和 down() 方法签名返回 void（如示例所示）。
验证函数是否成功创建：进入 phpMyAdmin → 选择对应数据库 → 切换至“ routines” 标签页，即可看到 calculate_distance 函数；或在 SQL 查询框中执行 SELECT calculate_distance(40.7128, -74.0060, 34.0522, -118.2437); 测试返回值。
掌握此模式后，你可将任意 MySQL 存储过程、函数或视图通过迁移统一纳入版本控制，实现数据库逻辑与应用代码的协同演进。
