2017 © Pedro Peláez
 

library namecase

This package allows you to convert names into the correct case where possible.

image

tamtamchik/namecase

This package allows you to convert names into the correct case where possible.

  • Wednesday, May 18, 2016
  • by tamtamchik
  • Repository
  • 3 Watchers
  • 47 Stars
  • 4,784 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 4 Versions
  • 19 % Grown

The README.md

NameCase

Latest Version on Packagist ![PHP][ico-php] ![Total Downloads][ico-downloads] ![Software License][ico-license] Build Status ![Coverage Status][ico-scrutinizer] Quality Score, (*1)

SensioLabsInsight, (*2)

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 appear in a single string, whitespace-separated, NameCase deals correctly with them., (*3)

Currently, NameCase correctly name-cases names which include any of the following:, (*4)

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 that contain apostrophes and hyphens, too., (*5)

[!NOTE] This README.md is for version 3.x.
If you need a PHP 5 compatible version, please use 1.0.x! README.md, (*6)

Install

Via Composer, (*7)

$ composer require tamtamchik/namecase

Usage

use \Tamtamchik\NameCase\Formatter;
use function \Tamtamchik\NameCase\str_name_case;

// 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

// Or as a function
str_name_case("JJ ABRAMS");                              // => JJ Abrams

// Passing options (see below for details)
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]);

// And for function
str_name_case("VAN DYKE", ['lazy' = false]);

Options

  • lazy – Default: true. Do not do anything if the string is already mixed case and the 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.

Exclude Post-Nominals

<?php

use Tamtamchik\NameCase\Formatter;

Formatter::excludePostNominals('MOst');

Formatter::nameCase('ČERNÝ MOST');

Changelog

Please see CHANGELOG for more information on what has changed recently., (*8)

Testing & Demo

$ composer tests
$ composer demo

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details., (*9)

Security

If you discover any security-related issues, please email yuri.tam.tkachenko@gmail.com instead of using the issue tracker., (*10)

Acknowledgements

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., (*11)

Credits

Original PERL Lingua::EN::NameCase Version:, (*12)

  • Copyright © Mark Summerfield 1998-2014. All Rights Reserved.
  • Copyright © Barbie 2014-2019. All Rights Reserved.

Ruby Version:, (*13)

  • Copyright © Aaron Patterson 2006. All Rights Reserved.

PHP Version:, (*14)

License

The MIT License (MIT). Please see License File for more information., (*15)


Buy Me A Coffee, (*16)

The Versions

18/05 2016

dev-master

9999999-dev https://github.com/tamtamchik/namecase

This package allows you to convert names into the correct case where possible.

  Sources   Download

MIT

The Requires

  • php >=5.4.0

 

The Development Requires

strings tamtamchik namecase properly cased

06/02 2016

1.0.2

1.0.2.0 https://github.com/tamtamchik/namecase

This package allows you to convert names into the correct case where possible.

  Sources   Download

MIT

The Requires

  • php >=5.4.0

 

The Development Requires

strings tamtamchik namecase properly cased

30/01 2016

1.0.1

1.0.1.0 https://github.com/tamtamchik/namecase

A library for converting strings to be properly cased. This is good for converting denormalized data to human friendly data.

  Sources   Download

MIT

The Requires

  • php >=5.4.0

 

The Development Requires

strings tamtamchik namecase properly cased

29/01 2016

1.0.0

1.0.0.0 https://github.com/tamtamchik/namecase

A library for converting strings to be properly cased. This is good for converting denormalized data to human friendly data.

  Sources   Download

MIT

The Requires

  • php >=5.4.0

 

The Development Requires

strings tamtamchik namecase properly cased