Laravel開(kāi)發(fā):如何使用Laravel Cashier實(shí)現(xiàn)訂閱功能?
Laravel Cashier是一個(gè)易于使用的Stripe付款處理包,可以幫助我們?cè)贚aravel應(yīng)用程序中實(shí)現(xiàn)訂閱功能。在此教程中,我們將學(xué)習(xí)如何使用Laravel Cashier實(shí)現(xiàn)訂閱功能。
步驟1:安裝Laravel Cashier
在我們開(kāi)始使用Laravel Cashier之前,需要安裝它。在Laravel項(xiàng)目中運(yùn)行以下命令來(lái)安裝Laravel Cashier:
composer require laravel/cashier
登錄后復(fù)制
步驟2:配置Stripe憑據(jù)
Laravel Cashier需要您配置Stripe憑據(jù)才能正常工作。如果您還沒(méi)有Stripe賬戶,可以在https://stripe.com/上注冊(cè)一個(gè)新賬戶。然后,登錄到Stripe Dashboard,點(diǎn)擊API選項(xiàng)卡,復(fù)制您的私鑰并將其添加到.env文件中。
STRIPE_SECRET_KEY=your_stripe_secret_key STRIPE_PUBLIC_KEY=your_stripe_public_key
登錄后復(fù)制
步驟3:創(chuàng)建訂閱計(jì)劃
在我們實(shí)現(xiàn)訂閱功能之前,我們需要在Stripe Dashboard中創(chuàng)建訂閱計(jì)劃。轉(zhuǎn)到您的Stripe Dashboard并創(chuàng)建一個(gè)新的訂閱計(jì)劃。
在創(chuàng)建訂閱計(jì)劃時(shí),請(qǐng)確保設(shè)置適當(dāng)?shù)慕痤~,計(jì)費(fèi)周期和試用期(如有需要)。
步驟4:創(chuàng)建Subscriber模型
Subscriber模型將繼承Laravel Cashier的Billable Trait,并定義有關(guān)訂閱的所有信息。通過(guò)執(zhí)行以下命令在Laravel項(xiàng)目中創(chuàng)建Subscriber模型:
php artisan make:model Subscriber -m
登錄后復(fù)制
此命令將創(chuàng)建一個(gè)Subscriber模型文件和一個(gè)遷移文件。
在遷移文件中,我們需要將Billable Trait添加到模型中。修改Subscriber模型遷移文件,如下所示:
<?php
use IlluminateDatabaseMigrationsMigration;
use IlluminateDatabaseSchemaBlueprint;
use IlluminateSupportFacadesSchema;
class CreateSubscribersTable extends Migration
{
public function up()
{
Schema::create('subscribers', function (Blueprint $table) {
$table->bigIncrements('id');
$table->string('name');
$table->string('email')->unique();
$table->timestamp('email_verified_at')->nullable();
$table->string('password');
$table->rememberToken();
$table->string('stripe_id')->nullable();
$table->string('card_brand')->nullable();
$table->string('card_last_four')->nullable();
$table->timestamp('trial_ends_at')->nullable();
$table->timestamps();
});
Schema::table('subscribers', function (Blueprint $table) {
$table->softDeletes();
});
}
public function down()
{
Schema::table('subscribers', function (Blueprint $table) {
$table->dropSoftDeletes();
});
Schema::dropIfExists('subscribers');
}
}
登錄后復(fù)制
我們?cè)赟ubscriber模型中添加了訂閱所需的所有字段以及軟刪除支持。
步驟5:配置Laravel Cashier
在Subscriber模型中添加Laravel Cashier Trait,如下所示:
<?php
namespace App;
use IlluminateFoundationAuthUser as Authenticatable;
use IlluminateNotificationsNotifiable;
use IlluminateDatabaseEloquentSoftDeletes;
use LaravelCashierBillable;
class Subscriber extends Authenticatable
{
use Notifiable, SoftDeletes, Billable;
protected $dates = ['deleted_at'];
protected $fillable = [
'name', 'email', 'password',
];
protected $hidden = [
'password', 'remember_token',
];
public function getStripeKeyName()
{
return 'stripe_id';
}
}
登錄后復(fù)制
在上面的代碼中,我們添加了Billable Trait并指定了Stripe中的“stripe_id”。
步驟6:實(shí)現(xiàn)訂閱功能
現(xiàn)在,我們已經(jīng)配置好了Laravel Cashier并創(chuàng)建了Subscriber模型,我們可以開(kāi)始使用Laravel Cashier來(lái)實(shí)現(xiàn)訂閱功能。
在我們開(kāi)始之前,我們需要確保用戶已登錄。我們將使用Laravel的Authentication功能來(lái)處理此步驟。
在web.php中添加以下路由:
Route::group(['middleware' => ['auth']], function () {
Route::get('/subscribe', 'SubscriptionController@index')->name('subscribe.index');
Route::post('/subscribe', 'SubscriptionController@store')->name('subscribe.store');
Route::get('/subscribe/cancel', 'SubscriptionController@cancel')->name('subscribe.cancel');
Route::get('/subscribe/resume', 'SubscriptionController@resume')->name('subscribe.resume');
Route::get('/subscribe/invoice', 'SubscriptionController@invoice')->name('subscribe.invoice');
});
登錄后復(fù)制
現(xiàn)在,我們需要添加一個(gè)SubscriptionController來(lái)處理我們的訂閱功能。使用以下命令創(chuàng)建SubscriptionController:
php artisan make:controller SubscriptionController
登錄后復(fù)制
在SubscriptionController中添加index方法,
<?php
namespace AppHttpControllers;
use IlluminateHttpRequest;
use LaravelCashierExceptionsIncompletePayment;
use Stripe{EphemeralKey, PaymentIntent, PaymentMethod};
class SubscriptionController extends Controller
{
public function index(Request $request)
{
$intent = $request->user()->createSetupIntent();
return view('subscription.index', [
'intent' => $intent,
]);
}
}
登錄后復(fù)制
在上面的代碼中,我們創(chuàng)建了一個(gè)Setup Intent用于收集用戶的付款信息。然后,我們將此Setup Intent傳遞到視圖中,并在用于訂閱的表單中使用它。
在訂閱表單中,我們可以使用Stripe.js來(lái)收集用戶的付款信息。以下是一個(gè)基本的訂閱表單示例:
@extends('layouts.app')
@section('content')
{!! Form::open(['route' => 'subscribe.store', 'class' => 'form-horizontal']) !!}
<div class="form-group row">
<label for="name">{{ __('Plan') }}</label>
<select name="plan" id="plan" class="form-control">
<option value="price_123456">Basic Plan - $20/month</option>
<option value="price_123457">Standard Plan - $50/month</option>
<option value="price_123458">Premium Plan - $100/month</option>
</select>
<div id="card-element"></div>
</div>
<div class="form-group row">
<div id="card-errors" class="mx-auto" role="alert"></div>
</div>
<div class="form-group row mb-0">
<button type="submit" class="btn btn-primary">
{{ __('Subscribe') }}
</button>
</div>
{!! Form::close() !!}
<script src="https://js.stripe.com/v3/"></script>
<script>
let stripe = Stripe('{{ env('STRIPE_PUBLIC_KEY') }}');
let elements = stripe.elements();
let card = elements.create('card', {
hidePostalCode: true,
style: {
base: {
iconColor: '#666EE8',
color: '#31325F',
lineHeight: '40px',
fontWeight: 300,
fontFamily: '"Helvetica Neue", Helvetica, sans-serif',
fontSize: '15px',
'::placeholder': {
color: '#CFD7E0',
},
},
},
}
);
card.mount('#card-element');
let cardErrors = document.getElementById('card-errors');
card.addEventListener('change', function(event) {
if (event.error) {
cardErrors.textContent = event.error.message;
} else {
cardErrors.textContent = '';
}
});
let submitButton = document.querySelector('button[type=submit]');
let form = document.querySelector('form');
let clientSecret = null;
submitButton.addEventListener('click', async function(ev) {
ev.preventDefault();
submitButton.disabled = true;
let {setupIntent, error} = await stripe.confirmCardSetup(
clientSecret, {
payment_method: {
card: card,
}
});
if (error) {
cardErrors.textContent = error.message;
submitButton.disabled = false;
return;
}
let paymentMethodId = setupIntent.payment_method;
axios.post('{{ route('subscribe.store') }}', {
plan: document.querySelector('#plan').value,
payment_method: paymentMethodId,
_token: '{{ csrf_token() }}'
}).then(function(response) {
window.location.href = response.data.success_url;
}).catch(function(error) {
submitButton.disabled = false;
});
});
(async () => {
let {setupIntent} = await axios.get('/api/create-setup-intent', {
headers: {
'X-CSRF-Token': document.head.querySelector('meta[name="csrf-token"]').content
}
}).then(response => response.data)
clientSecret = setupIntent.client_secret;
})();
</script>
@endsection
登錄后復(fù)制
在上面的代碼中,我們使用了Stripe.js來(lái)構(gòu)建一個(gè)簡(jiǎn)單的訂閱表單。我們通過(guò)使用Stripe.js中的create()方法創(chuàng)建一個(gè)card元素,然后將其掛載到#card-element div中。這里我們還使用了axios來(lái)處理POST請(qǐng)求,其中包含訂閱計(jì)劃信息和付款信息。如果付款被成功處理,我們將重定向用戶到成功頁(yè)面。
現(xiàn)在,我們需要添加存儲(chǔ)用戶付款信息和創(chuàng)建訂閱邏輯的存儲(chǔ)庫(kù)。
<?php
namespace AppRepositories;
use AppSubscriber;
use IlluminateSupportFacadesConfig;
use LaravelCashierExceptionsPaymentActionRequired;
use LaravelCashierExceptionsPaymentFailure;
use LaravelCashierSubscription;
use StripeStripe;
class SubscriberRepository
{
public function createFromRequest(array $data)
{
$subscriber = Subscriber::create([
'name' => $data['name'],
'email' => $data['email'],
'password' => bcrypt($data['password']),
]);
$subscriber->createAsStripeCustomer([
'name' => $subscriber->name,
'email' => $subscriber->email,
]);
return $subscriber;
}
public function subscribe(Subscriber $subscriber, string $plan, string $paymentMethod)
{
$subscriber->newSubscription('main', $plan)->create($paymentMethod, [
'email' => $subscriber->email,
]);
}
}
登錄后復(fù)制
在上面的代碼中,我們創(chuàng)建了一個(gè)SubscriberRepository類,用于存儲(chǔ)用戶信息和創(chuàng)建訂閱。在我們的createFromRequest()方法中,我們將創(chuàng)建一個(gè)新的Stripe Customer,然后將其相關(guān)信息存儲(chǔ)到我們的Subscriber模型中。在subscribe()方法中,我們使用Laravel Cashier的newSubscription()函數(shù)來(lái)為用戶創(chuàng)建新的訂閱。
步驟7:處理訂閱回調(diào)
在訂閱回調(diào)中,我們需要更新用戶訂閱的當(dāng)前狀態(tài)。如果訂閱被取消或期滿,我們需要根據(jù)需要取消或恢復(fù)用戶訂閱。
在SubscriptionController中添加以下方法:
public function store(Request $request, SubscriberRepository $subscriberRepository)
{
$paymentMethod = $request->input('payment_method');
$plan = $request->input('plan');
$subscriberRepository->subscribe(
$request->user(),
$plan,
$paymentMethod
);
return response()->json([
'success_url' => route('subscribe.invoice'),
]);
}
public function cancel(Request $request)
{
$request->user()->subscription('main')->cancel();
return redirect()->route('subscribe.index')
->with('success', 'Your subscription has been cancelled.');
}
public function resume(Request $request)
{
$request->user()->subscription('main')->resume();
return redirect()->route('subscribe.index')
->with('success', 'Your subscription has been resumed.');
}
public function invoice(Request $request)
{
$invoice = $request->user()->invoices()->latest()->first();
return view('subscription.invoice', [
'invoice' => $invoice,
]);
}
登錄后復(fù)制
在上面的代碼中,我們處理了創(chuàng)建新的訂閱,取消/恢復(fù)用戶訂閱,并顯示訂閱的最新發(fā)票。
現(xiàn)在,我們已經(jīng)成功地使用Laravel Cashier實(shí)現(xiàn)了訂閱功能,并可以讓用戶創(chuàng)建和管理其訂閱了!
以上就是Laravel開(kāi)發(fā):如何使用Laravel Cashier實(shí)現(xiàn)訂閱功能?的詳細(xì)內(nèi)容,更多請(qǐng)關(guān)注www.xfxf.net其它相關(guān)文章!






