A vendor cleanup package, to remove tests and documentation to save space

v1.2.4 2014-08-21 11:40 UTC

This package is auto-updated.

Last update: 2024-02-05 16:56:41 UTC


Remove tests & documentation from the vendor dir

Stand-alone Composer plugin:

Don't use this when you hava ssh access, just use composer and don't worry about size!

If possible at all, just create a distribution script or use git to deploy!

Require this package in your composer.json:

"barryvdh/laravel-vendor-cleanup": "1.*"

And add the ServiceProvider to the providers array in app/config/app.php


You can now remove all the docs/tests/examples/build scripts throught artisan

php artisan vendor-cleanup

You should change your composer file to use the dist version, without the .git history. You can configure your composer.json to do this, and cleanup after updating:

    "post-install-cmd": [
        "php artisan vendor-cleanup",
        "php artisan optimize"
        "php artisan vendor-cleanup",
        "php artisan optimize"
"config": {
    "preferred-install": "dist"

Note: If you switch from prefer-source (the default composer setting for non-stable packages), you should delete your vendor dir and re-download all packages, without the .git history (and greatly reducing filesize). This will also prevent questions about changed files, because packages with .git history are checked for changes.

When distributing

You can add your own rules, when you publish the config file.

'commands' => array(
   'name/package' => 'CHANGELOG* phpunit.xml* tests docs',

This will look for files matching CHANGELOG* or phpunit.xml* or tests or docs in vendor/name/package and delete them.

If the package is commonly used, please make a PR to add the command to src/Barryvdh/VendorCleanup/VendorCleanupCommand.php

Most of the cleanup commands are based on the SensioDistributionBundle build script;


The Laravel Vendor Cleanup Command is open-sourced software licensed under the MIT license