Laravel迁移创建MySQL自定义函数教程

在 Laravel 迁移中必须使用 `DB::statement()`（而非 `DB::raw()`）来创建或删除 MySQL 自定义函数，因为只有 `DB::statement()` 能实际执行 DDL 语句。

在 Laravel 迁移中，使用 `DB::raw()` 无法执行 SQL 函数定义；必须改用 `DB::statement()` 才能实际创建或删除 MySQL 存储函数。本文详解实现步骤、常见错误及最佳实践。

在 Laravel 应用中，当需要复用地理距离计算等复杂逻辑时，将计算逻辑下沉至 MySQL 层（如定义 calculate_distance 函数）是常见且高效的方案。但许多开发者在迁移中误用 DB::raw()，导致函数看似“迁移成功”，实则未在数据库中创建——正如你在 phpMyAdmin 中观察到的那样：控制台显示 Migrated:，但函数列表为空。

根本原因在于：DB::raw() 仅用于构造原始 SQL 表达式（例如 WHERE 条件中的 RAW 值），它不会触发 SQL 执行；而创建/删除函数属于 DDL（数据定义语言）操作，必须通过可执行语句接口完成。

✅ 正确做法是使用 DB::statement() —— 它专为执行任意原生 SQL 语句（包括 CREATE FUNCTION、DROP PROCEDURE、SET @var := ... 等）而设计，支持多语句（需确保 PDO 配置允许，见下文注意事项）。

以下是修复后的迁移文件示例（兼容 Laravel 8+，已优化可读性与健壮性）：

? 关键注意事项：  
✅ 必须分两次调用 DB::statement()：MySQL 不允许在单条 DB::statement() 中执行多个以分号分隔的语句（除非启用 PDO::MYSQL_ATTR_MULTI_STATEMENTS，但 Laravel 默认禁用，且存在安全风险）。因此 DROP 和 CREATE 需拆分为独立语句。  
✅ 参数类型建议使用 DECIMAL 而非 FLOAT：地理坐标精度敏感，DECIMAL(10,8) 可精确表示纬度（±90°）和经度（±180°），避免浮点误差累积。  
✅ 显式指定 READS SQL DATA 和 DETERMINISTIC：这是 MySQL 5.7+ 强制要求（尤其在 sql_mode=STRICT_TRANS_TABLES 下），否则创建失败。  
⚠️ 函数名大小写敏感性：MySQL 默认函数名不区分大小写，但建议统一小写以保证跨平台一致性。  
? 验证是否生效：迁移后可在 phpMyAdmin 的「Routines」→「Functions」标签页查看，或运行 SHOW FUNCTION STATUS LIKE 'calculate_distance';。
? 进阶提示：若需在 Eloquent 查询中调用该函数，可直接嵌入 selectRaw 或 whereRaw：
$stores = Store::select('id', 'name')
    ->selectRaw('calculate_distance(?, ?, latitude, longitude) as distance', [
        $userLat, $userLon
    ])
    ->having('distance', '<', 10)
    ->orderBy('distance')
    ->get();
至此，你的自定义 SQL 函数即可被 Laravel 稳定调用，同时保持数据库层逻辑复用与查询性能优势。
终于介绍完啦！小伙伴们，这篇关于《Laravel迁移创建MySQL自定义函数教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！