wordpress - wordpress 中的 get_header_image() 和 header_image() 有什么区别

Question

在从官方wordpress主题开发手册中自我学习的过程中，
此页面显示了如何创建标题并使用了两个不同的功能：

• get_header_image()
• header_image()

两者都返回一个字符串，即图像 URL。
这只是另一个令人困惑的冗余吗？或者两者之间是否存在实际差异。

Answer 1

语义

展示

在容易看到的地方突出展示（某物）。

宫殿曾经展示一系列佛兰芒挂毯。

取回

拿回或带回（某物）；重新拥有。

我被派去从他的花园里取回球

---

如何

虽然header_image()会回显标题图像 URL，get_header_image()但不会。

<?php

header_image();

get_header_image();

header_image()是get_header_image(). 主要用在前端，作用是逃逸回显get_header_image()。

<?php

/**
 * Displays header image URL.
 *
 * @link https://developer.wordpress.org/reference/functions/header_image/
 */
function header_image() {
    $image = get_header_image();
 
    if ( $image ) {
        echo esc_url( $image );
    }
}

的一个实际用例get_header_image()将在函数内部。

WordPress 将这种get_ ...区别用于大多数默认功能，例如：

• get_the_title()和the_title()。
• get_the_post_thumbnail()和the_post_thumbnail()。
• get_the_content()和the_content()。... ETC。

Answer 2

我找到了答案。
有人发布它然后很快将其删除，但只是为了让每个正在寻找答案的人受益：
header_image()将回显 URL 而无需使用 php echo。虽然get_header_image()也将返回图像 URL，但它不会回显它。您必须为此使用 php echo。
注意：官方文档中没有提到这一点，除非我是盲人，否则我挑战任何人向我展示它在官方页面中的echo位置，或者解释了这种区别的位置。