Mitgliedschaften mit Laravel -Kassierer

In diesem Tutorial werden wir sehen, wie einfach es ist, eine grundlegende gezahlte Mitgliedschaftswebsite mit dem Laravel Cashier -Paket zu erstellen. Sie können hier eine Demo der App sehen und den Quellcode hier herunterladen.

Key Takeaways

• Laravel Cassier vereinfacht die Erstellung einer basischen bezahlten Mitgliedschaftswebsite, indem sie Abonnement -Abrechnungen verwaltet, Gutscheine bearbeiten, Abonnements ausgetauscht haben, Zeiträume von Stornierungen und Rechnungen pdfs generieren.
• Um Laravel Cashier in ein vorhandenes Laravel -Projekt zu integrieren, das Paket über den Komponisten zu installieren, eine Migration auszuführen, um die erforderlichen Spalten in die Tabelle der Benutzer hinzuzufügen, API -Schlüssel einrichten und das Modell des Modells abzusetzen.
• Laravel -Kassierer kann fehlgeschlagene Zahlungen erledigen, indem die Zahlung automatisch erneut abgerufen wird. Wenn die Zahlung weiter fehlschlägt, wird das Abonnement storniert.
• Laravel Cassier unterstützt derzeit nur Stripe und Braintree, kann aber für die Zusammenarbeit mit anderen Zahlungsgateways mit einem guten Verständnis von Laravel und der API des Zahlungsgateways erweitert werden.

Einrichten einer Arbeitsumgebung

Wir müssen ein Boilreplat -Projekt erstellen, um loszulegen, und wir können dies auf zwei verschiedene Arten tun:

• wir können das Github -Repo in unseren Projektordner klonen.
• unter der Annahme, dass Sie Komponist installiert haben (Weitere Einzelheiten finden Sie in der Installationshandbuch).
  Wir führen Composer Create-Project Laravel/Laravel Laravel_Membership-Prefer-Dist aus. Dies erstellt ein Laravel-Boilerplate-Projekt in unserem Ordner laravel_mitmbership.

Jetzt müssen wir das Laravel -Kassierer -Paket zum Projekt verlangen, indem wir "Laravel/Cashier" hinzuzufügen: "~ 1.0" zu unserem Composer.json im Abschnitt des Forderns und führen Sie den Komponisten -Update aus, um unsere Abhängigkeiten zu aktualisieren.

Danach müssen wir unsere App sagen, dass sie die Kassierer -Dienstleisterklasse laden soll. Wir können dies tun, indem wir dem Anbieterarray in der Datei config/app.php "laravelcashiercashierserviceProvider" hinzufügen.

Hinweis: Sie müssen den Komponisten-Dump-Autoload ausführen, um das ClassMap-Paket zu aktualisieren.

Erstellen der Datenbank mit Migrationen

Wenn Sie bei Laravel -Migrationen neu sind, überprüfen Sie die Dokumentation.
Wir werden zwei Tabellen verwenden:

Beiträge Tabelle:
- int id
- String -Titel
- long_text content
- bool is_premium

Benutzer Tabelle:
- int id
- Varchar (60) E -Mail
- Varchar (60) Passwort

Das Befehlszeilen -Tool von Laravel Artisan erleichtert es einfach, Migrationsklassen zu erstellen und zu verwalten.

<span>php artisan migrate:make create_posts_table --create="posts"
</span><span>
</span><span>php artisan migrate:make create_users_table --create="users"</span>

Und dann füllen wir das Schema :: Callback -Funktionsargument mit dem erforderlichen Code erstellen, der so aussieht

<span>Schema::create('posts', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('title');
</span><span>    $table->longText('content');
</span><span>    $table->boolean("is_premium");
</span><span>    $table->timestamps();
</span><span>});
</span><span>
</span><span>Schema::create('users', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('email', 100)->unique();
</span><span>    $table->string('password', 60);
</span><span>    $table->timestamps();
</span><span>});</span>

Um Laravel Cassier über unsere abrechnungsfähige Tabelle zu informieren, müssen wir dafür eine bestimmte Migration erstellen. Laravel Cassier hat zu diesem Zweck einen integrierten Befehl.

