如何在 Laravel 中正确处理第三方包的响应与异常

use Craftsys\Msg91\Facade\Msg91;
use Craftsys\Msg91\Support\Response; // 引入响应类

// ... 在控制器或服务中

public function sendOtp(string $fullMobileNumber)
{
    // 捕获 Msg91::otp()->send() 方法的返回值
    /** @var Response $response */
    $response = Msg91::otp()
        ->to($fullMobileNumber)
        ->template('61432d6c30afb372115d3062')
        ->send();

    // 此时，$response 变量包含了 Msg91 服务器返回的所有信息
    // 你可以通过 $response 对象访问其属性或方法
    if ($response->success()) {
        // OTP 发送成功
        return ['status' => 'success', 'message' => 'OTP sent successfully', 'data' => $response->getData()];
    } else {
        // OTP 发送失败，可以获取错误信息
        return ['status' => 'error', 'message' => 'Failed to send OTP', 'error_details' => $response->getMessage()];
    }
}

use Craftsys\Msg91\Facade\Msg91;
use Craftsys\Msg91\Support\Response;
use Craftsys\Msg91\Exceptions\ValidationException; // 引入可能的异常类
use Exception; // 捕获其他通用异常

class AuthController extends Controller
{
    public function loginWithMobile(LoginRequest $request)
    {
        $countryCode = $request->input('countryCode');
        $mobileNumber = $request->input('mobileNumber');
        $fullMobileNumber = $countryCode . $mobileNumber;

        // 检查用户是否存在或创建新用户
        if (!User::where('mobileNumber', $fullMobileNumber)->exists()) {
            $userId = \Ramsey\Uuid\Uuid::uuid4()->toString();
            User::create([
                'userId' => $userId,
                'mobileNumber' => $fullMobileNumber
            ]);
        }

        try {
            /** @var Response $response */
            $response = Msg91::otp()
                ->to($fullMobileNumber)
                ->template('61432d6c30afb372115d3062')
                ->send();

            if ($response->success()) {
                // OTP 发送成功，返回成功响应
                return response()->json([
                    'status' => 'success',
                    'message' => 'OTP sent successfully. Please verify your mobile number.'
                ]);
            } else {
                // Msg91 返回失败响应，但未抛出异常
                // 这可能是由于业务逻辑上的失败（例如，模板ID无效但API仍返回了响应体）
                return response()->json([
                    'status' => 'error',
                    'message' => 'Failed to send OTP: ' . $response->getMessage(),
                    'details' => $response->getData()
                ], 400);
            }
        } catch (ValidationException $e) {
            // 捕获 Msg91 相关的验证异常
            // 例如，手机号格式不正确，模板ID无效等
            \Log::error("Msg91 OTP validation error for {$fullMobileNumber}: " . $e->getMessage());
            return response()->json([
                'status' => 'error',
                'message' => 'OTP sending failed due to validation issue.',
                'details' => $e->getMessage()
            ], 422); // HTTP 422 Unprocessable Entity
        } catch (Exception $e) {
            // 捕获其他通用异常，例如网络错误、API服务不可用等
            \Log::error("General error sending OTP to {$fullMobileNumber}: " . $e->getMessage());
            return response()->json([
                'status' => 'error',
                'message' => 'An unexpected error occurred while sending OTP.',
                'details' => $e->getMessage()
            ], 500); // HTTP 500 Internal Server Error
        }
    }
}