如何为WordPress上传的媒体文件设置自定义固定链接结构

问题分析 #

你需要将媒体附件（图片）的固定链接从www.example.com/imagename/改为www.example.com/img/imagename/，避免占用文章预留的slug。原代码失效的核心原因：

• add_permastruct第三个参数设为false，导致WordPress未自动生成对应重写规则
• 仅替换标签逻辑不完整，缺少URL解析的关联处理

修正后的完整代码 #

// 注册自定义附件固定链接结构与重写标签
add_action('init', 'custom_attachment_permastruct');
function custom_attachment_permastruct() {
    global $wp_rewrite;
    // 定义附件固定链接格式
    $wp_rewrite->add_permastruct('attachment', '/img/%attachment_postname%/', true);
    // 注册重写标签，关联附件的post_name字段
    $wp_rewrite->add_rewrite_tag('%attachment_postname%', '([^/]+)', 'attachment=');
}

// 过滤附件链接生成，替换标签为实际post_name
add_filter('post_type_link', 'custom_attachment_link', 10, 3);
function custom_attachment_link($permalink, $post, $leavename) {
    if ($post->post_type === 'attachment') {
        $permalink = str_replace('%attachment_postname%', $post->post_name, $permalink);
        return $permalink;
    }
    return $permalink;
}

// 修正查询逻辑，确保能解析/img/开头的附件URL
add_filter('request', 'custom_attachment_request');
function custom_attachment_request($query_vars) {
    if (isset($query_vars['attachment']) && !is_numeric($query_vars['attachment'])) {
        // 通过post_name查询对应附件ID
        $post_id = get_post_id_from_name($query_vars['attachment'], 'attachment');
        if ($post_id) {
            $query_vars['attachment'] = $post_id;
        }
    }
    return $query_vars;
}

// 辅助函数：通过post_name获取指定类型的内容ID
function get_post_id_from_name($post_name, $post_type = 'post') {
    $posts = get_posts([
        'name' => $post_name,
        'post_type' => $post_type,
        'numberposts' => 1,
        'fields' => 'ids'
    ]);
    return !empty($posts) ? $posts[0] : false;
}

操作步骤 #

• 将代码添加到主题functions.php文件或自定义插件中
• 进入WordPress后台「设置→固定链接」，无需修改设置，直接点击保存更改触发重写规则刷新
• 此时查看媒体库中附件的固定链接，已变为www.example.com/img/imagename/格式

内容的提问来源于stack exchange，提问作者theKing