<span>php artisan cashier:table users</span>

Jetzt sind wir bereit, unsere Datenbank zu migrieren

<span>php artisan migrate:make create_posts_table --create="posts"
</span><span>
</span><span>php artisan migrate:make create_users_table --create="users"</span>

Wenn Sie Ihre Benutzertabelle öffnen, wird eine Reihe von Feldern angezeigt, die bei Ausführung der Paketmigration hinzugefügt werden.
- STRIPE_ACTIVE, wenn Sie ein aktives Abonnement haben.
- Stripe_id -Benutzer -ID auf Stripe Server.
- Stripe_Plan Stripe -Abonnementplan.
- LEST_FOUR -Kreditkarte Letzte vier Ziffern.
- trial_ends_at Ein Enddatum wird gespeichert, wenn Sie einen Testzeitraum angeben.
- Abonnements -Abonnement -Enddatum.

Jetzt werden wir die Datenbank mit einigen Dummy -Daten säen, um loszulegen. Überprüfen Sie das Endergebnis auf GitHub.

Stripe -Abrechnungsprozess

Umgang mit der Zahlung kann ein Schmerz im Nacken sein, und Stripe kann Ihnen dabei helfen, sie verwenden Token anstelle von Kartennummern usw., und so können Sie sicherstellen, dass Ihre Kunden sicher bleiben, während Sie Ihren Service bezahlen .

Hinweis: Überprüfen Sie, ob Stripe in Ihrem Land unterstützt wird. Sie können ihn jedoch weiterhin zum Testen verwenden, wenn nicht.

Um loszulegen, müssen wir zuerst ein Konto erhalten. Stripe hat keine monatliche Gebühr für das Abonnement. Sie zahlen nur, wenn Sie bezahlt werden.

Nachdem Sie ein Konto erhalten haben, müssen Sie Pläne für Ihre Bewerbung erstellen (monatlich, jährlich, Silber, Gold…).

Jedes Feld ist selbsterklärend. Erstellen Sie also eine Goldmitgliedschaft, die 40 US -Dollar und eine grundlegende Mitgliedschaft für 10 US -Dollar kosten. Sie werden jeden Monat in Rechnung gestellt.

Wir haben bereits die erforderlichen Spalten zu unserer Benutzertabelle hinzugefügt. Jetzt müssen wir Laravel Cassier wissen lassen, dass wir die Benutzerklasse als Abrechnungsklasse verwenden werden.

<span>Schema::create('posts', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('title');
</span><span>    $table->longText('content');
</span><span>    $table->boolean("is_premium");
</span><span>    $table->timestamps();
</span><span>});
</span><span>
</span><span>Schema::create('users', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('email', 100)->unique();
</span><span>    $table->string('password', 60);
</span><span>    $table->timestamps();
</span><span>});</span>

Hinweis: Wir verwenden Billabletrait und Merkmale erfordern PHP 5,4 oder höher.

Jetzt müssen wir unseren Stripe -API -Zugriffstast

Durch die Verwendung der Billabletrait erhalten wir Zugriff auf die Methode :: setStripekey (Schlüssel), die in unserem Code überall aufgerufen werden kann. Die bevorzugte Möglichkeit besteht jedoch darin, eine Dienste.Php -Datei unter Ihrem Konfigurationsverzeichnis zu erstellen und ein Array wie möglich zurückzugeben. Dies:

<span>php artisan cashier:table users</span>

Wenn GetStripeKey versucht, Ihren Schlüssel zu laden, wird nach einer Eigenschaft namens Stripekey gesucht. Wenn nicht gefunden, lädt es automatisch Ihre Dienstedatei.

Erstellen unserer Seiten

Um die Dinge einfach zu halten, werden wir nur ein paar Seiten erstellen:

- Anmeldung: Wenn der Benutzer einen Mitgliedschaftsplan (Basic, Gold) anmelden kann.
- Login: Mitglieder Anmeldeseite.
- Upgrade: Upgrade von Basic auf Gold -Mitgliedschaft.
- Beitrag: Zeigen Sie eine einzelne Beitragsseite an.

