正确命令是下载官方PHAR：curl -LO https://www.php.cn/link/490c348329a61872baf3a92c47a37f23，再mv deployer.phar /usr/local/bin/dep && chmod +x /usr/local/bin/dep。
Composer 安装 Deployer 的正确命令是什么
Deployer 不是通过 composer require 全局安装的常规 PHP 包，它本身是一个独立的 PHAR 可执行文件。直接运行 composer require deployer/deployer --dev 会装错东西：你得到的是源码依赖，不是可运行的 dep 命令。
正确做法是下载官方 PHAR：
- 运行
curl -LO <a href="https://www.php.cn/link/490c348329a61872baf3a92c47a37f23">https://www.php.cn/link/490c348329a61872baf3a92c47a37f23</a> - 改名并加执行权限：
mv deployer.phar /usr/local/bin/dep && chmod +x /usr/local/bin/dep - 验证：
dep --version应输出版本号
如果你坚持用 Composer 管理（比如项目级部署脚本需复现环境），才用 composer require deployer/deployer --dev，但此时必须手动绑定命令：在 composer.json 的 scripts 里加 "dep": "vendor/bin/dep"，否则 dep 命令依然不可用。
为什么 dep init 生成的 deploy.php 默认不工作
新生成的 deploy.php 是骨架，几乎全是注释和空任务，不填关键配置就跑不起来。最常卡在：
-
host()没定义：必须显式写上服务器地址、用户、端口，例如host('prod')->hostname('192.168.1.100')->user('deploy') -
set('repository', '...')缺失：Git 仓库地址不能为空，否则dep deploy在 clone 阶段直接报Cloning into ''...错误 -
set('shared_dirs', [])或set('writable_dirs', [])留空但应用需要上传目录（如storage）：会导致权限失败，错误信息类似chmod: cannot access '.../shared/storage': No such file or directory
别跳过 dep deploy -p（带预览），它能提前暴露路径拼错、变量未定义等问题。
PHP 版本不一致导致 dep deploy 失败怎么办
Deployer 的 PHAR 默认捆绑 PHP 7.4+ 运行时，但目标服务器上的 PHP 版本可能不匹配——尤其当部署脚本里用了 match、str_contains() 等 8.0+ 特性，而远程 php -v 返回 7.4，就会在 run() 中静默失败或报 ParseError。
检查方式很简单：
- 在
deploy.php开头加一行：run('php -v');，看输出是否符合预期 - 若不一致，改用
run('php8.1 -r "echo PHP_VERSION;"')显式调用高版本解释器
更稳妥的做法是：在 host() 配置里统一指定 ->set('bin/php', 'php8.1')，避免散落在各处的 run() 调用各自猜版本。
本地测试 dep deploy 时 SSH 连不上，但终端 ssh 能通
这是因为 Deployer 默认复用 SSH agent，但不会自动加载 ~/.ssh/config 别名或 Include 文件，也不会读取 IdentityFile 指定的私钥路径。
常见表现是 SSH error: Connection refused 或超时，即使 ssh prod（别名）在 shell 里完全正常。
解决方法只有两个：
- 把 host 配置写完整：
host('prod')->hostname('example.com')->user('deploy')->port(22)->identityFile('/path/to/key') - 或者关掉 Deployer 的 SSH agent 自动发现：
set('ssh_multiplexing', false)，强制走密码/密钥直连
别指望 dep 会像 shell 那样解析 ~/.ssh/config —— 它不会。
