---
title: "Мультитенантность"
description: "Подключение tenancy-драйвера, выбор тенанта и границы изоляции данных"
canonical_url: "https://frame.qubeek.io/ru/developers/customization/tenancy"
---
# Мультитенантность

> Подключение tenancy-драйвера, выбор тенанта и границы изоляции данных

Frame подключает изоляцию тенантов через `TenancyDriver`. Пока драйвер не зарегистрирован, панель работает в однотенантном режиме. Политики доступа к операциям настраиваются отдельно — см. [Авторизация ресурса](https://frame.qubeek.io/ru/developers/resources/authorization).

<warning>

Описанное ниже ограничение `SoftTenancyDriver` при отсутствии активного тенанта — изменение, подготовленное для следующего согласованного выпуска. Оно не заявляется как поведение базовой версии 0.4.7. До обновления проверьте версию установленного пакета и поведение своего драйвера.

</warning>

## Подключение

Зарегистрируйте драйвер в `boot()` провайдера приложения:

```php [app/Providers/AppServiceProvider.php]
use Frame\Core\Frame;
use Frame\Laravel\Tenancy\SoftTenancyDriver;

public function boot(): void
{
    Frame::useTenancy(SoftTenancyDriver::class);
}
```

Для общей БД `SoftTenancyDriver` использует колонку `tenant_id`. Добавьте её в таблицы, принадлежащие тенантам, и определите ограничения целостности в приложении. Таблицы без этой колонки считаются общими и не ограничиваются этим драйвером.

## Выбор тенанта

Модель пользователя приложения реализует `Frame\Core\Contracts\HasTenants`:

<table>
<thead>
  <tr>
    <th>
      Метод
    </th>
    
    <th>
      Назначение
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        tenants(): Collection
      </code>
    </td>
    
    <td>
      Возвращает доступные пользователю тенанты
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        canAccessTenant(object $tenant): bool
      </code>
    </td>
    
    <td>
      Проверяет доступ к конкретному тенанту
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        defaultTenant(): ?object
      </code>
    </td>
    
    <td>
      Возвращает тенанта по умолчанию либо <code>
        null
      </code>
    </td>
  </tr>
</tbody>
</table>

Middleware выбирает явно запрошенного тенанта через параметр `tid`, а при отсутствии выбора — тенанта по умолчанию. Доступ проверяется через `canAccessTenant()`. Недоступный явно выбранный или недоступный тенант по умолчанию приводит к отказу.

Отсутствие выбранного тенанта не блокирует middleware целиком: пользователю могут оставаться доступны выбор тенанта и другие общие разделы. Ограничение данных выполняется отдельно драйвером.

## Границы SoftTenancyDriver

Для таблиц с `tenant_id` поведение зависит от активного контекста:

<table>
<thead>
  <tr>
    <th>
      Операция драйвера
    </th>
    
    <th>
      Активный тенант задан
    </th>
    
    <th>
      Активного тенанта нет
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        scopeQuery()
      </code>
    </td>
    
    <td>
      Добавляет явное условие по тенанту
    </td>
    
    <td>
      Делает выборку пустой
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        associate()
      </code>
    </td>
    
    <td>
      Заполняет пустую колонку тенанта при создании
    </td>
    
    <td>
      Отклоняет привязку с HTTP 403
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        owns()
      </code>
    </td>
    
    <td>
      Сравнивает владельца записи с тенантом
    </td>
    
    <td>
      Возвращает <code>
        false
      </code>
    </td>
  </tr>
</tbody>
</table>

Для общих таблиц без tenant-колонки эти ограничения не применяются: выборка не сужается, `associate()` ничего не меняет, `owns()` возвращает `true`. Это не отменяет Laravel Policy и другие проверки прав приложения.

У [экспорта](https://frame.qubeek.io/ru/developers/resources/export#%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF-%D0%BA-%D1%81%D0%BE%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D1%8E-%D0%B8-%D1%81%D0%BA%D0%B0%D1%87%D0%B8%D0%B2%D0%B0%D0%BD%D0%B8%D1%8E) есть отдельное требование: контракт кандидата запрещает запуск без активного тенанта при включённой tenancy, в том числе для общей таблицы. Запрос получает HTTP 403 до создания batch, заданий и файлов выгрузки. Это проверено на Laravel 12.71 и не меняет описанное выше поведение shared-таблиц в обычных запросах. Кандидат не опубликован; это не обещание поведения базовой версии 0.4.7.

Драйвер добавляет явные условия в запрос. Не заменяйте их одним Eloquent global scope: Frame может снимать глобальные scopes при построении выборок.

`associate()` не перезаписывает уже заполненный `tenant_id`. Не доверяйте значению тенанта из загруженного файла или тела запроса; проверяйте владение при собственных операциях записи.

## Собственный драйвер и отдельные БД

Контракт `Frame\Core\Contracts\TenancyDriver` включает `currentTenant()`, `boot()`, `scopeQuery()`, `associate()` и `owns()`. Собственный драйвер определяет способ хранения контекста, фильтрации запросов и проверки владения.

`ConnectionSwitchTenancyDriver` служит основой для модели «БД на тенанта»: `boot()` переключает подключение, а построчные `scopeQuery()`, `associate()` и `owns()` не обеспечивают дополнительную изоляцию. Ограничения `SoftTenancyDriver` при пустом контексте на него не распространяются.

В приложении проверьте выбор подключения, общие таблицы, восстановление контекста очереди и сброс соединений между запросами долгоживущего процесса. Не считайте регистрацию per-DB драйвера готовой гарантией изоляции.

## Что дальше

- [Авторизация ресурса](https://frame.qubeek.io/ru/developers/resources/authorization) — настройте права на операции над моделями.
- [Экспорт](https://frame.qubeek.io/ru/developers/resources/export) — согласуйте worker и общее хранилище.
- [Импорт](https://frame.qubeek.io/ru/developers/resources/import) — проверьте загрузку данных в нужном контексте.
- [Расположение слотов](https://frame.qubeek.io/ru/developers/slots/locations) — найдите место переключателя тенанта.


## Sitemap

See the full [sitemap](https://frame.qubeek.io/sitemap.md) for all pages.
