如何从 WordPress 附件 URL 中提取相对路径（不含域名）-php教程-PHP中文网

如何从 WordPress 附件 URL 中提取相对路径（不含域名）

本文介绍在 WordPress 开发中，如何将 wp_get_attachment_url() 返回的完整 URL（如 https://example.com/wp-content/uploads/...）安全、可靠地转换为以 /wp-content/ 开头的相对路径（如 /wp-content/uploads/...），避免硬编码和正则误匹配风险。

本文介绍在 wordpress 开发中，如何将 `wp_get_attachment_url()` 返回的完整 url（如 `https://example.com/wp-content/uploads/...`）安全、可靠地转换为以 `/wp-content/` 开头的相对路径（如 `/wp-content/uploads/...`），避免硬编码和正则误匹配风险。

在 WordPress 主题或插件开发中，常需生成指向上传文件的链接。wp_get_attachment_url($id) 是标准方法，但它始终返回绝对 URL（含协议、域名和路径），例如：

https://example.com/wp-content/uploads/2022/03/sample.pdf

而某些场景（如 AJAX 响应、前端 JS 路径处理、CDN 兼容逻辑或服务端文件系统操作）更需要服务器内部路径的相对表示——即以 / 开头、不含协议与域名的路径部分：

/wp-content/uploads/2022/03/sample.pdf

✅ 推荐方案：使用 PHP 内置函数 parse_url()

这是最健壮、语义清晰且兼容所有 URL 结构（HTTP/HTTPS、子目录安装、多站点等）的方式：

word报告自动生成神器

Word报告自动生成神器。自动生成专业Word文档报告，支持模板填充、目录生成、表格/图表插入、页眉页脚、多级标题、样式主题、批量邮件合并。当用户需要生成Word报告、创建合同文档、批量生成通知/证书、填充Word模板、制作商业计划书时触发。

下载

$full_url = wp_get_attachment_url($file->ID);
$relative_path = parse_url($full_url, PHP_URL_PATH);

// 安全输出到 HTML 属性（仍需 esc_url 对 URL 类属性，但此处是路径，建议 esc_attr）
$files[$file->ID]['file_title'] = sprintf(
    '<p><a target="_blank" href="%s">%s</a>%s</p>',
    esc_url($relative_path), // 注意：此处 $relative_path 本身是相对路径，但 href 属性接受相对路径；若需确保跨环境兼容，也可用 site_url($relative_path)
    esc_html($real_title),
    esc_html($title)
);

⚠️ 为什么不推荐 str_replace() 或正则？
例如：

// ❌ 危险示例（硬编码域名，且易出错）
str_replace('https://example.com', '', $url);
// ❌ 更危险（忽略协议变化、子目录、大小写等）
preg_replace('#^https?://[^/]+#', '', $url);

问题包括：

域名可能为 www.example.com、example.com:8080 或 HTTPS；
站点可能安装在子目录（如 https://example.com/blog/），此时路径实际为 /blog/wp-content/...；
多站点环境下主站与子站域名不同；
parse_url() 自动处理 URL 组成结构，无需假设格式。

? 进阶提示：与 WP_CONTENT_DIR 的区别
注意：parse_url(..., PHP_URL_PATH) 返回的是Web 可访问的相对路径（用于或 wp_get_attachment_image_src），而非服务器绝对文件系统路径（如 /var/www/html/wp-content/uploads/...）。如需后者，请使用 get_attached_file($file->ID)。

✅ 总结

✅ 始终优先使用 parse_url($url, PHP_URL_PATH) 提取路径；
✅ 避免字符串替换或正则处理 URL —— 它们脆弱且不可维护；
✅ 在 HTML 输出中，对 href 使用 esc_url()（即使传入的是相对路径，esc_url() 也安全）；
✅ 若需构造完整可访问 URL，推荐 site_url($relative_path)，它自动适配站点地址（含子目录）且更语义化。

这样即可干净、可靠地从附件 URL 中剥离域名，获得符合 Web 标准的相对路径。