2017 © Pedro Peláez
 

library laravel-phone

Adds a phone validator to Laravel and Lumen based on Google's libphonenumber API.

image

tapfury/laravel-phone

Adds a phone validator to Laravel and Lumen based on Google's libphonenumber API.

  • Wednesday, July 19, 2017
  • by gcphost
  • Repository
  • 3 Watchers
  • 0 Stars
  • 1,231 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 79 Forks
  • 0 Open issues
  • 34 Versions
  • 4 % Grown

The README.md

Laravel Phone

Build Status Scrutinizer Code Quality Code Coverage Latest Stable Version Total Downloads License, (*1)

Adds a phone validator & formatter to Laravel 4 & 5 and Lumen based on the PHP port of Google's libphonenumber API by giggsey., (*2)

Installation

Run the following command to install the latest version of the package, (*3)

composer require propaganistas/laravel-phone

Laravel, (*4)

In your app config, add the Service Provider to the $providers array (only for Laravel 5.4 or below):, (*5)

```php 'providers' => [ ... Propaganistas\LaravelPhone\LaravelPhoneServiceProvider::class, ],, (*6)


In your languages directory, add for each language an extra language line for the validator:

```php
"phone" => "The :attribute field contains an invalid number.",

Lumen, (*7)

In bootstrap/app.php, register the Service Provider, (*8)

$app->register(Propaganistas\LaravelPhone\LaravelPhoneServiceProvider::class);

Validator

To validate a field using the phone validator, use the phone keyword in your validation rules array. The phone validator is able to operate in three ways., (*9)

  • You either specify ISO 3166-1 alpha-2 compliant country codes yourself as parameters for the validator, e.g.:, (*10)

    'phonefield'  => 'phone:US,BE',

    The validator will check if the number is valid in at least one of provided countries, so feel free to add as many country codes as you like., (*11)

  • You don't specify any parameters but you plug in a dedicated country input field (keyed by ISO 3166-1 compliant country codes) to allow end users to supply a country on their own. The easiest method by far is to install the Laravel-Intl package. Make sure the country field is named similar as the phone field but with _country appended for automatic discovery, or provide your custom country field name as a parameter to the validator:, (*12)

    'phonefield'            => 'phone',
'phonefield_country'    => 'required_with:phonefield',

    'phonefield'            => 'phone:custom_country_field',
'custom_country_field'  => 'required_with:phonefield',

    If using Laravel-Intl, you could then use the following snippet to populate a country selection list. It will automatically present translated country names according to your application locale:, (*13)

    Country::all()

  • You instruct the validator to detect which country the number belongs to using the AUTO keyword (and optionally any fallback countries):, (*14)

    'phonefield'  => 'phone:AUTO,US',

    The validator will try to extract the country from the number itself and then check if the number is valid for that country. If the country could not be guessed it will be validated using the fallback countries if provided. Note that country guessing will only work when phone numbers are entered in international format (prefixed with a + sign, e.g. +32 ....). Leading double zeros will NOT be parsed correctly as this isn't an established consistency., (*15)

To specify constraints on the number type, just append the allowed types to the end of the parameters, e.g.:, (*16)

'phonefield'  => 'phone:US,BE,mobile',

The most common types are mobile and fixed_line, but feel free to use any of the types defined here., (*17)

You can also enable more lenient validation (for example, fixed lines without area codes) by using the LENIENT parameter. This feature inherently doesn't play well with country autodetection and number type validation, so use such combo at own risk., (*18)

'phonefield'  => 'phone:LENIENT,US',

Formatter

Format a phone number using the phone() helper function. $country_code is the country the phone number belongs to., (*19)

phone($phone_number, $country_code = null, $format = PhoneNumberFormat::INTERNATIONAL)

Always try to provide a $country_code in order for the phone number to be recognized correctly. If no $country_code was given, the current application locale will be used as a sensible default. The $format parameter defines the output format and is optional. The format defaults to international format but can be any constant of libphonenumber\PhoneNumberFormat., (*20)

The Versions

19/07 2017

dev-master

9999999-dev

Adds a phone validator to Laravel and Lumen based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel lumen validation phone libphonenumber

19/07 2017

3.0.1

3.0.1.0

Adds a phone validator to Laravel and Lumen based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel lumen validation phone libphonenumber

17/07 2017

dev-dev-v3

dev-dev-v3

Adds phone number functionality to Laravel and Lumen based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel lumen validation phone libphonenumber

19/06 2017

dev-Laravel-4

dev-Laravel-4

Adds a phone validator to Laravel and Lumen based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel lumen validation phone libphonenumber

02/06 2017

2.8.5

2.8.5.0

Adds a phone validator to Laravel and Lumen based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel lumen validation phone libphonenumber

28/05 2017

2.8.4

2.8.4.0

Adds a phone validator to Laravel and Lumen based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel lumen validation phone libphonenumber

26/05 2017

2.8.3

2.8.3.0

Adds a phone validator to Laravel and Lumen based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel lumen validation phone libphonenumber

14/12 2016

2.8.2

2.8.2.0

Adds a phone validator to Laravel and Lumen based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel lumen validation phone libphonenumber

25/11 2016

2.8.1

2.8.1.0

Adds a phone validator to Laravel and Lumen based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel lumen validation phone libphonenumber

01/10 2016

2.8.0

2.8.0.0

Adds a phone validator to Laravel and Lumen based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel lumen validation phone libphonenumber

20/05 2016

2.7.4

2.7.4.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel validation phone libphonenumber

15/05 2016

2.7.3

2.7.3.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel validation phone libphonenumber

28/04 2016

2.7.2

2.7.2.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel validation phone libphonenumber

06/04 2016

2.7.1

2.7.1.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel validation phone libphonenumber

20/03 2016

2.7.0

2.7.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel validation phone libphonenumber

23/02 2016

2.6.1

2.6.1.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel validation phone libphonenumber

01/01 2016

2.6.0

2.6.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel validation phone libphonenumber

19/12 2015

2.5.0

2.5.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Propaganistas

laravel validation phone libphonenumber

16/12 2015

2.4.2

2.4.2.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

08/12 2015

2.4.1

2.4.1.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

15/09 2015

2.4.0

2.4.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

19/06 2015

2.3.0

2.3.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

09/05 2015

2.2.0

2.2.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

04/05 2015

2.1.2

2.1.2.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

04/05 2015

1.3.2

1.3.2.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

29/04 2015

1.3.1

1.3.1.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

29/04 2015

2.1.1

2.1.1.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

24/04 2015

1.3.0

1.3.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

24/04 2015

2.1.0

2.1.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

27/02 2015

2.0

2.0.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

12/01 2015

1.2.0

1.2.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

20/11 2014

1.1.1

1.1.1.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

22/03 2014

1.1.0

1.1.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel validation phone libphonenumber

28/02 2014

1.0.0

1.0.0.0

Adds a phone validator to Laravel based on Google's libphonenumber API.

  Sources   Download

MIT

The Requires

 

by Avatar Propaganistas

laravel libphonenumber