在开发一个 laravel 应用时，我需要一个可靠的短信发送功能来通知用户，例如订单状态更新、账户验证等。 起初，我尝试直接调用各个短信供应商的 api，这导致代码变得冗长且难以维护，不同供应商的 api 接口也让我疲于奔命。 每添加一个新的短信供应商，都需要修改大量的代码，这简直是噩梦！
这时，我发现了 gr8shivam/laravel-sms-api 这个 Laravel 包。它支持任何提供 REST API 的短信供应商，这意味着我可以轻松切换供应商，而无需修改核心代码。 这正是我梦寐以求的解决方案！
首先，使用 composer 安装该包：
composer require gr8shivam/laravel-sms-api
对于 Laravel 5.5 及以上版本，服务提供者和 Facade 会自动发现。 对于旧版本，你需要手动将其添加到 config/app.php 文件中：
'providers' => [ // ... Gr8ShivamSmsApiSmsApiServiceProvider::class, // ...],'aliases' => [ // ... 'SmsApi' => Gr8ShivamSmsApiSmsApiFacade::class, // ...],
然后，发布配置文件：
php artisan vendor:publish --provider="Gr8ShivamSmsApiSmsApiServiceProvider"
接下来，打开 config/sms-api.php 文件，配置你的短信供应商信息。 该包支持自定义多个网关，方便你同时使用多个短信服务。 配置方法非常清晰，只需按照文档填写相应的 method、url、params 和 headers 等参数即可。 这部分配置非常灵活，可以适配各种短信 API 的特殊需求。例如，它支持 json 参数来发送 JSON 格式的请求，并提供 wrapper 参数来处理需要特殊包装的 JSON 请求。
配置完成后，就可以开始发送短信了。 该包提供了两种方式：直接使用 smsapi() 辅助函数或 SmsApi Facade。 以下是一个简单的例子：
// 使用辅助函数smsapi('+86138xxxxxxxx', '您的验证码是：123456');// 使用 FacadeSmsApi::sendMessage('+86138xxxxxxxx', '您的验证码是：123456');
你还可以添加额外的参数和 headers，以及指定不同的网关和国家代码。 该包甚至支持发送短信到多个号码。 是不是非常方便？
此外，该包还提供了对 Laravel Notifications 的支持，你可以轻松地将其集成到你的通知系统中，让短信通知变得更加优雅和高效。 只需要在你的可通知模型中添加 routeNotificationForSmsApi() 方法，并在你的通知中使用 SmsApiChannel 和 SmsApiMessage 即可。
通过使用 gr8shivam/laravel-sms-api，我成功地将短信发送功能集成到我的 Laravel 应用中，显著地提高了开发效率。 告别了之前繁琐的代码和难以维护的短信集成方式，现在我可以专注于应用的核心功能，而无需再为短信发送而烦恼。 而且，这个包的配置非常灵活，能够轻松适配不同的短信供应商，为未来的扩展提供了很大的便利。 强烈推荐给所有需要在 Laravel 应用中集成短信功能的开发者！
