正文：

在 Laravel 项目中集成第三方服务（如 Msg91 短信服务）时，如何优雅地处理 API 响应并将其传递给视图是一个常见的需求。本文将带你从基础封装到高级实践，一步步实现这一目标。

1. 理解 Msg91 的响应结构

Msg91 的 API 通常返回 JSON 格式的响应，包含 status、message 和 data 等字段。例如：

{
  "status": "success",
  "message": "SMS sent successfully",
  "data": { "message_id": "ABC123" }
}

我们需要确保代码能解析这种结构，并处理可能的错误（如网络问题或无效参数）。

2. 创建服务层封装

首先，通过 Laravel 的 Service 模式封装 Msg91 的调用逻辑。在 app/Services 目录下创建 Msg91Service.php：

namespace App\Services;

use Illuminate\Support\Facades\Http;

class Msg91Service {
  protected $apiKey;
  protected $baseUrl = 'https://api.msg91.com/api/v5/';

  public function __construct() {
    $this->apiKey = config('services.msg91.key');
  }

  public function sendSMS(string $mobile, string $message) {
    $response = Http::withHeaders([
      'authkey' => $this->apiKey
    ])->post($this->baseUrl . 'sms/send', [
      'mobile' => $mobile,
      'message' => $message
    ]);

    return $this->parseResponse($response);
  }

  protected function parseResponse($response) {
    if ($response->successful()) {
      return $response->json();
    }
    throw new \Exception('Msg91 API Error: ' . $response->body());
  }
}

关键点：
- 使用 Laravel 的 HTTP 客户端发起请求。
- 通过 parseResponse 方法统一处理成功和失败的响应。

3. 控制器中调用服务

在控制器中注入 Msg91Service，并处理业务逻辑：

namespace App\Http\Controllers;

use App\Services\Msg91Service;
use Illuminate\Http\Request;

class SMSController extends Controller {
  public function send(Request $request, Msg91Service $msg91) {
    try {
      $response = $msg91->sendSMS($request->mobile, $request->message);
      return view('sms.status', ['response' => $response]);
    } catch (\Exception $e) {
      return back()->with('error', $e->getMessage());
    }
  }
}

这里通过异常捕获确保用户友好的错误提示，并将成功响应传递给视图。

4. 视图中的响应展示

在 resources/views/sms/status.blade.php 中设计响应展示逻辑：

@if(isset($response['status']) && $response['status'] === 'success')
  
{{ $response['message'] }}

Message ID: {{ $response['data']['message_id'] }}
@else
  
Failed to send SMS. Please try again.
@endif

通过 Blade 模板的条件渲染，实现动态内容展示。

5. 进阶优化：响应格式化

为提升可维护性，可以定义专用的 ResponseFormatter 类：

namespace App\Formatters;

class Msg91ResponseFormatter {
  public static function format(array $response) {
    return [
      'is_success' => $response['status'] === 'success',
      'message' => $response['message'] ?? 'No message',
      'meta' => $response['data'] ?? []
    ];
  }
}

在服务层调用格式化方法后，视图只需检查 is_success 即可。

6. 单元测试保障

最后，为 Msg91Service 编写测试：

namespace Tests\Unit;

use App\Services\Msg91Service;
use Illuminate\Support\Facades\Http;
use Tests\TestCase;

class Msg91ServiceTest extends TestCase {
  public function test_send_sms_success() {
    Http::fake(['*' => Http::response(['status' => 'success'])]);
    $service = new Msg91Service();
    $this->assertArrayHasKey('status', $service->sendSMS('1234567890', 'Test'));
  }
}

通过 HTTP 伪造和断言，确保核心逻辑的可靠性。

结语

通过服务层封装、异常处理和视图分离，我们实现了 Msg91 响应处理的优雅方案。这种模式不仅适用于短信服务，还可扩展至其他第三方 API 集成。