php平台怎么用Laravel Cashier接Stripe订阅-php教程-PHP中文网

Laravel Cashier 是 Laravel 与 Stripe 的集成胶水层，自动处理订阅生命周期、发票、Webhook 验证和数据库同步；需配置环境、发布迁移、引入 Billable trait、手动创建 Stripe 产品价格、前端用 Stripe.js 传 payment_method、后端调用 newSubscription()->create()，并正确配置 Webhook 路由与事件监听。

php平台怎么用laravel cashier接stripe订阅

用 Laravel Cashier 接 Stripe 订阅，核心是把 Cashier 当作 Laravel 和 Stripe 的“胶水层”，它帮你自动处理订阅生命周期、发票、Webhook 验证、数据库同步等重复逻辑。关键不是手写 API 调用，而是按 Cashier 的约定建模和配置。

1. 安装与基础配置

确保项目已使用 Laravel 9+（Cashier v14+），PHP 8.0+，且已配置好数据库和队列（Webhook 处理强烈依赖队列）。

运行 composer require laravel/cashier
发布迁移：执行 php artisan vendor:publish --tag="cashier-migrations"，再 php artisan migrate
在 .env 中填入 Stripe 密钥：
STRIPE_KEY=sk_test_...
STRIPE_SECRET=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...（需在 Stripe Dashboard → Developers → Webhooks 创建并复制）
在 App\Models\User（或你用的模型）中引入 Billable trait：
use Laravel\Cashier\Billable;
class User extends Authenticatable { use Billable; }

2. 创建 Stripe 产品与价格（后台操作）

Cashier 不负责创建 Stripe 后台资源，这步必须手动完成：

登录 Stripe Dashboard
Products → + Add product（如 “Pro Plan”）→ Save
点击刚建的产品 → Pricing → + Add price（选 Recurring，设置周期、金额、货币）→ Publish
记下 Price ID（如 price_1Q...xyz），后续代码中会用到

3. 前端订阅流程（精简示例）

用户点击订阅按钮时，不直接传卡信息给后端，而是用 Stripe.js 创建 paymentMethod 或 setupIntent，再把 token 交给 Laravel 处理。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

前端引入 Stripe.js：
<script src="https://js.stripe.com/v3/"></script>
用 stripe.createPaymentMethod() 或 elements.submit() 获取 payment_method ID
发 POST 请求到你的 Laravel 路由（如 /user/subscribe），附带 price_id 和 payment_method

后端控制器中调用：

$user->newSubscription('default', $request->price_id)<br>
      ->create($request->payment_method);

成功后，Cashier 自动创建 Subscription 记录、关联 Stripe 订阅，并触发 Webhook 同步状态。

4. Webhook 设置与安全验证

Stripe 会通过 Webhook 主动通知事件（如付款成功、订阅取消）。Cashier 提供了开箱即用的路由和控制器，但必须正确启用：

在 routes/web.php 中添加：
Route::stripeWebhooks('stripe-webhook');
在 APP_URL 对应域名下配置 Webhook endpoint：
https://yoursite.com/stripe-webhook（注意不能是 localhost）
确保该路由未被中间件拦截（如 auth、VerifyCsrfToken），Cashier 内部已做签名验证
可监听特定事件，例如在 App\Providers\EventServiceProvider 中注册：
'stripe.webhook.subscription.updated' => [HandleSubscriptionUpdated::class]