Weave Code
Laravel Short Url Laravel Package
pharaonic/laravel-short-url
pharaonic/laravel-short-url is a Laravel package for generating and managing short URLs. It creates compact links with redirect handling and a simple, configurable API, making it easy to add URL shortening to any Laravel application.
pharaonic/laravel-short-url is a lightweight Laravel package for creating and managing shortened URLs. It provides an Eloquent model, configurable route prefix, and redirect handling out of the box, letting you generate short links for any destination with minimal setup.
- Generate unique short codes for long URLs
- Customizable keys and route prefix
- Built-in redirect controller and model
- Configurable via a single config file
- Simple integration with existing Laravel apps
Frequently asked questions about Laravel Short Url
- How do I install pharaonic/laravel-short-url in a Laravel app?
- Install it with Composer, publish the package config, add your short URL provider credentials to your environment file, then publish and run the migrations. Release 2.0.2 specifically fixes the migrations path on publish, so use that patch level or later when following the install steps.
- Which Laravel and PHP versions does pharaonic/laravel-short-url support?
- The package is described as Laravel-idiomatic and conforms to framework conventions such as service provider auto-discovery. The provided context does not list a supported Laravel or PHP version matrix, so check composer.json and the README before adopting.
- Do I need to publish the migrations before using the ShortUrl model?
- The package ships an Eloquent ShortUrl model plus a migration, and the 2.0.2 patch corrected the migrations path on publish. The provided context does not confirm whether migrations auto-load via loadMigrationsFrom or require vendor:publish, so verify that behavior for your pinned version before running migrate.
- How does pharaonic/laravel-short-url generate short links?
- It exposes a Laravel facade that delegates shortening to third-party providers, with provider credentials supplied through config and environment variables. The package stores the resulting foreign identifier and URL in an Eloquent-backed ShortUrl record rather than owning the redirect infrastructure itself.
- Does the package handle redirects for short URLs?
- It includes simple redirect handling and customizable routes, but the actual resolution of links issued by a third-party provider happens on that provider's infrastructure. The package does not own the redirect path for provider-issued links, so liveness and redirect policy remain provider decisions.
- What are the production risks of using pharaonic/laravel-short-url?
- The main risk is provider dependency: rate limits, free-tier changes, API deprecations, and credential rotation all sit on the link-creation path and are outside your control. Link permanence is also a concern because previously issued short links remain tied to the provider you used, making later provider migration effectively irreversible.
- Can I plug in a custom short URL provider or an in-house shortener?
- The provided assessment does not verify whether the package exposes a driver or manager extension point versus hardcoding provider selection per method. Confirm that abstraction before committing, because it determines whether you can contain provider lock-in with a custom driver or need to wrap the facade.
- Does ShortUrl support multi-tenant ownership or attribution?
- The context does not confirm whether the ShortUrl table is flat or includes a polymorphic owner or associator, which matters for multi-tenant and attribution reporting. Inspect the published migration and model, and add your own association if the package does not provide one.
- How should I test short URL generation without calling a real provider API?
- No test helper or fake provider is described in the provided context, so avoid using real provider credentials in tests. Mock outbound HTTP calls to the provider or bind a fake implementation if the package exposes a manager or driver abstraction; otherwise wrap the facade behind your own service boundary.
- Is pharaonic/laravel-short-url actively maintained, and what license does it use?
- The assessment flags a single-maintainer bus factor and patch-level churn on the install path, including the 2.0.2 migrations-path fix. The provided context does not state the license or issue-response history, so check the repository and pin a reviewed version before production use.
Weaver
How can I help you explore Laravel packages today?