AWS EC2实例中PHP项目相对路径引用文件报错求助

结论先行：AWS EC2完全支持PHP相对路径引用，问题出在路径解析或文件配置上 #

这个报错和EC2本身没有关系——EC2只是一台标准的Linux服务器，和你本地的Linux环境对PHP的文件引用逻辑完全一致。出现failed to open stream: No such file or directory的核心原因是PHP找不到你指定的相对路径对应的文件，下面是一步步排查和解决的方法：

• 先确认当前脚本的实际路径，核对目标文件位置
  相对路径的解析是基于PHP的「当前工作目录」，而不是你写代码时默认的脚本所在目录，很容易出现偏差。你可以在报错的脚本顶部加一行代码，输出当前脚本的绝对路径：

  echo __DIR__; // 输出当前脚本所在的绝对目录
  exit;
  

  访问页面后得到路径（比如/var/www/html/Controllers/UserController.php），然后计算../Models/ConDB.php对应的绝对路径应该是/var/www/html/Models/ConDB.php，登录EC2用命令检查这个文件是否存在：

  ls /var/www/html/Models/ConDB.php
  

  注意：Linux是严格区分大小写的，如果你的实际文件是condb.php或者models/ConDB.php，都会导致找不到文件。

• 改用绝对路径引用（推荐方案，彻底避免路径问题）
  相对路径的不确定性太高，建议直接用绝对路径引用文件，有两种常用方式：

  1. 利用__DIR__常量（PHP 5.3及以上支持），它代表当前脚本所在的绝对目录，修改引用代码为：

     include(__DIR__ . '/../Models/ConDB.php');
     

  2. 定义项目根目录常量，在项目入口文件（比如index.php）中添加：

     // 定义项目根目录的绝对路径
     define('PROJECT_ROOT', realpath(__DIR__));
     

     之后所有脚本都可以用这个常量来引用文件：

     include(PROJECT_ROOT . '/Models/ConDB.php');
     

• 检查文件和目录的权限
  即使路径正确，Web服务器的运行用户（比如Apache的www-data、Nginx的nginx）需要有读取目标文件和遍历上级目录的权限。登录EC2执行以下命令检查权限：

  # 检查文件权限
  ls -l /var/www/html/Models/ConDB.php
  # 检查目录权限（需要有执行权限才能遍历）
  ls -ld /var/www/html/Models/
  ls -ld /var/www/html/
  

  如果权限不足，用以下命令调整（根据实际路径修改）：

  sudo chmod 644 /var/www/html/Models/ConDB.php # 给文件读权限
  sudo chmod 755 /var/www/html/Models/ /var/www/html/ # 给目录读+遍历权限
  

• 核对Web服务器的根目录配置
  如果你的Apache或Nginx配置中，DocumentRoot（Apache）或root（Nginx）指向的不是项目的根目录，也会导致相对路径解析错误。比如如果服务器根目录设为/var/www/html/Controllers，那么../Models会指向/var/www/html/，但如果Models不在那里就会出错。确保服务器根目录指向你的项目根目录（比如/var/www/html/）。

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