Laravel Cashier：优雅地删除 Stripe 客户

<?php

namespace App\Services; // 假设这是一个服务类

use App\Models\User; // 假设你的可计费模型是 App\Models\User
use Stripe\Exception\ApiErrorException; // 引入 Stripe API 错误异常

class StripeCustomerService
{
    /**
     * 删除 Stripe 平台上的客户及其相关数据。
     *
     * @param User $user 需要删除 Stripe 客户的用户实例
     * @return bool 删除操作是否成功
     * @throws ApiErrorException 如果 Stripe API 调用失败
     */
    public function deleteStripeCustomer(User $user): bool
    {
        // 1. 检查用户是否关联了 Stripe 客户 ID
        if (empty($user->stripe_id)) {
            // 如果没有 Stripe ID，则无需执行删除操作
            // 可以在此处记录日志或抛出特定异常
            return true; // 视为成功，因为没有需要删除的 Stripe 客户
        }

        try {
            // 2. 获取 Stripe 客户实例并调用 delete 方法
            // asStripeCustomer() 会返回一个 Stripe\Customer 对象
            $stripeCustomer = $user->asStripeCustomer();
            $stripeCustomer->delete();

            // 3. (可选但推荐) 清除本地数据库中与 Stripe 客户相关的字段
            // 这确保了本地数据与 Stripe 平台状态的一致性
            $user->forceFill([
                'stripe_id' => null,
                'pm_type' => null, // 清除默认支付方式类型
                'pm_last_four' => null, // 清除默认支付方式后四位
                // 根据你的 Cashier 配置，可能还需要清除其他相关字段，
                // 例如 subscription_name, subscription_stripe_id, subscription_stripe_status 等
            ])->save();

            return true; // 删除成功
        } catch (ApiErrorException $e) {
            // 处理 Stripe API 错误，例如网络问题、API 密钥无效等
            // 可以在此处记录错误日志，并重新抛出或返回 false
            \Log::error("删除 Stripe 客户失败: 用户ID {$user->id}, 错误信息: {$e->getMessage()}");
            throw $e; // 重新抛出异常以便上层调用者处理
        } catch (\Exception $e) {
            // 处理其他潜在的 PHP 错误
            \Log::error("删除 Stripe 客户时发生未知错误: 用户ID {$user->id}, 错误信息: {$e->getMessage()}");
            throw $e;
        }
    }
}

// 如何在控制器或服务中使用：
// use App\Models\User;
// use App\Services\StripeCustomerService;

// public function destroyUserAccount(User $user, StripeCustomerService $stripeCustomerService)
// {
//     try {
//         $stripeCustomerService->deleteStripeCustomer($user);
//         // 用户账号的其他删除逻辑...
//         return redirect()->back()->with('success', '用户及其 Stripe 客户已成功删除。');
//     } catch (\Exception $e) {
//         return redirect()->back()->with('error', '删除用户失败：' . $e->getMessage());
//     }
// }