Download the PHP package sebastiaanluca/laravel-conditional-providers without Composer
On this page you can find all versions of the php package sebastiaanluca/laravel-conditional-providers. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sebastiaanluca/laravel-conditional-providers
More information about sebastiaanluca/laravel-conditional-providers
Files in sebastiaanluca/laravel-conditional-providers
Package laravel-conditional-providers
Short Description Load Laravel service providers based on the current environment.
License MIT
Homepage https://github.com/sebastiaanluca/laravel-conditional-providers
Informations about the package laravel-conditional-providers
Laravel Conditional Providers
Load Laravel service providers and facades based on the current environment.
Specify the service providers and facades to load per environment directly in your configuration file. No more need to add lengthy blocks of conditionals to your AppServiceProvider
, do it all in the app configuration file like you would with any service provider and facade!
Inspired by Matt Staufer, Sven Luijten, and others.
Table of contents
- What does it solve?
- Requirements
- How to install
- How to use
- Conditional providers
- Conditional aliases
- License
- Change log
- Testing
- Contributing
- Security
- Credits
- About
What does it solve?
Say you're using a package like barryvdh/laravel-ide-helper in your project. If you've followed its installation instructions and require it only in development environments (like you should), you'd do the following:
And then add the service provider to your app's config providers array:
Now when you run composer install --no-dev
in your production environment to install all but development packages, this will throw an exception. Laravel will try to load the registered service provider class which it can't find, because the package is not installed.
Of course you can —per the instructions— conditionally load the provider manually in the register method of the app/Providers/AppServiceProvider.php
file:
But you'd have to do this for each development package and each environment you don't want it loaded in, which is hardly maintainable and pollutes your application-specific code.
Enter Laravel conditional providers to easily do all of this in your main application config file!
Requirements
- PHP 7.3 or higher
- Laravel 6.0 or higher
How to install
How to use
Conditional providers
Disable auto-discovery of the package's service provider by adding it to your composer.json's relevant section:
Once you're set up, simply add a providers array per environment to your config/app.php
file:
Each providers key is optional and can be empty —so you could just use the local_providers
array or none at all.
The example above will do the following in a local
environment:
- Load every provider from
providers
- Load every provider from
local_providers
- Ignore everything in
production_providers
All done! Now your app service provider is clean and you get a better view on what's loaded and when, with the added benefit of enabling or disabling packages based on environment.
Conditional aliases
In addition to conditionally loading providers, this workflow is also available for aliases/facades. Add a facades/aliases array per environment to your config/app.php
file like so:
That's it! This will load the Debugbar
facade only in the local environment.
License
This package operates under the MIT License (MIT). Please see LICENSE for more information.
Change log
Please see CHANGELOG for more information what has changed recently.
Testing
Contributing
Please see CONDUCT for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Sebastiaan Luca
- All Contributors
About
My name is Sebastiaan and I'm a freelance Laravel developer specializing in building custom Laravel applications. Check out my portfolio for more information, my blog for the latest tips and tricks, and my other packages to kick-start your next project.
Have a project that could use some guidance? Send me an e-mail at [email protected]!