Commandes CLI
cashier:install
Installe la configuration minimale du bundle dans un projet Symfony.
php bin/console cashier:installEffets:
- crée les fichiers de config manquants
- crée les variables Stripe manquantes dans
.env - crée
var/dataetvar/data/invoices - n’écrase pas les fichiers existants
Option
php bin/console cashier:install --env-file=.env.localcashier:webhook
Crée ou met à jour un endpoint webhook côté Stripe.
php bin/console cashier:webhook --url=https://example.com/cashier/webhookOptions utiles:
--disabled--api-version--show-secret
cashier:webhook:listen
Ouvre un listener Stripe CLI local.
php bin/console cashier:webhook:listen --forward-to=http://127.0.0.1:8000/cashier/webhookOu avec --base-url pour construire automatiquement l’URL :
php bin/console cashier:webhook:listen --forward-to --base-url http://localhost:8000Note : La Stripe CLI doit être installée localement.
Cette commande sert à:
- forwarder les événements Stripe vers votre app locale
- récupérer et persister le secret
whsec_... - lire visuellement les réponses HTTP grâce aux couleurs console
Événements Stripe enregistrés par défaut
La commande cashier:webhook crée un webhook avec les événements suivants:
customer.subscription.createdcustomer.subscription.updatedcustomer.subscription.deletedcustomer.deletedinvoice.payment_succeededinvoice.payment_failedinvoice.payment_action_requiredcheckout.session.completedcheckout.session.expiredpayment_intent.succeededpayment_intent.payment_failedpayment_method.updated
cashier:report-usage
Rapporte l’usage d’un SubscriptionItem metered.
# 1 = ID local (clé primaire) de l'entité SubscriptionItem en base
# 100 = quantité d'usage à déclarer
php bin/console cashier:report-usage 1 100
# Pour définir une valeur absolue plutôt qu'incrémenter
php bin/console cashier:report-usage 1 100 --action=setcashier:cleanup-sessions
Avertissement : Cette commande nécessite l’entité
CheckoutSessionqui n’est pas implémentée dans cette version.
php bin/console cashier:cleanup-sessionsCommande placeholder pour nettoyer les sessions Checkout expirées.
Commande officielle d’init
Tant qu’une recipe Flex publiée n’est pas la voie canonique dans votre distribution, considérez cashier:install comme la commande officielle de bootstrap du bundle.