如何将Docker中的PHP解释器关联至Bash终端并支持全局调用

我之前也碰到过一模一样的困扰——别名确实没法满足/usr/bin/env php的调用需求，因为/usr/bin/env只会搜索PATH环境变量里的可执行文件，而shell别名是会话级的，根本不在它的搜索范围内。下面是我验证过的可行方案：

1. 用Shell脚本替代别名，实现全局PHP调用 #

我们可以在PATH目录下创建一个可执行的shell脚本，让它直接调用Docker容器里的PHP：

• 首先，创建脚本文件（推荐放在/usr/local/bin，这个目录默认在PATH里；如果没有root权限，可以用~/.local/bin，记得确保这个目录在你的PATH中）：

  touch /usr/local/bin/php
  

• 编辑脚本内容，把下面的代码粘贴进去（如果你的docker-compose.yml不在当前执行目录，可以用-f参数指定路径）：

  #!/bin/bash
  # 若yml文件不在当前目录，替换为实际路径：
  # docker-compose -f /home/your-project/docker-compose.yml exec php php "$@"
  docker-compose exec php php "$@"
  

  这里的"$@"是关键，它会把你在终端输入的所有参数（比如php script.php --debug）原封不动传递给容器里的PHP。

• 给脚本添加执行权限：

  chmod +x /usr/local/bin/php
  

• 现在测试一下：

  php -v          # 应该返回容器里的PHP版本
  /usr/bin/env php -v  # 同样能正常输出，说明/usr/bin/env能找到这个PHP了
  

2. 让Vim中的phpcs适配这个环境 #

要让Vim里的phpcs正常工作，只需要确保phpcs也能调用到容器里的PHP环境，有两种方式：

方式一：给phpcs也创建全局脚本 #

如果你的phpcs是安装在Docker容器里的，同样可以创建一个全局脚本：

• 创建/usr/local/bin/phpcs文件：

  touch /usr/local/bin/phpcs
  

• 编辑脚本内容（替换容器里phpcs的实际路径，比如Composer全局安装的话可能是~/.composer/vendor/bin/phpcs，或者系统全局的/usr/local/bin/phpcs）：

  #!/bin/bash
  docker-compose exec php php /path/to/container/phpcs "$@"
  

• 添加执行权限：

  chmod +x /usr/local/bin/phpcs
  

• 最后在Vim的配置文件（比如.vimrc）里指定phpcs的路径：

  let g:phpcs_executable = 'phpcs'
  

方式二：直接在Vim配置里指定phpcs调用容器的命令 #

如果不想额外创建phpcs脚本，也可以直接在Vim配置里写完整的调用命令：

let g:phpcs_executable = 'docker-compose exec php php /path/to/container/phpcs'

注意事项 #

• 如果你的项目有多个docker-compose环境，记得在脚本里用-f参数指定对应的yml文件路径，避免执行错误。
• 确保你的当前用户有权限执行docker-compose命令，不需要sudo（如果需要sudo的话，脚本里要加上sudo，但不推荐这样做）。

内容的提问来源于stack exchange，提问作者Brainexploded