Download .zip |
Info | Example | View files (15) | Download .zip | Reputation | Support forum | Blog | Links |
Last Updated | Ratings | Unique User Downloads | Download Rankings | |||||
2020-03-10 (2 hours ago) | Not enough user ratings | Total: 58 This week: 11 | All time: 9,664 This week: 27 |
Version | License | PHP version | Categories | |||
namecase 2.1.1 | MIT/X Consortium ... | 7.2 | Localization, PHP 5, Text processing |
Description | Author | |||
This class can be used to correct the case of personal names. Innovation Award
|
|
[![Latest Version on Packagist][ico-version]][link-packagist] [![Software License][ico-license]](LICENSE.md) [![Build Status][ico-travis]][link-travis] [![Coverage Status][ico-scrutinizer]][link-scrutinizer] [![Quality Score][ico-code-quality]][link-code-quality] [![Total Downloads][ico-downloads]][link-downloads] [![SensioLabsInsight][ico-insight]][link-insight]
Forenames and surnames are often stored either entirely in UPPERCASE or lowercase. This package allows you to convert names into the correct case where possible. Although forenames and surnames are typically stored separately if they do appear in a single string, whitespace-separated, NameCase deals correctly with them.
Currently NameCase correctly name cases names which include any of the following:
Mc, Mac, al, el, ap, bat, ben, bin, binti, binte, da, de, das, dos, delle, della, di, du, del, der, den, ten, ter, la, le, lo, van and von.
It correctly deals with names which contain apostrophes and hyphens too.
> Warning! This README.md is for version 2.0.x. > If you need PHP 5 compatible version, please use 1.0.x! README.md
Via Composer
$ composer require tamtamchik/namecase
use \Tamtamchik\NameCase\Formatter;
// As a static call
Formatter::nameCase("KEITH"); // => Keith
Formatter::nameCase("LEIGH-WILLIAMS"); // => Leigh-Williams
Formatter::nameCase("MCCARTHY"); // => McCarthy
Formatter::nameCase("O'CALLAGHAN"); // => O'Callaghan
Formatter::nameCase("ST. JOHN"); // => St. John
Formatter::nameCase("VON STREIT"); // => von Streit
Formatter::nameCase("AP LLWYD DAFYDD"); // => ap Llwyd Dafydd
Formatter::nameCase("HENRY VIII"); // => Henry VIII
Formatter::nameCase("VAN DYKE"); // => van Dyke
// Or as an instance
$formatter = new Formatter();
$formatter->nameCase("LOUIS XIV"); // => Louis XIV
// Passing options
Formatter::setOptions([
'lazy' => true,
'irish' => true,
'spanish' => false,
'roman' => true,
'hebrew' => true,
'postnominal' => true,
]);
// Or
$formatter = new Formatter(['spanish' => true]);
// Or
$formatter->setOptions([
'lazy' = false,
'postnominal' => false
]);
// Or even
Formatter::nameCase("VAN DYKE", ['lazy' = false]);
lazy
? Default: true
. Do not do anything if string is already mixed case and lazy option is true
.irish
? Default: true
. Correct "Mac" exceptions.spanish
? Default: false
. Correct el, la
and spanish conjunctions.roman
? Default: true
. Correct roman numbers.hebrew
? Default: true
. Correct ben, bat
.postnominal
? Default: true
. Correct post-nominal e.g. PhD
.This package used to have global function str_name_case
. Now it does not have it anymore.
But, if you still need to have it, use this snippet.
<?php
use Tamtamchik\NameCase\Formatter;
if ( ! function_exists('str_name_case')) {
/
* Wrapper for NameCase object to be used as global function.
*
* @param string $string - string to NameCase.
* @param array $options - options for NameCase.
*
* @return string
*/
function str_name_case($string, $options = [])
{
return Formatter::nameCase($string, $options);
}
}
<?php
use Tamtamchik\NameCase\Formatter;
Formatter::excludePostNominals('MOst');
Formatter::nameCase('?ERNƯ MOST');
Please see CHANGELOG for more information what has changed recently.
$ composer tests
$ composer demo
Please see CONTRIBUTING and CONDUCT for details.
If you discover any security-related issues, please email <yuri.tam.tkachenko@gmail.com> instead of using the issue tracker.
This library is a port of the Perl library and owes most of its functionality to the Perl version by Mark Summerfield. I also used some solutions from Ruby version by Aaron Patterson. Any bugs in the PHP port are my fault.
Original PERL Lingua::EN::NameCase
Version:
Ruby Version:
PHP Version:
The MIT License (MIT). Please see License File for more information.
[ico-version]: https://img.shields.io/packagist/v/tamtamchik/namecase.svg?style=flat-square [ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square [ico-travis]: https://img.shields.io/travis/tamtamchik/namecase/master.svg?style=flat-square [ico-scrutinizer]: https://img.shields.io/scrutinizer/coverage/g/tamtamchik/namecase.svg?style=flat-square [ico-code-quality]: https://img.shields.io/scrutinizer/g/tamtamchik/namecase.svg?style=flat-square [ico-downloads]: https://img.shields.io/packagist/dt/tamtamchik/namecase.svg?style=flat-square [ico-insight]: https://img.shields.io/sensiolabs/i/660fea1e-d105-4064-9caa-f47e8a282f2a.svg?style=flat-square
[link-packagist]: https://packagist.org/packages/tamtamchik/namecase [link-travis]: https://travis-ci.org/tamtamchik/namecase [link-scrutinizer]: https://scrutinizer-ci.com/g/tamtamchik/namecase/code-structure [link-code-quality]: https://scrutinizer-ci.com/g/tamtamchik/namecase [link-downloads]: https://packagist.org/packages/tamtamchik/namecase [link-author]: https://github.com/tamtamchik [link-contributors]: ../../contributors [link-insight]: https://insight.sensiolabs.com/projects/660fea1e-d105-4064-9caa-f47e8a282f2a
Files |
File | Role | Description | ||
---|---|---|---|---|
examples (1 file) | ||||
src (1 file) | ||||
tests (3 files) | ||||
.editorconfig | Data | Auxiliary data | ||
.scrutinizer.yml | Data | Auxiliary data | ||
.travis.yml | Data | Auxiliary data | ||
CHANGELOG.md | Data | Auxiliary data | ||
composer.json | Data | Auxiliary data | ||
CONDUCT.md | Data | Auxiliary data | ||
CONTRIBUTING.md | Data | Auxiliary data | ||
LICENSE.md | Lic. | License text | ||
phpunit.xml.dist | Data | Auxiliary data | ||
README.md | Doc. | Documentation |
Files | / | tests |
File | Role | Description |
---|---|---|
NameCaseTest.php | Class | Class source |
OptionsTest.php | Class | Class source |
PostNominalsTest.php | Class | Class source |
Version Control | Unique User Downloads | Download Rankings | |||||||||||||||
100% |
|
|
Applications that use this package |
If you know an application of this package, send a message to the author to add a link here.