Weave Code
Kanuu Laravel Laravel Package
kanuu-io/kanuu-laravel
Official Laravel integration for Kanuu, a hosted customer portal for SaaS billing. Quickly let customers manage subscriptions, update payment details, and view invoices. The package provides simple configuration, routes, and helpers for connecting your Laravel app to Kanuu and Stripe.
A Laravel package to quickly integrate with Kanuu
Frequently asked questions about Kanuu Laravel
- What is kanuu-io/kanuu-laravel used for?
- It is the official Laravel integration for Kanuu, a hosted customer portal for SaaS billing. It connects a Laravel app to Kanuu and Stripe so customers can manage subscriptions, update payment details, and view invoices. Use it when you want Kanuu's hosted portal rather than building billing management screens yourself.
- How do I install kanuu-io/kanuu-laravel?
- Install it with Composer using composer require kanuu-io/kanuu-laravel. Laravel package discovery should register the service provider automatically; if you disable discovery, register it manually. Then publish and configure the package config as described in the package documentation, and check that your app meets the PHP and Laravel version constraints.
- How do I configure Kanuu in a Laravel app?
- Configuration is handled through the package config and helpers that connect your Laravel app to Kanuu and Stripe. Publish the package config, add your Kanuu and Stripe credentials and portal settings, and keep secrets in the environment rather than in version control. Review the package routes and helpers so your customer model and billing flow line up with Kanuu's hosted portal.
- Which Laravel and PHP versions does kanuu-laravel support?
- Based on the v1.0.0 release notes, treat the floor as PHP 8.0+ and Laravel 8+, with Laravel 9 and PHP 8.1 as the tested frontier. Laravel 7 and PHP 7.4 are explicitly excluded by the 1.0.0 constraints. Confirm the exact composer.json constraints for your target version before rollout.
- Can I use kanuu-laravel with Laravel 7 or PHP 7.4?
- No. The v1.0.0 release removes Laravel 7 and PHP 7.4 support, so Composer will refuse to resolve the package on those versions. This is a hard gate, not a soft deprecation. Upgrade PHP and Laravel first, verify the app is green, then add the package.
- Does kanuu-laravel support Laravel 10, Laravel 11, PHP 8.2, or PHP 8.3?
- The release notes do not state a support ceiling for Laravel 10/11 or PHP 8.2/8.3. Only Laravel 9 and PHP 8.1 are confirmed as the tested frontier. If a framework upgrade is on your roadmap, get a maintainer statement or defer adoption until compatibility is verified.
- Is upgrading from a pre-1.0 version of kanuu-laravel safe?
- The 1.0.0 tag is a semver stability promise, but it can also be a breaking change for anyone on dev-main or 0.x. The release note does not reference an upgrade guide, so pin ^1.0 and diff against your currently resolved commit. Expect possible config or API renames and budget remediation for a small integration.
- Is kanuu-laravel production-ready and actively maintained?
- A 1.0.0 tag is a good production signal because it freezes the public API, config keys, and published assets until 2.0. Maintenance risk is moderate: verify the CHANGELOG, release cadence, CI matrix, and test coverage in the repository. The maintainer and bus-factor profile are not described in the release note, so check the GitHub activity before a critical rollout.
- How should I test kanuu-laravel before rolling it out?
- Pilot it in one non-critical Laravel service on the newest confirmed combination, Laravel 9 with PHP 8.1. Exercise the routes, helpers, and billing flows in a staging Kanuu setup before production. Then roll to other services only after a full release cycle with no regressions.
- What are alternatives to kanuu-laravel for Laravel SaaS billing?
- Kanuu is a hosted customer portal, so the main alternative is building or using a billing portal directly with Stripe, often alongside Laravel Cashier. Laravel Cashier gives you Stripe subscription primitives in Laravel, while Stripe's own customer portal can handle payment details and invoices. Choose Kanuu if you want a hosted portal with a simple Laravel integration; choose Cashier if you need deeper in-app billing control.
Weaver
How can I help you explore Laravel packages today?