掌握 Laravel Cashier：高效删除 Stripe 客户

// app/Http/Controllers/CustomerManagementController.php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;
use Stripe\Exception\ApiErrorException; // 引入 Stripe API 异常类

class CustomerManagementController extends Controller
{
    /**
     * 删除指定用户的 Stripe 客户信息。
     *
     * @param Request $request
     * @param User $user 要删除 Stripe 客户的用户模型实例
     * @return \Illuminate\Http\RedirectResponse
     */
    public function deleteStripeCustomer(Request $request, User $user)
    {
        // 1. 权限验证（根据实际业务逻辑添加）
        // 在实际应用中，你可能需要验证当前操作用户是否有权限删除目标用户的 Stripe 客户。
        // 例如：$this->authorize('deleteStripeCustomer', $user);

        // 2. 检查用户是否关联了 Stripe 客户 ID
        // Cashier 提供了 hasStripeId() 方法来检查用户是否在 Stripe 中注册过。
        if (!$user->hasStripeId()) {
            Log::warning("尝试删除未关联 Stripe 客户的用户 ID: {$user->id}");
            return back()->with('error', '该用户未关联 Stripe 客户，无需执行删除操作。');
        }

        try {
            // 3. 获取 Stripe 客户实例并执行删除操作
            // $user->asStripeCustomer() 会获取到 Stripe\Customer 对象
            // 然后直接调用其 delete() 方法即可完成删除
            $stripeCustomer = $user->asStripeCustomer();
            $stripeCustomer->delete();

            // 4. 可选：更新本地数据库状态
            // 强烈建议在 Stripe 客户删除成功后，将本地数据库中用户的 stripe_id 字段设为 null，
            // 以保持数据一致性，并防止未来误操作。
            $user->forceFill(['stripe_id' => null])->save();

            Log::info("Stripe 客户 ID: {$user->stripe_id} 已成功删除，对应本地用户 ID: {$user->id}。");
            return back()->with('success', 'Stripe 客户已成功删除。');

        } catch (ApiErrorException $e) {
            // 捕获 Stripe API 错误
            // 这类错误可能包括网络问题、API 密钥无效、Stripe 内部错误等。
            Log::error("删除 Stripe 客户失败 (用户 ID: {$user->id})，Stripe API 错误: " . $e->getMessage());
            return back()->with('error', '删除 Stripe 客户时发生 Stripe API 错误，请检查日志。');
        } catch (\Exception $e) {
            // 捕获其他未知错误
            // 例如数据库操作失败、PHP 运行时错误等。
            Log::error("删除 Stripe 客户失败 (用户 ID: {$user->id})，未知错误: " . $e->getMessage());
            return back()->with('error', '删除 Stripe 客户时发生未知错误，请重试。');
        }
    }
}