安装Composer时PHP 8.1提示PHAR扩展缺失的解决办法

1. 安装mbstring扩展 #

iconv通常已包含在php8.1-common中，但mbstring是独立扩展包，执行以下命令安装：

sudo apt install php8.1-mbstring

2. 检查PHP扩展加载状态 #

通过以下命令确认phar、iconv、mbstring是否已加载：

php -i | grep -E "phar|iconv|mbstring"

若输出显示phar support => disabled，或找不到对应扩展的条目，说明扩展被禁用或未加载。

3. 启用PHP扩展 #

首先找到CLI模式下的PHP配置文件路径：

php --ini

定位输出中Loaded Configuration File对应的文件（例如/etc/php/8.1/cli/php.ini），编辑该文件：

• 去掉extension=phar、extension=iconv（或extension=mbstring）行首的;注释，确保扩展启用
• 将phar.readonly设置为Off（Composer安装依赖此配置）：

  phar.readonly = Off
  

4. 验证配置并重新安装Composer #

执行以下命令确认扩展已加载：

php -m | grep -E "phar|iconv|mbstring"

若能看到phar以及iconv/mbstring中的至少一个，说明配置生效，重新运行Composer安装脚本即可。

内容的提问来源于stack exchange，提问作者LJ S.A.