Propaganistas / Laravel-Phone

src/Validation/Phone.php

Unused Use Statements -1 removed lines

@@ -4,7 +4,6 @@
 use Illuminate\Support\Collection;
 use libphonenumber\PhoneNumberUtil;
 use Propaganistas\LaravelPhone\Exceptions\InvalidParameterException;
-use Propaganistas\LaravelPhone\Exceptions\CountryCodeException;
 use Propaganistas\LaravelPhone\Exceptions\NumberParseException;
 use Propaganistas\LaravelPhone\PhoneNumber;
 use Propaganistas\LaravelPhone\Traits\ParsesCountries;

Indentation +121 added lines, -121 removed lines

@@ -12,125 +12,125 @@
 
 class Phone
 {
-    use ParsesCountries,
-        ParsesTypes;
-
-    /**
-     * @var \libphonenumber\PhoneNumberUtil
-     */
-    protected $lib;
-
-    /**
-     * Phone constructor.
-     */
-    public function __construct()
-    {
-        $this->lib = PhoneNumberUtil::getInstance();
-    }
-
-    /**
-     * Validates a phone number.
-     *
-     * @param  string $attribute
-     * @param  mixed  $value
-     * @param  array  $parameters
-     * @param  object $validator
-     * @return bool
-     */
-    public function validate($attribute, $value, array $parameters, $validator)
-    {
-        $data = $validator->getData();
-
-        list(
-            $countries,
-            $types,
-            $detect,
-            $lenient) = $this->extractParameters($attribute, $parameters, $data);
-
-        // A "null" country is prepended:
-        // 1. In case of auto-detection to have the validation run first without supplying a country.
-        // 2. In case of lenient validation without provided countries; we still might have some luck...
-        if ($detect || ($lenient && empty($countries))) {
-            array_unshift($countries, null);
-        }
-
-        foreach ($countries as $country) {
-            try {
-                // Parsing the phone number also validates the country, so no need to do this explicitly.
-                // It'll throw a PhoneCountryException upon failure.
-                $phoneNumber = PhoneNumber::make($value, $country);
-
-                // Type validation.
-                if (! empty($types) && ! $phoneNumber->isOfType($types)) {
-                    continue;
-                }
-
-                $lenientPhoneNumber = $phoneNumber->lenient()->getPhoneNumberInstance();
-
-                // Lenient validation.
-                if ($lenient && $this->lib->isPossibleNumber($lenientPhoneNumber, $country)) {
-                    return true;
-                }
-
-                $phoneNumberInstance = $phoneNumber->getPhoneNumberInstance();
-
-
-                // Country detection.
-                if ($detect && $this->lib->isValidNumber($phoneNumberInstance)) {
-                    return true;
-                }
-
-                // Default number+country validation.
-                if ($this->lib->isValidNumberForRegion($phoneNumberInstance, $country)) {
-                    return true;
-                }
-            } catch (NumberParseException $e) {
-                continue;
-            }
-        }
-
-        return false;
-    }
-
-    /**
-     * Parse and extract parameters in the appropriate validation arguments.
-     *
-     * @param string $attribute
-     * @param array  $parameters
-     * @param array  $data
-     * @return array
-     * @throws \Propaganistas\LaravelPhone\Exceptions\InvalidParameterException
-     */
-    protected function extractParameters($attribute, array $parameters, array $data)
-    {
-        // Discover if an input field was provided. If not, guess the field's name.
-        $inputField = Collection::make($parameters)
-                                ->intersect(array_keys(Arr::dot($data)))
-                                ->first(null, "${attribute}_country");
-
-        // Attempt to retrieve the field's value. If no field is present, this will be null.
-        $inputCountry = Arr::get($data, $inputField);
-
-        $countries = static::parseCountries($inputCountry ? [$inputCountry] : $parameters);
-        $types = static::parseTypes($parameters);
-
-        // Force developers to write proper code.
-        // Since the static parsers return a validated array with preserved keys, we can safely diff against the keys.
-        $leftovers = Collection::make($parameters)
-                               ->diffKeys($types)
-                               ->diffKeys($inputCountry ? [] : $countries)
-                               ->diff(['AUTO', 'LENIENT', $inputField]);
-
-        if ($leftovers->isNotEmpty()) {
-            throw InvalidParameterException::parameters($leftovers);
-        }
-
-        return [
-            $countries,
-            $types,
-            in_array('AUTO', $parameters),
-            in_array('LENIENT', $parameters),
-            $inputField,
-        ];
-    }
+	use ParsesCountries,
+		ParsesTypes;
+
+	/**
+	 * @var \libphonenumber\PhoneNumberUtil
+	 */
+	protected $lib;
+
+	/**
+	 * Phone constructor.
+	 */
+	public function __construct()
+	{
+		$this->lib = PhoneNumberUtil::getInstance();
+	}
+
+	/**
+	 * Validates a phone number.
+	 *
+	 * @param  string $attribute
+	 * @param  mixed  $value
+	 * @param  array  $parameters
+	 * @param  object $validator
+	 * @return bool
+	 */
+	public function validate($attribute, $value, array $parameters, $validator)
+	{
+		$data = $validator->getData();
+
+		list(
+			$countries,
+			$types,
+			$detect,
+			$lenient) = $this->extractParameters($attribute, $parameters, $data);
+
+		// A "null" country is prepended:
+		// 1. In case of auto-detection to have the validation run first without supplying a country.
+		// 2. In case of lenient validation without provided countries; we still might have some luck...
+		if ($detect || ($lenient && empty($countries))) {
+			array_unshift($countries, null);
+		}
+
+		foreach ($countries as $country) {
+			try {
+				// Parsing the phone number also validates the country, so no need to do this explicitly.
+				// It'll throw a PhoneCountryException upon failure.
+				$phoneNumber = PhoneNumber::make($value, $country);
+
+				// Type validation.
+				if (! empty($types) && ! $phoneNumber->isOfType($types)) {
+					continue;
+				}
+
+				$lenientPhoneNumber = $phoneNumber->lenient()->getPhoneNumberInstance();
+
+				// Lenient validation.
+				if ($lenient && $this->lib->isPossibleNumber($lenientPhoneNumber, $country)) {
+					return true;
+				}
+
+				$phoneNumberInstance = $phoneNumber->getPhoneNumberInstance();
+
+
+				// Country detection.
+				if ($detect && $this->lib->isValidNumber($phoneNumberInstance)) {
+					return true;
+				}
+
+				// Default number+country validation.
+				if ($this->lib->isValidNumberForRegion($phoneNumberInstance, $country)) {
+					return true;
+				}
+			} catch (NumberParseException $e) {
+				continue;
+			}
+		}
+
+		return false;
+	}
+
+	/**
+	 * Parse and extract parameters in the appropriate validation arguments.
+	 *
+	 * @param string $attribute
+	 * @param array  $parameters
+	 * @param array  $data
+	 * @return array
+	 * @throws \Propaganistas\LaravelPhone\Exceptions\InvalidParameterException
+	 */
+	protected function extractParameters($attribute, array $parameters, array $data)
+	{
+		// Discover if an input field was provided. If not, guess the field's name.
+		$inputField = Collection::make($parameters)
+								->intersect(array_keys(Arr::dot($data)))
+								->first(null, "${attribute}_country");
+
+		// Attempt to retrieve the field's value. If no field is present, this will be null.
+		$inputCountry = Arr::get($data, $inputField);
+
+		$countries = static::parseCountries($inputCountry ? [$inputCountry] : $parameters);
+		$types = static::parseTypes($parameters);
+
+		// Force developers to write proper code.
+		// Since the static parsers return a validated array with preserved keys, we can safely diff against the keys.
+		$leftovers = Collection::make($parameters)
+							   ->diffKeys($types)
+							   ->diffKeys($inputCountry ? [] : $countries)
+							   ->diff(['AUTO', 'LENIENT', $inputField]);
+
+		if ($leftovers->isNotEmpty()) {
+			throw InvalidParameterException::parameters($leftovers);
+		}
+
+		return [
+			$countries,
+			$types,
+			in_array('AUTO', $parameters),
+			in_array('LENIENT', $parameters),
+			$inputField,
+		];
+	}
 }
