pharaonic / laravel-localization
Localized routing for Laravel: static locale-prefixed URLs for websites, and an ordered resolver pipeline for APIs.
13.0.0
2026-11-19 07:00 UTC
Requires
- php: >=8.3 <8.6
- ext-intl: *
- illuminate/console: ^13.0
- illuminate/container: ^13.0
- illuminate/contracts: ^13.0
- illuminate/http: ^13.0
- illuminate/routing: ^13.0
- illuminate/support: ^13.0
Requires (Dev)
- laravel/pint: ^1.20
- orchestra/testbench: ^11.0
- pestphp/pest: ^4.0
- phpstan/phpstan: ^2.1.33
- phpunit/phpunit: ^12.5.8
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-19 07:08:58 UTC
README
Localized routing for Laravel: static locale-prefixed URLs for websites, and an ordered resolver pipeline for APIs.
Installation
composer require pharaonic/laravel-localization
The service provider is registered automatically. Publish the configuration when you need to change it:
php artisan vendor:publish --tag=localization-config
Usage
use App\Http\Controllers\ApiProductController; use App\Http\Controllers\ProductController; // config/pharaonic/localization.php: 'supported' => ['en', 'ar', 'fr'], with app.locale = 'en' Route::localized(function (): void { Route::get('/products', [ProductController::class, 'index'])->name('products.index'); }); // /products (en), /ar/products, /fr/products; /en/products redirects to /products Route::middleware('localization')->get('/api/products', [ApiProductController::class, 'index']); // The locale comes from the user's preferredLocale(), then Accept-Language, then app.locale locale()->route('products.index', locale: 'ar'); // "https://example.com/ar/products"
Upgrading from 1.x? See UPGRADING.md.
Documentation
Full documentation: Laravel Localization Documentation.
Support & Security
See SUPPORT.md and SECURITY.md. Contributions are welcome; see CONTRIBUTING.md.
License
MIT. See LICENSE.
