Получить сущность Entity::getInstance
Модуль: main — подключать отдельно не нужно
Статический метод Entity::getInstance возвращает сущность ORM по имени. При первом обращении метод создает сущность.
- Приводит имя к классу таблицы методом normalizeEntityClass.
- Создает объект класса из
DataManager::getEntityClassи вызывает initialize и postInitialize. - Вызывает
postInitializeкласса таблицы, если наследник его переопределил.
Следующие вызовы возвращают тот же объект.
Сигнатура метода в классе Bitrix\Main\ORM\Entity:
public static function getInstance($entityName)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| entityName* | string |
Задает имя сущности или класса таблицы |
Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод возвращает объект Entity.
Исключения
| Исключение | Когда возникает |
|---|---|
Error |
Класса таблицы нет |
Bitrix\Main\SystemException |
У таблицы с полями нет первичного ключа |
Bitrix\Main\ArgumentException |
Описание поля содержит неизвестный тип |
Примеры
Пример. Код получает сущность по имени класса таблицы:
<?php
use Bitrix\Main\ORM\Entity;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$entity = Entity::getInstance('\Bitrix\Main\Localization\LanguageTable');
echo $entity->getName() . ' ' . var_export($entity === Entity::get('Bitrix\Main\Localization\Language'), true);
Код выведет Language true.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая