使用Laravel Cashier简化PHP订阅管理

在当今的互联网时代，订阅模式已成为许多在线服务的核心商业模式。无论是SaaS产品、流媒体服务还是会员制内容平台，高效的订阅管理系统能够显著提升用户体验和业务运营效率。PHP开发者们有福了，因为Laravel Cashier这个强大的库能够极大地简化订阅管理的复杂度。

什么是Laravel Cashier？

Laravel Cashier是由Laravel官方提供的一个包装库，旨在简化Stripe和Paddle等支付网关的集成过程。它提供了一套简洁的API，使得处理订阅、发票、优惠券等任务变得轻而易举。

安装与配置

首先，确保你的项目是基于Laravel框架。接下来，通过Composer安装Cashier：

composer require laravel/cashier

安装完成后，需要在.env文件中配置你的Stripe或Paddle密钥：

STRIPE_KEY=your_stripe_key
STRIPE_SECRET=your_stripe_secret

然后，运行迁移命令以创建必要的数据库表：

php artisan migrate

创建订阅

假设你有一个用户模型User，你可以通过以下方式为用户创建一个新的订阅：

use Laravel\Cashier\Cashier;

$user = User::find(1);
$subscription = $user->newSubscription('default', 'price_id')->create($paymentMethod);

在这里，'default'是订阅的名称，'price_id'是你在Stripe中定义的价格ID，$paymentMethod是用户的支付方式。

管理订阅

Cashier提供了丰富的API来管理订阅。例如，你可以轻松地取消或恢复订阅：

// 取消订阅
$user->subscription('default')->cancel();

// 恢复订阅
$user->subscription('default')->resume();

处理发票

Cashier还支持发票管理，你可以轻松地获取和发送发票：

// 获取用户的发票
$invoices = $user->invoices();

// 发送最新发票
$user->sendInvoice($invoices->first());

优惠券与促销

支持优惠券和促销是提升用户转化率的有效手段。Cashier允许你轻松地应用优惠券：

// 应用优惠券
$subscription = $user->newSubscription('default', 'price_id')
                    ->withCoupon('COUPON_CODE')
                    ->create($paymentMethod);

事件与通知

Cashier触发了一系列事件，你可以监听这些事件来执行自定义逻辑，例如发送通知：

use Illuminate\Support\Facades\Event;

Event::listen(
    'Laravel\Cashier\Events\SubscriptionCreated',
    function ($event) {
        // 发送订阅成功通知
        $event->user->notify(new SubscriptionCreatedNotification());
    }
);