Um den Prozess zu beschleunigen, verwenden wir Bootsnipp. Sie können den endgültigen Code vom Github Repo erhalten.

Anmeldeseite:

Die Anmeldeseite verfügt über ein grundlegendes Feld für E -Mail- und Kennwort mit einer Logincontroller -Seite, die so aussieht:

<span>php artisan migrate:make create_posts_table --create="posts"
</span><span>
</span><span>php artisan migrate:make create_users_table --create="users"</span>

Anmeldeseite:

Auf der Anmeldeseite verfügt über ein Abonnementplanfeld, mit dem ein Benutzer planen.
Wir haben auch eine Kreditkartennummer, Ablaufdatum, cvc.

Wie bereits erwähnt, müssen wir uns niemals mit Zahlungs- oder Überprüfungsprozess befassen. Wir geben diese Werte an den Stripe -Server weiter, um den Lade- und Überprüfungsprozess zu kümmern.
Der Rückgabewert ist ein Token im Erfolgsfall, da wir sonst eine Fehlermeldung erhalten, die wir dem Benutzer anzeigen können.

Mal sehen, wie der Front-End-Code aussieht:

<span>Schema::create('posts', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('title');
</span><span>    $table->longText('content');
</span><span>    $table->boolean("is_premium");
</span><span>    $table->timestamps();
</span><span>});
</span><span>
</span><span>Schema::create('users', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('email', 100)->unique();
</span><span>    $table->string('password', 60);
</span><span>    $table->timestamps();
</span><span>});</span>

Zuerst schließen wir die JavaScript -API -Datei ein, dann setzen wir unseren öffentlichen Schlüssel, den wir aus unseren Stripe Dashboard -Einstellungen gepackt haben.

Als nächstes fügen wir unserem Sendenformular eine Rückruffunktion hinzu (stellen Sie sicher, dass Ihre Formular -ID mit der auf dem Ereignishandler verwendeten Funktionen entspricht), um eine doppelte Einreichung zu verhindern, dass wir unsere Sendetaste deaktivieren.
Die Stripe.card.CreateToken akzeptiert zwei Argumente, das erste ist ein JSON -Objekt, das einige erforderliche und optionale Werte enthält.

Erforderliche Werte:

• Nummer: Kartennummer als Zeichenfolge ohne Trennzeichen.
• exp_month: Zweistellige Nummer, die den Ablaufmonat der Karte darstellt.
• exp_year: zwei oder vierstellige Nummer, die das Ablaufjahr der Karte darstellt.

Optionale Werte:

• CVC: Kartensicherheitscode Als Zeichenfolge ist die CVC -Nummer optional, aber empfohlen, Betrug zu verhindern.
• Name: Karteninhaber Name.
• adress_line1: Abriebadressenzeile 1.
• adress_line2: Abriebadressenzeile 2.
• adress_city: Abrechnungsadresse Stadt.
• adress_state: Abrechnungsadressenstatus.
• adress_zip: Rechnungsschleifer als Zeichenfolge.
• adress_country: Rechnungsadresse Land.
  Sie können feststellen, dass wir ein Formularobjekt anstelle eines JSON-Objekts übergeben. Sie können die Werte manuell erfassen oder das HTML5-Attribut für Datenstreifen für Ihre Eingänge verwenden, und Stripe verwendet einige Helfermethoden, um diese Werte automatisch für Sie zu greifen . Ex:

<span>php artisan cashier:table users</span>

Das zweite Argument, das an Stripe.card.CreateToken -Methode übergeben wurde, ist eine Rückruffunktion, um die Antwort zu verarbeiten.

Bei Ausfall wird der StripersponseHandler versucht, ein Element mit einer Klasse von Payment_errors zu finden, um dem Benutzer einige beschreibende Fehler anzuzeigen.
Im Erfolg wird eine Stripetoken -versteckte Eingabe an das Formular angehängt und ist bei Senden verfügbar.

Zusätzliche Optionen

