Download the PHP package rawnoq/laravel-locale-detector without Composer

Laravel Locale Detector

A professional Laravel package for automatic locale detection from HTTP headers and translation key extraction from your codebase.

📋 Table of Contents

• Features
• Requirements
• Installation
• Configuration
• Usage
• Translation Key Extraction
• Translatable Models
• Advanced Usage
• Testing
• License

✨ Features

• ✅ Automatic Locale Detection - Automatically detects user's preferred language from Accept-Language header
• ✅ Translation Key Extraction - Extract all translation keys from your codebase
• ✅ Multiple Detection Methods - Supports Laravel's getPreferredLanguage() and direct header parsing
• ✅ Configurable Supported Locales - Define which locales your application supports
• ✅ Global Middleware - Automatically registered middleware for seamless integration
• ✅ Multiple Output Formats - Export translation keys as JSON, PHP, or array format
• ✅ Namespace Filtering - Filter translation keys by namespace
• ✅ Exclude Paths - Exclude specific directories from key extraction
• ✅ Translation Key Synchronization - Sync translation keys to language files automatically
• ✅ 40+ Language Files - Includes translation files for auth, pagination, passwords, and validation in 40+ languages
• ✅ Translatable Models - Wrapper for Astrotomic Translatable with additional helper methods
• ✅ Database Migrations - Helper traits and classes for creating translation tables
• ✅ Translation Format Converter - Convert between attribute-based and locale-based translation formats

📦 Requirements

• PHP 8.2 or higher
• Laravel 11.0+ or Laravel 12.0+

🚀 Installation

Step 1: Install via Composer

The package will be automatically discovered and registered by Laravel.

Step 2: Publish Configuration (Optional)

This will publish the configuration file to config/locale-detector.php.

Step 3: Publish Language Files (Optional)

This will publish language files to lang/ directory. The package includes translation files for 40+ languages (auth, pagination, passwords, validation).

⚙️ Configuration

The configuration file is located at config/locale-detector.php:

Environment Variables

You can configure the package using environment variables in your .env file:

🎯 Usage

Automatic Locale Detection

The middleware automatically detects the user's preferred language from the Accept-Language header and sets the application locale accordingly.

No additional code required! The middleware is automatically registered and works out of the box.

Manual Locale Setting

You can still manually set the locale in your code:

Accessing Current Locale

🔍 Translation Key Extraction

The package provides a powerful command to extract all translation keys from your codebase.

Basic Usage

Options

Examples

Extract Keys from App Directory

Extract Keys and Save to File

Extract Keys in PHP Format

Exclude Vendor and Storage Directories

Filter Keys by Namespace

This will only extract keys that start with blog::.

Extract Keys with Location Information

This will extract keys with file path and line number information. The output will include:

• key: The translation key
• file: The relative file path
• line: The line number where the key was found
• location: A formatted string like file:line
• locations: An array of all locations where the key appears (if the same key appears multiple times)

Example output:

Supported Translation Patterns

The command extracts keys from the following patterns:

• __('key') - Laravel's translation helper
• trans('key') - Translation function
• @lang('key') - Blade directive
• Lang::get('key') - Lang facade method
• Lang::trans('key') - Lang facade trans method
• trans_choice('key', ...) - Translation choice function
• __('namespace::key') - Namespaced translations
• trans('namespace::key') - Namespaced translations

Output Formats

JSON Format

PHP Format

Array Format

🌐 Translatable Models

The package provides a wrapper for Astrotomic Translatable with additional helper methods and utilities.

Using the Translatable Trait

Creating Models with Translations

Converting Translation Formats

The package provides helper functions to convert between different translation formats:

Using Helper Functions

Using Model Methods

Database Migrations with Translations

The package provides helper traits and classes for creating translation tables:

Using MigrationWithTranslations

Using the Trait Directly

Using UUID for Foreign Keys

🎓 Advanced Usage

Custom Locale Detection

You can customize the locale detection logic by modifying the middleware or creating your own:

Integration with HMVC Modules

If you're using the rawnoq/laravel-hmvc package, you can extract translation keys from modules:

Automated Translation Key Management

You can create a script to automatically extract and update translation files:

🔧 Troubleshooting

Middleware Not Working

If locale detection is not working:

1. Check if middleware is registered: php artisan route:list
2. Verify configuration: php artisan config:show locale-detector
3. Check Accept-Language header in requests
4. Ensure supported locales are configured correctly

Translation Keys Not Found

If the extraction command finds no keys:

1. Verify the path contains PHP files
2. Check if translation functions are used correctly
3. Ensure files are readable
4. Check excluded paths

Command Not Found

If locale:extract-keys command is not found:

1. Run php artisan package:discover
2. Clear cache: php artisan optimize:clear
3. Verify Service Provider is registered

📝 Examples

Example 1: Extract All Keys

Example 2: Extract from Specific Path

Example 3: Extract and Save to File

Example 4: Extract with Exclusions

Example 5: Extract Namespaced Keys Only

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

🧪 Testing

The package comes with a comprehensive test suite:

Test Coverage

The test suite includes:

• ✅ Middleware locale detection tests
• ✅ ServiceProvider registration tests
• ✅ Translation key extraction command tests
• ✅ Configuration tests
• ✅ Translation format converter tests
• ✅ Helper functions tests
• ✅ Edge cases and error handling

📄 License

This package is open-sourced software licensed under the MIT license.

🙏 Credits

• Author: Rawnoq
• Package: rawnoq/laravel-locale-detector
• Version: 1.0.0

Made with ❤️ for the Laravel community