Added I18n PhoneNumber validator based off of country

[mwillbanks]

I am breaking off items from #3884 to make it easier to be able to merge each individually. Please see original PR for several notes. None were given on phone number implementation.

Phone Number

The Phone Number validator is based on libPhoneNumber's XML file. It is a multi-dimensional hash that takes the country code as a key then several subkeys for possible types, national types and separated by types of numbers. The country is primarily used so that you will only need to validate against a subset of items. A country is required.
Basic Usage:

$validator = new \Zend\I18n\Validator\PhoneNumber();
$validator->setCountry('US'); // could be omitted since AD below is a country
$validator->isValid('2015550123');

// input filter with context
$filter = new InputFilter();
$factory = new InputFactory();
// assumption here is that we have a country field coming through the context
$filter->add($factory->createInput(array(
    'name' => 'country',
    'required' => true,
    'validators' => array(
        'name' => 'Zend\I18n\Validator\Country', // separate PR coming later
    ),
)));
$filter->add($factory->createInput(array(
    'name' => 'phoneNumber',
    'required' => true,
    'filters' => array(
        'Digits',
    ),
    'validators' => array(
        'name' => 'Zend\I18n\Validator\PhoneNumber',
        'options' => array(
            'country' => 'country',
        ),
    ),
)));

[EvanDotPro]

Thank you. Thank you. Thank you. Thank you.

[mwillbanks]

@EvanDotPro i think it may need some additional work to fit your use case a bit better but it should be customizable enough for now. I think it could possibly go through all patterns to find possible matches and then attempt to figure out a country or something like that but for now it requires a country :)

[tca3]

I am wondering if there isn't a better way to implement a 200kb array in the validator, I was looking at SplFixedArray but that would require a second array for indexes. I wonder what the benchmarks are on memory usage on this PR.

More generally, the question is, is this the best way to use large fixed datasets accross ZF2.

[DASPRiD]

@mwillbanks About the large array problem @ThomasCantonnet mentioned:

I'd suggest to split the country data into individual files (Zend/I18n/Validator/PhoneNumer/[a-z]{2}.php). and then just load them as required:

$specs = require __DIR__ . '/PhoneNumber/' . $countryCode . '.php';

This should solve a possible memory problem quite a bit.

[mwillbanks]

I'll refactor this a bit; likely tonight ;)

[mwillbanks]

Rebased, force pushed, adjusted for feedback.
@EvanDotPro @DASPRiD care to review?

[wohugb]

how to set only for mobile?
find it:

'allowed_types' => array('mobile'),

[Thinkscape]

#5150 is still hanging ...