Download
? URLify
Description
Convert any string into an valid and readable string for usage in the url.
This is a PHP port of "URLify.js" from the Django project + fallback via "Portable UTF-8".
We handles symbols from many languages via an matching-array and others via "UTF8::to_ascii()".
-
https://github.com/django/django/blob/master/django/contrib/admin/static/admin/js/urlify.js
-
https://github.com/voku/portable-utf8
Install via "composer require"
composer require voku/urlify
Usage:
namespace: "voku\helper\URLify"
To generate slugs for URLs:
echo URLify::filter(' J\'étudie le français ');
// "J-etudie-le-francais"
echo URLify::filter('Lo siento, no hablo español.');
// "Lo-siento-no-hablo-espanol"
To generate slugs for file names:
echo URLify::filter('????.jpg', 60, '', true);
// "foto.jpg"
To simply transliterate characters:
echo URLify::downcode('J\'étudie le français');
// "J'etudie le francais"
echo URLify::downcode('Lo siento, no hablo español.');
// "Lo siento, no hablo espanol."
/Or use transliterate() alias:/
echo URLify::transliterate('Lo siento, no hablo español.');
// "Lo siento, no hablo espanol."
To extend the character list:
URLify::add_chars(array(
'¿' => '?', '®' => '(r)', '¼' => '1/4',
'¼' => '1/2', '¾' => '3/4', '¶' => 'P'
));
echo URLify::downcode('¿ ® ¼ ¼ ¾ ¶');
// "? (r) 1/2 1/2 3/4 P"
To extend or replace the default replacing list:
URLify::add_array_to_seperator(array(
"/®/"
));
echo URLify::filter('¿ ® ¼ ¼ ¾ ¶');
// "14-14-34-P"
To extend the list of words to remove for one language:
URLify::remove_words(array('remove', 'these', 'too'), 'de');
To prioritize a certain language map:
echo URLify::filter(' Ägypten und Österreich besitzen wie üblich ein Übermaß an ähnlich öligen Attachés ', 60, 'de');
// "Aegypten-und-Oesterreich-besitzen-wie-ueblich-ein-Uebermass-aehnlich-oeligen-Attaches"
echo URLify::filter('Ca?alo?lu, çal??t???, müjde, laz?m, mahkûm', 60, 'tr');
// "Cagaloglu-calistigi-mujde-lazim-mahkum"
Please note that the "ü" is transliterated to "ue" in the first case, whereas it results in a simple "u" in the latter.
Available languages
-
Arabic: 'ar'
-
Austrian (German): 'de_at'
-
Austrian (French): 'fr_at'
-
Azerbaijani: 'az'
-
Bulgarian: 'bg'
-
Burmese: 'by'
-
Croatian: 'hr'
-
Czech: 'cs'
-
Danish: 'da'
-
English: 'en'
-
Esperanto: 'eo'
-
Estonian: 'et'
-
Finnish: 'fi'
-
French: 'fr'
-
Georgian: 'ka'
-
German: 'de'
-
Greek: 'el'
-
Hindi: 'hi'
-
Hungarian: 'hu'
-
Kazakh: 'kk'
-
Latvian: 'lv'
-
Lithuanian: 'lt'
-
Norwegian: 'no'
-
Polish: 'pl'
-
Romanian: 'ro'
-
Russian: 'ru'
-
Serbian: 'sr'
-
Slovak: 'sk'
-
Swedish: 'sv'
-
Switzerland (German): 'de_ch'
-
Switzerland (French): 'fr_ch'
-
Turkish: 'tr'
-
Ukrainian: 'uk'
-
Vietnamese: 'vn'
Support
For support and donations please visit Github | Issues | PayPal | Patreon.
For status updates and release announcements please visit Releases | Twitter | Patreon.
For professional support please contact me.
Thanks
-
Thanks to GitHub (Microsoft) for hosting the code and a good infrastructure including Issues-Managment, etc.
-
Thanks to IntelliJ as they make the best IDEs for PHP and they gave me an open source license for PhpStorm!
-
Thanks to Travis CI for being the most awesome, easiest continous integration tool out there!
-
Thanks to StyleCI for the simple but powerfull code style check.
-
Thanks to PHPStan && Psalm for relly great Static analysis tools and for discover bugs in the code!
|