CodeIgniter, руководство пользователя к версии 1.6.1


Хелпер Text

Хелпер Text содержит функции, помогающие в работе с текстом.

Загрузка этого хелпера

Загрузить хелпер можно следующим образом:

$this->load->helper('text');

Хелпер содержит следующие функции:

word_limiter()

Сокращает строку до количества указанных слов. Например:

$string = "Это прекрасная строка текста из семи слов.";

$string = word_limiter($string, 4);

// Вернет: Это прекрасная строка текста…

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

character_limiter()

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

$string = "Это прекрасная строка текста из семи слов.";

$string = character_limiter($string, 20);

// Вернет: Это прекрасная строка…

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

ascii_to_entities()

Конвертирует значение ASCII в символьные сущности, работая с символами за пределами ASCII и символами MS Word которые могут вызвать проблемы при использовании на веб-странице, так что они могут быть безопасно показаны на странице или сохранены в базу данных. Существует определенная зависимость между настройками сервера и поддерживаемыми символами, поэтому на эту функцию нельзя полагаться на 100%. Тем не менее основная часть символов за пределами стандартного диапазона должна определяться корректно. Пример:

$string = ascii_to_entities($string);

entities_to_ascii()

Эта функция работает обратно предыдущей; она преобразует символы обратно в ASCII.

word_censor()

Включает цензор слов во входящей строке. Первым параметром принимает оригинальную строку. Второй параметр должен содержать массив слов, которые должны быть запрещены. Третий (опциональный) параметр может содержать строку, которой будут заменены найденные слова. Если он не указан, то будет происходить замена на следующие символы: ####. Пример:

$disallowed = array('проклятье', 'черт', 'черт побери!', 'дьявол');

$string = word_censor($string, $disallowed, '<пип>');

highlight_code()

Функция подсвечивает синтаксис в строке кода (PHP, HTML и т.д.). Пример:

$string = highlight_code($string);

Используется функция PHP highlight_string(), поэтому используемые цвета необходимо изменять в файле php.ini.

highlight_phrase()

Выделяет подстроку в строке, окружая ее указанными символами. Первый параметр должен содержать оригинальную строку, вторым параметром необходимо указать строку для подсветки. Третий и четвертый параметры должны содержать открывающий/закрывающий HTML теги, которыми вы хотите выделить подстроку. Пример:

$string = "Это прекрасная строка текста из семи слов.";

$string = highlight_phrase($string, "прекрасная строка", '<span style="color:#990000">', '</span>');

Вернется преобразованная строка:

Это прекрасная строка текста из семи слов.

word_wrap()

Разбиение текста на строки по указанному количеству символов. Пример:

$string = "Это простая строка, которая продемонстрирует работу описанной функции";

echo word_wrap($string, 25);

// Would produce:

Это простая строка,
которая продемонстрирует
работу описанной функции