如何在 WordPress 中动态获取当前域名与目录路径-php教程-PHP中文网

如何在 WordPress 中动态获取当前域名与目录路径

本文详解 wordpress 中安全、可移植地获取当前站点域名和资源路径的正确方法，推荐使用 home_url()、get_template_directory_uri() 等内置函数替代硬编码或服务器变量，确保项目迁移后 css、js、图片等资源仍能正常加载。

本文详解 wordpress 中安全、可移植地获取当前站点域名和资源路径的正确方法，推荐使用 home_url()、get_template_directory_uri() 等内置函数替代硬编码或服务器变量，确保项目迁移后 css、js、图片等资源仍能正常加载。

在 WordPress 开发中，直接依赖 $_SERVER 变量（如 $_SERVER['HTTP_HOST'] 或 dirname($_SERVER['PHP_SELF'])）来拼接 URL 是常见误区——它不仅易受服务器配置（如子目录安装、伪静态、反向代理）影响，还可能因协议（HTTP/HTTPS）、端口、重写规则导致链接失效，更无法适配多环境部署（如本地开发 → 测试站 → 生产站）。

✅ 正确做法：始终使用 WordPress 官方推荐的上下文感知函数，它们自动读取数据库中设置的 siteurl 和 home 地址，并智能处理协议、路径及子目录结构：

unity3d游戏开发之相机切换中文WORD版

本文档主要讲述的是unity3d游戏开发之相机切换；希望对大家会有帮助；感兴趣的朋友可以过来看看

下载

1. 获取站点根 URL（含协议与路径）

<?php echo home_url('/'); ?><!-- 输出示例：https://myurl.com/myproject/ （开发环境） --><!-- 输出示例：https://myurl.com/ （上线后） -->

home_url('/') 返回 WordPress「首页地址」（即 Settings → General → Site Address (URL)），自动包含完整协议、域名及子目录（如 /myproject），是引用站内链接（如导航、AJAX endpoints）的首选。

2. 引入主题资源（CSS/JS/图片）——推荐方式

<!-- 在主题的 header.php 或 functions.php 中 -->
<link rel="stylesheet" href="<?php%20echo%20get_stylesheet_directory_uri();%20?>/css/style.css"><script src="<?php%20echo%20get_template_directory_uri();%20?>/js/main.js"></script>
@@##@@" alt="Logo">

get_template_directory_uri()：返回父主题的 URL（如 https://myurl.com/myproject/wp-content/themes/mytheme）
get_stylesheet_directory_uri()：返回当前激活主题的 URL（子主题时指向子主题目录）
get_theme_file_uri($path)：安全获取主题内任意文件的绝对 URL，自动兼容子主题继承逻辑。

3. 获取服务器端文件系统路径（用于 require/include）

<?php require_once get_template_directory() . '/inc/custom-function.php';
$upload_dir = wp_upload_dir();
$custom_config = file_get_contents( $upload_dir['basedir'] . '/config.json' );
?>

get_template_directory() 返回父主题的物理路径（如 /var/www/myproject/wp-content/themes/mytheme）
get_stylesheet_directory() 返回当前主题（含子主题）的物理路径
⚠️ 注意：这些函数返回的是服务器绝对路径，不可用于 HTML 属性！

⚠️ 关键注意事项

❌ 避免 $_SERVER['HTTP_HOST'] + dirname($_SERVER['PHP_SELF'])：该组合在 Nginx、HTTPS 反向代理、WP-CLI 环境下极易出错，且不兼容 WordPress 多站点网络。
✅ 所有 URL 函数均支持参数扩展：home_url('/wp-admin/')、admin_url('edit.php')、includes_url('js/jquery.js')。
? 子目录安装无需额外处理：WordPress 自动识别并注入路径（如 /myproject/），开发者无需手动拼接。
? 安全性保障：home_url() 等函数会自动过滤恶意字符，防止 XSS 或路径遍历风险。

总之，遵循 WordPress 的“约定优于配置”原则，用好 home_url()、get_template_directory_uri() 等核心函数，不仅能实现无缝环境迁移，更是代码健壮性与可维护性的基石。