yepteam/typograph

PHP-библиотека для типографической обработки текста.

v1.2.1 2025-06-10 20:09 UTC

Requires

• php: >=8.1.0
• ext-mbstring: *

Requires (Dev)

• phpunit/phpunit: ^10

MIT

README

PHP-библиотека для типографической обработки текста.

Возможности

• Расстановка неразрывных пробелов
• Замена дефисов, короткого и длинного тире
• Замена кавычек первого и второго уровня
• Игнорирование HTML-тегов, содержимого тегов script и style
• Кодирование символов в виде мнемоник или числовых кодов

Установка

Установите пакет через composer:

composer require yepteam/typograph

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

use Yepteam\Typograph\Typograph;

// Инициализация со стандартными параметрами
$typograph = new Typograph();

$html = $typograph->format($html);

Пример конфигурации

// Указаны параметры по умолчанию
$typograph = new Typograph([
    // Режим кодирования
    // named - буквенными кодами
    // numeric - числовыми кодами
    // hex - шестнадцатеричными кодами
    // raw - готовыми символами
    'entities' => 'named',
    
    // Многоточия
    // hellip - замена трех точек на символ многоточия
    // dots - замена символа многоточия на три точки
    // none - не обрабатывать многоточия
    'ellipsis' => 'hellip',
    
    // Массив кавычек по каждому уровню
    // При пустом массиве обработка кавычек будет отключена
    'quotes' => [
        ['«', '»'], // кавычки 1 уровня
        ['„', '“'], // кавычки 2 уровня
    ],
    
    // Правила расстановки неразрывных пробелов
    'nbsp' => [
        'initial' => true, // До и после инициалов
        'mdash' => true, // До и после тире
        'number' => true, // До и после числа
        'short-word' => true, // До и после короткого слова
    ],
]);