0.0.0 / composer-include-files
Include files at a higher priority than autoload files. Useful for overriding Laravel helpers.
Installs: 352 787
Dependents: 8
Suggesters: 0
Security: 0
Stars: 12
Watchers: 3
Forks: 21
Type:composer-plugin
Requires
- composer-plugin-api: ^1.0 || ^2.0
Requires (Dev)
- composer/composer: ^2.0
This package is auto-updated.
Last update: 2024-11-13 21:06:44 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 0.0.0/composer-include-files
Usage
Just add the files you need included using "include_files"
and they will be included 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" ] }, }
Composer v2.2 includes a new security feature: https://getcomposer.org/doc/06-config.md#allow-plugins
As of Composer 2.2.0, the allow-plugins option adds a layer of security allowing you to restrict which Composer plugins are able to execute code during a Composer run.
So as well you need to add this library to the allowed plugins in your composer.json
file like this:
{ "config": { "allow-plugins": { "0.0.0/composer-include-files": true } } }
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" ] }, }