Класс TextHelper

__call()source public

__call( string $method , array $params )

Вызов методов из класса утилиты для работы со строками

Параметры

строка $method

Метод для вызова

массив $params

Массив параметров для метода.

Возвращает

mixed
Результат вызываемого метода или false при ошибке

Переопределяет

Cake\View\Helper::__call()

__construct()source public

__construct( Cake\View\View $View , array $config [] )

Конструктор

Настройки:

• engine Имя класса, используемого для замены функциональности String. Класс должен быть размещён в каталоге Utility.

Параметры

Cake\View\View $View

объект представления, к которому прикреплён помощник.

массив $config необязательно []

Массив настроек

Исключения

Cake\Core\Exception\Exception
при невозможности найти класс движка.

Переопределяет

Cake\View\Helper::__construct()

_insertPlaceHolder()source protected

_insertPlaceHolder( array $matches )

Сохраняет заполнитель для строки, для последующего использования. Это обходит двойное экранирование содержимого в URL's.

Параметры

массив $matches

Массив совпадений по регулярному выражению.

Возвращает

строка
Заменённые значения.

_linkEmails()source protected

_linkEmails( string $text , array $options )

Связывание адресов электронной почты

Параметры

строка $text

Текст для обработки

массив $options

Массив параметров для использования в HTML.

Возвращает

строка

См. также

\Cake\View\Helper\TextHelper::autoLinkEmails()

_linkUrls()source protected

_linkUrls( string $text , array $htmlOptions )

Замена заполнителей ссылками.

Параметры

строка $text

Текст для обработки.

массив $htmlOptions

Параметры для сгенерированных ссылок.

Возвращает

строка
Текст со вставленными ссылками.

autoLink()source public

autoLink( string $text , array $options [] )

Преобразование всех ссылок и адресов электронной почты в HTML-ссылки.

Параметры

• escape Управление HTML-экранированием входных данных. По умолчанию значение true.

Параметры

строка $text

Текст

массив $options необязательно []

Массив HTML-параметров и параметров, перечисленных выше.

Возвращает

строка
Текст со ссылками

Ссылка

http://book.cakephp.org/3.0/ru/views/helpers/text.html#linking-both-urls-and-email-addresses

autoLinkEmails()source public

autoLinkEmails( string $text , array $options [] )

