Debian系统Composer安装？纯净版Linux环境部署-composer-PHP中文网

必须手动安装最新版composer，因debian仓库版（如1.10.22或阉割版2.2.x）不支持^2.5约束、php 8.2+、签名校验及platform-check，且缺扩展时静默失败；需卸载旧版、校验下载、设执行权限、加入path并配置国内镜像。

debian系统composer安装？纯净版linux环境部署

Debian 上装 Composer 不能靠 apt install composer，那装出来的是 1.10.x，连 ^2.5 依赖都解析不了，PHP 8.2+ 项目直接报错退出——它根本不是“不能用”，而是“假装能用，直到你 run composer install 卡在 Class 'ZipArchive' not found 才暴露”。必须手动下载、校验、设权、入 PATH。

为什么 `apt install composer` 在 Debian 上一定得卸掉

Debian 12（bookworm）仓库里自带的 composer 包版本是 2.2.x，但它是阉割版：禁用签名验证、硬编码过时镜像源、不支持 platform-check 块。更糟的是，它和官方 2.7+ 的行为不一致，比如对 conflict 规则静默忽略。一旦你本地有旧版残留：which composer 返回 /usr/bin/composer，就得先清干净：

sudo apt remove composer
sudo rm -f /usr/bin/composer
hash -r（清 shell 命令缓存）

PHP 扩展缺一个，`composer install` 就会静默失败

Composer 2.5+ 强制要求 CLI 环境启用 zip、openssl、json、mbstring、phar、xml 六个扩展，缺任何一项都会在 install 阶段报 Class 'ZipArchive' not found 或直接卡住。别信“php -v 能跑就行”——要查 CLI 模式实际加载了哪些：

php -m | grep -E "zip|openssl|json|mbstring|phar|xml" —— 输出必须六项全在
缺 zip？sudo apt install php-zip
缺 mbstring？sudo apt install php-mbstring
改完记得重启 PHP-FPM（如果用了）或重开终端

`composer --version` 报 “Permission denied” 或 “command not found” 怎么快速定位

这两个错误看着像一回事，其实是两个独立问题叠加的结果：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

Permission denied → 文件没执行权限：ls -l /usr/local/bin/composer 看输出是不是 -rw-r--r--；补权限：sudo chmod +x /usr/local/bin/composer
command not found → /usr/local/bin 不在当前 $PATH 里：echo $PATH | grep -o '/usr/local/bin' 若无输出，说明路径没加载；临时修复：export PATH="/usr/local/bin:$PATH"；永久生效需写入 ~/.bashrc（用户级）或 /etc/profile（系统级）
注意：Docker 容器或 systemd service 启动的进程通常不读 ~/.bashrc，这类场景必须确保 /usr/local/bin 已在系统默认 PATH 中

国内网络下不配镜像源，`composer create-project` 基本必超时

默认走 packagist.org，DNS 解析慢 + 连接不稳定，create-project 经常卡在 “Downloading laravel/framework” 或 “Resolving packages”。全局配置阿里云镜像只需一行：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

验证是否生效：composer config -g repo.packagist 应输出 https://mirrors.aliyun.com/composer/。如果后续遇到镜像同步延迟（比如新包发布后几小时才同步），可临时切回官方源：composer config -g --unset repos.packagist。

真正容易被忽略的点是：PATH 和权限问题在最小化安装的 Debian（比如 debian:bookworm-slim Docker 镜像）里几乎必然出现，而且不会报明确错误，只会让 composer 命令“不存在”或“拒绝执行”——查的时候别只盯着下载步骤，先 ls -l /usr/local/bin/composer && echo $PATH 两行命令就能定死因。