PHP文件引入失败求助：Docker-Compose路径配置排查

针对你遇到的include(./app/TableGateways/PersonGateway.php)文件不存在的错误，按以下步骤排查：

1. 验证本地与容器内的文件一致性 #

• 先确认本地项目根目录下确实存在app/TableGateways/PersonGateway.php，注意Linux容器区分大小写，文件名大小写必须完全匹配
• 进入PHP容器查看挂载后的实际文件：

  docker-compose exec [php服务名] ls -l /var/www/html/app/TableGateways/
  

  把[php服务名]换成你docker-compose.yml里php服务的名称（比如php或php-fpm），如果输出为空或提示目录不存在，说明挂载有问题

2. 检查docker-compose.yml的卷挂载配置 #

• 确保php服务的volumes配置将本地项目根目录正确挂载到容器的/var/www/html，示例配置：

  services:
    php:
      # 其他配置...
      volumes:
        - ./:/var/www/html  # 本地当前目录（docker-compose.yml所在目录）挂载到容器的/var/www/html
  

  • 如果你的项目代码在本地子目录（比如./src），则挂载路径要改为./src:/var/www/html
  • 重启容器让挂载生效：docker-compose down && docker-compose up -d

3. 修正include路径的写法 #

• 相对路径依赖PHP的当前工作目录，可能和你预期的不一致，先在index.php中添加代码查看当前工作目录：

  echo getcwd(); exit;
  

• 推荐使用绝对路径或__DIR__拼接路径，避免工作目录问题：

  // 方式1：直接用容器内绝对路径
  include('/var/www/html/app/TableGateways/PersonGateway.php');
  // 方式2：用__DIR__（当前脚本所在目录）拼接，更具可移植性
  include(__DIR__ . '/app/TableGateways/PersonGateway.php');
  

4. 检查PHP Dockerfile的配置 #

• 确认Dockerfile中设置了正确的工作目录：

  WORKDIR /var/www/html
  

  如果没有这一行，PHP的默认工作目录可能不是/var/www/html，导致相对路径失效
• 如果Dockerfile中用COPY指令复制代码，确保复制路径正确：

  COPY . /var/www/html
  

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