• Testzeiträume: Wie bereits erwähnt, haben Sie, wenn Sie einen neuen Plan erstellen
Coupons: Sie erstellen Gutscheine über Ihr Dashboard -Menü, in dem Sie einen festen Betrag oder nach Prozentsatz mit einigen anderen nützlichen Optionen angeben können.

Lassen Sie uns nun zu unserem SignUpController wechseln, um zu sehen, wie wir damit umgehen werden.

<span>php artisan migrate:make create_posts_table --create="posts"
</span><span>
</span><span>php artisan migrate:make create_users_table --create="users"</span>

wir werden den Validierungsprozess überspringen, um die Dinge einfach zu halten.

Nachdem wir einen neuen Benutzer erstellt und gespeichert haben, haben wir jetzt die Möglichkeit, den Benutzer für einen neuen Mitgliedschaftsplan zu abonnieren. Die Abonnementmethode akzeptiert einen bereits registrierten Plan als Argument, der entweder ein Planinterface oder eine Zeichenfolge sein kann und eine Stripegateway zurückgibt.
Die Methode erstellen akzeptiert ein Token als Parameter. Wir übergeben den neuen versteckten Eingangswert mit dem Namen Stripetoken.

Upgrade -Seite:

Die Upgrade -Seite wird dem UpgradeController übermittelt, der so aussieht:

<span>Schema::create('posts', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('title');
</span><span>    $table->longText('content');
</span><span>    $table->boolean("is_premium");
</span><span>    $table->timestamps();
</span><span>});
</span><span>
</span><span>Schema::create('users', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('email', 100)->unique();
</span><span>    $table->string('password', 60);
</span><span>    $table->timestamps();
</span><span>});</span>

Wir überprüfen, ob der Benutzer zuerst angemeldet ist, dann erstellen wir ein neues Abonnement mit dem neuen Plan und nennen die Swap -Methode, offensichtlich in einem echten Projekt haben Sie einige Gebührenanpassungen und eine Downgrade -Option, aber es sollte funktionieren, aber es sollte funktionieren, aber es sollte funktionieren genauso.

Post Seite:

Der Postcontroller prüft, ob der Beitrag IS_PREMIUM, und wenn ja, testen wir, ob der Benutzer ein Goldmitglied ist, das den Beitrag sehen kann. Andernfalls geben wir eine einfache Fehlermeldung zurück.

<span>php artisan cashier:table users</span>

Natürlich müssen wir in unserer Datei routes.php einen Auth -Filter hinzufügen, um zu verhindern, dass nicht authentifizierte Benutzer auf die Seite zugreifen.
Unsere Routes -Datei sieht folgendermaßen aus:

<span>php artisan migrate</span>

Andere nützliche Methoden

• withcoupon: Wir haben vorher gesagt, dass wir die Möglichkeit haben, Rabatt -Gutscheine zu erstellen. In unserem Beispiel können wir das wie so tun:

