funkjedi / composer-include-files
Include files at a higher priority than autoload files.
Installs: 2 326 377
Dependents: 18
Suggesters: 0
Security: 0
Stars: 120
Watchers: 9
Forks: 21
Open Issues: 6
Type:composer-plugin
Requires
- composer-plugin-api: ^1.0 || ^2.0
This package is auto-updated.
Last update: 2024-09-26 23:03:01 UTC
README
When using the Composer Autoloader if you need project files included prior to files autoloaded by any of your dependencies your out of luck. No longer!
Installation
composer require funkjedi/composer-include-files
Usage
Just add the files you need included using "include_files"
and they will be include prior to any files included by your dependencies.
// composer.json (project) { "extra": { "include_files": [ "/path/to/file/you/want/to/include", "/path/to/another/file/you/want/to/include" ] }, }
Specific Use Case
A good example of where this is required is when overriding helpers provided by Laravel.
In the past simply modifying bootstrap/autoload.php
to include helpers was sufficient. However new versions of PHPUnit include the Composer Autoloader prior to executing the PHPUnit bootstrap file. Consequently this method of overriding helpers is no longer viable as it will trigger a fatal error when your bootstrap file is included.
But now we can use Composer - Include Files Plugin to have Composer include the files in the necessary order.
// composer.json (project) { "require": { "laravel/framework": "^5.2", "funkjedi/composer-include-files": "^1.0", }, "extra": { "include_files": [ "app/helpers.php" ] }, }