PHPackages                             voku/urlify - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. voku/urlify

ActiveLibrary[Utility & Helpers](/categories/utility)

voku/urlify
===========

PHP port of URLify.js from the Django project. Transliterates non-ascii characters for use in URLs.

5.0.8(2mo ago)274.2M↓24.1%5[1 PRs](https://github.com/voku/urlify/pulls)7BSD-3-ClausePHPPHP >=7.1.0CI passing

Since Feb 11Pushed 2mo ago3 watchersCompare

[ Source](https://github.com/voku/urlify)[ Packagist](https://packagist.org/packages/voku/urlify)[ Docs](https://github.com/voku/urlify)[ Fund](https://www.paypal.me/moelleken)[ GitHub Sponsors](https://github.com/voku)[ RSS](/packages/voku-urlify/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (8)Versions (68)Used By (7)

[![CI](https://github.com/voku/urlify/actions/workflows/ci.yml/badge.svg)](https://github.com/voku/urlify/actions/workflows/ci.yml)[![Coverage Status](https://camo.githubusercontent.com/3cf0e9423a6f10708cbb009c7e22d7b7951d7d8ecf0477a31c0b8f750a094f1e/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f766f6b752f75726c6966792f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/voku/urlify?branch=master)[![Codacy Badge](https://camo.githubusercontent.com/b49bb0d9c6235fdc00b6f2461251e616a3f4e61bdef868ea9ddbcb9f9046377f/68747470733a2f2f6170692e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f3939303464353936623835313438393161333863623362353639636434643935)](https://www.codacy.com/app/voku/urlify)[![Latest Stable Version](https://camo.githubusercontent.com/c9cbc24b407b8c3911d8984e6350fb0f46a05775c86267ea91b82af52aae784f/68747470733a2f2f706f7365722e707567782e6f72672f766f6b752f75726c6966792f762f737461626c65)](https://packagist.org/packages/voku/urlify)[![Total Downloads](https://camo.githubusercontent.com/92e9f14a51293d53a1a3990122175a4a78f3f15791a216c7f38b12ce4e1809e8/68747470733a2f2f706f7365722e707567782e6f72672f766f6b752f75726c6966792f646f776e6c6f616473)](https://packagist.org/packages/voku/urlify)[![License](https://camo.githubusercontent.com/e23877ad906d34e497000deb0fc5ba31ee18e631c3004d7cc0c27a3bdecbde12/68747470733a2f2f706f7365722e707567782e6f72672f766f6b752f75726c6966792f6c6963656e7365)](https://packagist.org/packages/voku/urlify)[![Donate to this project using Paypal](https://camo.githubusercontent.com/0d6e4d8b50b5983a58205941b1a581b1305903393b7a39da574e3f60af3c7f5b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70617970616c2d646f6e6174652d79656c6c6f772e737667)](https://www.paypal.me/moelleken)[![Donate to this project using Patreon](https://camo.githubusercontent.com/f9e075baad95563481d35174d43ef50757281abb6bc795d0f473fad452afa030/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70617472656f6e2d646f6e6174652d79656c6c6f772e737667)](https://www.patreon.com/voku)

🔗 URLify
========

[](#-urlify)

Description
-----------

[](#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 ASCII". We handles symbols from many languages via an matching-array and others via "ASCII::to\_transliterate()".

-
-
-

Install via "composer require"
------------------------------

[](#install-via-composer-require)

```
composer require voku/urlify
```

Usage:
------

[](#usage)

namespace: "voku\\helper\\URLify"

#### To generate slugs for URLs:

[](#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:

[](#to-generate-slugs-for-file-names)

```
echo URLify::filter('фото.jpg', 60, '', true);
// "foto.jpg"
```

#### To simply transliterate characters:

[](#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:

[](#to-extend-the-character-list)

```
URLify::add_chars(array(
  '¿' => '?', '®' => '(r)', '¼' => '1/4',
  '½' => '1/2', '¾' => '3/4', '¶' => 'P'
));

echo URLify::downcode('¿ ® ½ ¼ ¾ ¶');
// "? (r) 1/2 1/4 3/4 P"
```

#### To extend or replace the default replacing list:

[](#to-extend-or-replace-the-default-replacing-list)

```
URLify::add_array_to_seperator(array(
  "/®/"
));

echo URLify::filter('¿ ® ½ ¼ ¾ ¶');
// "12-14-34-P"
```

#### To extend the list of words to remove for one language:

[](#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:

[](#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
-------------------

[](#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
-------

[](#support)

For support and donations please visit [Github](https://github.com/voku/urlify/) | [Issues](https://github.com/voku/urlify/issues) | [PayPal](https://paypal.me/moelleken) | [Patreon](https://www.patreon.com/voku).

For status updates and release announcements please visit [Releases](https://github.com/voku/urlify/releases) | [Twitter](https://twitter.com/suckup_de) | [Patreon](https://www.patreon.com/voku/posts).

For professional support please contact [me](https://about.me/voku).

Thanks
------

[](#thanks)

- Thanks to [GitHub](https://github.com) (Microsoft) for hosting the code and a good infrastructure including Issues-Managment, etc.
- Thanks to [IntelliJ](https://www.jetbrains.com) as they make the best IDEs for PHP and they gave me an open source license for PhpStorm!
- Thanks to [GitHub Actions](https://github.com/features/actions) for providing the CI pipeline for this project!
- Thanks to [StyleCI](https://styleci.io/) for the simple but powerful code style check.
- Thanks to [PHPStan](https://github.com/phpstan/phpstan) && [Psalm](https://github.com/vimeo/psalm) for really great Static analysis tools and for discovering bugs in the code!

###  Health Score

64

—

FairBetter than 99% of packages

Maintenance87

Actively maintained with recent releases

Popularity53

Moderate usage in the ecosystem

Community29

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 71.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~81 days

Recently: every ~580 days

Total

60

Last Release

73d ago

Major Versions

2.3.1 → 3.0.02017-12-01

3.0.0 → 4.0.02017-12-23

1.1.2-stable → 4.1.02019-01-12

1.1.3-stable → 4.1.12019-09-03

4.1.1 → 5.0.02019-09-07

PHP version history (4 changes)1.0.0-stablePHP >=5.3.0

1.0.2-stablePHP >=5.3

3.0.0PHP >=7.0.0

5.0.8PHP >=7.1.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/6456fe693db197c458272cb758bf78958bc7d3e787ccd59db4bf3cf41654316a?d=identicon)[voku](/maintainers/voku)

---

Top Contributors

[![voku](https://avatars.githubusercontent.com/u/264695?v=4)](https://github.com/voku "voku (135 commits)")[![jbroadway](https://avatars.githubusercontent.com/u/87886?v=4)](https://github.com/jbroadway "jbroadway (26 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (9 commits)")[![nickl-](https://avatars.githubusercontent.com/u/1404606?v=4)](https://github.com/nickl- "nickl- (4 commits)")[![patrickheck](https://avatars.githubusercontent.com/u/778565?v=4)](https://github.com/patrickheck "patrickheck (3 commits)")[![nikmarchenko](https://avatars.githubusercontent.com/u/1553818?v=4)](https://github.com/nikmarchenko "nikmarchenko (2 commits)")[![KorvinSzanto](https://avatars.githubusercontent.com/u/1007419?v=4)](https://github.com/KorvinSzanto "KorvinSzanto (2 commits)")[![bamse16](https://avatars.githubusercontent.com/u/147856?v=4)](https://github.com/bamse16 "bamse16 (2 commits)")[![mlocati](https://avatars.githubusercontent.com/u/928116?v=4)](https://github.com/mlocati "mlocati (1 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (1 commits)")[![hkdobrev](https://avatars.githubusercontent.com/u/506129?v=4)](https://github.com/hkdobrev "hkdobrev (1 commits)")[![andgrankin](https://avatars.githubusercontent.com/u/1209271?v=4)](https://github.com/andgrankin "andgrankin (1 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")[![tobiassjosten](https://avatars.githubusercontent.com/u/65159?v=4)](https://github.com/tobiassjosten "tobiassjosten (1 commits)")

---

Tags

hacktoberfestslugslugifytranslittransliteratetransliterationurlifyurlsluglinkiconvencodeurlifytransliteratetranslittransliteration

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/voku-urlify/health.svg)

```
[![Health](https://phpackages.com/badges/voku-urlify/health.svg)](https://phpackages.com/packages/voku-urlify)
```

###  Alternatives

[jbroadway/urlify

A fast PHP slug generator and transliteration library that converts non-ascii characters for use in URLs.

6758.1M80](/packages/jbroadway-urlify)[illuminate/support

The Illuminate Support package.

630113.0M41.3k](/packages/illuminate-support)[ausi/slug-generator

Slug Generator

8022.4M27](/packages/ausi-slug-generator)[misd/linkify

Converts URLs and email addresses in text into HTML links

1163.2M12](/packages/misd-linkify)[shivella/laravel-bitly

Laravel package for generating bitly url

75867.0k1](/packages/shivella-laravel-bitly)[keyvanakbary/slugifier

A full-featured, simple, clean and pure functional implementation for creating slugs

69191.5k4](/packages/keyvanakbary-slugifier)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)