PHP跨目录调用include文件时图片路径失效问题咨询

问题根源 #

HTML中的相对路径是相对于当前访问的页面URL，而非PHP文件的物理路径：

• 从subdomain/main-website/index.php访问时，页面基准URL是http://xxx/subdomain/main-website/，img/logo.png会正确解析到subdomain/main-website/img/logo.png
• 从subdomain/index.php访问时，页面基准URL是http://xxx/subdomain/，img/logo.png会被解析到subdomain/img/logo.png（不存在的路径），导致logo加载失败；同时导航链接也会指向错误的页面位置。

最优方案：定义站点根目录常量，使用绝对路径 #

通过PHP定义统一的站点根目录常量，让所有资源和页面链接都基于这个常量生成绝对路径，彻底解决跨目录引入的路径问题。

步骤1：在所有入口文件中定义常量

在subdomain/main-website/index.php和subdomain/index.php的最顶部添加：

// 定义站点根目录的URL路径（根据你的实际域名调整）
define('SITE_ROOT', '/subdomain/main-website/');

步骤2：修改header.php中的路径

将header.php里的资源和链接路径改为基于常量的绝对路径：

<div>
 <img class="logoImg" src="<?php echo SITE_ROOT; ?>img/logo.png" alt="" title="" />
</div>

<nav id="nav-menu-container">
 <ul class="nav-menu">
  <li class="menu-active"><a href="<?php echo SITE_ROOT; ?>index.php">Home</a></li>
  <li><a href="<?php echo SITE_ROOT; ?>about.php">About Us</a></li>
 </ul>
</nav>

可选优化：使用<base>标签简化路径

如果不想每个路径都写<?php echo SITE_ROOT; ?>，可以在header.php的<head>标签内添加<base>标签，统一基准路径：

<head>
  <!-- 其他head内容 -->
  <base href="<?php echo SITE_ROOT; ?>">
</head>

之后header.php中的路径可以保持原相对写法，浏览器会自动基于<base>的路径解析：

<div>
 <img class="logoImg" src="img/logo.png" alt="" title="" />
</div>

<nav id="nav-menu-container">
 <ul class="nav-menu">
  <li class="menu-active"><a href="index.php">Home</a></li>
  <li><a href="about.php">About Us</a></li>
 </ul>
</nav>

其他方案对比（不推荐） #

• 手动调整相对路径：在subdomain/index.php中引入header时，通过PHP判断当前页面位置动态修改路径，但这种方法需要维护多套路径判断逻辑，容易出错且扩展性差。
• 使用物理路径转URL：通过$_SERVER['DOCUMENT_ROOT']拼接物理路径再转URL，虽然可行，但不如直接定义站点根URL常量直观简洁。

内容的提问来源于stack exchange，提问作者us-er8192