\ No newline at end of file

Spacing +1 added lines, -1 removed lines

@@ -61,7 +61,7 @@
                 $phoneNumber = PhoneNumber::make($value, $country);
 
                 // Type validation.
-                if (! empty($types) && ! $phoneNumber->isOfType($types)) {
+                if (!empty($types) && !$phoneNumber->isOfType($types)) {
                     continue;
                 }
 

src/Exceptions/InvalidParameterException.php

Indentation +11 added lines, -11 removed lines

@@ -4,16 +4,16 @@
 
 class InvalidParameterException extends \Exception
 {
-    /**
-     * Invalid parameters static constructor.
-     *
-     * @param array|Collection $parameters
-     * @return static
-     */
-    public static function parameters($parameters)
-    {
-        $parameters = Collection::make($parameters);
+	/**
+	 * Invalid parameters static constructor.
+	 *
+	 * @param array|Collection $parameters
+	 * @return static
+	 */
+	public static function parameters($parameters)
+	{
+		$parameters = Collection::make($parameters);
 
-        return new static('Invalid phone validation parameters: "' . $parameters->implode(',') . '".');
-    }
+		return new static('Invalid phone validation parameters: "' . $parameters->implode(',') . '".');
+	}
 }
\ No newline at end of file

Spacing +1 added lines, -1 removed lines

@@ -14,6 +14,6 @@
     {
         $parameters = Collection::make($parameters);
 
-        return new static('Invalid phone validation parameters: "' . $parameters->implode(',') . '".');
+        return new static('Invalid phone validation parameters: "'.$parameters->implode(',').'".');
     }
 }
\ No newline at end of file

src/Exceptions/NumberParseException.php

Indentation +13 added lines, -13 removed lines

@@ -4,17 +4,17 @@
 
 class NumberParseException extends libNumberParseException
 {
-    /**
-     * Country specification required static constructor.
-     *
-     * @param string $number
-     * @return static
-     */
-    public static function countryRequired($number)
-    {
-        return new static(
-            libNumberParseException::INVALID_COUNTRY_CODE,
-            'Country specification for number "' . $number . '" required.'
-        );
-    }
+	/**
+	 * Country specification required static constructor.
+	 *
+	 * @param string $number
+	 * @return static
+	 */
+	public static function countryRequired($number)
+	{
+		return new static(
+			libNumberParseException::INVALID_COUNTRY_CODE,
+			'Country specification for number "' . $number . '" required.'
+		);
+	}
 }
\ No newline at end of file

Spacing +1 added lines, -1 removed lines

@@ -14,7 +14,7 @@
     {
         return new static(
             libNumberParseException::INVALID_COUNTRY_CODE,
-            'Country specification for number "' . $number . '" required.'
+            'Country specification for number "'.$number.'" required.'
         );
     }
 }
