PHPackages neunerlei/inflection - 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. neunerlei/inflection ActiveLibrary[Utility & Helpers](/categories/utility) neunerlei/inflection ==================== An inflector with implementation agnostic inflector adapter and fancy string modifications 2.0.0(3y ago)02.7k2Apache-2.0PHPPHP ^8.0CI failing Since Mar 11Pushed 3y ago1 watchersCompare [ Source](https://github.com/Neunerlei/inflection)[ Packagist](https://packagist.org/packages/neunerlei/inflection)[ RSS](/packages/neunerlei-inflection/feed)WikiDiscussions master Synced 6d ago READMEChangelogDependencies (3)Versions (6)Used By (2) Inflection ========== [](#inflection) The package contains yet another inflector but with a twist. The implementation of the actual inflecting (pluralize and singularize a string) is agnostic to the actual implementation you want to use. By default the inflection is done by the [symfony/inflector](https://packagist.org/packages/symfony/inflector) but you can simply switch to any other inflector using adapter classes. In addition to that the inflector comes with additional string modification capabilities like toDashed, toHuman or toGetter and more. Installation ------------ [](#installation) Install this package using composer: ``` composer require neunerlei/inflection ``` Methods ------- [](#methods) The inflector can be found at `Neunerlei\Inflection\Inflector`. #### toSingular() [](#tosingular) Returns the singular form of a word ``` use Neunerlei\Inflection\Inflector; Inflector::toSingular("trees"); // "tree" ``` #### toPlural() [](#toplural) Returns the plural form of a word ``` use Neunerlei\Inflection\Inflector; Inflector::toPlural("tree"); // "trees" ``` #### toSlug() [](#toslug) Converts a "Given string" to "given-string" or "another.String-you wouldWant" to "another-string-you-wouldwant". But in addition to that, it will convert "Annahäuser\_Römertopf.jpg" into "annahaeuser-roemertopf-jpg" NOTE: The implementation is heavily inspired (*cough* mostly stolen *cough*) from [cakephp's Inflector::slug method](https://book.cakephp.org/4/en/core-libraries/inflector.html). Kudos to them! ``` use Neunerlei\Inflection\Inflector; Inflector::toSlug("Given string"); // "given-string" ``` #### toFile() [](#tofile) Similar to toSlug() but is able to detect file extensions, and a path segment which will both be ignored while converting the file into a sluggified version. ``` use Neunerlei\Inflection\Inflector; Inflector::toFile("Given string.jpg"); // "given-string.jpg" // With and without path handling Inflector::toFile("/path/with/Given string.jpg", true); // "/path/with/given-string.jpg" Inflector::toFile("/path/with/Given string.jpg"); // "path-with-given-string.jpg" ``` #### toArray() [](#toarray) Converts a "Given string" to \["given", "string"\] or "another.String-you wouldWant" to \["another", "string", "you", "would", "want"\]. **A thought on intelligent splitting:** The default splitter is rather dumb when it comes to edge cases like IP, URL, and so on, because it will split them like I, P and U, R, L but stuff like HandMeAMango on the other hand will be correctly splitted like: hand, me, a, mango. If you set the second parameter to true, those edge cases will be handled more intelligently. Problems might occur when stuff like "ThisIsFAQandMore" is given, because the camelCase is broken the result will be: "this is fa qand more". ``` use Neunerlei\Inflection\Inflector; Inflector::toArray("Given string"); // ["given", "string"]; Inflector::toArray(" Given string "); // ["given", "string"]; // Intelligent vs default splitting // Default: Inflector::toArray("HelloWORLD"); // ["hello", "w", "o", "r", "l", "d"]; Inflector::toArray("FAQ"); // ["f", "a", "q"]; // Intelligent: Inflector::toArray("HelloWORLD", TRUE); // ["hello", "world"] Inflector::toArray("FAQ", TRUE); // ["faq"]; ``` #### toSpacedUpper() | toHuman() [](#tospacedupper--tohuman) Converts a "Given string" to "Given String" or "another.String-you wouldWant" to "Another String You Would Want". ``` use Neunerlei\Inflection\Inflector; Inflector::toSpacedUpper("Given string"); // "Given String" // Alias: toHuman() Inflector::toHuman("Given string"); // "Given String" ``` #### toCamelCase() [](#tocamelcase) Converts a "Given string" to "GivenString" or "another.String-you wouldWant" to "AnotherStringYouWouldWant". ``` use Neunerlei\Inflection\Inflector; Inflector::toCamelCase("Given string"); // "GivenString" ``` #### toCamelBack() [](#tocamelback) Converts a "Given string" to "givenString" or "another.String-you wouldWant" to "anotherStringYouWouldWant". ``` use Neunerlei\Inflection\Inflector; Inflector::toCamelBack("Given string"); // "givenString" ``` #### toDashed() [](#todashed) Converts a "Given string" to "given-string" or "another.String-you wouldWant" to "another-string-you-would-want". ``` use Neunerlei\Inflection\Inflector; Inflector::toDashed("Given string"); // "given-string" ``` #### setInflectorAdapter() [](#setinflectoradapter) Can be used to inject a custom inflector adapter if you don't want to use the symfony inflector ``` use Neunerlei\Inflection\Inflector; Inflector::setInflectorAdapter(new MyInflectorAdapter()); ``` #### toUnderscore() | toDatabase() [](#tounderscore--todatabase) Converts a "Given string" to "given\_string" or "another.String-you wouldWant" to "another\_string\_you\_would\_want". ``` use Neunerlei\Inflection\Inflector; Inflector::toUnderscore("Given string"); // "given_string" // Alias: toUnderscore() Inflector::toDatabase("Given string"); // "given_string" ``` #### toGetter() [](#togetter) Converts a "Given string" to "getGivenString" or "another.String-you wouldWant" to "getAnotherStringYouWouldWant". It allows you to add a custom prefix other than "get" using the second parameter. It will also sanitize the incoming string so if "getMyProperty" is given as string you will still end up with "getMyProperty" instead of "getGetMyProperty" which would not make much sense. The sanitation will remove the following prefixes "is", "has", "get" and "set". ``` use Neunerlei\Inflection\Inflector; // Sanitization in action Inflector::toGetter("myProperty"); // "getMyProperty" Inflector::toGetter("hasMyProperty"); // "getMyProperty" Inflector::toGetter("my-Property"); // "getMyProperty" Inflector::toGetter("isMyProperty"); // "getMyProperty" Inflector::toGetter("issetProperty"); // "getIssetProperty" this works, too! // Disable sanitization Inflector::toGetter("isMyProperty", null, ["noSanitization"]); // "getIsMyProperty" Inflector::toGetter("hasMyProperty", null, ["ns"]); // "getHasMyProperty" // Change the prefix Inflector::toGetter("myProperty", "is"); // "isMyProperty" Inflector::toGetter("getMyProperty", "has"); // "hasMyProperty" // Intelligent splitting works here to Inflector::toGetter("FAQ", "is", ["intelligentSplitting"]); // "isFaq"; ``` #### toSetter() [](#tosetter) Converts a "Given string" to "setGivenString" or "another.String-you wouldWant" to "setAnotherStringYouWouldWant". Sanitizes the input string like toGetter() does and has the same options. ``` use Neunerlei\Inflection\Inflector; Inflector::toSetter("Given string"); // "setGivenString" ``` #### toProperty() [](#toproperty) This is in general an alias of toCamelBack(); But it will also strip away has/get/is/set prefixes from the given value before the camel back version is generated. ``` use Neunerlei\Inflection\Inflector; Inflector::toSetter("hasMyProperty"); // "myProperty" ``` #### toComparable() [](#tocomparable) This method will convert the given string by unifying it. Unify means, it makes it comparable with other strings, by removing all special characters, converting everything to lowercase, counting all words and the number of their occurrence (optional) and sorting them alphabetically. This also means, that the text will no longer make sense for humans, but is easy to use for search and comparison actions. ``` use Neunerlei\Inflection\Inflector; Inflector::toComparable("max mustermann"); // "max1 mustermann1" Inflector::toComparable("Mustermann, Max "); // "max1 mustermann1" Inflector::toComparable("first name last name"); // "first1 last1 name2" ``` #### toUuid() [](#touuid) Converts any given string into a UUID like: 123e4567-e89b-12d3-a456-426655440000. This is useful if you want to create, unique id's but want to combine multiple strings with different word order. Note that "ASDF QWER" will result in the same ID as "QWER ASDF", because the values will be sorted alphabetically before the id is created. This makes sorting via first name and last name a lot easier. ``` use Neunerlei\Inflection\Inflector; Inflector::toUuid("max mustermann"); // "c47276d9-be31-5329-40d9-25fc290609ec" Inflector::toUuid("Mustermann, Max "); // "c47276d9-be31-5329-40d9-25fc290609ec" Inflector::toUuid("first name last name"); // "7f9f995d-6b94-460e-0158-edd97a8b016a" ``` Changing the Inflector implementation ------------------------------------- [](#changing-the-inflector-implementation) As stated above you can change the actual implementation of the inflector by providing a adapter class for the inflector you would like to use the most (pull requests welcome!). Writing an adapter is easy, create a new class: ``` namespace YourVendor\YourNamespace; use Neunerlei\Inflection\Adapter\InflectorAdapterInterface; class MyInflectorAdapter implements InflectorAdapterInterface{ public function toSingular(string $pluralWord) : string{ // Your fancy inflector does it's job here... } public function toPlural(string $singularWord) : string{ // Your fancy inflector does it's job here... } } ``` After writing your adapter simply register it like: ``` namespace YourVendor\YourNamespace; use Neunerlei\Inflection\Inflector; // If your adapter does not need any dependencies Inflector::$inflectorAdapterClass = MyInflectorAdapter::class; // If you have to instantiate your adapter first Inflector::setInflectorAdapter(new MyInflectorAdapter()); ``` After that the toSingular() and toPlural() methods will be resolved using your own adapter implementation. Running tests ------------- [](#running-tests) - Clone the repository - Install the dependencies with `composer install` - Run the tests with `composer test` Postcardware ------------ [](#postcardware) You're free to use this package, but if it makes it to your production environment I highly appreciate you sending me a postcard from your hometown, mentioning which of our package(s) you are using. You can find my address [here](https://www.neunerlei.eu/). Thank you :D ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity16 Limited adoption so far Community12 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 100% 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 ~256 days Total 5 Last Release 1231d ago Major Versions 1.3.1 → 2.0.02023-01-02 PHP version history (2 changes)1.1.0PHP ^7.3 2.0.0PHP ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/0eb1c26fb5a535cd7a656faffbae7929009558b2bfa6156b2be7b636d689e13a?d=identicon)[labor-digital](/maintainers/labor-digital) ![](https://www.gravatar.com/avatar/c0356afb258572c8908df3132ea59545b7642a6b77fd90bc54215e506c42bfb7?d=identicon)[neunerlei](/maintainers/neunerlei) --- Top Contributors [![Neunerlei](https://avatars.githubusercontent.com/u/22350956?v=4)](https://github.com/Neunerlei "Neunerlei (5 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/neunerlei-inflection/health.svg) ``` [![Health](https://phpackages.com/badges/neunerlei-inflection/health.svg)](https://phpackages.com/packages/neunerlei-inflection) ``` ### Alternatives [phing/phing PHing Is Not GNU make; it's a PHP project build system or build tool based on Apache Ant. 1.2k21.7M876](/packages/phing-phing)[shlinkio/shlink A self-hosted and PHP-based URL shortener application with CLI and REST interfaces 4.8k4.3k](/packages/shlinkio-shlink)[flow-php/etl PHP ETL - Extract Transform Load - Abstraction 374468.4k51](/packages/flow-php-etl)[codefog/contao-haste haste extension for Contao Open Source CMS 42650.8k139](/packages/codefog-contao-haste)[symfony/ai-bundle Integration bundle for Symfony AI components 30282.3k6](/packages/symfony-ai-bundle)[netgen/layouts-core Netgen Layouts enables you to build and manage complex web pages in a simpler way and with less coding. This is the core of Netgen Layouts, its heart and soul. 3689.4k10](/packages/netgen-layouts-core) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)