PHP MVC模式下从子目录调用Controller失败问题排查

问题现象 #

开发个人MVC项目时，从View/Plataforma/testView.php调用PlataformaController.php，页面提示：This page isn’t working. localhost is currently unable to handle this request.

项目目录结构 #

12_MVC_CRUD
├── Controller
│   └── PlataformaController.php
├── Model
│   ├── DbConnection.php
│   └── PlataformaModel.php
└── View
    ├── footer.php
    ├── header.php
    ├── Idioma
    │   └── IdiomaView.php
    ├── Pelicula
    │   ├── PeliculaAddView.php
    │   └── PeliculaView.php
    ├── Persona
    │   └── PersonaView.php
    ├── Plataforma
    │   ├── HomePlataformaView.php
    │   ├── PlataformaConfiguracionView.php
    │   ├── PlataformaView.php
    │   └── testView.php
    ├── Serie
    │   ├── SerieAddView.php
    │   ├── SerieEditView.php
    │   └── SerieView.php
    ├── Subtitulo
    │   └── SubtituloView.php
    └── testV.php

错误日志信息 #

执行命令 tail -n 100 php_error_log | grep testView 得到以下输出：

[08-May-2024 04:41:59 Europe/Berlin] PHP Fatal error:  Uncaught Error: Failed opening required '/opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/../../../Controller/PlataformaController.php' (include_path='.:/opt/lampp/lib/php') in /opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/testView.php:3
  thrown in /opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/testView.php on line 3
[08-May-2024 04:42:00 Europe/Berlin] PHP Warning:  require_once(/opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/../../../Controller/PlataformaController.php): Failed to open stream: No such file or directory in /opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/testView.php on line 3
[08-May-2024 04:42:00 Europe/Berlin] PHP Fatal error:  Uncaught Error: Failed opening required '/opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/../../../Controller/PlataformaController.php' (include_path='.:/opt/lampp/lib/php') in /opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/testView.php on line 3
  thrown in /opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/testView.php on line 3
[08-May-2024 04:42:00 Europe/Berlin] PHP Warning:  require_once(/opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/../../../Controller/PlataformaController.php): Failed to open stream: No such file or directory in /opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/testView.php on line 3
[08-May-2024 04:42:00 Europe/Berlin] PHP Fatal error:  Uncaught Error: Failed opening required '/opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/../../../Controller/PlataformaController.php' (include_path='.:/opt/lampp/lib/php') in /opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma/testView.php on line 3

相关代码 #

testView.php 中的控制器引用代码：

<?php require_once("../../Controller/PlataformaController.php"); $obj = new PlataformaController(); ?>

问题分析 #

从错误日志的路径可以看出，PHP解析后的目标路径为 /opt/lampp/htdocs/Controller/PlataformaController.php，但实际控制器文件位于 /opt/lampp/htdocs/12_MVC_CRUD/Controller/ 目录下，说明相对路径的层级计算错误。另外，PHP的相对路径基于当前执行脚本的工作目录，而非脚本文件本身的目录，也可能导致路径解析偏差。

解决方案 #

方案1：修正相对路径 #

testView.php 位于 12_MVC_CRUD/View/Plataforma/，需要向上跳转2层回到项目根目录（12_MVC_CRUD/），再进入Controller目录，正确的相对路径应为：

<?php require_once("../../../Controller/PlataformaController.php"); $obj = new PlataformaController(); ?>

方案2：使用绝对路径（推荐） #

利用PHP的__DIR__常量（代表当前脚本所在的绝对目录）构建可靠路径，避免相对路径的歧义：

<?php require_once(__DIR__ . "/../../../Controller/PlataformaController.php"); $obj = new PlataformaController(); ?>

__DIR__ 对应 /opt/lampp/htdocs/12_MVC_CRUD/View/Plataforma，拼接后最终指向正确的控制器文件路径。

架构优化建议 #

标准MVC架构中，应通过Controller作为请求入口，由Controller处理业务逻辑后再渲染对应的View，而非直接从View调用Controller。这种方式能更好地分离职责，便于路由管理和后续维护。

内容的提问来源于stack exchange，提问作者Andres Sebastian Cabrera