Download the PHP package enzyme/name without Composer
On this page you can find all versions of the php package enzyme/name. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package name
Short Description Name manipulation library for PHP.
License MIT
Homepage https://github.com/enzyme/name
Informations about the package name
Name manipulation library for PHP.
What is it?
If your website accepts user data in the form of First Name, Last Name and optionally Middle and/or Prefix (Dr., Mrs.) and then you would like to format the data - this package is for you.
Installation
Usage
Standard first and last names.
Formatted first and last names.
Formatted full names (with middle/prefix).
Name options
Simple
exposes the follow accessors which return Part
instances.
$name->getPrefix();
$name->getFirst();
$name->getMiddle();
$name->getLast();
Each Part
has two options:
$part->long()
Returns the long version of the name, eg: Hubert
$part->short()
Returns the short version of the name, eg: H.
You can build a new name in 3 ways:
Simple::fromString(...)
Simply pass in a string and it will 'intelligently' try and parse the name out from it.
Simple::fromArgs(...)
Simply pass in arguments and it will try and build the full name from them. The name is build based on the number of arguments passed in, so 1 argument equals to the first
name, 2 -> first last
, 3 -> first middle last
and 4 -> prefix first middle last
.
So to create the name Hubert Cumberdale
using the fromArgs
constructor, it would look like Simple::fromArgs('Hubert', 'Cumberdale');
.
The last option give you the most control, Simple::strict()
. It simply returns a new Simple
object which you then explicitly build up using the setters: $simple->prefix(...);
, $simple->first(...);
, $simple->middle(...);
and $simple->last(...);
. Each setter can be optionally called to build names of different configurations.
Formatter Options
The following examples use the name Mr. Hubert Alfred Smith Cumberdale
Marker | Returned Name |
---|---|
Prefix | Mr. |
P. | Mr. |
First | Hubert |
F. | H. |
Last | Cumberdale |
L. | C. |
Middle | Alfred Smith |
M. | A. S. |
Any other character will be left untouched. So for example you can create the name Cumberdale, H. A. S.
from the following format string Last, F. M.