如何通过单个文件统一管理项目中的相对路径？

核心思路 #

创建单个全局配置文件，将项目中所有常用路径定义为常量，后续所有页面直接调用这些常量即可，无需重复编写繁琐的相对路径，修改路径时仅需更新配置文件。

实现步骤 #

1. 创建路径配置文件
   在项目根目录下新建config/paths.php文件，通过__DIR__和realpath定义绝对路径常量，确保路径不随文件层级变化而失效：

// config/paths.php
// 项目根目录（自动计算，无需手动修改）
define('ROOT_PATH', realpath(__DIR__ . '/../') . '/');

// 页面路径常量
define('HOME_PAGE', ROOT_PATH . 'index.php');
define('ADMIN_PAGE', ROOT_PATH . 'admin/index.php');

// 可按需扩展更多路径，比如静态资源、上传目录等
// define('STATIC_PATH', ROOT_PATH . 'static/');
// define('UPLOAD_PATH', ROOT_PATH . 'uploads/');

2. 在业务文件中引入配置
   在所有需要使用路径的PHP文件顶部，引入这个配置文件（根据当前文件位置调整引入的相对路径）：

require_once __DIR__ . '/../config/paths.php';

3. 替换原有相对路径代码
   把原来的硬编码相对路径替换为配置文件中定义的常量：

// 若用户角色为user则重定向至首页，否则重定向至管理员控制台
if ($_SESSION['role'] === 'user') {
  header('location: ' . HOME_PAGE);
} else {
  header('location: ' . ADMIN_PAGE);
}

优势 #

• 路径统一管理，修改时只需更新paths.php，无需逐个文件查找替换
• 基于绝对路径定义，避免因文件层级变动导致的路径错误
• 可扩展性强，新增路径只需在配置文件中添加对应常量

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