- Saved searches
- Use saved searches to filter your results more quickly
- License
- ashtokalo/php-translit
- Name already in use
- Sign In Required
- Launching GitHub Desktop
- Launching GitHub Desktop
- Launching Xcode
- Launching Visual Studio Code
- Latest commit
- Git stats
- Files
- README.md
- About
- PHP транслит
- Транслит для текста
- Результат
- Транслит для ЧПУ
- Результат:
- Транслит для URL
- Результат:
- Транслит для имен файлов
- Результат:
- Php translit to russian
Saved searches
Use saved searches to filter your results more quickly
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.
PHP library to convert text from one script to another
License
ashtokalo/php-translit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Sign In Required
Please sign in to use Codespaces.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching Xcode
If nothing happens, download Xcode and try again.
Launching Visual Studio Code
Your codespace will open once ready.
There was a problem preparing your codespace, please try again.
Latest commit
Git stats
Files
Failed to load latest commit information.
README.md
translit is a PHP library to convert text from one script to another. Currently it assume conversion of Cyrillic, Georgian, Armenian and Greek scripts into Roman (Latin). Cyrillic has sub-groups for Russian, Ukrainian, Belarusian, Bulgarian and Kazakh languages with custom rules.
This package can be installed through Composer:
$ composer require ashtokalo/php-translit
Make sure to use Composer’s autoload:
require __DIR__.'/../vendor/autoload.php';
Main class Translit could be used as singleton or object itself. Built-in transliteration tables could be referred by following language codes:
- ru — Russian cyrillic chars,
- uk — Ukrainian cyrillic chars,
- mk — Macedonian cyrillic chars,
- be — Belarusian cyrillic chars (converted to latin with diacritical),
- bg — Bulgarian cyrillic chars (converted to latin with diacritical),
- kk — Kazakh cyrillic chars (converted to latin with diacritical),
- ka — Georgian chars,
- hy — Armenian chars (converted to latin with diacritical),
- el — Greek chars (converted to latin with diacritical),
- cyrillic — all cyrillic chars according to ISO 9:1995,
- latin — only latin chars without diacritical marks,
- ascii — only ASCII chars, all non ASCII will be replaced with question mark.
Language codes could be combined by comma to handle more cases, e.g.
echo \ashtokalo\translit\Translit::object()->convert('Беларусь', 'be') . ' vs ' . \ashtokalo\translit\Translit::object()->convert('Беларусь', 'be,latin');
You can also add alternative transliteration tables through property classes , which is list of language code in keys and class names in values:
$translit = new \ashtokalo\translit\Translit; $translit->classes['tlh'] = \startrek\TranslitKlingon::class; echo $translit->convert(' ', 'tlh');
By default wrong language codes ignored. But this behavior could be changed by using strict mode. For all language codes that prepended with exclamation mark exception will be fired if any error (no conversion table, wrong format, empty). For example:
// following code returns 'Привет' as is because handler ru_ru not defined echo Translit::object()->convert('Привет', 'ru_ru') . PHP_EOL; // but next code fires Exception, because strict mode have used echo Translit::object()->convert('Привет', '!ru_ru') . PHP_EOL;
The package contains integration tests. You can run them using PHPUnit.
All transliteration tables were created from information found at Wikipedia. The links to these pages posted into header of each file. Please update me if any mistakes found or you have new transliteration tables to add here.
There are many sources of these tables which could be used — ISO and BGN/PCGN standards, a lot of native standards and informal standard used by people. For this library I assume next order of sources — native, ISO, BGN/PCGN, informal.
Contributions are very welcome.
Only contributions via Pull Requests on Github is accepted:
- PSR-2 Coding Standard
- Document any change in behaviour — Make sure the README.md and any other relevant documentation are kept up-to-date.
- Create feature branches — Don’t ask me to pull from your master branch.
- One pull request per feature — If you want to do more than one thing, send multiple pull requests.
- Send coherent history — Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please squash them before submitting.
The MIT License (MIT). Refer to the License for more information.
About
PHP library to convert text from one script to another
PHP транслит
PHP функции для перевода текста, ЧПУ, ссылок и имен файлов в транслит.
Транслит для текста
function translit($value) < $converter = array( 'а' =>'a', 'б' => 'b', 'в' => 'v', 'г' => 'g', 'д' => 'd', 'е' => 'e', 'ё' => 'e', 'ж' => 'zh', 'з' => 'z', 'и' => 'i', 'й' => 'y', 'к' => 'k', 'л' => 'l', 'м' => 'm', 'н' => 'n', 'о' => 'o', 'п' => 'p', 'р' => 'r', 'с' => 's', 'т' => 't', 'у' => 'u', 'ф' => 'f', 'х' => 'h', 'ц' => 'c', 'ч' => 'ch', 'ш' => 'sh', 'щ' => 'sch', 'ь' => '', 'ы' => 'y', 'ъ' => '', 'э' => 'e', 'ю' => 'yu', 'я' => 'ya', 'А' => 'A', 'Б' => 'B', 'В' => 'V', 'Г' => 'G', 'Д' => 'D', 'Е' => 'E', 'Ё' => 'E', 'Ж' => 'Zh', 'З' => 'Z', 'И' => 'I', 'Й' => 'Y', 'К' => 'K', 'Л' => 'L', 'М' => 'M', 'Н' => 'N', 'О' => 'O', 'П' => 'P', 'Р' => 'R', 'С' => 'S', 'Т' => 'T', 'У' => 'U', 'Ф' => 'F', 'Х' => 'H', 'Ц' => 'C', 'Ч' => 'Ch', 'Ш' => 'Sh', 'Щ' => 'Sch', 'Ь' => '', 'Ы' => 'Y', 'Ъ' => '', 'Э' => 'E', 'Ю' => 'Yu', 'Я' => 'Ya', ); $value = strtr($value, $converter); return $value; > echo translit('Яндекс, Гугл, Майл ру');
Результат
Транслит для ЧПУ
Транслитерация для части URL (path), текст переводится в нижний регистр, пробелы и знаки препинания заменяются на « — ».
function translit_sef($value) < $converter = array( 'а' =>'a', 'б' => 'b', 'в' => 'v', 'г' => 'g', 'д' => 'd', 'е' => 'e', 'ё' => 'e', 'ж' => 'zh', 'з' => 'z', 'и' => 'i', 'й' => 'y', 'к' => 'k', 'л' => 'l', 'м' => 'm', 'н' => 'n', 'о' => 'o', 'п' => 'p', 'р' => 'r', 'с' => 's', 'т' => 't', 'у' => 'u', 'ф' => 'f', 'х' => 'h', 'ц' => 'c', 'ч' => 'ch', 'ш' => 'sh', 'щ' => 'sch', 'ь' => '', 'ы' => 'y', 'ъ' => '', 'э' => 'e', 'ю' => 'yu', 'я' => 'ya', ); $value = mb_strtolower($value); $value = strtr($value, $converter); $value = mb_ereg_replace('[^-0-9a-z]', '-', $value); $value = mb_ereg_replace('[-]+', '-', $value); $value = trim($value, '-'); return $value; > echo translit_sef('Яндекс, Гугл, Майл ру');
Результат:
Транслит для URL
В данную функцию можно передавать URL целиком, домен и GET параметры останутся без изменений.
function translit_path($value) < $converter = array( 'а' =>'a', 'б' => 'b', 'в' => 'v', 'г' => 'g', 'д' => 'd', 'е' => 'e', 'ё' => 'e', 'ж' => 'zh', 'з' => 'z', 'и' => 'i', 'й' => 'y', 'к' => 'k', 'л' => 'l', 'м' => 'm', 'н' => 'n', 'о' => 'o', 'п' => 'p', 'р' => 'r', 'с' => 's', 'т' => 't', 'у' => 'u', 'ф' => 'f', 'х' => 'h', 'ц' => 'c', 'ч' => 'ch', 'ш' => 'sh', 'щ' => 'sch', 'ь' => '', 'ы' => 'y', 'ъ' => '', 'э' => 'e', 'ю' => 'yu', 'я' => 'ya', ); $value = mb_strtolower($value); $value = strtr($value, $converter); $value = mb_ereg_replace('[^-0-9a-z\.]', '-', $value); $value = mb_ereg_replace('[-]+', '-', $value); $value = trim($value, '-'); return $value; > function traslit_url($url) < $url = parse_url(trim($url)); if (!empty($url['host'])) < $res = ''; if (!empty($url['scheme'])) < $res .= $url['scheme'] . '://'; >if (!empty($url['host'])) < $res .= idn_to_ascii($url['host']); >if (!empty($url['port'])) < $res .= ':' . $url['port']; >if (!empty($url['path'])) < $path = explode('/', $url['path']); foreach ($path as $i =>$row) < if (preg_match('/[а-яё]/iu', $row)) < $path[$i] = translit_path($row); >> $res .= implode('/', $path); > if (!empty($url['query'])) < $res .= '?' . $url['query']; >if (!empty($url['fragment'])) < $res .= '#' . $url['fragment']; >return $res; > else < return translit_path($url); >> echo traslit_url('https://example.com/category/статья о транслите.html?page=1');
Результат:
https://example.com/category/statya-o-translite.html?page=1
Транслит для имен файлов
function translit_file($filename) < $converter = array( 'а' =>'a', 'б' => 'b', 'в' => 'v', 'г' => 'g', 'д' => 'd', 'е' => 'e', 'ё' => 'e', 'ж' => 'zh', 'з' => 'z', 'и' => 'i', 'й' => 'y', 'к' => 'k', 'л' => 'l', 'м' => 'm', 'н' => 'n', 'о' => 'o', 'п' => 'p', 'р' => 'r', 'с' => 's', 'т' => 't', 'у' => 'u', 'ф' => 'f', 'х' => 'h', 'ц' => 'c', 'ч' => 'ch', 'ш' => 'sh', 'щ' => 'sch', 'ь' => '', 'ы' => 'y', 'ъ' => '', 'э' => 'e', 'ю' => 'yu', 'я' => 'ya', 'А' => 'A', 'Б' => 'B', 'В' => 'V', 'Г' => 'G', 'Д' => 'D', 'Е' => 'E', 'Ё' => 'E', 'Ж' => 'Zh', 'З' => 'Z', 'И' => 'I', 'Й' => 'Y', 'К' => 'K', 'Л' => 'L', 'М' => 'M', 'Н' => 'N', 'О' => 'O', 'П' => 'P', 'Р' => 'R', 'С' => 'S', 'Т' => 'T', 'У' => 'U', 'Ф' => 'F', 'Х' => 'H', 'Ц' => 'C', 'Ч' => 'Ch', 'Ш' => 'Sh', 'Щ' => 'Sch', 'Ь' => '', 'Ы' => 'Y', 'Ъ' => '', 'Э' => 'E', 'Ю' => 'Yu', 'Я' => 'Ya', ); $new = ''; $file = pathinfo(trim($filename)); if (!empty($file['dirname']) && @$file['dirname'] != '.') < $new .= rtrim($file['dirname'], '/') . '/'; >if (!empty($file['filename'])) < $file['filename'] = str_replace(array(' ', ','), '-', $file['filename']); $file['filename'] = strtr($file['filename'], $converter); $file['filename'] = mb_ereg_replace('[-]+', '-', $file['filename']); $file['filename'] = trim($file['filename'], '-'); $new .= $file['filename']; >if (!empty($file['extension'])) < $new .= '.' . $file['extension']; >return $new; > echo translit_file('/upload/Пример файла.jpg');
Результат:
Php translit to russian
Периодически встречаются задачи, где требуется перевести русский текст в транслит. Например, из имени и фамилии человека сделать почту и перевести ее в транслит, или символьный код новости для ЧПУ сформировать. Мы рассмотрим два варианта решения: 1) для любых сайтов на php и 2) для битрикса Первый вариант универсальный может использоваться на всех сайтах, так как мы напишем php функцию для транслита. Для этого нам понадобится два массива: один с русскими буквами, второй с буквами на транслите и функцию str_replace. Если мы посмотрим документацию, то там сказано
Если и search, и replace — массивы, то str_replace() использует все значения массива search и соответствующие значения массива replace для поиска и замены в subject. Если в массиве replace меньше элементов, чем в search, в качестве строки замены для оставшихся значений будет использована пустая строка.
$russian = array('А', 'Б', 'В', 'Г', 'Д', 'Е', 'Ё', 'Ж', 'З', 'И', 'Й', 'К', 'Л', 'М', 'Н', 'О', 'П', 'Р', 'С', 'Т', 'У', 'Ф', 'Х', 'Ц', 'Ч', 'Ш', 'Щ', 'Ъ', 'Ы', 'Ь', 'Э', 'Ю', 'Я', 'а', 'б', 'в', 'г', 'д', 'е', 'ё', 'ж', 'з', 'и', 'й', 'к', 'л', 'м', 'н', 'о', 'п', 'р', 'с', 'т', 'у', 'ф', 'х', 'ц', 'ч', 'ш', 'щ', 'ъ', 'ы', 'ь', 'э', 'ю', 'я'); $translit = array('A', 'B', 'V', 'G', 'D', 'E', 'E', 'Gh', 'Z', 'I', 'Y', 'K', 'L', 'M', 'N', 'O', 'P', 'R', 'S', 'T', 'U', 'F', 'H', 'C', 'Ch', 'Sh', 'Sch', 'Y', 'Y', 'Y', 'E', 'Yu', 'Ya', 'a', 'b', 'v', 'g', 'd', 'e', 'e', 'gh', 'z', 'i', 'y', 'k', 'l', 'm', 'n', 'o', 'p', 'r', 's', 't', 'u', 'f', 'h', 'c', 'ch', 'sh', 'sch', 'y', 'y', 'y', 'e', 'yu', 'ya');
А значит нам достаточно просто передать эти два массива и строку для получения транслита. Создадим функцию translit
function translit($str) < $russian = array('А', 'Б', 'В', 'Г', 'Д', 'Е', 'Ё', 'Ж', 'З', 'И', 'Й', 'К', 'Л', 'М', 'Н', 'О', 'П', 'Р', 'С', 'Т', 'У', 'Ф', 'Х', 'Ц', 'Ч', 'Ш', 'Щ', 'Ъ', 'Ы', 'Ь', 'Э', 'Ю', 'Я', 'а', 'б', 'в', 'г', 'д', 'е', 'ё', 'ж', 'з', 'и', 'й', 'к', 'л', 'м', 'н', 'о', 'п', 'р', 'с', 'т', 'у', 'ф', 'х', 'ц', 'ч', 'ш', 'щ', 'ъ', 'ы', 'ь', 'э', 'ю', 'я'); $translit = array('A', 'B', 'V', 'G', 'D', 'E', 'E', 'Gh', 'Z', 'I', 'Y', 'K', 'L', 'M', 'N', 'O', 'P', 'R', 'S', 'T', 'U', 'F', 'H', 'C', 'Ch', 'Sh', 'Sch', 'Y', 'Y', 'Y', 'E', 'Yu', 'Ya', 'a', 'b', 'v', 'g', 'd', 'e', 'e', 'gh', 'z', 'i', 'y', 'k', 'l', 'm', 'n', 'o', 'p', 'r', 's', 't', 'u', 'f', 'h', 'c', 'ch', 'sh', 'sch', 'y', 'y', 'y', 'e', 'yu', 'ya'); return str_replace($russian, $translit, $str); >echo translit("Русский текст в транслит");?>
Но не будем забывать, что некоторые буквы в транслите могут содержать апостроф, который недопустим в ЧПУ, поэтому данный массив $translit не содержит апостроф. Все таки мы это делаем для получения ЧПУ. 2) Вариант для Битрикс. В битриксе уже заложено много полезных функций, в том числе и транслит.
Cutil::translit($name,$lang,$params);
где $name — строка текста для транслита $lang — язык с которого производится транслитерация $params — параметры перевода
Массив параметров: max_len ограничение количества символов, по умолчанию — 100 change_case к какому регистру приводить: L — к нижнему, U — к верхнему, false — не изменять. По умолчанию — «L» replace_space чем заменять пробел, по умолчанию: «_» replace_other чем заменять прочие символы, по умолчанию: «_» delete_repeat_replace удалять повторяющиеся пробелы, по умолчанию — «true» safe_chars строка из символов, замена которых не производится
За нас уже все придумали. Нам надо только вывести его
"-","replace_other"=>"-"); $trans = Cutil::translit($name,"ru",$arParams); echo $trans; ?>