nameable
This package provides a caster and a formatter class for presenting your user's names. It can get a user's first, last or full name, their initials, and common abbreviations. Instead of separating the fields over a few database columns you can store a user's name in a single column and fetch what you need.
This package is based upon Basecamp's name_of_person package for Ruby/Rails.
Installation
You can install the package via Composer:
composer require watson/nameableThen use the Nameable cast for any Eloquent models you want to use as a name.
use Watson\Nameable\Nameable;
class User extends Model
{
protected $casts = [
'name' => Nameable::class,
];
}Alternatively, you can interact with the Name class directly.
use Watson\Nameable\Name;
$name = new Name('Dwight', 'Conrad Watson');
$name = Name::from('Dwight Conrad Watson');Usage
$user = new User(['name' => 'Dwight Watson']);
$user->name->full // Dwight Watson
$user->name->first // Dwight
$user->name->last // Watson
$user->name->familiar // Dwight W.
$user->name->abbreviated // D. Watson
$user->name->sorted // Watson, Dwight
$user->name->initials // DWIn addition there are possessive variants you can use which will work correctly with names that end in s.
$user = new User(['name' => 'Dwight Watson']);
$user->name->full_possessive // Dwight Watson's
$user->name->first_possessive // Dwight's
$user->name->last_possessive // Watson's
$user->name->abbreviated_possessive // D. Watson's
$user->name->sorted_possessive // Watson, Dwight's
$user->name->initials_possessive // DW's
$user = new User(['name' => 'Angus Young']);
$user->name->full_possessive // Angus Young's
$user->name->first_possessive // Angus'If a user doesn't provide a full name (for example, just a first name) the attributes will just omit the last name.
License
The MIT License (MIT). Please see License File for more information.