Skip to content

Latest commit

 

History

History
125 lines (103 loc) · 3.65 KB

README.md

File metadata and controls

125 lines (103 loc) · 3.65 KB

Naming

Latest Version ci build Code Coverage PHPStan Downloads

Naming is a library that has filter and validator for people name with multibyte string check support, extends the Laminas filter and validator, while it can be used as standalone.

Installation

composer require samsonasik/naming

Filter Flow

  • Strip Tags
  • String Trim
  • String To Upper first letter in each word with set lower case after that
  • Replace double space to single space
  • String To Upper after ' and - character if any

Examples:

Original name Filtered name
<script>Abdul Abdul
ABduL Abdul
aBDUL m. ikHsan Abdul M. Ikhsan
abdul Malik   I Abdul Malik I
D'lilah D'Lilah
Veli-matti Veli-Matti
äX Äx

Validation checks

  • Allowed characters: letters, hyphens, apostrophe, spaces, full stops.
  • Not allowed:
    • include number
    • special characters
    • single . character
    • single - character
    • single ' character
    • consecutive . characters
    • consecutive - characters
    • consecutive ' characters
    • full stops not in the last of each word

Usage with laminas-form instance:

use Naming\Filter;
use Naming\Validator;
use Laminas\Form\Element\Text;
use Laminas\Form\Form;
use Laminas\InputFilter\InputFilterProviderInterface;

class ContactForm extends Form implements InputFilterProviderInterface
{
    public function init()
    {
        $this->add([
            'type' => Text::class,
            'name' => 'fullname',
            'options' => [
                'label' => 'Full name',
            ],
        ]);
    }

    public function getInputFilterSpecification()
    {
        return [
            [
                'name'     => 'fullname',
                'required' => true,
                'filters' => [
                    [
                        'name' => Filter\Naming::class
                    ],
                ],
                'validators' => [
                    [
                        'name' => Validator\Naming::class,
                    ],
                ],
            ],
        ];
    }
}

Using standalone:

use Naming\Filter;
use Naming\Validator;

include 'vendor/autoload.php';

// ... VALID
$filtered = (new Filter\Naming())->filter('Abdul malik ikhsan');
$validator = new Validator\Naming();

echo $filtered; // Abdul Malik Ikhsan
var_dump($validator->isValid($filtered)); // true

// ... INVALID
$filtered = (new Filter\Naming())->filter('Abdul....');
$validator = new Validator\Naming();

echo $filtered; // Abdul....
var_dump($validator->isValid($filtered)); // false
var_dump(\current($validator->getMessages())); /* "Consecutive "."s are not allowed" */

Contributing

Contributions are very welcome. Please read CONTRIBUTING.md