Ubuntu切换PHP7.4后Composer执行update遇PSR语法错误求助

背景操作 #

已通过以下命令完成PHP版本切换至7.4：

update-alternatives --set php /usr/bin/php7.4
update-alternatives --set phar /usr/bin/phar7.4
update-alternatives --set phar.phar /usr/bin/phar.phar7.4

报错信息 #

在项目目录执行 php7.4 /usr/bin/composer update 时触发语法错误：

Parse error: syntax error, unexpected '|', expecting variable (T_VARIABLE) in 
/usr/share/php/Psr/Log/LoggerInterface.php on line 30

问题分析 #

系统全局的PSR库为PHP 8专属版本，其代码中使用了PHP7.4不支持的语法（如联合类型|），导致PHP7.4无法解析该库文件。需要为不同PHP版本配置独立的依赖库目录，或使用适配PHP7.4的Composer版本。

已尝试操作 #

• 当前Composer版本为2.4.1
• 执行 apt-cache rdepends php-psr-log 确认Composer依赖该库
• 重命名/usr/share/php/Psr文件夹后，出现依赖缺失错误：Failed opening required 'Psr/Log/autoload.php' (include_path='.:/usr/share/php') in /usr/share/php/Composer/XdebugHandler/autoload.php
• 在项目内执行 php8.1 composer require psr/log:^1.0 --ignore-platform-req=all --no-update 后，再次运行 php7.4 composer update 仍报相同错误

解决方案 #

方案1：为PHP7.4安装独立的适配版Composer（推荐） #

Composer 2.2.x分支是最后支持PHP7.4的版本，可单独安装该版本供PHP7.4使用：

1. 下载适配PHP7.4的Composer安装包：

   php7.4 -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
   php7.4 -r "if (hash_file('sha384', 'composer-setup.php') === '55ce33d7678c5a611085589f1f3ddf8b3c52d662cd01d4ba75c0ee0459970c2200a51f492d557530c71c15d8dba01eae') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
   php7.4 composer-setup.php --version=2.2.24
   php7.4 -r "unlink('composer-setup.php');"
   

2. 将安装好的composer.phar移动到专属目录，避免与全局Composer冲突：

   sudo mv composer.phar /usr/local/bin/composer74
   

3. 后续在项目中使用PHP7.4执行专属Composer：

   php7.4 /usr/local/bin/composer74 update
   

方案2：修改PHP include_path，优先加载项目本地依赖 #

通过调整include_path让PHP7.4优先读取项目本地的vendor库（而非全局系统库）：

1. 临时生效方式：执行Composer时直接指定include_path参数

   php7.4 -d include_path=".:./vendor:/usr/share/php" /usr/bin/composer update
   

2. 永久生效方式：编辑PHP7.4的CLI配置文件 /etc/php/7.4/cli/php.ini，修改include_path项：

   include_path = ".:./vendor:/usr/share/php"
   

方案3：安装PHP7.4兼容的PSR库版本 #

替换全局的PHP8版本PSR库为PHP7.4适配版本：

1. 卸载全局的PHP8版本PSR库：

   sudo apt remove php-psr-log
   

2. 安装PHP7.4版本的PSR库（若apt仓库存在）：

   sudo apt install php7.4-psr-log
   

3. 若apt无对应包，通过Composer全局安装适配版本：

   php7.4 /usr/bin/composer global require psr/log:^1.1.4
   

   并修改PHP7.4的include_path加入全局Composer目录：

   include_path = ".:~/.composer/vendor:/usr/share/php"
   

内容的提问来源于stack exchange，提问作者ESP32