Docker容器配置PHPUnit报错：vendor/bin/phpunit不存在

错误原因分析 #

报错提示找不到./vendor/bin/phpunit，核心问题有两个：

• PHPUnit服务的工作目录与挂载路径不匹配：配置里working_dir: /app，但代码和vendor目录实际挂载到了/var/www，导致容器在/app下找不到vendor文件夹。
• 可能未通过Composer正确安装PHPUnit到项目依赖中。

具体修复步骤 #

1. 修正PHPUnit服务的路径配置 #

修改docker-compose.yml中的phpunit服务部分，调整工作目录和命令路径：

phpunit:
  image: php:7.3-cli
  restart: "no" # 测试服务不需要一直重启
  volumes:
    - ./app:/var/www
    - ./vendor:/var/www/vendor
  working_dir: /var/www # 改为实际挂载的代码目录
  entrypoint: ["./vendor/bin/phpunit"] # 使用相对当前工作目录的路径，或直接写绝对路径/var/www/vendor/bin/phpunit
  networks:
    - backend-php # 加入后端网络，方便测试时连接数据库
  depends_on:
    - sql-db # 依赖数据库服务，确保测试时数据库已启动

2. 确保PHPUnit已安装到项目 #

通过已有的composer服务安装PHPUnit开发依赖：

docker-compose run composer require --dev phpunit/phpunit

这条命令会在本地项目目录生成vendor文件夹，并安装PHPUnit，之后挂载到容器中就能被识别。

3. 补充必要的PHP扩展（可选但推荐） #

php:7.3-cli基础镜像可能缺少项目（如MySQL连接）所需的扩展，比如pdo_mysql。可以通过两种方式解决：

• 临时在容器内安装：运行测试前先执行安装命令（不推荐长期使用）：

  docker-compose run phpunit docker-php-ext-install pdo_mysql
  

• 自定义PHPUnit镜像：创建./phpunit/Dockerfile，基于php:7.3-cli安装所需扩展：

  FROM php:7.3-cli
  RUN docker-php-ext-install pdo_mysql
  

  然后修改docker-compose.yml中phpunit服务的image为build: ./phpunit。

4. 运行测试 #

配置完成后，执行以下命令启动PHPUnit测试：

docker-compose run phpunit

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