Добавляет ссылки на электронную почту (<a href="mailto:....) к заданному тексту.

Параметры

• escape Управление HTML-экранированием входных данных. По умолчанию значение true.

Параметры

строка $text

Текст

массив $options необязательно []

Массив HTML-параметров и параметров, перечисленных выше.

Возвращает

строка
Текст со ссылками

Ссылка

http://book.cakephp.org/3.0/ru/views/helpers/text.html#linking-email-addresses

autoLinkUrls()source public

autoLinkUrls( string $text , array $options [] )

Добавляет ссылки (<a href=....) к заданному тексту, находя текст, начинающийся со строк, таких как http:// и ftp://.

Параметры

• escape Управление экранированием HTML входных данных. По умолчанию значение true.

Параметры

строка $text

Текст

массив $options необязательно []

Массив HTML-параметров и параметров, перечисленных выше.

Возвращает

строка
Текст со ссылками

Ссылка

http://book.cakephp.org/3.0/ru/views/helpers/text.html#linking-urls

autoParagraph()source public

autoParagraph( string $text )

Форматирует абзацы вокруг заданного текста для всех переносов строк
добавленных для однострочного возврата

<

p> добавлен для двойного возврата строки

Параметры

строка $text

Текст

Возвращает

строка

Текст с правильными

<

p> и
тегами

Ссылка

http://book.cakephp.org/3.0/ru/views/helpers/text.html#converting-text-into-paragraphs

excerpt()source public

excerpt( string $text , string $phrase , integer $radius 100 , string $ending '...' )

Извлекает выдержку из текста, окружающего фразу с количеством символов с каждой стороны, определяемым радиусом.

Параметры

строка $text

Строка для поиска фразы

строка $phrase

Фраза, которая будет искомой

целое число $radius необязательно 100

Количество символов, которое будет возвращено с каждой стороны найденной фразы

строка $ending необязательно '...'

Окончание, которое будет добавлено

Возвращает

строка
Измененная строка

См. также

\Cake\Utility\Text::excerpt()

Ссылка

http://book.cakephp.org/3.0/ru/views/helpers/text.html#extracting-an-excerpt

highlight()source public

highlight( string $text , string $phrase , array $options [] )

Выделяет заданную фразу в тексте. Вы можете указать любое выражение в выделенном, которое может включать выражение \1 для включения найденной фразы.

Параметры

строка $text

Текст, в котором будет производиться поиск фразы

строка $phrase

Искомая фраза

массив $options необязательно []

Массив HTML-атрибутов и параметров.

Возвращает

строка
Выделенный текст

См. также

\Cake\Utility\Text::highlight()

Ссылка

http://book.cakephp.org/3.0/ru/views/helpers/text.html#highlighting-substrings

implementedEvents()source public

implementedEvents( )

Обработчики событий.

Возвращает

массив

Переопределяет

Cake\View\Helper::implementedEvents()

stripLinks()source public

stripLinks( string $text )

Удаляет из заданного текста все ссылки (<a href=....)

Параметры

строка $text

Текст

Возвращает

строка
Текст без ссылок

См. также

\Cake\Utility\Text::stripLinks()

Ссылка

http://book.cakephp.org/3.0/ru/views/helpers/text.html#removing-links

tail()source public

tail( string $text , integer $length 100 , array $options [] )

Обрезает текст, начиная с конца.

Усекает строку до длины $length и заменяет первые символы многоточием, если текст длиннее длины.

Параметры:

• ellipsis Будет использоваться в качестве начала и предварять обрезанную строку
• exact Если false, $text не будет усечен посреди слова

Параметры

строка $text

Строка для усечения.

целое число $length необязательно 100

Длина возвращаемой строки, включая многоточие.

массив $options необязательно []

Массив HTML-атрибутов и параметров.

Возвращает

строка
Усеченная строка.

См. также

\Cake\Utility\Text::tail()

Ссылка

http://book.cakephp.org/3.0/ru/views/helpers/text.html#truncating-the-tail-of-a-string

toList()source public

toList( array $list , string|null $and null , string $separator ', ' )

Создаёт список, разделённый запятыми, где последние два элемента объединяются с 'и', формируя естественный язык.

Параметры

массив $list

Список для объединения.

строка|null $and необязательно null

Слово, используемое для объединения последних двух элементов. По умолчанию 'и'.

строка $separator необязательно ', '

Разделитель, используемый для объединения всех остальных элементов. По умолчанию ', '.

Возвращает

строка
Объединённая строка.

См. также

\Cake\Utility\Text::toList()

Ссылка

http://book.cakephp.org/3.0/ru/views/helpers/text.html#converting-an-array-to-sentence-form

truncate()source public

truncate( string $text , integer $length 100 , array $options [] )

Усекает текст.

Обрезает строку до длины $length и заменяет последние символы многоточием, если текст длиннее длины.

Параметры:

• ellipsis Будет использоваться в качестве окончания и добавляться к усечённой строке
• exact Если false, $text не будет усечен посреди слова
• html Если true, HTML-теги будут обработаны корректно

Параметры

строка $text

Строка для усечения.

целое число $length необязательно 100

Длина возвращаемой строки, включая многоточие.

массив $options необязательно []

Массив HTML-атрибутов и параметров.

Возвращает

строка
Усеченная строка.

См. также

\Cake\Utility\Text::truncate()

Ссылка

http://book.cakephp.org/3.0/ru/views/helpers/text.html#truncating-text

__debugInfo()source public

__debugInfo( )

Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.

Возвращает

массив

__get()source public

__get( string $name )

Лениво загружает помощники.

Параметры

строка $name

Имя свойства, к которому осуществляется доступ.

Возвращает

Cake\View\Helper|null
Экземпляр помощника, если помощник с указанным именем существует

_confirm()source protected

_confirm( string $message , string $okCode , string $cancelCode '' , array $options [] )

Возвращает строку, которая будет использоваться в качестве обработчика onclick для диалоговых окон подтверждения.

Параметры

строка $message

Сообщение, которое будет отображено

строка $okCode

Код, который будет выполнен после выбора пользователем 'OK'

строка $cancelCode необязательно ''

Код, который будет выполнен после выбора пользователем 'Отмена'

массив $options необязательно []

Массив параметров

Возвращает

строка
JS-код onclick

addClass()source public

addClass( array $options [] , string|null $class null , string $key 'class' )

Добавляет заданный класс к параметрам элемента

Параметры

массив $options необязательный []

Массив параметров/атрибутов для добавления класса

строка|null $class необязательный null

Имя добавляемого класса.

строка $key необязательный 'class'

ключ для использования класса.

Возвращает

массив
Массив параметров с установленным ключом.

initialize()source public

initialize( array $config )

Метод-обработчик конструктора.

Реализуйте этот метод, чтобы не переопределять конструктор и вызывать родительский.

Параметры

массив $config

Настройки конфигурации, предоставленные этому помощнику.

_configDelete()source protected

_configDelete( string $key )

Удаление одного ключа конфигурации

Параметры

строка $key

Ключ для удаления.

Исключения

Cake\Core\Exception\Exception
при попытке перезаписать существующую конфигурацию

_configRead()source protected

_configRead( string|null $key )

Чтение переменной конфигурации

Параметры

строка|null $key

Ключ для чтения.

Возвращает

смешанный

_configWrite()source protected

_configWrite( string|array $key , mixed $value , boolean|string $merge false )

Запись переменной конфигурации

Параметры

строка|массив $key

Ключ для записи.

смешанный $value

Значение для записи.

логическое|строка $merge необязательный false

Истина для рекурсивного слияния, «поверхностное» для простого слияния, ложь для перезаписи, по умолчанию ложь.

Исключения

Cake\Core\Exception\Exception
при попытке перезаписать существующую конфигурацию

config()source public

config( string|array|null $key null , mixed|null $value null , boolean $merge true )

Использование

Чтение всей конфигурации:

$this->config();

Чтение определенного значения:

$this->config('key');

Чтение вложенного значения:

$this->config('some.nested.key');

Установка определенного значения:

$this->config('key', $value);

Установка вложенного значения:

$this->config('some.nested.key', $value);

Обновление нескольких настроек конфигурации одновременно:

$this->config(['one' => 'value', 'another' => 'value']);

Параметры

строка|массив|null $key необязательный null

Ключ для получения/установки или целый массив конфигураций.

смешанный|null $value необязательный null

Значение для установки.

логическое $merge необязательный true

Выполнять ли рекурсивное слияние или перезапись существующей конфигурации, по умолчанию — истина.

Возвращает

смешанный
Значение конфигурации, которое читается, или сам объект при операциях записи.

Исключения

Cake\Core\Exception\Exception
При попытке установить недопустимый ключ.

configShallow()source public

configShallow( string|array $key , mixed|null $value null )

Объединить предоставленную конфигурацию с существующей конфигурацией. В отличие от config(), которая выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.

Установка определенного значения:

$this->config('key', $value);

Установка вложенного значения:

$this->config('some.nested.key', $value);

Обновление нескольких настроек конфигурации одновременно:

$this->config(['one' => 'value', 'another' => 'value']);

Параметры

строка|массив $key

Ключ для установки или целый массив конфигураций.

смешанный|null $value необязательный null

Значение для установки.

Возвращает

$this Сам объект.

[
    'engine' => 'Cake\Utility\Text'
]

[]

['Html']