Laravel集成第三方包：优化API响应捕获与异常处理教程

Msg91::otp()
    ->to($fullmobileNumber)
    ->template('61432d6c30afb372115d3062')
    ->send();

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

public function loginWithMobile(LoginRequest $request)
{
    $countryCode = $request->input('countryCode');
    $mobileNumber = $request->input('mobileNumber');
    $fullmobileNumber = $countryCode . $mobileNumber;

    if (User::where('mobileNumber', $fullmobileNumber)->exists()) {
        /** @var Response $response */ // 添加PHPDoc类型提示
        $response = Msg91::otp()
            ->to($fullmobileNumber)
            ->template('61432d6c30afb372115d3062')
            ->send();
        // ... 后续处理 $response
    } else {
        // ... 用户创建逻辑
        /** @var Response $response */
        $response = Msg91::otp()
            ->to($fullmobileNumber)
            ->template('61432d6c30afb372115d3062')
            ->send();
        // ... 后续处理 $response
    }
    // ...
}

// ... 承接上面的代码
if ($response->success()) {
    return redirect()->route('otp.verify')->with('success', 'OTP已发送至您的手机号。');
} else {
    // 记录错误或向用户显示更详细的错误信息
    \Log::error('OTP发送失败: ' . $response->message() . ' Status: ' . $response->status());
    return back()->withErrors(['mobileNumber' => 'OTP发送失败，请稍后再试。'])->withInput();
}
// ...

use Craftsys\Msg91\Facade\Msg91;
use Craftsys\Msg91\Support\Response;
use Craftsys\Msg91\Exceptions\ValidationException;
use Craftsys\Msg91\Exceptions\OtpException;
use Exception; // 通用异常

public function loginWithMobile(LoginRequest $request)
{
    $countryCode = $request->input('countryCode');
    $mobileNumber = $request->input('mobileNumber');
    $fullmobileNumber = $countryCode . $mobileNumber;

    try {
        // 检查用户或创建用户的逻辑
        if (!User::where('mobileNumber', $fullmobileNumber)->exists()) {
            $userId = \Ramsey\Uuid\Uuid::uuid4()->toString();
            User::create([
                'userId' => $userId,
                'mobileNumber' => $fullmobileNumber
            ]);
        }

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

        if ($response->success()) {
            // 将响应信息传递给视图或重定向
            return redirect()->route('otp.verify')->with('success', 'OTP已发送至您的手机号。');
        } else {
            // API调用成功但业务逻辑失败 (例如，API返回错误消息)
            \Log::warning('OTP发送业务逻辑失败: ' . $response->message() . ' Status: ' . $response->status() . ' Extra: ' . json_encode($response->extra()));
            return back()->withErrors(['mobileNumber' => $response->message() ?: 'OTP发送失败，请稍后再试。'])->withInput();
        }
    } catch (ValidationException $e) {
        // 处理参数验证失败异常
        \Log::error('OTP发送验证失败: ' . $e->getMessage(), ['exception' => $e]);
        return back()->withErrors(['mobileNumber' => '手机号格式不正确或参数有误。'])->withInput();
    } catch (OtpException $e) {
        // 处理OTP相关的特定异常 (如模板ID错误、OTP服务不可用等)
        \Log::error('OTP服务异常: ' . $e->getMessage(), ['exception' => $e]);
        return back()->withErrors(['mobileNumber' => 'OTP服务异常，请联系管理员。'])->withInput();
    } catch (Exception $e) {
        // 捕获所有其他未知异常
        \Log::critical('OTP发送未知错误: ' . $e->getMessage(), ['exception' => $e]);
        return back()->withErrors(['mobileNumber' => '系统发生未知错误，请稍后再试。'])->withInput();
    }
}

// 在成功发送OTP后
return redirect()->route('otp.verify')->with('otp_sent_status', $response->success());
// 在视图中可以通过 session()->get('otp_sent_status') 访问

// 如果不重定向，直接渲染视图
return view('auth.otp_verification', [
    'response' => $response,
    'mobileNumber' => $fullmobileNumber
]);