分析 `get_author_posts_url()` 函数的源码，它如何根据作者 ID 生成文章列表页的链接。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

各位观众，晚上好！我是你们的老朋友，今天我们来聊聊一个在 WordPress 世界里相当重要的小家伙：get_author_posts_url() 函数。别看它名字长，其实作用很简单，就是帮你生成作者文章列表页面的 URL。但魔鬼藏在细节里，所以今天我们就要把它扒个精光，看看它是怎么工作的。

一、开场白：为什么要关心这个函数？

想想看，如果你想做一个展示所有作者文章的页面，或者你想在作者资料页放一个链接，让用户可以轻松浏览这个作者的所有作品，你就需要用到这个函数。它就像一个导航员，指引用户找到特定作者的文章宝藏。没有它，你就得自己手动拼接 URL，那可太麻烦了，而且容易出错。

二、get_author_posts_url() 的基本用法

最简单的用法是直接传入作者 ID：

<?php
$author_id = 123; // 假设作者 ID 是 123
$author_url = get_author_posts_url( $author_id );

echo '<a href="' . esc_url( $author_url ) . '">查看该作者的文章</a>';
?>

这段代码会生成一个指向作者 ID 为 123 的文章列表页面的链接。 esc_url() 函数很重要，它可以确保 URL 是安全的，防止 XSS 攻击。

三、源码解剖：get_author_posts_url() 的内部结构

好的，现在我们深入 get_author_posts_url() 的源码，看看它是怎么工作的。为了方便理解，我们简化一下 WordPress 内核代码（毕竟内核代码比较复杂），保留核心逻辑。

function my_get_author_posts_url( $author_id, $author_nicename = '' ) {
    global $wp_rewrite;

    $author_id = (int) $author_id; // 确保是整数
    $author_link = '';

    if ( empty( $author_nicename ) ) {
        $author = get_userdata( $author_id );
        if ( ! $author ) {
            return false; // 作者不存在
        }
        $author_nicename = $author->user_nicename;
    }

    $author_nicename = rawurlencode( $author_nicename );

    if ( $wp_rewrite->using_permalinks() ) {
        $author_link = $wp_rewrite->get_author_permastruct();

        if ( ! empty( $author_link ) ) {
            $author_link = str_replace( '%author%', $author_nicename, $author_link );
            $author_link = home_url( user_trailingslashit( $author_link, 'author' ) );
        } else {
            $author_link = home_url( '?author=' . $author_id );
        }
    } else {
        $author_link = home_url( '?author=' . $author_id );
    }

    /**
     * Filters the URL for the author posts page.
     *
     * @since 2.1.0
     *
     * @param string $author_link URL for the author's posts page.
     * @param int    $author_id   Author ID.
     * @param string $author_nicename Author nicename.
     */
    $author_link = apply_filters( 'author_link', $author_link, $author_id, $author_nicename );

    return $author_link;
}

让我们一行一行地分析：

$author_id = (int) $author_id;: 首先，它会确保传入的 $author_id 是一个整数。这是一种安全措施，防止恶意用户传递非整数值。
if ( empty( $author_nicename ) ) { ... }: 如果 $author_nicename (作者别名) 为空，它会尝试通过 get_userdata( $author_id ) 获取作者信息，并从中提取 user_nicename。 user_nicename 通常是作者登录名的 URL 安全版本。
$author_nicename = rawurlencode( $author_nicename );: 使用 rawurlencode() 对 $author_nicename 进行 URL 编码。这是为了确保别名中的特殊字符 (例如空格) 在 URL 中正确显示。
if ( $wp_rewrite->using_permalinks() ) { ... }: 这是关键部分！它检查 WordPress 是否启用了固定链接。固定链接会影响 URL 的结构。
- $author_link = $wp_rewrite->get_author_permastruct();: 如果启用了固定链接，它会尝试获取作者固定链接结构。这个结构定义了作者 URL 的基本格式 (例如 /%author%/)。
- $author_link = str_replace( '%author%', $author_nicename, $author_link );: 它会将固定链接结构中的 %author% 占位符替换为实际的作者别名。
- $author_link = home_url( user_trailingslashit( $author_link, 'author' ) );: 它将构建好的 URL 与网站的根 URL (通过 home_url() 获取) 组合在一起，并使用 user_trailingslashit() 添加或删除尾部的斜杠，以保持 URL 的一致性。
- else { $author_link = home_url( '?author=' . $author_id ); }: 如果没有定义作者固定链接结构，则回退到使用查询字符串的 URL 格式 (例如 ?author=123)。
else { $author_link = home_url( '?author=' . $author_id ); }: 如果没有启用固定链接，它会使用查询字符串的 URL 格式。
$author_link = apply_filters( 'author_link', $author_link, $author_id, $author_nicename );: 这是一个过滤器钩子，允许其他插件或主题修改最终的作者 URL。这提供了极大的灵活性。
return $author_link;: 最后，函数返回生成的作者 URL。

