Права доступа
Suggest EditРазрешения определяют доступные действия, роли объединяют их для назначения пользователю. В логике приложения проверяйте разрешения, а для доступа к конкретным записям используйте политики Laravel. Скрытие кнопки или меню не заменяет авторизацию.
Регистрация разрешений
Добавьте группы в метод permissions() поставщика Orchid в приложении:
use Orchid\Access\PermissionGroup;
use Orchid\Platform\OrchidServiceProvider;
class PlatformProvider extends OrchidServiceProvider
{
public function permissions(): array
{
return [
PermissionGroup::make('Orders')
->add('orders.view', 'View orders')
->add('orders.update', 'Update orders'),
];
}
}
В обычном поставщике Laravel внедрите Orchid\Platform\Orchid в boot() и вызовите
$orchid->registerPermissionGroup($group) для каждой группы. Для статических вызовов используйте
Orchid\Support\Facades\Orchid. Регистрация делает разрешение доступным для назначения, но не выдаёт его пользователям.
Встроенные ключи включают orchid.users, orchid.roles и orchid.attachment.
Миграция старых назначений описана в руководстве по обновлению.
Проверка доступа
$user->hasAccess('orders.view');
$user->hasAnyAccess(['orders.view', 'orders.update']);
$user->hasAccess('orders.*');
hasAccess() проверяет собственные права пользователя и права его ролей. Любое совпавшее разрешение даёт доступ.
Запрет в собственных правах не отменяет разрешение роли. hasAnyAccess() проверяет наличие хотя бы одного разрешения;
пустой список не ограничивает доступ. Маска в проверке сопоставляется с именами назначенных разрешений.
use App\Models\User;
User::byAccess('orders.view')->get();
User::byAnyAccess(['orders.view', 'orders.update'])->get();
Эти scopes проверяют точные ключи без масок.
После изменения назначений уже загруженного пользователя вызовите $user->clearCachePermission() перед новой проверкой.
Методы addRole(), removeRole() и replaceRoles() сбрасывают этот кеш самостоятельно.
Значение permissions
User и Role приводят permissions к Orchid\Access\Permissions. Присвойте карту прав или объект Permissions и сохраните:
use Orchid\Access\Permissions;
$user->permissions = Permissions::make(['orders.view' => true]);
$user->save();
$user->permissions->isActive('orders.view');
$user->permissions->allows('orders.*');
$user->permissions->count();
$user->permissions->toArray();
count() считает разрешённые ключи. isEmpty() проверяет отсутствие любых назначений, включая запреты.
Это не массив и не изменяемая коллекция Laravel. Для изменения получите карту через toArray(), обновите её, присвойте обратно и сохраните модель. При расширении casts() сохраняйте родительское приведение Permissions.
Orchid::allowedPermissions() возвращает объект Permissions со всеми зарегистрированными разрешениями.
В авторизованном обработчике формы прав Orchid используйте
Permissions::fromEncodedForm($request->input('permissions', [])) для декодирования ключей флажков.
Изменять назначения должен только администратор с соответствующими правами.
Роли
Новая схема использует UUID для ролей и уникальные имена. Колонки slug больше нет.
Вместо удалённых getRoles(), getUsers(), getRoleId() и getRoleSlug() используйте отношения Eloquent:
use Orchid\Platform\Models\Role;
$role = Role::create([
'name' => 'Editor',
'permissions' => ['orders.view' => true, 'orders.update' => true],
]);
$user->addRole($role);
$user->roles()->get();
$user->inRole($role);
$role->users()->get();
$user->removeRole($role);
Ключ доступен через $role->getKey(), имя через $role->name.
inRole() принимает модель роли, ID или имя. Для назначения и удаления передавайте модель.
Перед использованием UUID-моделей существующим базам нужна миграция схемы.
Защита экранов и маршрутов
Определите необходимые разрешения экрана:
public function permission(): ?iterable
{
return ['orders.view'];
}
Если указано несколько разрешений, достаточно одного. По умолчанию отказ возвращает HTTP 403.
Для другого ответа переопределите статический метод unaccessed() экрана.
В обработчиках действий дополнительно проверяйте доступ к конкретной записи и валидируйте входные данные.
Для маршрутов вне настроенной группы middleware Orchid зарегистрируйте псевдоним в bootstrap/app.php:
use Illuminate\Foundation\Configuration\Middleware;
use Orchid\Platform\Http\Middleware\Access;
// In bootstrap/app.php:
->withMiddleware(function (Middleware $middleware): void {
$middleware->alias(['access' => Access::class]);
})
Route::screen('/orders', OrderListScreen::class)->middleware('access:orders.view');
В Blade проверяйте пользователя через @if (auth()->user()?->hasAccess('orders.view')).
Создание администратора
php artisan orchid:admin
php artisan orchid:admin --id=1
Команда выдаёт разрешения, зарегистрированные на момент её запуска. Новые разрешения нужно назначать отдельно.
Чтобы изменить создание пользователя, зарегистрируйте свою модель через Orchid::useModel() и переопределите createAdmin().
Вход от имени другого пользователя
Проверяйте право на смену пользователя до вызова. Настроенный guard Orchid должен поддерживать сессии:
use Orchid\Access\Impersonation;
Impersonation::loginAs($otherUser);
Impersonation::isImpersonating();
$originalUser = Impersonation::impersonator();
Impersonation::logout();