PHP命令不可用需先软链宝塔PHP到/usr/local/bin/php并验证php -v及openssl、tokenizer扩展；禁用函数putenv/proc_open/pcntl_signal须手动删除后重载配置；composer全局安装需chmod +x授权；国内需配置阿里云镜像源。

php 命令在终端里用不了？先软链，再验证

宝塔装的 PHP 默认不在系统 PATH 里，php -v 直接报 command not found 是最常见起点问题。这不是 Composer 没装好，是连 PHP 都没认上。

• 进宝塔【PHP 管理】，确认你项目实际用的版本（比如 82、80 或 74），别猜
• 执行：ln -sf /www/server/php/82/bin/php /usr/local/bin/php（把 82 换成你的真实版本）
• 验证：php -v 有输出，且 php -m | grep openssl 和 php -m | grep tokenizer 都得有结果——缺一个，Composer 启动就直接崩

putenv/proc_open/pcntl_signal 被禁用了？install 卡住就是它

执行 composer install 后卡在 Loading composer repositories... 或报 putenv() has been disabled for security reasons，99% 是这三个函数被宝塔 PHP 配置拦住了，不是网慢。

• 进宝塔【网站】→【PHP 管理】→ 选中对应 PHP 版本 → 【禁用函数】
• 找到并**手动删除**这三行文字：putenv、proc_open、pcntl_signal（不是取消勾选，是删掉整行）
• 点【重载配置】或重启该 PHP 服务——改完不重载 = 白改

全局安装 composer 总提示 Permission denied？chmod +x 漏了

mv composer.phar /usr/local/bin/composer 这步做完，composer --version 还报 Permission denied，说明文件没执行权限。Linux 下没 +x 就是“不能跑”，不是安装失败。

Workflow Decomposer

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

下载

• 标准三步必须齐：cd /tmp → curl -sS https://getcomposer.org/installer | php → mv composer.phar /usr/local/bin/composer && chmod +x /usr/local/bin/composer
• 如果提示 /usr/local/bin 不可写（某些精简系统），换路径：mv composer.phar /root/composer.phar，再加一行：echo "alias composer='php /root/composer.phar'" >> /root/.bashrc，最后 source /root/.bashrc

require/laravel/framework 卡十分钟？镜像源没设等于没装

不设国内镜像，composer require laravel/framework 很可能卡在 Downloading... 十几分钟后超时。官方源在国内基本不可用，这不是 Composer 的锅，是网络策略问题。

• 全局生效（推荐）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 验证是否生效：composer config -g repo.packagist 应返回阿里云地址
• 如果只想当前项目用，进项目目录运行（去掉 -g）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/

真正麻烦的从来不是命令怎么敲，而是 PHP 命令行环境、禁用函数、执行权限、镜像源这四块拼图没对齐。漏一块，composer install 就会静默卡死或报错，而且错误信息还藏得深。