HyperText Markup Language, commonly referred to as HTML, is the standard markup language used to create web pages.[1] Web browsers can read HTML files and render them into visible or audible web pages. HTML describes the structure of a website semantically along with cues for presentation, making it a markup language, rather than a programming language.
'; StringHumanizer::truncateHtml($text, 3); // "HyperText" StringHumanizer::truncateHtml($text, 12, ''); // "HyperText Markup" StringHumanizer::truncateHtml($text, 50, '', '...'); // "HyperText Markup Language, commonly referred to as..." StringHumanizer::truncateHtml($text, 75, '', '...'); // 'HyperText Markup Language, commonly referred to as HTML, is the standard markup...' ``` **Remove shortcodes** ```php $text = 'A text with [short]random[/short] [codes]words[/codes].'; StringHumanizer::removeShortcodes($text); // "A text with ." StringHumanizer::removeShortcodeTags($text); // "A text with random words." ``` ## Number **Ordinalize** ```php use Coduo\PHPHumanizer\NumberHumanizer; NumberHumanizer::ordinalize(0); // "0th" NumberHumanizer::ordinalize(1); // "1st" NumberHumanizer::ordinalize(2); // "2nd" NumberHumanizer::ordinalize(23); // "23rd" NumberHumanizer::ordinalize(1002, 'nl'); // "1002e" NumberHumanizer::ordinalize(-111); // "-111th" ``` **Ordinal** ```php use Coduo\PHPHumanizer\NumberHumanizer; NumberHumanizer::ordinal(0); // "th" NumberHumanizer::ordinal(1); // "st" NumberHumanizer::ordinal(2); // "nd" NumberHumanizer::ordinal(23); // "rd" NumberHumanizer::ordinal(1002); // "nd" NumberHumanizer::ordinal(-111, 'nl'); // "e" ``` **Roman numbers** ```php use Coduo\PHPHumanizer\NumberHumanizer; NumberHumanizer::toRoman(1); // "I" NumberHumanizer::toRoman(5); // "V" NumberHumanizer::toRoman(1300); // "MCCC" NumberHumanizer::fromRoman("MMMCMXCIX"); // 3999 NumberHumanizer::fromRoman("V"); // 5 NumberHumanizer::fromRoman("CXXV"); // 125 ``` **Binary Suffix** Convert a number of bytes in to the highest applicable data unit ```php use Coduo\PHPHumanizer\NumberHumanizer; NumberHumanizer::binarySuffix(0); // "0 bytes" NumberHumanizer::binarySuffix(1); // "1 bytes" NumberHumanizer::binarySuffix(1024); // "1 kB" NumberHumanizer::binarySuffix(1025); // "1 kB" NumberHumanizer::binarySuffix(1536); // "1.5 kB" NumberHumanizer::binarySuffix(1048576 * 5); // "5 MB" NumberHumanizer::binarySuffix(1073741824 * 2); // "2 GB" NumberHumanizer::binarySuffix(1099511627776 * 3); // "3 TB" NumberHumanizer::binarySuffix(1325899906842624); // "1.18 PB" ``` Number can be also formatted for specific locale ```php use Coduo\PHPHumanizer\NumberHumanizer; NumberHumanizer::binarySuffix(1536, 'pl'); // "1,5 kB" ``` Number can also be humanized with a specific number of decimal places with `preciseBinarySuffix($number, $precision, $locale = 'en')` The precision parameter must be between 0 and 3. ```php use Coduo\PHPHumanizer\NumberHumanizer; NumberHumanizer::preciseBinarySuffix(1024, 2); // "1.00 kB" NumberHumanizer::preciseBinarySuffix(1325899906842624, 3); // "1.178 PB" ``` This function also supports locale ```php use Coduo\PHPHumanizer\NumberHumanizer; NumberHumanizer::preciseBinarySuffix(1325899906842624, 3, 'pl'); // "1,178 PB" ``` **Metric Suffix** ```php use Coduo\PHPHumanizer\NumberHumanizer; NumberHumanizer::metricSuffix(-1); // "-1" NumberHumanizer::metricSuffix(0); // "0" NumberHumanizer::metricSuffix(1); // "1" NumberHumanizer::metricSuffix(101); // "101" NumberHumanizer::metricSuffix(1000); // "1k" NumberHumanizer::metricSuffix(1240); // "1.2k" NumberHumanizer::metricSuffix(1240000); // "1.24M" NumberHumanizer::metricSuffix(3500000); // "3.5M" ``` Number can be also formatted for specific locale ```php use Coduo\PHPHumanizer\NumberHumanizer; NumberHumanizer::metricSuffix(1240000, 'pl'); // "1,24M" ``` ## Collections **Oxford** ```php use Coduo\PHPHumanizer\CollectionHumanizer; CollectionHumanizer::oxford(['Michal', 'Norbert', 'Lukasz', 'Pawel'], 2); // "Michal, Norbert, and 2 others" CollectionHumanizer::oxford(['Michal', 'Norbert', 'Lukasz'], 2); // "Michal, Norbert, and 1 other" CollectionHumanizer::oxford(['Michal', 'Norbert']); // "Michal and Norbert" ``` Oxford is using translator component, so you can use whatever string format you like. ## Date time **Difference** ```php use Coduo\PHPHumanizer\DateTimeHumanizer; DateTimeHumanizer::difference(new \DateTime("2014-04-26 13:00:00"), new \DateTime("2014-04-26 13:00:00")); // just now DateTimeHumanizer::difference(new \DateTime("2014-04-26 13:00:00"), new \DateTime("2014-04-26 13:00:05")); // 5 seconds from now DateTimeHumanizer::difference(new \DateTime("2014-04-26 13:00:00"), new \DateTime("2014-04-26 12:59:00")); // 1 minute ago DateTimeHumanizer::difference(new \DateTime("2014-04-26 13:00:00"), new \DateTime("2014-04-26 12:45:00")); // 15 minutes ago DateTimeHumanizer::difference(new \DateTime("2014-04-26 13:00:00"), new \DateTime("2014-04-26 13:15:00")); // 15 minutes from now DateTimeHumanizer::difference(new \DateTime("2014-04-26 13:00:00"), new \DateTime("2014-04-26 14:00:00")); // 1 hour from now DateTimeHumanizer::difference(new \DateTime("2014-04-26 13:00:00"), new \DateTime("2014-04-26 15:00:00")); // 2 hours from now DateTimeHumanizer::difference(new \DateTime("2014-04-26 13:00:00"), new \DateTime("2014-04-26 12:00:00")); // 1 hour ago DateTimeHumanizer::difference(new \DateTime("2014-04-26"), new \DateTime("2014-04-25")); // 1 day ago DateTimeHumanizer::difference(new \DateTime("2014-04-26"), new \DateTime("2014-04-24")); // 2 days ago DateTimeHumanizer::difference(new \DateTime("2014-04-26"), new \DateTime("2014-04-28")); // 2 days from now DateTimeHumanizer::difference(new \DateTime("2014-04-01"), new \DateTime("2014-04-15")); // 2 weeks from now DateTimeHumanizer::difference(new \DateTime("2014-04-15"), new \DateTime("2014-04-07")); // 1 week ago DateTimeHumanizer::difference(new \DateTime("2014-01-01"), new \DateTime("2014-04-01")); // 3 months from now DateTimeHumanizer::difference(new \DateTime("2014-05-01"), new \DateTime("2014-04-01")); // 1 month ago DateTimeHumanizer::difference(new \DateTime("2015-05-01"), new \DateTime("2014-04-01")); // 1 year ago DateTimeHumanizer::difference(new \DateTime("2014-05-01"), new \DateTime("2016-04-01")); // 2 years from now ``` **Precise difference** ```php use Coduo\PHPHumanizer\DateTimeHumanizer; DateTimeHumanizer::preciseDifference(new \DateTime("2014-04-26 13:00:00"), new \DateTime("2014-04-25 11:20:00")); // 1 day, 1 hour, 40 minutes ago DateTimeHumanizer::preciseDifference(new \DateTime("2014-04-26 13:00:00"), new \DateTime("2015-04-28 17:00:00")); // 1 year, 2 days, 4 hours from now DateTimeHumanizer::preciseDifference(new \DateTime("2014-04-26 13:00:00"), new \DateTime("2016-04-27 13:00:00")); // 2 years, 1 day from now ``` Currently we support following languages: * [English](src/Coduo/PHPHumanizer/Resources/translations/difference.en.yml) * [Polish](src/Coduo/PHPHumanizer/Resources/translations/difference.pl.yml) * [German](src/Coduo/PHPHumanizer/Resources/translations/difference.de.yml) * [Turkish](src/Coduo/PHPHumanizer/Resources/translations/difference.tr.yml) * [French](src/Coduo/PHPHumanizer/Resources/translations/difference.fr.yml) * [Português - Brasil](src/Coduo/PHPHumanizer/Resources/translations/difference.pt_BR.yml) * [Italian](src/Coduo/PHPHumanizer/Resources/translations/difference.it.yml) * [Dutch](src/Coduo/PHPHumanizer/Resources/translations/difference.nl.yml) * [Русский](src/Coduo/PHPHumanizer/Resources/translations/difference.ru.yml) * [Norwegian](src/Coduo/PHPHumanizer/Resources/translations/difference.no.yml) * [Afrikaans](src/Coduo/PHPHumanizer/Resources/translations/difference.af.yml) * [Bulgarian](src/Coduo/PHPHumanizer/Resources/translations/difference.bg.yml) * [Indonesian](src/Coduo/PHPHumanizer/Resources/translations/difference.id.yml) * [Chinese Simplified](src/Coduo/PHPHumanizer/Resources/translations/difference.zh_CN.yml) * [Chinese Taiwan](src/Coduo/PHPHumanizer/Resources/translations/difference.zh_TW.yml) * [Spanish](src/Coduo/PHPHumanizer/Resources/translations/difference.es.yml) * [Ukrainian](src/Coduo/PHPHumanizer/Resources/translations/difference.uk.yml) * [Danish](src/Coduo/PHPHumanizer/Resources/translations/difference.da.yml) * [Thai](src/Coduo/PHPHumanizer/Resources/translations/difference.th.yml) * [Japanese](src/Coduo/PHPHumanizer/Resources/translations/difference.ja.yml) * [Romanian](src/Coduo/PHPHumanizer/Resources/translations/difference.ro.yml) # Development After downloading library update dependencies: ``` composer update ``` In order to check lowest possible versions of dependencies add ``` composer update --prefer-lowest ```` Execute test suite: ``` composer run test ``` Run CS Fixer ``` composer run cs:php:fix ``` # Credits This lib was inspired by [Java Humanize Lib](https://github.com/mfornos/humanize) && [Rails Active Support](https://github.com/rails/rails/tree/master/activesupport/lib/active_support)