PHPackages                             commerce-wa-ols/nicknames - 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. commerce-wa-ols/nicknames

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

commerce-wa-ols/nicknames
=========================

Find nicknames for a given name or perform a reverse search on a nickname.

1.0.1(9y ago)445MITPHPPHP ~5.6 || ~7.0

Since Sep 22Pushed 2y ago2 watchersCompare

[ Source](https://github.com/commerce-wa-ols/nicknames)[ Packagist](https://packagist.org/packages/commerce-wa-ols/nicknames)[ RSS](/packages/commerce-wa-ols-nicknames/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (1)Versions (6)Used By (0)

Nicknames1
==========

[](#nicknames1)

[![Code Climate](https://camo.githubusercontent.com/d9cc8b8f1e8141f4292fac5865863ccf8f0ecb43909ce3107ed49e931061608b/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f636f6d6d657263652d77612d6f6c732f6e69636b6e616d65732f6261646765732f6770612e737667)](https://codeclimate.com/github/commerce-wa-ols/nicknames)[![Build Status](https://camo.githubusercontent.com/d446d7ae2238cfec274012092b82ad1534964917afac97458df4cabb92a04e91/68747470733a2f2f7472617669732d63692e6f72672f636f6d6d657263652d77612d6f6c732f6e69636b6e616d65732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/commerce-wa-ols/nicknames)

Nicknames is a simple package that either returns an array of common nicknames for a provided name or returns an array of potential matches to a provided nickname. The data features common English diminutives, nicknames and shortened forms, of given names.

For example, "William" may appear in databases as "Bill" or "Willie", and "Rebecca" as "Becca" or "Becky".

The list of names is from [Diminutives.db](https://github.com/dtrebbien/diminutives.db) with some extra names added to the list from our sources. The idea behind the package has also taken heavy influence from the ruby gem [Nickname](https://github.com/bsimpson/Nickname) which also has some great information about other techniques for fuzzy matching strings.

Usage
-----

[](#usage)

Get nicknames for a given formal name.

```
Nicknames::givenTo("William");use CommerceWA\Utilities\Nicknames;
```

The above example will return:

```
Array
(
    [0] => bill
    [1] => billy
    [2] => will
    [3] => willie
    [4] => willy
)
```

Get the formal name for a given nickname.

```
use CommerceWA\Utilities\Nicknames;

Nicknames::givenTo("Becky");
```

The above example will return:

```
Array
(
    [0] => rebecca
)
```

Why?
----

[](#why)

The library was created to solve issues when trying match names from multiple databases where full names and preferred names (nicknames) were used to identify a person.

Example of different names for the same person

first\_namesurname**Database 1**BillDoe**Database 2**WilliamDoeInstallation
------------

[](#installation)

This package uses [composer](https://getcomposer.org) so you can just add `commerce-wa-ols/nicknames` as a dependency to your `composer.json` file or execute the following command:

```
composer require commerce-wa-ols/nicknames
```

Contributors
------------

[](#contributors)

Developed by [Cyrus Eftos](https://github.com/cyruseftos) at the [Department of Commerce](https://github.com/commerce-wa-ols).

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 62.5% 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 ~62 days

Total

2

Last Release

3315d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/311369?v=4)[Cyrus Eftos](/maintainers/cyruseftos)[@cyruseftos](https://github.com/cyruseftos)

---

Top Contributors

[![cyruseftos](https://avatars.githubusercontent.com/u/311369?v=4)](https://github.com/cyruseftos "cyruseftos (5 commits)")[![ocean](https://avatars.githubusercontent.com/u/4443?v=4)](https://github.com/ocean "ocean (3 commits)")

---

Tags

nicknamesnicknamediminutives

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/commerce-wa-ols-nicknames/health.svg)

```
[![Health](https://phpackages.com/badges/commerce-wa-ols-nicknames/health.svg)](https://phpackages.com/packages/commerce-wa-ols-nicknames)
```

###  Alternatives

[phpoffice/common

PHPOffice Common

23512.6M36](/packages/phpoffice-common)[pragmarx/random

Create random chars, numbers, strings

714.4M5](/packages/pragmarx-random)[flarum/nicknames

Allow users to set nicknames.

11305.8k10](/packages/flarum-nicknames)[sansec/composer-integrity-plugin

5726.2k2](/packages/sansec-composer-integrity-plugin)[netresearch/t3-cowriter

With the help of AI you can now work on a page together with a cowriter - a digital assistant that helps you to write your content.

1011.5k](/packages/netresearch-t3-cowriter)

PHPackages © 2026

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