\ No newline at end of file

src/Exceptions/CountryCodeException.php

Indentation +10 added lines, -10 removed lines

@@ -2,14 +2,14 @@
 
 class CountryCodeException extends \Exception
 {
-    /**
-     * Invalid country code static constructor.
-     *
-     * @param string $country
-     * @return static
-     */
-    public static function invalid($country)
-    {
-        return new static('Invalid country code "' . $country . '".');
-    }
+	/**
+	 * Invalid country code static constructor.
+	 *
+	 * @param string $country
+	 * @return static
+	 */
+	public static function invalid($country)
+	{
+		return new static('Invalid country code "' . $country . '".');
+	}
 }

Spacing +1 added lines, -1 removed lines

@@ -10,6 +10,6 @@
      */
     public static function invalid($country)
     {
-        return new static('Invalid country code "' . $country . '".');
+        return new static('Invalid country code "'.$country.'".');
     }
 }

src/Exceptions/NumberFormatException.php

Indentation +10 added lines, -10 removed lines

@@ -2,14 +2,14 @@
 
 class NumberFormatException extends \Exception
 {
-    /**
-     * Invalid number format static constructor.
-     *
-     * @param string $format
-     * @return static
-     */
-    public static function invalid($format)
-    {
-        return new static('Invalid number format "' . $format . '".');
-    }
+	/**
+	 * Invalid number format static constructor.
+	 *
+	 * @param string $format
+	 * @return static
+	 */
+	public static function invalid($format)
+	{
+		return new static('Invalid number format "' . $format . '".');
+	}
 }
\ No newline at end of file

Spacing +1 added lines, -1 removed lines

@@ -10,6 +10,6 @@
      */
     public static function invalid($format)
     {
-        return new static('Invalid number format "' . $format . '".');
+        return new static('Invalid number format "'.$format.'".');
     }
 }
\ No newline at end of file

src/helpers.php

Indentation +16 added lines, -16 removed lines

@@ -3,22 +3,22 @@
 use Propaganistas\LaravelPhone\PhoneNumber;
 
 if (! function_exists('phone')) {
-    /**
-     * Get a PhoneNumber instance or a formatted string.
-     *
-     * @param string       $number
-     * @param string|array $country
-     * @param string       $format
-     * @return string|Propaganistas\LaravelPhone\PhoneNumber
-     */
-    function phone($number, $country = null, $format = null)
-    {
-        $phone = PhoneNumber::make($number, $country);
+	/**
+	 * Get a PhoneNumber instance or a formatted string.
+	 *
+	 * @param string       $number
+	 * @param string|array $country
+	 * @param string       $format
+	 * @return string|Propaganistas\LaravelPhone\PhoneNumber
+	 */
+	function phone($number, $country = null, $format = null)
+	{
+		$phone = PhoneNumber::make($number, $country);
 
-        if (! is_null($format)) {
-            return $phone->format($format);
-        }
+		if (! is_null($format)) {
+			return $phone->format($format);
+		}
 
-        return $phone;
-    }
+		return $phone;
+	}
 }

Spacing +2 added lines, -2 removed lines

@@ -2,7 +2,7 @@ 
 
 use Propaganistas\LaravelPhone\PhoneNumber;
 
