Should I commit the dependencies in my vendor directory?(我应该在vendor目录中提交依赖项吗?)#
The general recommendation is no. The vendor directory (or wherever your
dependencies are installed) should be added to .gitignore
/svn:ignore
/etc.
The best practice is to then have all the developers use Composer to install the dependencies. Similarly, the build server, CI, deployment tools etc should be adapted to run Composer as part of their project bootstrapping.
While it can be tempting to commit it in some environment, it leads to a few problems:
- Large VCS repository size and diffs when you update code.
- Duplication of the history of all your dependencies in your own VCS.
- Adding dependencies installed via git to a git repo will show them as submodules. This is problematic because they are not real submodules, and you will run into issues.
If you really feel like you must do this, you have a few options:
- Limit yourself to installing tagged releases (no dev versions), so that you only get zipped installs, and avoid problems with the git "submodules".
- Use --prefer-dist or set
preferred-install
todist
in your config. - Remove the
.git
directory of every dependency after the installation, then you can add them to your git repo. You can do that withrm -rf vendor/**/.git
in ZSH orfind vendor/ -type d -name ".git" -exec rm -rf {} \;
in Bash. But this means you will have to delete those dependencies from disk before runningcomposer update
. - Add a .gitignore rule (
/vendor/**/.git
) to ignore all the vendor.git
folders. This approach does not require that you delete dependencies from disk prior to running acomposer update
.