get_theme_file_path()

检索主题中文件的路径。

原型

get_theme_file_path( string $file = '' )

描述

在模板目录之前搜索样式表目录，以便从父主题继承的主题可以覆盖一个文件。

参数

$file (string) (Optional)  要在样式表目录中搜索的文件。

返回值

(string)  文件的路径。

源文件

路径：wp-includes/link-template.php

<?php
...
function get_theme_file_path( $file = '' ) {
	$file = ltrim( $file, '/' );
	if ( empty( $file ) ) {
		$path = get_stylesheet_directory();
	} elseif ( file_exists( get_stylesheet_directory() . '/' . $file ) ) {
		$path = get_stylesheet_directory() . '/' . $file;
	} else {
		$path = get_template_directory() . '/' . $file;
	}
	/**
	 * Filters the path to a file in the theme.
	 *
	 * @since 4.7.0
	 *
	 * @param string $path The file path.
	 * @param string $file The requested file to search for.
	 */
	return apply_filters( 'theme_file_path', $path, $file );
}
...
?>

其他

英文文档：https://developer.wordpress.org/reference/functions/get_theme_file_path/