PHPackages floor9design/character-humaniser - 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. floor9design/character-humaniser ActiveLibrary[Utility & Helpers](/categories/utility) floor9design/character-humaniser ================================ Turns difficult strings into easy to read strings ideal for sharing 1.2.0(1y ago)06.9kMITPHPPHP >=7.4CI failing Since Mar 30Pushed 1y ago1 watchersCompare [ Source](https://github.com/floor9design-ltd/character-humaniser)[ Packagist](https://packagist.org/packages/floor9design/character-humaniser)[ Docs](https://github.com/floor9design-ltd/character-humaniser)[ RSS](/packages/floor9design-character-humaniser/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (5)Dependencies (3)Versions (6)Used By (0) character-humaniser =================== [](#character-humaniser) [![Latest Version](https://camo.githubusercontent.com/b0fc8bdf51cf72d855a01692bba598797e3afe31ac649b160c0a6699d7ee3f31/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f666c6f6f723964657369676e2d6c74642f6368617261637465722d68756d616e697365723f696e636c7564655f70726572656c6561736573267374796c653d706c6173746963)](https://github.com/floor9design-ltd/character-humaniser/releases)[![Packagist](https://camo.githubusercontent.com/67f15f0bd9d88ff50fabc5343ab75d88b43924469c2f61f2a7369b9fe43765b7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666c6f6f723964657369676e2f6368617261637465722d68756d616e697365723f7374796c653d706c6173746963)](https://packagist.org/packages/floor9design/character-humaniser)[![Software License](https://camo.githubusercontent.com/10955426da15c7ed27f262e19d2eddeb65055494880cc858e8fc0792d5e15d1c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d706c6173746963)](LICENCE.md) [![Build Status](https://camo.githubusercontent.com/36de01270093ce601147836e9434e552fd036886f9aac033b2c190032e0ab38a/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636f6d2f666c6f6f723964657369676e2d6c74642f6368617261637465722d68756d616e697365723f7374796c653d706c6173746963)](https://travis-ci.com/github/floor9design-ltd/character-humaniser)[![Code Coverage](https://camo.githubusercontent.com/eb831618455b24bd546ccea25580359d642b5ae7ee72be430997066e80b42dd6/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f666c6f6f723964657369676e2d6c74642f6368617261637465722d68756d616e697365723f7374796c653d706c6173746963)](https://codecov.io/gh/floor9design-ltd/character-humaniser) [![Github Downloads](https://camo.githubusercontent.com/cf271d10e106bfc7bf92ef9c1b4292d6896a6ea4acafca0c5bcde9fb8ec9b133/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f666c6f6f723964657369676e2d6c74642f6368617261637465722d68756d616e697365722f746f74616c3f7374796c653d706c6173746963)](https://github.com/floor9design-ltd/character-humaniser)[![Packagist Downloads](https://camo.githubusercontent.com/3b87a66812cf7b6c0a4b72b27299336d700dd22899a2fb84ae9a08988311d798/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666c6f6f723964657369676e2f6368617261637465722d68756d616e697365723f7374796c653d706c6173746963)](https://packagist.org/packages/floor9design/character-humaniser) A class that offers quick ways to make confusing/complex strings readable, for example passwords Introduction ------------ [](#introduction) Passwords often give confusing/difficult outputs. For example: lower case l (lima) and upper case i (indigo) are similar in many fonts, and symbols such as tilde have names that are often unknown or difficult to remember. For example: ``` $password = 'lIaA3~'; ``` ... can be easily translated to: ``` $password_humanised = 'lima INDIGO alpha ALPHA three tilde'; ``` Features -------- [](#features) [![Latest Version](https://camo.githubusercontent.com/b0fc8bdf51cf72d855a01692bba598797e3afe31ac649b160c0a6699d7ee3f31/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f666c6f6f723964657369676e2d6c74642f6368617261637465722d68756d616e697365723f696e636c7564655f70726572656c6561736573267374796c653d706c6173746963)](https://github.com/floor9design-ltd/character-humaniser/releases)[![Packagist](https://camo.githubusercontent.com/67f15f0bd9d88ff50fabc5343ab75d88b43924469c2f61f2a7369b9fe43765b7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666c6f6f723964657369676e2f6368617261637465722d68756d616e697365723f7374796c653d706c6173746963)](https://packagist.org/packages/floor9design/character-humaniser) The `CharacterHumaniser` class offers: - array and string output for easy display - catches unexpected characters - ability to add your own custom definitions to undefined symbols/letters As a bonus, there is a joke class: `BadCharacterHumaniser` which does a funny but awful attempt at the same: ``` $password = '$aX3k'; // can be badly converted to: $password_humanised = 'benjamins aether XYLOPHONE cup of tea knife'; ``` Install ------- [](#install) Via Composer/packagist [![Packagist Downloads](https://camo.githubusercontent.com/3b87a66812cf7b6c0a4b72b27299336d700dd22899a2fb84ae9a08988311d798/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666c6f6f723964657369676e2f6368617261637465722d68756d616e697365723f7374796c653d706c6173746963)](https://packagist.org/packages/floor9design/character-humaniser) ``` composer require floor9design/character-humaniser ``` Via git [![Github Downloads](https://camo.githubusercontent.com/cf271d10e106bfc7bf92ef9c1b4292d6896a6ea4acafca0c5bcde9fb8ec9b133/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f666c6f6f723964657369676e2d6c74642f6368617261637465722d68756d616e697365722f746f74616c3f7374796c653d706c6173746963)](https://github.com/floor9design-ltd/character-humaniser) ``` git clone https://github.com/floor9design-ltd/character-humaniser.git ``` Or: ``` git clone git@github.com:floor9design-ltd/character-humaniser.git ``` Usage ----- [](#usage) This is discussed in the usage document. - [usage](docs/project/usage.md) Recommended ----------- [](#recommended) The following related class has a great password generating function: - [floor9design/test-data-generator](https://github.com/floor9design-ltd/test-data-generator) - Use `randomPassword()` Setup ----- [](#setup) There are no specific config setup steps required. The class should autoload in PSR-4 compliant systems. If you are using the class on its own, simply include it however is most appropriate. Testing ------- [](#testing) [![Build Status](https://camo.githubusercontent.com/36de01270093ce601147836e9434e552fd036886f9aac033b2c190032e0ab38a/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636f6d2f666c6f6f723964657369676e2d6c74642f6368617261637465722d68756d616e697365723f7374796c653d706c6173746963)](https://travis-ci.com/github/floor9design-ltd/character-humaniser)[![Code Coverage](https://camo.githubusercontent.com/eb831618455b24bd546ccea25580359d642b5ae7ee72be430997066e80b42dd6/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f666c6f6f723964657369676e2d6c74642f6368617261637465722d68756d616e697365723f7374796c653d706c6173746963)](https://codecov.io/gh/floor9design-ltd/character-humaniser) Tests can be run as follows: - `./vendor/phpunit/phpunit/phpunit` The following tests and also creates code coverage (usually maintained at 100%) - `./vendor/phpunit/phpunit/phpunit --coverage-html docs/tests/` Static analysis/code review can be performed by using [phpstan](https://phpstan.org/): - `./vendor/bin/phpstan` Credits ------- [](#credits) - [Rick](https://github.com/elb98rm) Changelog --------- [](#changelog) A changelog is generated here: - [Change log](CHANGELOG.md) License ------- [](#license) This software is available under the MIT licence. - [License File](LICENCE.md) ### Health Score 32 — LowBetter than 72% of packages Maintenance35 Infrequent updates — may be unmaintained Popularity22 Limited adoption so far Community9 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 67.3% 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 ~226 days Total 5 Last Release 605d ago Major Versions 0.2.0 → 1.0.02022-04-10 ### Community Maintainers ![](https://www.gravatar.com/avatar/ca241b0576f1570f1de86d5cb18429e6a662cc165c1e798d321754a549d65a27?d=identicon)[elb98rm](/maintainers/elb98rm) --- Top Contributors [![elb98rm](https://avatars.githubusercontent.com/u/2630101?v=4)](https://github.com/elb98rm "elb98rm (111 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (54 commits)") --- Tags stringfloor9design ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/floor9design-character-humaniser/health.svg) ``` [![Health](https://phpackages.com/badges/floor9design-character-humaniser/health.svg)](https://phpackages.com/packages/floor9design-character-humaniser) ``` ### Alternatives [nette/utils 🛠 Nette Utils: lightweight utilities for string & array manipulation, image handling, safe JSON encoding/decoding, validation, slug or strong password generating etc. 2.1k394.3M1.5k](/packages/nette-utils)[danielstjules/stringy A string manipulation library with multibyte support 2.4k26.0M191](/packages/danielstjules-stringy)[spatie/string String handling evolved 5604.6M24](/packages/spatie-string)[coduo/php-to-string Simple library that converts PHP value into strings 27112.7M10](/packages/coduo-php-to-string)[kwn/number-to-words Multi language standalone PHP number to words converter. Fully tested, open for extensions and new languages. 4235.0M21](/packages/kwn-number-to-words)[voku/stringy A string manipulation library with multibyte support 1783.8M19](/packages/voku-stringy) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)