PHP多项目结构下从header.php动态引入静态资源的相对路径方案

针对多项目嵌套目录下，从inc/header.php动态引入assets目录资源的需求，以下是几种无需硬编码绝对路径的实现方式：

方法1：基于文件系统路径动态计算项目根URI #

利用PHP魔术常量__DIR__获取当前文件物理路径，结合$_SERVER["DOCUMENT_ROOT"]生成项目根的相对URI，兼容性强且不依赖请求上下文：

// 在 inc/header.php 中添加
// 获取header.php所在目录的上级目录（项目根目录物理路径）
$project_root_path = dirname(__DIR__);
// 转换为网站根目录下的相对URI
$project_root_uri = str_replace($_SERVER['DOCUMENT_ROOT'], '', $project_root_path);
?>

<!-- 引入资源 -->
<link rel="stylesheet" href="<?php echo $project_root_uri; ?>/assets/styles.css">
<script src="<?php echo $project_root_uri; ?>/assets/script.js"></script>

优势：只要header.php位置不变，无论访问哪个层级的页面，都能正确指向资源。

方法2：生成相对于当前请求页面的纯相对路径 #

若需严格使用非绝对路径（不以/开头），可解析当前请求的脚本路径，计算到assets目录的相对层级：

// 在 inc/header.php 中添加
// 当前请求脚本的URI目录（例：访问proj1/sub/page.php时，值为"/proj1/sub"）
$current_script_dir = dirname($_SERVER['SCRIPT_NAME']);
// assets目录的完整URI（例："/proj1/assets"）
$assets_root_uri = str_replace($_SERVER['DOCUMENT_ROOT'], '', dirname(__DIR__) . '/assets');

// 分解路径为数组，计算相对层级
$current_parts = explode('/', trim($current_script_dir, '/'));
$assets_parts = explode('/', trim($assets_root_uri, '/'));

// 找到路径的共同前缀
$common_depth = 0;
while (
    $common_depth < count($current_parts) 
    && $common_depth < count($assets_parts) 
    && $current_parts[$common_depth] === $assets_parts[$common_depth]
) {
    $common_depth++;
}

// 生成回退层级 + 剩余路径
$back_steps = count($current_parts) - $common_depth;
$relative_assets_path = str_repeat('../', $back_steps) . implode('/', array_slice($assets_parts, $common_depth));
?>

<!-- 使用纯相对路径引入资源 -->
<link rel="stylesheet" href="<?php echo $relative_assets_path; ?>/styles.css">
<script src="<?php echo $relative_assets_path; ?>/script.js"></script>

优势：完全脱离网站根目录配置限制，适合需要部署到任意子目录的场景。

方法3：定义全局项目路径常量（简化版） #

在项目根目录入口文件（如index.php）定义全局常量，后续所有页面直接复用：

// 在 proj1/index.php 顶部添加
define('PROJECT_ASSETS_URI', str_replace($_SERVER['DOCUMENT_ROOT'], '', __DIR__) . '/assets/');

在inc/header.php中直接使用：

<link rel="stylesheet" href="<?php echo PROJECT_ASSETS_URI; ?>styles.css">
<script src="<?php echo PROJECT_ASSETS_URI; ?>script.js"></script>

优势：代码简洁，适合目录结构固定的项目，只需在入口文件定义一次即可全局使用。

内容的提问来源于stack exchange，提问作者p-marco