-if (! function_exists('phone')) {
+if (!function_exists('phone')) {
     /**
      * Get a PhoneNumber instance or a formatted string.
      *
@@ -15,7 +15,7 @@ 
     {
         $phone = PhoneNumber::make($number, $country);
 
-        if (! is_null($format)) {
+        if (!is_null($format)) {
             return $phone->format($format);
         }
 

src/PhoneServiceProvider.php

Indentation +51 added lines, -51 removed lines

@@ -10,63 +10,63 @@
 
 class PhoneServiceProvider extends ServiceProvider
 {
-    /**
-     * Bootstrap the application events.
-     *
-     * @return void
-     */
-    public function boot()
-    {
-        $this->registerValidator();
+	/**
+	 * Bootstrap the application events.
+	 *
+	 * @return void
+	 */
+	public function boot()
+	{
+		$this->registerValidator();
 
-        $this->registerRule();
-    }
+		$this->registerRule();
+	}
 
-    /**
-     * Register the service provider.
-     *
-     * @return void
-     */
-    public function register()
-    {
-        $this->app->singleton('libphonenumber', function ($app) {
-            return PhoneNumberUtil::getInstance();
-        });
+	/**
+	 * Register the service provider.
+	 *
+	 * @return void
+	 */
+	public function register()
+	{
+		$this->app->singleton('libphonenumber', function ($app) {
+			return PhoneNumberUtil::getInstance();
+		});
 
-        $this->app->alias('libphonenumber', PhoneNumberUtil::class);
-    }
+		$this->app->alias('libphonenumber', PhoneNumberUtil::class);
+	}
 
-    /**
-     * Register the "phone" validator.
-     */
-    protected function registerValidator()
-    {
-        $extend = static::canUseDependentValidation() ? 'extendDependent' : 'extend';
+	/**
+	 * Register the "phone" validator.
+	 */
+	protected function registerValidator()
+	{
+		$extend = static::canUseDependentValidation() ? 'extendDependent' : 'extend';
 
-        $this->app['validator']->{$extend}('phone', Validation\Phone::class . '@validate');
-    }
+		$this->app['validator']->{$extend}('phone', Validation\Phone::class . '@validate');
+	}
 
-    /**
-     * Register the "phone" rule macro.
-     */
-    protected function registerRule()
-    {
-        if (class_exists('Illuminate\Validation\Rule') && class_uses(Rule::class, Macroable::class)) {
-            Rule::macro('phone', function () {
-                return new Rules\Phone;
-            });
-        }
-    }
+	/**
+	 * Register the "phone" rule macro.
+	 */
+	protected function registerRule()
+	{
+		if (class_exists('Illuminate\Validation\Rule') && class_uses(Rule::class, Macroable::class)) {
+			Rule::macro('phone', function () {
+				return new Rules\Phone;
+			});
+		}
+	}
 
-    /**
-     * Determine whether we can register a dependent validator.
-     *
-     * @return bool
-     */
-    public static function canUseDependentValidation()
-    {
-        $validator = new ReflectionClass('\Illuminate\Validation\Factory');
+	/**
+	 * Determine whether we can register a dependent validator.
+	 *
+	 * @return bool
+	 */
+	public static function canUseDependentValidation()
+	{
+		$validator = new ReflectionClass('\Illuminate\Validation\Factory');
 
-        return $validator->hasMethod('extendDependent');
-    }
+		return $validator->hasMethod('extendDependent');
+	}
 }

Spacing +3 added lines, -3 removed lines

@@ -29,7 +29,7 @@ 
      */
     public function register()
     {
-        $this->app->singleton('libphonenumber', function ($app) {
+        $this->app->singleton('libphonenumber', function($app) {
             return PhoneNumberUtil::getInstance();
         });
 
@@ -43,7 +43,7 @@ 
     {
         $extend = static::canUseDependentValidation() ? 'extendDependent' : 'extend';
 
-        $this->app['validator']->{$extend}('phone', Validation\Phone::class . '@validate');
+        $this->app['validator']->{$extend}('phone', Validation\Phone::class.'@validate');
     }
 
     /**
@@ -52,7 +52,7 @@ 
     protected function registerRule()
     {
         if (class_exists('Illuminate\Validation\Rule') && class_uses(Rule::class, Macroable::class)) {
-            Rule::macro('phone', function () {
+            Rule::macro('phone', function() {
                 return new Rules\Phone;
             });
         }

src/PhoneNumber.php

Indentation +352 added lines, -352 removed lines

@@ -18,356 +18,356 @@
 
 class PhoneNumber implements Jsonable, JsonSerializable, Serializable
 {
-    use ParsesCountries,
-        ParsesFormats,
-        ParsesTypes;
-
-    /**
-     * The provided phone number.
-     *
-     * @var string
-     */
-    protected $number;
-
-    /**
-     * The provided phone country.
-     *
-     * @var array
-     */
-    protected $countries = [];
-
-    /**
-     * The detected phone country.
-     *
-     * @var string
-     */
-    protected $country;
-
-    /**
-     * Whether to allow lenient checks (i.e. landline numbers without area codes).
-     *
-     * @var bool
-     */
-    protected $lenient = false;
-
-    /**
-     * @var \libphonenumber\PhoneNumberUtil
-     */
-    protected $lib;
-
-    /**
-     * Phone constructor.
-     *
-     * @param string $number
-     */
-    public function __construct($number)
-    {
-        $this->number = $number;
-        $this->lib = PhoneNumberUtil::getInstance();
-    }
-
-    /**
-     * Create a phone instance.
-     *
-     * @param string       $number
-     * @param string|array $country
-     * @return static
-     */
-    public static function make($number, $country = [])
-    {
-        $instance = new static($number);
-
-        return $instance->ofCountry($country);
-    }
-
-    /**
-     * Set the country to which the phone number belongs to.
-     *
-     * @param string|array $country
-     * @return static
-     */
-    public function ofCountry($country)
-    {
-        $countries = is_array($country) ? $country : func_get_args();
-
-        $instance = clone $this;
-        $instance->countries = array_unique(
-            array_merge($instance->countries, static::parseCountries($countries))
-        );
-
-        return $instance;
-    }
-
-    /**
-     * Format the phone number in international format.
-     *
-     * @return string
-     */
-    public function formatInternational()
-    {
-        return $this->format(PhoneNumberFormat::INTERNATIONAL);
-    }
-
-    /**
-     * Format the phone number in national format.
-     *
-     * @return string
-     */
-    public function formatNational()
-    {
-        return $this->format(PhoneNumberFormat::NATIONAL);
-    }
-
-    /**
-     * Format the phone number in E164 format.
-     *
-     * @return string
-     */
-    public function formatE164()
-    {
-        return $this->format(PhoneNumberFormat::E164);
-    }
-
-    /**
-     * Format the phone number in RFC3966 format.
-     *
-     * @return string
-     */
-    public function formatRFC3966()
-    {
-        return $this->format(PhoneNumberFormat::RFC3966);
-    }
-
-    /**
-     * Format the phone number in a given format.
-     *
-     * @param string $format
-     * @return string
-     * @throws \Propaganistas\LaravelPhone\Exceptions\NumberFormatException
-     */
-    public function format($format)
-    {
-        $parsedFormat = static::parseFormat($format);
-
-        if (is_null($parsedFormat)) {
-            throw NumberFormatException::invalid($format);
-        }
-
-        return $this->lib->format(
-            $this->getPhoneNumberInstance(),
-            $parsedFormat
-        );
-    }
-
-    /**
-     * Format the phone number in a way that it can be dialled from the provided country.
-     *
-     * @param string $country
-     * @return string
-     * @throws \Propaganistas\LaravelPhone\Exceptions\CountryCodeException
-     */
-    public function formatForCountry($country)
-    {
-        if (! static::isValidCountryCode($country)) {
-            throw CountryCodeException::invalid($country);
-        }
-
-        return $this->lib->formatOutOfCountryCallingNumber(
-            $this->getPhoneNumberInstance(),
-            $country
-        );
-    }
-
-    /**
-     * Format the phone number in a way that it can be dialled from the provided country using a cellphone.
-     *
-     * @param string $country
-     * @param bool   $removeFormatting
-     * @return string
-     * @throws \Propaganistas\LaravelPhone\Exceptions\CountryCodeException
-     */
-    public function formatForMobileDialingInCountry($country, $removeFormatting = false)
-    {
-        if (! static::isValidCountryCode($country)) {
-            throw CountryCodeException::invalid($country);
-        }
-
-        return $this->lib->formatNumberForMobileDialing(
-            $this->getPhoneNumberInstance(),
-            $country,
-            $removeFormatting
-        );
-    }
-
-    /**
-     * Get the phone number's country.
-     *
-     * @return string
-     */
-    public function getCountry()
-    {
-        if (! $this->country) {
-            $this->country = $this->filterValidCountry($this->countries);
-        }
-
-        return $this->country;
-    }
-
-    /**
-     * Filter the provided countries to the one that is valid for the number.
-     *
-     * @param string|array $countries
-     * @return string
-     * @throws \Propaganistas\LaravelPhone\Exceptions\NumberParseException
-     */
-    protected function filterValidCountry($countries)
-    {
-        $result = Collection::make($countries)
-                            ->filter(function ($country) {
-                                $instance = $this->lib->parse($this->number, $country);
-
-                                return $this->lenient
-                                    ? $this->lib->isPossibleNumber($instance, $country)
-                                    : $this->lib->isValidNumberForRegion($instance, $country);
-                            })->first();
-
-        // If we got a new result, return it.
-        if ($result) {
-            return $result;
-        }
-
-        // Last resort: try to detect it from an international number.
-        if ($this->numberLooksInternational()) {
-            $instance = $this->lib->parse($this->number, null);
-
-            if ($this->lib->isValidNumber($instance)) {
-                return $this->lib->getRegionCodeForNumber($instance);
-            }
-        }
-
-        throw NumberParseException::countryRequired($this->number);
-    }
-
-    /**
-     * Get the phone number's type.
-     *
-     * @param bool $asConstant
-     * @return string|int|null
-     */
-    public function getType($asConstant = false)
-    {
-        $type = $this->lib->getNumberType($this->getPhoneNumberInstance());
-
-        if ($asConstant) {
-            return $type;
-        }
-
-        $stringType = Arr::first(static::parseTypesAsStrings($type));
-
-        return $stringType ? strtolower($stringType) : null;
-    }
-
-    /**
-     * Check if the phone number is of (a) given type(s).
-     *
-     * @param string $type
-     * @return bool
-     */
-    public function isOfType($type)
-    {
-        $types = static::parseTypes($type);
-
-        return in_array($this->getType(true), $types, true);
-    }
-
-    /**
-     * Get the PhoneNumber instance of the current number.
-     *
-     * @return \libphonenumber\PhoneNumber
-     */
-    public function getPhoneNumberInstance()
-    {
-        return $this->lib->parse($this->number, $this->getCountry());
-    }
-
-    /**
-     * Determine whether the phone number seems to be in international format.
-     *
-     * @return bool
-     */
-    protected function numberLooksInternational()
-    {
-        return Str::startsWith($this->number, '+');
-    }
-
-    /**
-     * Enable lenient number parsing.
-     *
-     * @return $this
-     */
-    public function lenient()
-    {
-        $this->lenient = true;
-
-        return $this;
-    }
-
-    /**
-     * Convert the phone instance to JSON.
-     *
-     * @param  int $options
-     * @return string
-     */
-    public function toJson($options = 0)
-    {
-        return json_encode($this->jsonSerialize(), $options);
-    }
-
-    /**
-     * Convert the phone instance into something JSON serializable.
-     *
-     * @return string
-     */
-    public function jsonSerialize()
-    {
-        return $this->formatE164();
-    }
-
-    /**
-     * Convert the phone instance into a string representation.
-     *
-     * @return string
-     */
-    public function serialize()
-    {
-        return $this->formatE164();
-    }
-
-    /**
-     * Reconstructs the phone instance from a string representation.
-     *
-     * @param string $serialized
-     */
-    public function unserialize($serialized)
-    {
-        $this->lib = PhoneNumberUtil::getInstance();
-        $this->number = $serialized;
-        $this->country = $this->lib->getRegionCodeForNumber($this->getPhoneNumberInstance());
-    }
-
-    /**
-     * Convert the phone instance to a formatted number.
-     *
-     * @return string
-     */
-    public function __toString()
-    {
-        // Formatting the phone number could throw an exception, but __toString() doesn't cope well with that.
-        // Let's just return the original number in that case.
-        try {
-            return $this->formatE164();
-        } catch (Exception $exception) {
-            return $this->number;
-        }
-    }
+	use ParsesCountries,
+		ParsesFormats,
+		ParsesTypes;
+
+	/**
+	 * The provided phone number.
+	 *
+	 * @var string
+	 */
+	protected $number;
+
+	/**
+	 * The provided phone country.
+	 *
+	 * @var array
+	 */
+	protected $countries = [];
+
+	/**
+	 * The detected phone country.
+	 *
+	 * @var string
+	 */
+	protected $country;
+
+	/**
+	 * Whether to allow lenient checks (i.e. landline numbers without area codes).
+	 *
+	 * @var bool
+	 */
+	protected $lenient = false;
+
+	/**
+	 * @var \libphonenumber\PhoneNumberUtil
+	 */
+	protected $lib;
+
+	/**
+	 * Phone constructor.
+	 *
+	 * @param string $number
+	 */
+	public function __construct($number)
+	{
+		$this->number = $number;
+		$this->lib = PhoneNumberUtil::getInstance();
+	}
+
+	/**
+	 * Create a phone instance.
+	 *
+	 * @param string       $number
+	 * @param string|array $country
+	 * @return static
+	 */
+	public static function make($number, $country = [])
+	{
+		$instance = new static($number);
+
+		return $instance->ofCountry($country);
+	}
+
+	/**
+	 * Set the country to which the phone number belongs to.
+	 *
+	 * @param string|array $country
+	 * @return static
+	 */
+	public function ofCountry($country)
+	{
+		$countries = is_array($country) ? $country : func_get_args();
+
+		$instance = clone $this;
+		$instance->countries = array_unique(
+			array_merge($instance->countries, static::parseCountries($countries))
+		);
+
+		return $instance;
+	}
+
+	/**
+	 * Format the phone number in international format.
+	 *
+	 * @return string
+	 */
+	public function formatInternational()
+	{
+		return $this->format(PhoneNumberFormat::INTERNATIONAL);
+	}
+
+	/**
+	 * Format the phone number in national format.
+	 *
+	 * @return string
+	 */
+	public function formatNational()
+	{
+		return $this->format(PhoneNumberFormat::NATIONAL);
+	}
+
+	/**
+	 * Format the phone number in E164 format.
+	 *
+	 * @return string
+	 */
+	public function formatE164()
+	{
+		return $this->format(PhoneNumberFormat::E164);
+	}
+
+	/**
+	 * Format the phone number in RFC3966 format.
+	 *
+	 * @return string
+	 */
+	public function formatRFC3966()
+	{
+		return $this->format(PhoneNumberFormat::RFC3966);
+	}
+
+	/**
+	 * Format the phone number in a given format.
+	 *
+	 * @param string $format
+	 * @return string
+	 * @throws \Propaganistas\LaravelPhone\Exceptions\NumberFormatException
+	 */
+	public function format($format)
+	{
+		$parsedFormat = static::parseFormat($format);
+
+		if (is_null($parsedFormat)) {
+			throw NumberFormatException::invalid($format);
+		}
+
+		return $this->lib->format(
+			$this->getPhoneNumberInstance(),
+			$parsedFormat
+		);
+	}
+
+	/**
+	 * Format the phone number in a way that it can be dialled from the provided country.
+	 *
+	 * @param string $country
+	 * @return string
+	 * @throws \Propaganistas\LaravelPhone\Exceptions\CountryCodeException
+	 */
+	public function formatForCountry($country)
+	{
+		if (! static::isValidCountryCode($country)) {
+			throw CountryCodeException::invalid($country);
+		}
+
+		return $this->lib->formatOutOfCountryCallingNumber(
+			$this->getPhoneNumberInstance(),
+			$country
+		);
+	}
+
+	/**
+	 * Format the phone number in a way that it can be dialled from the provided country using a cellphone.
+	 *
+	 * @param string $country
+	 * @param bool   $removeFormatting
+	 * @return string
+	 * @throws \Propaganistas\LaravelPhone\Exceptions\CountryCodeException
+	 */
+	public function formatForMobileDialingInCountry($country, $removeFormatting = false)
+	{
+		if (! static::isValidCountryCode($country)) {
+			throw CountryCodeException::invalid($country);
+		}
+
+		return $this->lib->formatNumberForMobileDialing(
+			$this->getPhoneNumberInstance(),
+			$country,
+			$removeFormatting
+		);
+	}
+
+	/**
+	 * Get the phone number's country.
+	 *
+	 * @return string
+	 */
+	public function getCountry()
+	{
+		if (! $this->country) {
+			$this->country = $this->filterValidCountry($this->countries);
+		}
+
+		return $this->country;
+	}
+
+	/**
+	 * Filter the provided countries to the one that is valid for the number.
+	 *
+	 * @param string|array $countries
+	 * @return string
+	 * @throws \Propaganistas\LaravelPhone\Exceptions\NumberParseException
+	 */
+	protected function filterValidCountry($countries)
+	{
+		$result = Collection::make($countries)
+							->filter(function ($country) {
+								$instance = $this->lib->parse($this->number, $country);
+
+								return $this->lenient
+									? $this->lib->isPossibleNumber($instance, $country)
+									: $this->lib->isValidNumberForRegion($instance, $country);
+							})->first();
+
+		// If we got a new result, return it.
+		if ($result) {
+			return $result;
+		}
+
+		// Last resort: try to detect it from an international number.
+		if ($this->numberLooksInternational()) {
+			$instance = $this->lib->parse($this->number, null);
+
+			if ($this->lib->isValidNumber($instance)) {
+				return $this->lib->getRegionCodeForNumber($instance);
+			}
+		}
+
+		throw NumberParseException::countryRequired($this->number);
+	}
+
+	/**
+	 * Get the phone number's type.
+	 *
+	 * @param bool $asConstant
+	 * @return string|int|null
+	 */
+	public function getType($asConstant = false)
+	{
+		$type = $this->lib->getNumberType($this->getPhoneNumberInstance());
+
+		if ($asConstant) {
+			return $type;
+		}
+
+		$stringType = Arr::first(static::parseTypesAsStrings($type));
+
+		return $stringType ? strtolower($stringType) : null;
+	}
+
+	/**
+	 * Check if the phone number is of (a) given type(s).
+	 *
+	 * @param string $type
+	 * @return bool
+	 */
+	public function isOfType($type)
+	{
+		$types = static::parseTypes($type);
+
+		return in_array($this->getType(true), $types, true);
+	}
+
+	/**
+	 * Get the PhoneNumber instance of the current number.
+	 *
+	 * @return \libphonenumber\PhoneNumber
+	 */
+	public function getPhoneNumberInstance()
+	{
+		return $this->lib->parse($this->number, $this->getCountry());
+	}
+
+	/**
+	 * Determine whether the phone number seems to be in international format.
+	 *
+	 * @return bool
+	 */
+	protected function numberLooksInternational()
+	{
+		return Str::startsWith($this->number, '+');
+	}
+
+	/**
+	 * Enable lenient number parsing.
+	 *
+	 * @return $this
+	 */
+	public function lenient()
+	{
+		$this->lenient = true;
+
+		return $this;
+	}
+
+	/**
+	 * Convert the phone instance to JSON.
+	 *
+	 * @param  int $options
+	 * @return string
+	 */
+	public function toJson($options = 0)
+	{
+		return json_encode($this->jsonSerialize(), $options);
+	}
+
+	/**
+	 * Convert the phone instance into something JSON serializable.
+	 *
+	 * @return string
+	 */
+	public function jsonSerialize()
+	{
+		return $this->formatE164();
+	}
+
+	/**
+	 * Convert the phone instance into a string representation.
+	 *
+	 * @return string
+	 */
+	public function serialize()
+	{
+		return $this->formatE164();
+	}
+
+	/**
+	 * Reconstructs the phone instance from a string representation.
+	 *
+	 * @param string $serialized
+	 */
+	public function unserialize($serialized)
+	{
+		$this->lib = PhoneNumberUtil::getInstance();
+		$this->number = $serialized;
+		$this->country = $this->lib->getRegionCodeForNumber($this->getPhoneNumberInstance());
+	}
+
+	/**
+	 * Convert the phone instance to a formatted number.
+	 *
+	 * @return string
+	 */
+	public function __toString()
+	{
+		// Formatting the phone number could throw an exception, but __toString() doesn't cope well with that.
+		// Let's just return the original number in that case.
+		try {
+			return $this->formatE164();
+		} catch (Exception $exception) {
+			return $this->number;
+		}
+	}
 }
\ No newline at end of file

Spacing +4 added lines, -4 removed lines

@@ -168,7 +168,7 @@ 
      */
     public function formatForCountry($country)
     {
-        if (! static::isValidCountryCode($country)) {
+        if (!static::isValidCountryCode($country)) {
             throw CountryCodeException::invalid($country);
         }
 
@@ -188,7 +188,7 @@ 
      */
     public function formatForMobileDialingInCountry($country, $removeFormatting = false)
     {
-        if (! static::isValidCountryCode($country)) {
+        if (!static::isValidCountryCode($country)) {
             throw CountryCodeException::invalid($country);
         }
 
@@ -206,7 +206,7 @@ 
      */
     public function getCountry()
     {
-        if (! $this->country) {
+        if (!$this->country) {
             $this->country = $this->filterValidCountry($this->countries);
         }
 
@@ -223,7 +223,7 @@ 
     protected function filterValidCountry($countries)
     {
         $result = Collection::make($countries)
-                            ->filter(function ($country) {
+                            ->filter(function($country) {
                                 $instance = $this->lib->parse($this->number, $country);
 
                                 return $this->lenient

src/Rules/Phone.php

Indentation +152 added lines, -152 removed lines

@@ -6,156 +6,156 @@
 
 class Phone
 {
-    use ParsesCountries,
-        ParsesTypes;
-
-    /**
-     * The provided phone countries.
-     *
-     * @var array
-     */
-    protected $allowedCountries = [];
-
-    /**
-     * The input field name to check for a country value.
-     *
-     * @var string
-     */
-    protected $countryField;
-
-    /**
-     * The provided phone types.
-     *
-     * @var array
-     */
-    protected $allowedTypes = [];
-
-    /**
-     * Whether the number's country should be auto-detected.
-     *
-     * @var bool
-     */
-    protected $detect = false;
-
-    /**
-     * Whether to allow lenient checks (i.e. landline numbers without area codes).
-     *
-     * @var bool
-     */
-    protected $lenient = false;
-
-    /**
-     * Set the phone countries.
-     *
-     * @param string|array $country
-     * @return $this
-     */
-    public function country($country)
-    {
-        $countries = is_array($country) ? $country : func_get_args();
-
-        $this->allowedCountries = array_merge(
-            $this->allowedCountries,
-            static::parseCountries($countries)
-        );
-
-        return $this;
-    }
-
-    /**
-     * Set the country input field.
-     *
-     * @param string $name
-     * @return $this
-     */
-    public function countryField($name)
-    {
-        $this->countryField = $name;
-
-        return $this;
-    }
-
-    /**
-     * Set the phone types.
-     *
-     * @param string|array $type
-     * @return $this
-     */
-    public function type($type)
-    {
-        $types = is_array($type) ? $type : func_get_args();
-
-        $this->allowedTypes = array_merge(
-            $this->allowedTypes,
-            static::parseTypesAsStrings($types)
-        );
-
-        return $this;
-    }
-
-    /**
-     * Shortcut method for mobile type restriction.
-     *
-     * @return $this
-     */
-    public function mobile()
-    {
-        $this->type(PhoneNumberType::MOBILE);
-
-        return $this;
-    }
-
-    /**
-     * Shortcut method for fixed line type restriction.
-     *
-     * @return $this
-     */
-    public function fixedLine()
-    {
-        $this->type(PhoneNumberType::FIXED_LINE);
-
-        return $this;
-    }
-
-    /**
-     * Enable automatic country detection.
-     *
-     * @return $this
-     */
-    public function detect()
-    {
-        $this->detect = true;
-
-        return $this;
-    }
-
-    /**
-     * Enable lenient number checking.
-     *
-     * @return $this
-     */
-    public function lenient()
-    {
-        $this->lenient = true;
-
-        return $this;
-    }
-
-    /**
-     * Convert the rule to a validation string.
-     *
-     * @return string
-     */
-    public function __toString()
-    {
-        $parameters = implode(',', array_merge(
-            $this->allowedCountries,
-            $this->allowedTypes,
-            ($this->countryField ? [$this->countryField]: []),
-            ($this->detect ? ['AUTO'] : []),
-            ($this->lenient ? ['LENIENT'] : [])
-        ));
-
-        return 'phone' . (! empty($parameters) ? ":$parameters" : '');
-    }
+	use ParsesCountries,
+		ParsesTypes;
+
+	/**
+	 * The provided phone countries.
+	 *
+	 * @var array
+	 */
+	protected $allowedCountries = [];
+
+	/**
+	 * The input field name to check for a country value.
+	 *
+	 * @var string
+	 */
+	protected $countryField;
+
+	/**
+	 * The provided phone types.
+	 *
+	 * @var array
+	 */
+	protected $allowedTypes = [];
+
+	/**
+	 * Whether the number's country should be auto-detected.
+	 *
+	 * @var bool
+	 */
+	protected $detect = false;
+
+	/**
+	 * Whether to allow lenient checks (i.e. landline numbers without area codes).
+	 *
+	 * @var bool
+	 */
+	protected $lenient = false;
+
+	/**
+	 * Set the phone countries.
+	 *
+	 * @param string|array $country
+	 * @return $this
+	 */
+	public function country($country)
+	{
+		$countries = is_array($country) ? $country : func_get_args();
+
+		$this->allowedCountries = array_merge(
+			$this->allowedCountries,
+			static::parseCountries($countries)
+		);
+
+		return $this;
+	}
+
+	/**
+	 * Set the country input field.
+	 *
+	 * @param string $name
+	 * @return $this
+	 */
+	public function countryField($name)
+	{
+		$this->countryField = $name;
+
+		return $this;
+	}
+
+	/**
+	 * Set the phone types.
+	 *
+	 * @param string|array $type
+	 * @return $this
+	 */
+	public function type($type)
+	{
+		$types = is_array($type) ? $type : func_get_args();
+
+		$this->allowedTypes = array_merge(
+			$this->allowedTypes,
+			static::parseTypesAsStrings($types)
+		);
+
+		return $this;
+	}
+
+	/**
+	 * Shortcut method for mobile type restriction.
+	 *
+	 * @return $this
+	 */
+	public function mobile()
+	{
+		$this->type(PhoneNumberType::MOBILE);
+
+		return $this;
+	}
+
+	/**
+	 * Shortcut method for fixed line type restriction.
+	 *
+	 * @return $this
+	 */
+	public function fixedLine()
+	{
+		$this->type(PhoneNumberType::FIXED_LINE);
+
+		return $this;
+	}
+
+	/**
+	 * Enable automatic country detection.
+	 *
+	 * @return $this
+	 */
+	public function detect()
+	{
+		$this->detect = true;
+
+		return $this;
+	}
+
+	/**
+	 * Enable lenient number checking.
+	 *
+	 * @return $this
+	 */
+	public function lenient()
+	{
+		$this->lenient = true;
+
+		return $this;
+	}
+
+	/**
+	 * Convert the rule to a validation string.
+	 *
+	 * @return string
+	 */
+	public function __toString()
+	{
+		$parameters = implode(',', array_merge(
+			$this->allowedCountries,
+			$this->allowedTypes,
+			($this->countryField ? [$this->countryField]: []),
+			($this->detect ? ['AUTO'] : []),
+			($this->lenient ? ['LENIENT'] : [])
+		));
+
+		return 'phone' . (! empty($parameters) ? ":$parameters" : '');
+	}
 }
\ No newline at end of file

Spacing +2 added lines, -2 removed lines

@@ -151,11 +151,11 @@
         $parameters = implode(',', array_merge(
             $this->allowedCountries,
             $this->allowedTypes,
-            ($this->countryField ? [$this->countryField]: []),
+            ($this->countryField ? [$this->countryField] : []),
             ($this->detect ? ['AUTO'] : []),
             ($this->lenient ? ['LENIENT'] : [])
         ));
 
-        return 'phone' . (! empty($parameters) ? ":$parameters" : '');
+        return 'phone'.(!empty($parameters) ? ":$parameters" : '');
     }
 }
\ No newline at end of file