Skip to content
本页为翻译版本:如有出入,以英文文档为准。 阅读英文版

关联页面 ​

启用 ​

可以在 resource 上为所有 relation manager 启用,也可以只在需要的 relation manager 上启用:

php
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;

class OrdersRelationManager extends RelationManager
{
    use InteractsWithRelationPage;
}
设置方式拥有页面的关联
在 resource 上使用 HasRelationPages全部,除了主动排除的
在 manager 上使用 InteractsWithRelationPage只有启用了它的 manager
你自己编写的页面类(见下文)全部,除了主动排除的

要排除某些关联:

php
// 在 resource 上
public static function hasRelationPage(string $slug): bool
{
    return $slug !== 'notes';
}

// 在 relation manager 上,配合 InteractsWithRelationPage
protected static bool $hasRelationPage = false;

被两个 resource 共用的 relation manager 会在两边都启用:用 resource 的 hasRelationPage() 排除其中一个。

URL 和 slug ​

getRelations() 条目URL
'orders' => OrdersRelationManager::class/customers/1/orders
SupportTicketsRelationManager::class(不带键)/customers/1/support-tickets
RelationGroup::make('Activity', [...])/customers/1/activity

relation manager 自己设置的 slug 优先(protected static ?string $relationPageSlug = 'tickets';),其次是 getRelations() 中的键,最后是 kebab-case 形式的关联关系名称(或分组标签:请给分组设置键,因为翻译后的标签会随语言变化)。与 resource 某个页面键(edit、view……)相同的 slug 会被跳过,slug 已被占用的第二个关联也会被跳过。

每个页面都是一个命名路由 relations.{slug}:

php
CustomerResource::getUrl('relations.orders', ['record' => $customer]);

授权与行为 ​

relation manager 接收 resource 的查看页面作为 $pageClass(没有查看页面时为编辑页面),因此 isReadOnly()、canViewForRecord()、getBadge() 以及其他所有检查的行为都与在标签页中完全一致。查看页面通过键(view、edit,或你自己编写的页面类上的 $contextPage)或类来查找。

关联页面需要满足查看页面的要求(它的 canAccess() 以及记录的 view policy;当它代表编辑页面时为 update),以及 manager 的 canViewForRecord()。没有查看页面和编辑页面时,适用 view policy。以“未找到”方式拒绝的 policy 会返回 404,未知的 slug 也一样。菜单、全局搜索和“作为页面打开”只会链接用户能打开的页面。

关联页面不会运行查看页面自己的代码:它的 authorizeAccess() 中的检查,或按用户过滤的 getRelationManagers(),在这里都不生效。请把它们放到 policy 或 canViewForRecord() 中,或者在 resource 上按记录否决某个关联页面:

php
public static function canAccessRelationPage(Model $record, string $slug): bool
{
    return $slug !== 'audit-logs' || auth()->user()->isAdmin();
}

版本 1.8.1,发布于 2026-11-15 · MIT 许可证。