debian上composer安装失败主因是php环境不达标：需php≥7.4且启用php-cli、mbstring、xml、zip、curl扩展，并确保phar.readonly=off；官方脚本安装后须移至/usr/local/bin/composer并加执行权限。
Debian上composer安装失败：常见报错和根源
直接运行curl -sS https://getcomposer.org/installer | php或sudo apt install composer失败，大概率不是Composer本身问题，而是底层PHP环境或系统依赖缺失。典型错误包括：Class 'Phar' not found、mbstring extension is missing、zip extension is missing，甚至php: command not found——这些都指向Debian默认PHP包过于精简。
必须安装的PHP扩展（Debian 12/13适用）
Debian的php元包不自动拉取常用扩展，需手动补全。以下扩展缺一不可：
-
php-cli：提供php命令行入口 -
php-mbstring：Composer解析包名、处理UTF-8必需 -
php-xml：读取composer.json和packagist响应依赖 -
php-zip：解压下载的包归档（.zip格式） -
php-curl：与Packagist API通信（HTTPS请求）
执行：sudo apt update && sudo apt install php-cli php-mbstring php-xml php-zip php-curl
验证PHP配置是否满足Composer最低要求
Composer 2.5+ 要求PHP ≥ 7.4，且phar.readonly必须为Off。Debian默认可能禁用PHAR写入：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查当前值：
php -i | grep "phar.readonly"→ 若输出On，则失败 - 修改
/etc/php/*/cli/php.ini（注意是cli目录，不是fpm或apache2） - 找到
phar.readonly = On，改为phar.readonly = Off - 重启CLI无须重启服务，改完即可生效
顺带确认：php -v 输出版本 ≥ 7.4；php -m | grep -E "^(mbstring|xml|zip|curl)$" 应列出全部模块。
绕过apt源安装Composer时的权限陷阱
用官方脚本安装（php composer-setup.php）后，若将composer.phar移到/usr/local/bin/composer但提示Permission denied，不是路径问题，而是SELinux或AppArmor未启用，而是Debian默认/usr/local/bin对普通用户可写，但php进程可能被限制访问临时目录：
- 不要用
sudo php composer-setup.php生成文件，而用php composer-setup.php --filename=composer（避免root写入） - 移动后加执行权限：
sudo chmod +x /usr/local/bin/composer - 若仍报
failed to open stream: Permission denied，检查open_basedir是否在php.ini中设了限制（默认为空，但某些云镜像会预设）
最稳妥方式始终是：先确保php -r "echo 'ok';"能执行，再跑安装脚本；任何报错优先看php --ini加载的是哪个配置文件，别修错了位置。
