• This repository has been archived on 26/Apr/2021
  • Stars
    star
    212
  • Rank 186,122 (Top 4 %)
  • Language
    PHP
  • License
    MIT License
  • Created about 11 years ago
  • Updated over 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

[Project is not supported] php rutils - russian text handler for PHP

PHP RUtils

Больше не поддерживается

Summary

License Latest Stable Version

Build Status Code Climate

RUtils is a Russian-specific string utils (transliteration, numeral is words, russian dates, typography) for PHP. This is a port of the Python Pytils to PHP.

See additional docs and examples in doc subdir.

Library is published on the Composer: https://packagist.org/packages/andre_487/php_rutils


RUtils — утилиты для работы c текстом на русском языке (транслитерация, числительные словами, русские даты, простая типографика) для языка PHP. RUtils — порт утилит Pytils на PHP.

Документацию и примеры смотрите в каталоге doc.

Библиотека доступна через Composer: https://packagist.org/packages/andre_487/php_rutils

Daily Downloads Monthly Downloads Total Downloads


Буду рад принять помощь по проекту в виде советов, баг-репортов и pull-реквестов.

Проект следует стилю кодирования PSR-2. Стиль проверяется с помощью PHP_CodeSniffer на этапе CI.

Хочу сказать большое спасибо всем людям, внесшим свой вклад в улучшение проекта.


Basic usage

Modules of PHP RUtils:

  • Numeral - Plural forms and in-word representation for numerals
  • Dt - Russian dates without locales and other dates handling
  • Translit - Simple transliteration
  • Typo - Basic russian typography

Numeral

Choosing the word form depending of a number:

$variants = array(
    'гвоздь', //1
    'гвоздя', //2
    'гвоздей' //5
);
echo $amount, ' ', RUtils::numeral()->choosePlural(15, $variants);
//Result: 15 гвоздей

echo RUtils::numeral()->getPlural(2, $variants);
//Result: 2 гвоздя

Choosing the word form and print number in words:

echo RUtils::numeral()->sumString(1234, RUtils::MALE, $variants);
//Result: одна тысяча двести тридцать четыре гвоздя

Print number in words:

$numeral = RUtils::numeral();
echo $numeral->getInWordsInt(100);
//Result: сто

echo $numeral->getInWordsFloat(100.025);
//Result: сто целых двадцать пять тысячных

echo $numeral->getInWords(100.0);
//Result: сто

Print money (RUB):

echo RUtils::numeral()->getRubles(100.25);
//Result: сто рублей двадцать пять копеек

Dt

Today date: \php_rutils\struct\TimeParams - params structure, may be passed as array

$params = new TimeParams();
$params->date = null; //default value, 'now'
$params->format = 'сегодня d F Y года';
$params->monthInflected = true;
echo RUtils::dt()->ruStrFTime($params);
//Result: сегодня 22 октября 2013 года

Historical date:

$params = array(
    'date' => '09-05-1945',
    'format' => 'l d F Y была одержана победа над немецко-фашистскими захватчиками',
    'monthInflected' => true,
    'preposition' => true,
);
echo RUtils::dt()->ruStrFTime($params);
//Result: в среду 9 мая 1945 была одержана победа над немецко-фашистскими захватчиками

Time interval to fixed date:

$toTime = new \DateTime('05-06-1945'); //Unix timestamp and string also available
echo RUtils::dt()->distanceOfTimeInWords($toTime), PHP_EOL;
//Result: 68 лет назад

$toTime = strtotime('05-06-1945');
$fromTime = null; //now
$accuracy = RUtils::ACCURACY_MINUTE; //years, months, days, hours, minutes
echo RUtils::dt()->distanceOfTimeInWords($toTime, $fromTime, $accuracy), PHP_EOL;
//Result: 68 лет, 4 месяца, 21 день, 19 часов, 12 минут назад

Time interval from fixed date to fixed date:

$fromTime = '1988-01-01 11:40';
$toTime = '2088-01-01 12:35';
$accuracy = RUtils::ACCURACY_MINUTE; //years, months, days, hours, minutes
echo RUtils::dt()->distanceOfTimeInWords($toTime, $fromTime, $accuracy), PHP_EOL;
//Result: через 100 лет, 55 минут

Age:

$birthDate = strtotime('today - 25 years');
echo RUtils::dt()->getAge($birthDate);
//Result: 25

Translit

//Translify
echo RUtils::translit()->translify('Муха - это маленькая птичка');
//Result: Muxa - e`to malen`kaya ptichka

//Detranslify
echo RUtils::translit()->detranslify("Muxa - e`to malen`kaya ptichka");
//Result: Муха - это маленькая птичка

//Prepare to use in URLs or file paths
echo RUtils::translit()->slugify('Муха — это маленькая птичка');
//Result: muha-eto-malenkaya-ptichka

Typo

$text = <<<TEXT
...Когда В. И. Пупкин увидел в газете ( это была "Сермяжная правда" № 45) рубрику Weather Forecast (r),
он не поверил своим глазам - температуру обещали +-451F.
TEXT;

//Standard rules
echo RUtils::typo()->typography($text);
/**
 * Result:
 * ...Когда В. И. Пупкин увидел в газете (это была «Сермяжная правда» №45) рубрику Weather Forecast®,
 * он не поверил своим глазам — температуру обещали ±451°F.
 */


//Extended rules
echo RUtils::typo()->typography($text, TypoRules::$EXTENDED_RULES);
/**
 * Result:
 * …Когда В. И. Пупкин увидел в газете (это была «Сермяжная правда» №45) рубрику Weather Forecast®,
 * он не поверил своим глазам — температуру обещали ±451 °F.
 */

//Custom rules
echo RUtils::typo()->typography($text, array(TypoRules::DASHES, TypoRules::CLEAN_SPACES));
/**
 * Result:
 * ...Когда В. И. Пупкин увидел в газете (это была "Сермяжная правда" № 45) рубрику Weather Forecast (r),
 * он не поверил своим глазам — температуру обещали +-451F.
 */

More Repositories

1

VagrantWebdev

[DEPRECATED] Виртуальный сервер для веб-разработки
PHP
22
star
2

feed-validator

Node.js based simple validation tool for feeds like RSS or Atom. Supports opensearch.xml validation. Based on validator.w3.org/feed
JavaScript
14
star
3

node-link-cleaner

Remove garbage params from url (like utm_source)
JavaScript
4
star
4

kv-keeper.js

Key-value storage for JS that wraps IndexedDB with fallback to LocalStorage
JavaScript
4
star
5

html-stats

Simple utility for collecting HTML files stats
JavaScript
4
star
6

sms487

Service for pass notifications (and SMS) from Android to desktop
Java
3
star
7

view-testing-examples

Examples for testing view components in web development
JavaScript
2
star
8

saturday-2017-11-velocity

Презентация – Как мы работаем над скоростью Яндекс.Поиска
HTML
2
star
9

wpt-diff

WebPageTest Diff: Tool for compare services with public or private instance of WebPageTest
JavaScript
1
star
10

css-analyzer

Tool for the CSS analysis
JavaScript
1
star
11

node-linkify-lite

Linkify text with ~300B of code
JavaScript
1
star
12

synology-freshclam-fixer

The script for periodically fixing ClamAV mirror to a custom one
Python
1
star
13

diploma

Мой диплом: веб-приложение для решения задач линейного программирования
JavaScript
1
star
14

game-of-life

The Game of life implementation
TypeScript
1
star
15

notebooks

Jupyter Notebooks
Jupyter Notebook
1
star
16

github-repos-backuper

Backup util for cloud repos: GitHub, BitBucket, GitLab
Python
1
star