本文介绍在 Laravel Orchid 中获取附件相对路径（如 /storage/...）的两种可靠方法，避免返回完整绝对 URL，便于前端灵活处理资源路径。
本文介绍在 laravel orchid 中获取附件相对路径（如 `/storage/...`）的两种可靠方法，避免返回完整绝对 url，便于前端灵活处理资源路径。
在 Laravel Orchid 中，通过 Attachment 模型上传文件后，调用 $attachment->url() 默认返回的是完整绝对 URL（例如 http://localhost/storage/2022/06/08/xxx.jpg），这在某些场景下（如前后端分离、CDN 部署或路径拼接）并不理想。实际开发中，我们往往需要一个以 / 开头的相对 URL（即从 Web 根目录起始的路径），例如 /storage/2022/06/08/xxx.jpg，以便前端统一拼接域名、协议或 CDN 域名。
Orchid 提供了原生支持——直接使用 $attachment->relativeUrl 属性即可获取该相对路径，无需额外解析：
public function uploadPhoto(Request $request)
{
$file = new File($request->file('fileData'));
$attachment = $file->load();
// ✅ 推荐：直接获取相对 URL（Laravel Orchid 内置属性）
$relativeUrl = $attachment->relativeUrl;
// ✅ 备选：通过 parse_url 手动提取路径部分（兼容性更强）
// $relativeUrl = parse_url($attachment->url(), PHP_URL_PATH);
\Log::info('Uploaded relative URL', ['url' => $relativeUrl]);
return response()->json([
'url' => $relativeUrl,
'id' => $attachment->id,
]);
}⚠️ 注意事项：
- $attachment->relativeUrl 是 Orchid Attachment 模型的原生属性（自 v11.10+ 稳定支持），其值由 Storage::url() 的底层逻辑推导而来，已适配默认 public 磁盘配置（'storage' 盘映射至 public/storage 符号链接）。确保你的 config/filesystems.php 中 disks.public.root 和 disks.storage.url 配置正确。
- 若使用 S3 或其他外部存储驱动，$attachment->url() 会触发远程存在性校验（影响性能），而 $attachment->relativeUrl 不进行校验，仅返回逻辑路径。如需校验，请自行结合 Storage::exists() 判断。
- 不建议长期依赖 parse_url(..., PHP_URL_PATH) 方案，因其隐含对 url() 方法返回格式的强假设；而 relativeUrl 是语义明确、框架维护的官方接口，更健壮、可读性更高。
综上，优先使用 $attachment->relativeUrl —— 它简洁、高效、语义清晰，是 Orchid 官方推荐的相对路径获取方式。
