引言
在 Laravel 应用开发中，尽管 Eloquent ORM 提供了强大的数据库操作能力，但它并不直接支持像 DB::select() 这样用于查询的便捷方法来调用 MySQL 存储过程。这意味着当我们需要执行存储过程时，必须采用原生 SQL 语句的方式。本教程将详细阐述如何在 Laravel 8.0+ 环境下，根据存储过程的参数类型（无参数、仅输入、仅输出、输入输出兼有）进行调用，并提供相应的代码示例和最佳实践。
核心调用方法
在 Laravel 中执行原生 SQL 语句主要依赖于 Illuminate\Support\Facades\DB Facade 提供的两个方法：
- DB::statement(string $query, array $bindings = []): 用于执行不返回结果集的 SQL 语句，例如 INSERT, UPDATE, DELETE, CREATE TABLE 以及存储过程调用。
- DB::select(string $query, array $bindings = []): 用于执行返回结果集的 SQL 语句，例如 SELECT 查询。
接下来，我们将针对不同类型的存储过程调用进行详细讲解。
一、无参数存储过程调用
当存储过程不需要任何输入参数，也不返回任何输出数据时，调用方式最为简单。通常这类存储过程用于执行一些独立的后台任务或数据维护操作。
示例代码：
use Illuminate\Support\Facades\DB;
try {
$query = "CALL your_stored_procedure(); COMMIT;";
DB::statement($query);
echo "无参数存储过程调用成功。";
} catch (\Exception $e) {
echo "调用失败：" . $e->getMessage();
}二、仅含输入参数的存储过程调用
这类存储过程接受外部数据作为输入，根据输入参数执行相应的逻辑，但不通过参数直接返回数据（可能通过结果集返回，但这里主要讨论参数本身）。传递输入参数有两种常见方式：静态数据和动态数据绑定。
1. 传递静态数据
如果输入参数是固定值或直接拼接的字符串，可以直接在 SQL 语句中包含。但请注意，这种方式存在 SQL 注入风险，不推荐用于动态或用户输入的数据。
示例代码：
use Illuminate\Support\Facades\DB;
$staticData = 'some_static_value'; // 假设这是一个字符串，根据存储过程参数类型调整
// 如果是数字，直接写数字即可，例如 your_stored_procedure(123)
// 如果是字符串，需要用单引号括起来
$query = "CALL your_stored_procedure('" . $staticData . "'); COMMIT;";
try {
DB::statement($query);
echo "带静态输入参数的存储过程调用成功。";
} catch (\Exception $e) {
echo "调用失败：" . $e->getMessage();
}2. 传递动态数据（使用参数绑定）
强烈推荐使用参数绑定来传递动态数据，这可以有效防止 SQL 注入攻击，并提高代码的可读性和安全性。Laravel 的 DB::statement() 方法支持命名参数绑定。
示例代码：
use Illuminate\Support\Facades\DB;
$yourInputData = 'dynamic_value_from_user_input'; // 假设这是动态获取的数据
$query = "CALL your_stored_procedure(:your_data); COMMIT;";
$bind = [
'your_data' => $yourInputData
];
try {
DB::statement($query, $bind);
echo "带动态输入参数的存储过程调用成功。";
} catch (\Exception $e) {
echo "调用失败：" . $e->getMessage();
}三、仅含输出参数的存储过程调用
这类存储过程通过输出参数（通常是 MySQL 用户变量 @ 开头的变量）返回数据。调用时需要先执行存储过程，然后通过 SELECT 语句查询该用户变量的值。
示例代码：
use Illuminate\Support\Facades\DB;
try {
// 1. 调用存储过程，将结果写入用户变量 @your_output_data
$callQuery = "CALL your_stored_procedure(@your_output_data); COMMIT;";
DB::statement($callQuery);
// 2. 查询用户变量的值
$selectQuery = "SELECT @your_output_data AS your_output_alias;";
$result = DB::select($selectQuery);
// $result 是一个数组，每个元素是一个StdClass对象
// 例如：[{"your_output_alias": "actual_output_value"}]
if (!empty($result)) {
$outputValue = $result[0]->your_output_alias;
echo "存储过程输出数据： " . $outputValue;
} else {
echo "未获取到存储过程输出数据。";
}
} catch (\Exception $e) {
echo "调用失败：" . $e->getMessage();
}四、同时含输入和输出参数的存储过程调用
这是前两种情况的结合，存储过程既接受输入参数，也通过输出参数返回数据。同样，输入参数应使用参数绑定，输出参数通过用户变量获取。
示例代码：
use Illuminate\Support\Facades\DB;
$yourInputData = 'input_for_processing'; // 动态输入数据
try {
// 1. 调用存储过程，传递输入参数，并将输出写入用户变量
$callQuery = "CALL your_stored_procedure(:your_input_data, @your_output_data); COMMIT;";
$bind = [
'your_input_data' => $yourInputData
];
DB::statement($callQuery, $bind);
// 2. 查询用户变量的值以获取输出数据
$selectQuery = "SELECT @your_output_data AS your_output_alias;";
$result = DB::select($selectQuery);
if (!empty($result)) {
$outputValue = $result[0]->your_output_alias;
echo "存储过程输入数据：{$yourInputData}，输出数据：{$outputValue}";
} else {
echo "未获取到存储过程输出数据。";
}
} catch (\Exception $e) {
echo "调用失败：" . $e->getMessage();
}关于 COMMIT 语句的说明
在上述所有示例中，我们都在存储过程调用后紧跟着添加了 COMMIT; 语句。这是因为 COMMIT 命令用于将自上次 COMMIT 或 ROLLBACK 以来对数据库所做的所有更改永久保存。
在许多现代数据库管理系统（DBMS）中，AUTOCOMMIT 选项默认是开启的，这意味着每个独立的 SQL 语句都会被自动提交。然而，在某些情况下（例如，当 AUTOCOMMIT 被禁用，或者在更复杂的事务场景中），显式使用 COMMIT 变得尤为重要。
显式 COMMIT 的好处在于：
- 确保数据持久化： 即使 AUTOCOMMIT 关闭，也能保证存储过程内部的数据修改被永久保存。
- 事务控制： 它允许你在更复杂的业务逻辑中，将多个数据库操作作为一个原子单元进行管理。如果存储过程是某个更大事务的一部分，或者你希望在调用存储过程后根据后续逻辑决定是否回滚，那么显式 COMMIT（或在失败时 ROLLBACK）是必不可少的。
因此，为了代码的健壮性和在不同环境下的兼容性，在存储过程调用后添加 COMMIT 是一个良好的习惯。
总结与注意事项
本教程详细展示了在 Laravel 8.0+ 中调用 MySQL 存储过程的各种场景和方法。需要注意的是，本教程侧重于“如何调用”存储过程，而非“如何处理”存储过程返回的复杂结果集（例如，如果存储过程返回多个结果集或更复杂的数据结构）。对于复杂结果集的处理，可能需要更深入地结合 PHP 的 PDO 扩展或其他数据库驱动特性。
在实际开发中，请始终遵循以下最佳实践：
- 使用参数绑定： 无论何时传递动态数据给 SQL 语句，都应优先使用参数绑定来防止 SQL 注入。
- 错误处理： 使用 try-catch 块捕获数据库操作可能抛出的异常，确保应用的健壮性。
- 代码可读性： 保持 SQL 语句的清晰和可维护性，对于复杂的存储过程调用，可以考虑将其封装在服务类或仓库类中。
