Класс yii\BaseYii
| Наследование | yii\BaseYii |
|---|---|
| Подклассы | Yii |
| Доступно с версии | 2.0 |
| Исходный код | https://github.com/yiisoft/yii2/blob/master/framework/BaseYii.php |
BaseYii — это основной вспомогательный класс для фреймворка Yii.
Не используйте BaseYii напрямую. Вместо этого используйте его дочерний класс Yii, который вы можете заменить, чтобы настроить методы BaseYii.
Публичные свойства
| Свойство | Тип | Описание | Определено в |
|---|---|---|---|
| $aliases | массив | Зарегистрированные псевдонимы путей | yii\BaseYii |
| $app | yii\console\Application|yii\web\Application | Экземпляр приложения | yii\BaseYii |
| $classMap | массив | Карта классов, используемая механизмом автозагрузки Yii. | yii\BaseYii |
| $container | yii\di\Container | Контейнер внедрения зависимостей (DI), используемый методом createObject(). | yii\BaseYii |
Публичные методы
| Метод | Описание | Определено в |
|---|---|---|
| autoload() | Загрузчик автозагрузки классов. | yii\BaseYii |
| beginProfile() | Помечает начало блока кода для профилирования. | yii\BaseYii |
| configure() | Конфигурирует объект с начальными значениями свойств. | yii\BaseYii |
| createObject() | Создает новый объект, используя заданную конфигурацию. | yii\BaseYii |
| endProfile() | Помечает конец блока кода для профилирования. | yii\BaseYii |
| error() | Записывает сообщение об ошибке. | yii\BaseYii |
| getAlias() | Преобразует псевдоним пути в фактический путь. | yii\BaseYii |
| getLogger() | yii\BaseYii | |
| getObjectVars() | Возвращает публичные переменные члена объекта. | yii\BaseYii |
| getRootAlias() | Возвращает часть корневого псевдонима заданного псевдонима. | yii\BaseYii |
| getVersion() | Возвращает строку, представляющую текущую версию фреймворка Yii. | yii\BaseYii |
| info() | Записывает информационное сообщение. | yii\BaseYii |
| powered() | Возвращает HTML гиперссылку, которая может быть отображена на вашей веб-странице, показывая информацию "Powered by Yii Framework". | yii\BaseYii |
| setAlias() | Регистрирует псевдоним пути. | yii\BaseYii |
| setLogger() | Устанавливает объект регистратора. | yii\BaseYii |
| t() | Переводит сообщение на указанный язык. | yii\BaseYii |
| trace() | Записывает сообщение отслеживания. | yii\BaseYii |
| warning() | Записывает предупреждающее сообщение. | yii\BaseYii |
Подробное описание свойств
$aliases публическое статическое свойство
Зарегистрированные псевдонимы путей
См. также:
public static array $aliases = ['@yii' => __DIR__]
$app публическое статическое свойство
Экземпляр приложения
public static yii\console\Application|yii\web\Application $app = null
$classMap публическое статическое свойство
Карта классов, используемая механизмом автозагрузки Yii. Ключи массива — имена классов (без ведущих обратных слэшей), а значения — соответствующие пути к файлам классов (или псевдонимы путей). Это свойство главным образом влияет на работу метода autoload().
См. также autoload().
public static array $classMap = []
$container публическое статическое свойство
Контейнер внедрения зависимостей (DI), используемый методом createObject(). Вы можете использовать yii\di\Container::set() для настройки необходимых зависимостей классов и их начальных значений свойств.
См. также:
public static yii\di\Container $container = null
Подробное описание методов
autoload() public static method
Загрузчик класса автозагрузки.
Этот метод вызывается автоматически, когда PHP видит неизвестный класс. Метод попытается включить файл класса в соответствии со следующим алгоритмом:
- Поиск в $classMap;
- Если класс имеет пространство имён (например,
yii\base\Component), он попытается включить файл, соответствующий пути алиаса (например,@yii/base/Component.php);
Этот автозагрузчик позволяет загружать классы, которые следуют стандарту PSR-4 и имеют своё основное пространство имён или подпространства имён, определённые как пути алиасов.
Пример: Когда определены алиасы @yii и @yii/bootstrap, классы в пространстве имён yii\bootstrap будут загружаться с помощью алиаса @yii/bootstrap, который указывает на каталог, где установлены файлы расширения bootstrap, и все классы из других пространств имён yii будут загружаться из каталога фреймворка Yii.
Также см. раздел руководства по автозагрузке.
| public static void autoload ( $className ) | ||
|---|---|---|
| $className | string |
Полное имя класса без ведущего обратного слэша «\» |
| throws | yii\base\UnknownClassException |
если класс отсутствует в файле класса |
beginProfile() public static method
Помечает начало блока кода для профилирования.
Это должно быть согласовано с вызовом endProfile() с тем же именем категории. Вызовы begin и end также должны быть правильно вложены. Например,
\Yii::beginProfile('block1');
// some code to be profiled
\Yii::beginProfile('block2');
// some other code to be profiled
\Yii::endProfile('block2');
\Yii::endProfile('block1');
См. также endProfile().
| public static void beginProfile ( $token, $category = 'application' ) | ||
|---|---|---|
| $token | string |
Токен для блока кода |
| $category | string |
Категория этого сообщения журнала |
configure() public static method
Настраивает объект с начальными значениями свойств.
| public static object configure ( $object, $properties ) | ||
|---|---|---|
| $object | object |
Настраиваемый объект |
| $properties | array |
Начальные значения свойств, заданные в виде пар имя-значение. |
| return | object |
Сам объект |
createObject() public static method
Создаёт новый объект, используя заданную конфигурацию.
Этот метод можно рассматривать как усовершенствованную версию оператора new. Метод поддерживает создание объекта на основе имени класса, массива конфигурации или анонимной функции.
Ниже приведены примеры использования:
// create an object using a class name
$object = Yii::createObject('yii\db\Connection');
// create an object using a configuration array
$object = Yii::createObject([
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=127.0.0.1;dbname=demo',
'username' => 'root',
'password' => '',
'charset' => 'utf8',
]);
// create an object with two constructor parameters
$object = \Yii::createObject('MyClass', [$param1, $param2]);
Используя контейнер внедрения зависимостей, этот метод также может определить зависимые объекты, создать их и внедрить их в только что созданный объект.
См. также yii\di\Container.
| public static object createObject ( $type, array $params = [] ) | ||
|---|---|---|
| $type | string|array|callable |
Тип объекта. Это может быть указано в одном из следующих форматов:
|
| $params | array |
Параметры конструктора |
| return | object |
Созданный объект |
| throws | yii\base\InvalidConfigException |
если конфигурация некорректна. |
endProfile() public static method
Помечает конец блока кода для профилирования.
Это должно быть согласовано с предыдущим вызовом beginProfile() с тем же именем категории.
См. также beginProfile().
| public static void endProfile ( $token, $category = 'application' ) | ||
|---|---|---|
| $token | string |
Токен для блока кода |
| $category | string |
Категория этого сообщения журнала |
error() public static method
Записывает сообщение об ошибке.
Сообщение об ошибке обычно записывается, когда во время выполнения приложения возникает невосстановимая ошибка.
| public static void error ( $message, $category = 'application' ) | ||
|---|---|---|
| $message | string|array |
Сообщение для записи. Это может быть простая строка или более сложная структура данных, например, массив. |
| $category | string |
Категория сообщения. |
getAlias() public static method
Преобразует алиас пути в фактический путь.
Преобразование выполняется по следующему алгоритму:
- Если заданный алиас не начинается с «@», он возвращается без изменений;
- В противном случае ищется самый длинный зарегистрированный алиас, соответствующий начальной части заданного алиаса. Если он существует, соответствующая часть заданного алиаса заменяется соответствующим зарегистрированным путём.
- Выбрасывается исключение или возвращается false, в зависимости от параметра
$throwException.
Например, по умолчанию «@yii» зарегистрирован как алиас каталога фреймворка Yii, например, «/path/to/yii». Тогда алиас «@yii/web» преобразуется в «/path/to/yii/web».
Если у вас зарегистрированы два алиаса «@foo» и «@foo/bar». Тогда перевод «@foo/bar/config» заменит часть «@foo/bar» (вместо «@foo») соответствующим зарегистрированным путём. Это потому, что самый длинный алиас имеет приоритет.
Однако, если алиас для перевода — «@foo/barbar/config», то будет заменено «@foo», а не «@foo/bar», потому что «/» служит разделителем.
Обратите внимание, что этот метод не проверяет, существует ли возвращаемый путь или нет.
См. статью руководства по алиасам для получения дополнительной информации.
См. также setAlias().
| public static string|boolean getAlias ( $alias, $throwException = true ) | ||
|---|---|---|
| $alias | string |
Алиас для преобразования. |
| $throwException | boolean |
Выбрасывать ли исключение, если заданный алиас некорректен. Если это false, и задан некорректный алиас, этот метод вернёт false. |
| return | string|boolean |
Путь, соответствующий алиасу, false, если корневой алиас не был зарегистрирован ранее. |
| throws | yii\base\InvalidParamException |
если алиас некорректен, а $throwException — true. |
getLogger() public static method
| public static yii\log\Logger getLogger ( ) | ||
|---|---|---|
| return | yii\log\Logger |
Диспетчер сообщений |
getObjectVars() public static method
Возвращает общедоступные переменные члена объекта.
Этот метод предоставляется для получения общедоступных переменных члена объекта. Он отличается от «get_object_vars()», потому что последний вернёт приватные и защищённые переменные, если его вызывают внутри самого объекта.
| public static array getObjectVars ( $object ) | ||
|---|---|---|
| $object | object |
Обрабатываемый объект |
| return | array |
Общедоступные переменные члена объекта |
getRootAlias() public static method
Возвращает часть корневого алиаса заданного алиаса.
Корневой псевдоним — это псевдоним, который был зарегистрирован с помощью setAlias() ранее. Если заданный псевдоним соответствует нескольким корневым псевдонимам, будет возвращён самый длинный.
| public static string|boolean getRootAlias ( $alias ) | ||
|---|---|---|
| $alias | string |
Псевдоним |
| return | string|boolean |
Корневой псевдоним или false, если корневой псевдоним не найден |
getVersion() public static method
Возвращает строку, представляющую текущую версию фреймворка Yii.
| public static string getVersion ( ) | ||
|---|---|---|
| return | string |
Версия фреймворка Yii |
info() public static method
Записывает информационное сообщение.
Информационное сообщение обычно записывается приложением для ведения записи чего-либо важного (например, администратор входит в систему).
| public static void info ( $message, $category = 'application' ) | ||
|---|---|---|
| $message | string|array |
Сообщение для записи. Это может быть простая строка или более сложная структура данных, например, массив. |
| $category | string |
Категория сообщения. |
powered() public static method
Возвращает HTML гиперссылку, которая может быть отображена на вашей веб-странице, показывающую информацию "Работает на Yii Framework".
| public static string powered ( ) | ||
|---|---|---|
| return | string |
HTML гиперссылка, которая может быть отображена на вашей веб-странице, показывающая информацию "Работает на Yii Framework" |
setAlias() public static method
Регистрирует псевдоним пути.
Псевдоним пути — это короткое имя, представляющее длинный путь (путь к файлу, URL и т. д.). Например, мы используем '@yii' в качестве псевдонима пути к директории фреймворка Yii.
Псевдоним пути должен начинаться с символа '@', чтобы его можно было легко отличить от путей без псевдонима.
Обратите внимание, что этот метод не проверяет, существует ли заданный путь или нет. Всё, что он делает, — это связывает псевдоним с путем.
Любые конечные символы '/' и '\' в указанном пути будут обрезаны.
Дополнительную информацию см. в статье руководства по псевдонимам.
См. также getAlias().
| public static void setAlias ( $alias, $path ) | ||
|---|---|---|
| $alias | string |
Имя псевдонима (например, "@yii"). Он должен начинаться с символа '@'. Может содержать прямой слеш '/', который служит разделителем при выполнении перевода псевдонима методом getAlias(). |
| $path | string |
Путь, соответствующий псевдониму. Если это null, псевдоним будет удалён. Конечные символы '/' и '\' будут обрезаны. Это может быть
|
| throws | yii\base\InvalidParamException |
если $path является недопустимым псевдонимом. |
setLogger() public static method
Устанавливает объект логгера.
| public static void setLogger ( $logger ) | ||
|---|---|---|
| $logger | yii\log\Logger |
Объект логгера. |
t() public static method
Переводит сообщение на указанный язык.
Это сокращённый метод yii\i18n\I18N::translate().
Перевод будет выполнен в соответствии с категорией сообщения, а целевой язык будет использован.
Вы можете добавить параметры к сообщению перевода, которые будут заменены соответствующим значением после перевода. Формат для этого — использовать фигурные скобки вокруг имени параметра, как показано в следующем примере:
$username = 'Alexander';
echo \Yii::t('app', 'Hello, {username}!', ['username' => $username]);
Дополнительный форматирование параметров сообщения поддерживается с помощью расширений PHP intl форматировщик сообщений. Дополнительные сведения см. в yii\i18n\I18N::translate().
| public static string t ( $category, $message, $params = [], $language = null ) | ||
|---|---|---|
| $category | string |
Категория сообщения. |
| $message | string |
Сообщение для перевода. |
| $params | array |
Параметры, которые будут использованы для замены соответствующих местозаполнителей в сообщении. |
| $language | string |
Код языка (например, |
| return | string |
Переведённое сообщение. |
trace() public static method
Записывает сообщение трассировки.
Сообщения трассировки в основном записываются для целей разработки, чтобы увидеть поток выполнения некоторого кода.
| public static void trace ( $message, $category = 'application' ) | ||
|---|---|---|
| $message | string|array |
Сообщение для записи. Это может быть простая строка или более сложная структура данных, например, массив. |
| $category | string |
Категория сообщения. |
warning() public static method
Записывает предупреждающее сообщение.
Предупреждающее сообщение обычно записывается, когда возникает ошибка, но выполнение всё ещё может продолжаться.
| public static void warning ( $message, $category = 'application' ) | ||
|---|---|---|
| $message | string|array |
Сообщение для записи. Это может быть простая строка или более сложная структура данных, например, массив. |
| $category | string |
Категория сообщения. |
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc-2.0/yii-baseyii.html