详解 WordPress `get_theme_file_uri()` 函数的源码：如何处理子主题的优先级，并获取主题文件的 URL。

各位观众老爷们，大家好！ 今天咱们来聊聊 WordPress 里面一个看似简单，实则暗藏玄机的函数：get_theme_file_uri()。 这玩意儿，说白了，就是用来获取主题文件的 URL 的，听起来是不是so easy？但是，在子主题这个复杂关系里，它可不是简单粗暴地给你返回个URL就完事儿了。

咱们今天就来扒一扒它的源码，看看它到底是怎么处理子主题的优先级，以及如何找到正确的 URL 的。 准备好了吗？ Let’s dive in!

一、get_theme_file_uri() 的基本用法

先来点基础的，热热身。 get_theme_file_uri() 的基本用法很简单：

<?php
$stylesheet_uri = get_theme_file_uri( 'style.css' );
echo '<link rel="stylesheet" href="' . esc_url( $stylesheet_uri ) . '">';
?>

这行代码的意思是： 获取主题目录下的 style.css 文件的 URL，然后把它用在 <link> 标签里。 esc_url() 函数是为了安全起见，对 URL 进行转义，防止 XSS 攻击。

二、 源码解析：拨开云雾见真章

好了，基础知识过完了，咱们直接上源码。 get_theme_file_uri() 函数位于 wp-includes/theme.php 文件中。 为了方便大家阅读，我把源码简化了一下，去掉了不必要的注释和错误处理，只保留了核心逻辑。

function get_theme_file_uri( $file = '' ) {
  $theme = wp_get_theme();

  if ( $theme->parent() ) {
    $template_dir_uri = $theme->parent()->get_template_directory_uri();
    $stylesheet_dir_uri = $theme->get_stylesheet_directory_uri();

    if ( file_exists( get_stylesheet_directory() . '/' . $file ) ) {
      return $stylesheet_dir_uri . '/' . ltrim( $file, '/' );
    } else {
      return $template_dir_uri . '/' . ltrim( $file, '/' );
    }
  } else {
    $template_dir_uri = $theme->get_template_directory_uri();
    return $template_dir_uri . '/' . ltrim( $file, '/' );
  }
}

是不是感觉有点懵？ 别怕，我来一行一行地解释：

1. $theme = wp_get_theme();： 获取当前主题的对象。这个对象包含了主题的所有信息，比如主题名称、版本、作者等等。

2. if ( $theme->parent() ) { ... } else { ... }： 这是一个判断语句，用来判断当前主题是否有父主题（也就是是否是子主题）。 如果有父主题，就执行 if 里面的代码；否则，执行 else 里面的代码。

3. 子主题的情况 (if 分支)：

   • $template_dir_uri = $theme->parent()->get_template_directory_uri();： 获取父主题的模板目录的 URL。 模板目录是存放主题文件的目录，比如 header.php、footer.php 等等。

   • $stylesheet_dir_uri = $theme->get_stylesheet_directory_uri();： 获取子主题的样式目录的 URL。 样式目录通常是存放 style.css 文件的目录。

   • if ( file_exists( get_stylesheet_directory() . '/' . $file ) ) { ... } else { ... }： 这是一个关键的判断语句。 它用来判断子主题的样式目录下是否存在指定的文件。

     • 如果存在，就返回子主题样式目录下的文件 URL。 也就是说，子主题优先使用自己的文件。
     • 如果不存在，就返回父主题模板目录下的文件 URL。 也就是说，如果子主题没有这个文件，就使用父主题的文件。

4. 非子主题的情况 (else 分支)：

   • $template_dir_uri = $theme->get_template_directory_uri();： 获取主题的模板目录的 URL。

   • return $template_dir_uri . '/' . ltrim( $file, '/' );： 直接返回主题模板目录下的文件 URL。

三、 子主题优先级： 抽丝剥茧见真理

从上面的源码分析可以看出，get_theme_file_uri() 函数在处理子主题时，遵循以下优先级：

1. 子主题自己的文件： 如果子主题目录下存在指定的文件，就优先使用子主题的文件。
2. 父主题的文件： 如果子主题目录下不存在指定的文件，就使用父主题的文件。

这种优先级机制，使得子主题可以很方便地覆盖父主题的文件，而不需要复制父主题的所有文件。 这大大简化了子主题的开发和维护。

举个例子：

假设我们有一个父主题 ParentTheme，它的模板目录下有一个文件 header.php。 我们创建了一个子主题 ChildTheme，并且在子主题的样式目录下也创建了一个 header.php 文件。

当我们使用 get_theme_file_uri( 'header.php' ) 函数时，它会返回 ChildTheme/header.php 的 URL，而不是 ParentTheme/header.php 的 URL。 因为子主题目录下存在 header.php 文件。

但是，如果我们在子主题的样式目录下删除了 header.php 文件，再次使用 get_theme_file_uri( 'header.php' ) 函数时，它就会返回 ParentTheme/header.php 的 URL。 因为子主题目录下不存在 header.php 文件，所以会使用父主题的文件。

为了更清晰地说明这个优先级，我给大家准备了一个表格：

文件名	父主题目录	子主题目录	get_theme_file_uri('文件名') 返回值
style.css	/wp-content/themes/ParentTheme/style.css	/wp-content/themes/ChildTheme/style.css	/wp-content/themes/ChildTheme/style.css
header.php	/wp-content/themes/ParentTheme/header.php	/wp-content/themes/ChildTheme/header.php	/wp-content/themes/ChildTheme/header.php
footer.php	/wp-content/themes/ParentTheme/footer.php		/wp-content/themes/ParentTheme/footer.php
functions.php	/wp-content/themes/ParentTheme/functions.php		这个文件比较特殊，不会通过 get_theme_file_uri 获取， 通常是通过 include 或 require 直接引入

四、 get_stylesheet_directory() 和 get_template_directory()： 傻傻分不清楚？

在分析 get_theme_file_uri() 函数的源码时，我们用到了 get_stylesheet_directory() 和 get_template_directory() 这两个函数。 这两个函数经常被混淆，所以我们有必要来区分一下：

• get_stylesheet_directory()： 获取 当前使用的主题 的样式目录的绝对路径。 如果是子主题，就返回子主题的样式目录的绝对路径；如果是父主题，就返回父主题的样式目录的绝对路径。
• get_template_directory()： 获取 父主题 的模板目录的绝对路径。 即使当前使用的是子主题，它仍然返回父主题的模板目录的绝对路径。

可以用一个表格来总结他们的区别：

函数	返回值	适用场景
get_stylesheet_directory()	当前使用的主题的样式目录的绝对路径	主要用于获取当前使用的主题的 style.css 文件，或者其他样式文件。 在子主题中，可以用来获取子主题自己的样式文件。
get_template_directory()	父主题的模板目录的绝对路径	主要用于获取父主题的模板文件，比如 header.php、footer.php 等等。 在子主题中，可以用来获取父主题的模板文件，如果子主题没有覆盖这些文件的话。

五、 get_theme_file_path()： 获取文件路径

与 get_theme_file_uri() 函数类似，WordPress 还有一个 get_theme_file_path() 函数， 它的作用是获取主题文件的绝对路径，而不是 URL。

<?php
$header_path = get_theme_file_path( 'header.php' );
include( $header_path );
?>

这段代码的意思是： 获取主题目录下的 header.php 文件的绝对路径，然后把它包含进来。

get_theme_file_path() 函数的源码和 get_theme_file_uri() 函数非常相似，唯一的区别是它返回的是文件的绝对路径，而不是 URL。

六、 总结： 温故而知新

今天我们深入分析了 WordPress 的 get_theme_file_uri() 函数， 了解了它如何处理子主题的优先级，以及如何获取主题文件的 URL。 我们还区分了 get_stylesheet_directory() 和 get_template_directory() 这两个函数， 以及介绍了 get_theme_file_path() 函数。

希望通过今天的讲解，大家对 WordPress 主题机制有了更深入的了解。 以后在开发主题或者子主题的时候，就能更加得心应手了。

最后，给大家留一个小作业： 尝试修改 get_theme_file_uri() 函数的源码， 改变子主题的优先级， 比如让子主题优先使用父主题的文件，而不是自己的文件。 看看会发生什么？

今天的讲座就到这里， 感谢大家的观看！ 咱们下期再见！