<span>use Laravel\Cashier\BillableInterface;
</span><span>use Laravel\Cashier\BillableTrait;
</span><span>
</span><span>class User extends Eloquent implements BillableInterface {
</span><span>
</span><span>    use BillableTrait;
</span><span>    protected $dates = ['trial_ends_at', 'subscription_ends_at'];</span>

• Abbrechen: Sie können ein Abonnement mit dieser Methode problemlos abbrechen. Sie müssen jedoch überprüfen, ob der Benutzer Ongraceperiod ist, um sicherzustellen, dass Sie sie nicht sofort blockieren:

<span>return [
</span><span>    'stripe' => [
</span><span>            'secret'    => 'Your key'
</span><span>        ]
</span><span>];</span>

• Onplan: Sehen Sie, ob ein Benutzer in einem bestimmten Plan ist.
• onTrial: Sehen Sie, ob ein Benutzer noch in der Versuchsperiode.
• Storniert: Wenn der Benutzer sein Abonnement storniert hat.
• getLastfourcardDigits: Holen Sie sich die Benutzerkarte letzte vier Ziffern.
• GetubscriptionendDate: Holen Sie sich das Abonnement -Enddatum.
• GetTRIALENDDATE: Erhalten Sie das Testdatum des Tests.
• Rechnungen: Holen Sie sich die Liste der Benutzerrechnungen.
• FindInvoice: Finden Sie eine Rechnung mit id.
• DownloadInvoice: Generieren Sie eine herunterladbare Rechnung mit ID.

Schlussfolgerung

In diesem Tutorial haben wir untersucht, wie Laravel Cassier den Abrechnungsprozess erleichtern und Ihre Kunden leichter verwalten kann.

Wir haben hier sicherlich nicht alles behandelt, aber es ist ein Anfang für Sie, sich in den Quellcode zu befassen, um zu untersuchen, was Sie sonst noch tun können. Wenn Sie eine lachdos veranstaltete Demo dieser App sehen möchten, siehe hier.

häufig gestellte Fragen (FAQs) zu Laravel Casier Mitgliedschaften

Wie behandelt Laravel Cashier die Abonnement -Abrechnung? Es bietet eine ausdrucksstarke, fließende Schnittstelle zu den Abonnement -Billing -Diensten von Stripe und Braintree. Es behandelt fast den gesamten Boilerplate -Abonnement -Abrechnungscode, den Sie schreiben. Laravel Cassier kann Gutscheine, Swapping -Abonnement, Abonnement „Mengen“, Stornierungs -Gnade -Perioden und sogar Rechnungen PDFs erzeugen. 'LL muss ein Stripe -Konto erstellen und das Kassierer -Paket über Komponist installieren. Sie müssen Ihre Modelldefinition auch das abgebrägerliche Merkmal hinzufügen - dieses Merkmal bietet verschiedene Methoden, mit denen Sie gemeinsame Abrechnungsaufgaben ausführen können, z. Ich integriere Laravel -Kassierer in mein vorhandenes Laravel -Projekt? Zunächst müssen Sie das Paket über den Komponisten installieren. Anschließend müssen Sie die Datenbank vorbereiten, indem Sie eine Migration ausführen, in der die Tabelle der Benutzer mehrere Spalten hinzufügt. Danach müssen Sie die API -Schlüssel einrichten und Ihrem Modell das abgebrochene Merkmal hinzufügen. Schließlich können Sie die verschiedenen Methoden verwenden, die das Rechnungsabkommen zur Verwaltung Ihrer Abonnements zur Verfügung stellt. Wenn eine Zahlung fehlschlägt, wird die Zahlung automatisch wiederholt. Wenn die Zahlung weiter fehlschlägt, wird das Abonnement storniert. Sie können diese Ereignisse jedoch auch manuell übernehmen, indem Sie auf die relevanten Ereignisse zuhören und geeignete Maßnahmen ergreifen. Braintree. Sie können jedoch Kassierer für die Zusammenarbeit mit anderen Zahlungsgateways verlängern, wenn Sie dies wünschen. Dies würde ein gutes Verständnis für Laravel- und die API des Payment Gateway erfordern. . Wenn ein Abonnement storniert wird, setzt Kassierer automatisch das Enddatum des Abonnements auf das Ende des aktuellen Abrechnungszyklus. Unterstützt Probezeiten. Sie können den Testzeitraum beim Erstellen des Abonnements festlegen. Der Benutzer wird erst in Rechnung gestellt, bis die Testzeit beendet ist.

Wie kann ich Rechnungen mit Laravel -Kassierer generieren? Sie können auf die herunterladbare PDF -Version der Rechnung zugreifen, indem Sie die Download -Methode in einer Rechnungsinstanz aufrufen, mit der die PDF auf Festplatte geschrieben oder in den Browser streamen.

Ja, Laravel Cashier unterstützt die Anwendung von Gutscheinen auf Abonnements. Sie können dies tun, indem Sie die Withcoupon -Methode beim Erstellen eines neuen Abonnements verwenden. für Abonnements vom Typ "pro Sitz". Sie können die Menge eines Abonnements mit der Updatequantity -Methode auf einer Abonnementinstanz aktualisieren.

Das obige ist der detaillierte Inhalt vonMitgliedschaften mit Laravel -Kassierer. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!