在 Ubuntu 上排查 Composer 相关错误,通常可以按下面几个步骤系统来做。
composer --version
如果提示 command not found:
which composer
php -v
确认:
php -v
php -m
常见缺扩展:
curlmbstringzipopenssljson安装示例(Ubuntu):
sudo apt install php-cli php-curl php-mbstring php-zip php-xml
-vvv 看详细日志(最重要)composer install -vvv
composer update -vvv
能看到:
症状:
Connection timed outCould not resolve host排查:
ping repo.packagist.org
curl https://repo.packagist.org
中国用户常换镜像:
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
恢复官方:
composer config -g --unset repos.packagist
症状:
Permission denied/usr/local/bin/composer 无法写不要直接用 sudo composer(容易权限混乱)
推荐方式:
sudo chown -R $USER:$USER ~/.composer
或:
sudo chown -R $USER:$USER vendor
症状:
Allowed memory size exhausted解决:
php -d memory_limit=-1 /usr/local/bin/composer install
永久修改:
php --ini
编辑 php.ini:
memory_limit = 512M
rm composer.lock
composer install
(注意:生产环境谨慎)
composer diagnose
会检查:
~/.composer/composer.log
或用:
COMPOSER_DEBUG=1 composer install
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
sudo mv composer.phar /usr/local/bin/composer
✅ PHP 正常
✅ 扩展齐全
✅ 网络通畅
✅ 不用 sudo
✅ 加 -vvv
✅ composer diagnose
如果你有具体的报错信息(贴出来),我可以直接帮你定位是哪一类问题。