Troubleshooting

Guide

Common problems that people have run into and how to fix them.

System readiness

If you’ve encountered a problem, a good first step is to run composer patches-doctor. This will run a few checks against your system and look for common configuration errors.

Enable verbose output

If a command is failing and composer patches-doctor doesn’t give you any errors, you should re-run your command with extra verbose output. Example: composer -v install. Composer Patches will usually display extra information about why something is failing in any of the verbose output modes. Composer Patches only emits extra output in the normal verbose mode (composer -v), but if you’re having other problems with Composer, you can also add one or two additional v’s to your command (composer -vv or composer -vvv) to get extra information from Composer itself.

Upgrade system software

See the system requirements page for the minimum supported versions of PHP, Composer, and other software. Upgrade your software using the method appropriate for your operating system.

Install patching software

Composer Patches requires git to be installed in order to apply patches. Previous versions of the plugin relied on various versions of patch, but that is no longer the case. Make sure you have git installed and you should be all set.

Download patches securely

If you’ve been referred here, you’re trying to download patches over HTTP without explicitly telling Composer that you want to do that. See the secure-http documentation for more information.