四、固定链接的重要性

从上面的代码可以看出，固定链接对作者 URL 的结构有很大的影响。如果启用了固定链接，URL 会更简洁、更易读，也更 SEO 友好。例如：

启用固定链接: https://example.com/author/john-doe/
禁用固定链接: https://example.com/?author=123

启用固定链接后，WordPress 会使用 .htaccess (或 Nginx 的相应配置) 将这些 "漂亮" 的 URL 重写为内部的查询字符串格式。

五、wp_rewrite 对象：固定链接的幕后英雄

$wp_rewrite 是一个全局对象，负责处理 WordPress 中的固定链接。它包含了所有关于固定链接规则的信息，包括文章、页面、分类、标签和作者的固定链接结构。

我们可以通过 $wp_rewrite->rules 属性查看当前生效的固定链接规则。这是一个关联数组，其中键是正则表达式，值是重写规则。

六、user_trailingslashit()：尾部斜杠的秘密

user_trailingslashit() 函数用于确保 URL 的尾部斜杠保持一致。它会根据 WordPress 的设置 (在 "设置" -> "固定链接" 中) 添加或删除尾部的斜杠。这可以避免重复内容的问题，并提高 SEO。

七、apply_filters( 'author_link', ... )：扩展性的基石

apply_filters() 函数是 WordPress 插件和主题扩展性的关键。它允许开发者修改函数的结果，而无需修改函数本身的源码。

在这个例子中，'author_link' 过滤器允许其他插件或主题修改作者 URL。例如，一个插件可以添加额外的查询参数，或者使用完全不同的 URL 结构。

八、更高级的用法：自定义作者固定链接结构

WordPress 允许你自定义作者固定链接结构。这需要使用 add_rewrite_tag() 和 add_rewrite_rule() 函数。这是一个比较高级的主题，我们简单介绍一下。

add_rewrite_tag(): 定义一个新的重写标签。例如，你可以定义一个 '%author_id%' 标签，用于在 URL 中包含作者 ID。
add_rewrite_rule(): 定义一个新的重写规则。这个规则将匹配特定的 URL 模式，并将其重写为内部的查询字符串格式。

自定义固定链接结构需要对 WordPress 的重写规则有深入的了解，并且需要小心处理，以避免与其他插件或主题冲突。

九、实战演练：创建一个显示所有作者文章的页面

现在，让我们用 get_author_posts_url() 函数创建一个实际的例子。我们将创建一个页面，显示网站上所有作者的列表，并为每个作者提供一个指向其文章列表页面的链接。

<?php
/*
Template Name: 所有作者
*/

get_header();

// 获取所有作者
$authors = get_users( array( 'who' => 'authors' ) );

?>

<div id="primary" class="content-area">
    <main id="main" class="site-main">

        <h1>所有作者</h1>

        <ul>
            <?php
            foreach ( $authors as $author ) {
                $author_url = get_author_posts_url( $author->ID, $author->user_nicename );
                echo '<li><a href="' . esc_url( $author_url ) . '">' . esc_html( $author->display_name ) . '</a></li>';
            }
            ?>
        </ul>

    </main><!-- #main -->
</div><!-- #primary -->

<?php
get_sidebar();
get_footer();
?>

这段代码首先获取所有具有 "作者" 角色的用户。然后，它循环遍历每个作者，使用 get_author_posts_url() 函数获取其文章列表页面的 URL，并创建一个指向该页面的链接。

十、调试技巧：当 get_author_posts_url() 返回错误的结果时

有时候，get_author_posts_url() 函数可能会返回错误的结果。以下是一些调试技巧：

检查作者 ID 是否正确: 确保你传递给函数的作者 ID 是有效的。
检查作者别名是否正确: 如果指定了作者别名，确保它是正确的。
检查固定链接设置: 确保固定链接已启用，并且作者固定链接结构已正确配置。
检查 .htaccess 文件: 如果启用了固定链接，确保你的 .htaccess 文件 (或 Nginx 的相应配置) 包含了正确的重写规则。
禁用所有插件并切换到默认主题: 这可以帮助你确定是否是插件或主题冲突导致的问题。
使用 var_dump() 或 print_r() 函数: 打印 $wp_rewrite 对象的内容，可以帮助你了解固定链接规则是如何配置的。

十一、总结：get_author_posts_url() 的力量

get_author_posts_url() 函数是一个简单但强大的工具，可以帮助你轻松生成作者文章列表页面的 URL。通过理解其内部结构，你可以更好地利用它，并解决可能出现的问题。希望今天的讲解对你有所帮助！

十二、思考题

如果不使用 get_author_posts_url()，手动构建作者文章列表页面的 URL 会有哪些问题？
apply_filters( 'author_link', ... ) 过滤器在哪些场景下会非常有用？
如何自定义作者固定链接结构，并添加额外的 URL 参数？

下课！祝大家编程愉快！

发表回复 取消回复

发表回复取消回复