php-initials

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #dsh #claude-code #codex #developer-tools #react

★ 41 Open GitHub ↗

Library to generate initials from a full name. PHP 5.6+

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Generate initials from names

This is the core of [LasseRafn/php-initial-avatar-generator](http://github.com/LasseRafn/php-initial-avatar-generator), or well.. the initials generation part of it.

It's framework agnostic, which is different from basically everything else I do, you're welcome.

Supports UTF8 (yes, also emojis.)
 
<p align="center"> 
<a href="https://otterwise.app/github/lasserafn/php-initials"><img src="https://img.shields.io/endpoint?url=https://otterwise.app/badge/github/lasserafn/php-initials/7357cbb2-0474-4291-ab99-16073228dccf" alt="Code Coverage"></a>
<a href="https://styleci.io/repos/78973710"><img src="https://styleci.io/repos/78973710/shield?branch=master" alt="StyleCI Status"></a>
<a href="https://packagist.org/packages/LasseRafn/php-initials"><img src="https://img.shields.io/packagist/dt/LasseRafn/php-initials.svg?style=flat-square" alt="Total Downloads"></a>
<a href="https://packagist.org/packages/LasseRafn/php-initials"><img src="https://img.shields.io/packagist/v/LasseRafn/php-initials.svg?style=flat-square" alt="Latest Stable Version"></a>
<a href="https://packagist.org/packages/LasseRafn/php-initials"><img src="https://img.shields.io/packagist/l/LasseRafn/php-initials.svg?style=flat-square" alt="License"></a>
</p>

## Installation

You just require using composer and you're good to go!
```bash
composer require lasserafn/php-initials
```

## Usage

As with installation, usage is quite simple. Generating a image is done by running:

```php
use LasseRafn\Initials\Initials;

echo (new Initials('Lasse Rafn'));                                   // Output: LR
echo (new Initials)->name('Justine Bieber')->generate();             // Output: JB
echo (new Initials('John Christian Doe'))->generate();               // Output: JD
echo (new Initials)->generate('Leonardo');                           // Output: LE
echo (new Initials)->length(1)->generate('Camilla');                 // Output: C
echo (new Initials)->name('Jens Ølsted')->getUrlfriendlyInitials();  // Output: JO
```

All you'll have to do is either pass in the name in the constructor like so:

```php
echo new Initials('The Name Here'); // TH
```

or use the `name($name)` method, to specify the name.

## Supported methods

### name($name = 'John Doe')

```php
$initials->name('Albert Magnum')->generate();
```

### length($length = 2)

```php
$initials->name('Albert Magnum')->length(3)->generate();
```

### generate()

This method will output the initials. It's completely optional, you could also just echo out the class as it has a `__toString()` method.

```php
$initials->name('Albert Magnum')->generate();
```

### getUrlfriendlyInitials()

Will output url-friendly initials (stripping characters like ÆØÅ)

## Requirements
* PHP 5.6, 7.0 or 7.1

php-initials

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README