WordPress 获取附件 URL 函数：wp_get_attachment_url 源码解析

WordPress 获取附件 URL 函数：wp_get_attachment_url 源码解析

在 WordPress 中，想要获取已上传附件的 URL，可以使用 wp_get_attachment_url 函数。本文将深入解析该函数的源代码，帮助你更好地理解其工作原理。

源代码分析

/**
 * Retrieve the URL for an attachment.
 *
 * @since 2.1.0
 *
 * @param int|WP_Post $attachment Attachment ID or object.
 * @return string|false Attachment URL or false if no URL could be retrieved.
 */
function wp_get_attachment_url( $attachment_id ) {
    $attachment_id = absint( $attachment_id );
    $url           = '';

    if ( $attachment_id ) {
        $url = wp_get_attachment_url_raw( $attachment_id );
    }

    /**
     * Filters the attachment URL.
     *
     * @since 2.1.0
     *
     * @param string      $url           URL for the given attachment.
     * @param int|WP_Post $attachment_id Attachment ID or object.
     */
    return apply_filters( 'wp_get_attachment_url', $url, $attachment_id );
}

1. 函数参数: wp_get_attachment_url 函数接收一个参数 $attachment_id，它可以是附件的 ID 或附件对象。

2. 获取附件 URL: 首先，函数将 $attachment_id 转换为整数类型。如果 $attachment_id 有效，则调用 wp_get_attachment_url_raw 函数获取附件的 URL，并将结果赋值给 $url 变量。

3. 应用过滤器: 最后，函数使用 apply_filters 函数应用 wp_get_attachment_url 过滤器，允许开发者修改附件 URL。

函数使用场景

• 在主题或插件中，需要获取附件的 URL 进行展示或操作时。
• 在自定义函数或模板中，需要动态获取附件 URL 时。

总结

wp_get_attachment_url 函数是 WordPress 中获取附件 URL 的便捷方法。通过源代码分析，我们可以更好地理解该函数的内部工作机制，并根据需要进行自定义。