Хелперы
Внимание: Этот раздел находиться в стадии разработки.
Yii предоставляет много классов, которые помогают упростить общие задачи программирования, такие как манипуляция со строками или массивами, генерация HTML-кода, и так далее. Все helper-классы организованы в рамках пространства имен yii\helpers и являются статическими методами (это означает, что они содержат в себе только статические свойства и методы и объекты статического класса создать нельзя).
Вы можете использовать helper-класс с помощью вызова одного из статических методов, как показано ниже:
use yii\helpers\Html;
echo Html::encode('Test > test');Note: Помощь в настройке helper-классов, в Yii каждый основной helper состоит из двух классов: базовый класс (например,
BaseArrayHelper) и конкретный класс (например,ArrayHelper). Когда вы используете helper, вы должны использовать только конкретные версии классов и никогда не использовать базовые классы.
Встроенные хелперы
В этой версии Yii предоставляются следующие основные helper-классы:
- ArrayHelper
- Console
- FileHelper
- FormatConverter
- Html
- HtmlPurifier
- Imagine (provided by yii2-imagine extension)
- Inflector
- Json
- Markdown
- StringHelper
- Url
- VarDumper
Настройка хелперов
Для настройки основных helper-классов (например, [[yii\helpers\ArrayHelper]]), вы должны создать расширяющийся класс из помощников соответствующих базовых классов (например, [[yii\helpers\BaseArrayHelper]]) и дать похожее название вашему классу с соответствующим конкретному классу (например, [[yii\helpers\ArrayHelper]]), в том числе его пространство имен. Тогда созданный класс заменит оригинальную реализацию в фреймворке.
В следующих примерах показывается как настроить метод [[yii\helpers\ArrayHelper::merge()|merge()]] [[yii\helpers\ArrayHelper]] класса:
<?php
namespace yii\helpers;
class ArrayHelper extends BaseArrayHelper
{
public static function merge($a, $b)
{
// ваша собственная реализация
}
}Сохраните ваш класс в файле с именем ArrayHelper.php. Файл должен находиться в другой директории, например @app/components.
Далее, в приложении входной скрипт, добавьте следующую строчку кода после подключения yii.php файла, которая сообщит автозагрузка классов Yii загрузить ваш класс вместо оригинального helper-класса фреимворка:
Yii::$classMap['yii\helpers\ArrayHelper'] = '@app/components/ArrayHelper.php';Обратите внимание что пользовательская настройка helper-классов полезна только, если вы хотите изменить поведение существующей функции helper-классов. Если вы хотите добавить дополнительные функции, для использования в вашем приложении, будет лучше создать отдельный helper.
