Reference – Composer error “Your PHP version does not satisfy requirements” after upgrading PHP

by

The Problem

As well as the versions of other packages they require, Composer packages can specify the versions of PHP which they support.

While resolving the versions of packages to install, Composer has to find versions which match all the constraints in place:

  • The version constraints you’ve specified for dependencies in your composer.json
  • The version constraints each package has specified for its dependencies
  • The PHP versions each package supports

If there is no package that satisfies all of those constraints, you will get an error.

Common Confusions

Note that the version constraint for PHP version follows the same rules as other composer constraints. So a constraint of ^7.0 means “any version of 7.x above 7.0”, and does not include 8.0.

The Solution

To solve the problem, you need to relax one of those constraints:

  1. Look at the package mentioned in the error message (acme/some-package in the example) and find it on Packagist (or whatever custom package source you have configured).
  2. See if a newer version exists that supports your PHP version.
  3. If it doesn’t, you’ll need to find out what’s needed to add that support. This might mean checking out the project directly, running its tests, and submitting a patch to mark it as compatible with the new version.
  4. If (when) support has been added, you’ll need to make sure your composer.json, and other packages you depend on, don’t exclude that new version. For instance, if you currently depend on acme/some-package version ^1.0, but PHP 8.0 is only supported from version 2.2.0 onwards, you’ll need to change your constraint to ^2.2, and make sure your application is still compatible.

Temporary Workaround

Sometimes, you’re pretty sure your application will run fine with the same versions of packages as you were previously using. In that case, you can use the platform configuration variable in your composer.json to pretend you’re still using the old version. This should only be done as a temporary workaround or for testing as it means packages will be installed which may be completely broken on your new PHP version.

For example:

{
    "config": {
        "platform": {
             "php": "7.4.999"
        }
    }
}

See also “Override PHP base dependency in composer“

More Related Contents:

  1. Does PHP allow named parameters so that optional arguments can be omitted from function calls?
  2. Required parameter $xxx follows optional parameter $yyy
  3. Override PHP base dependency in composer
  4. How to install a specific version of package using Composer?
  5. Why use a PSR-0 or PSR-4 autoload in composer if classmap is actually faster?
  6. How do I install Composer PHP packages without Composer?
  7. Composer update memory limit
  8. How do I install Composer on a shared hosting?
  9. requires ext-fileinfo. How do I add that into my composer.json file?
  10. How to create a PSR-4 autoloader for my project?
  11. Change PHP version used by Composer on Windows
  12. Run composer with a PHP script in browser
  13. Composer killed while updating
  14. Autoloading classes in PHPUnit using Composer and autoload.php
  15. Composer require local package
  16. The openssl extension is required for SSL/TLS protection
  17. Laravel app stopped working after upgrading to php 8
  18. How to enable PHP’s openssl extension to install Composer?
  19. Running Composer returns: “Could not open input file: composer.phar”
  20. PHP Composer update “cannot allocate memory” error (using Laravel 4)
  21. Could not open input file: composer.phar
  22. PHP adding custom namespace using autoloader from composer
  23. Composer running out of memory on every project, Mac OS X
  24. Empty string comparison to zero gives different result in PHP 8 than in previous versions
  25. Composer: file_put_contents(./composer.json): failed to open stream: Permission denied
  26. How to always use ignore-platform-reqs flag when running composer?
  27. but these conflict with your requirements or minimum-stability
  28. How to use Composer to autoload classes from outside the vendor?
  29. Class Firebase\JWT\JWT not found
  30. Composer install error – requires ext_curl when it’s actually enabled

Leave a Comment