A composer cleanup plugin, to remove tests and documentation to save space

Installs: 12 355

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 1

Forks: 3

Open Issues: 0


v2.3.0 2020-12-05 09:14 UTC

This package is auto-updated.

Last update: 2022-06-19 09:57:34 UTC



Composer Cleanup Plugin

Version Version Build Status Coverage Downloads count License

Remove tests & documentation from the vendor dir. Based on barryvdh/composer-cleanup-plugin.

Usually disk size shouldn't be a problem, but when you have to use FTP to deploy or have very limited disk space, you can use this package to cut down the vendor directory by deleting files that aren't used in production (tests/docs etc).

Note: This package is still experimental, usage in production without detailed tests is not recommended.


Require this package in your composer.json:

$ composer require avto-dev/composer-cleanup-plugin "^2.0"


This plugin will work automatically on any packages installed.

What does it do?

For every installed or updated package in the default list, in general:

  1. Remove documentation, such as README files, docs folders, etc.
  2. Remove tests, PHPUnit configs, and other build/CI configuration.

Some packages don't obey the general rules, and remove more/less files. Packages that do not have rules added are ignored.

Adding rules

Please submit a PR to src/Rules.php to add more rules for packages. Make sure you test them first, sometimes tests dirs are classmapped and will error when deleted.


For package testing we use phpunit framework and docker-ce + docker-compose as develop environment. So, just write into your terminal after repository cloning:

$ make build
$ make latest # or 'make lowest'
$ make test

Changes log

Release date Commits since latest release

Changes log can be found here.


Issues Issues

If you will find any package errors, please, make an issue in current repository.


This is open-sourced software licensed under the MIT License.