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/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/Traits/ParsesTypes.php

Indentation +63 added lines, -63 removed lines

@@ -7,74 +7,74 @@
 
 trait ParsesTypes
 {
-    /**
-     * Array of available phone types.
-     *
-     * @var array
-     */
-    protected static $types;
+	/**
+	 * Array of available phone types.
+	 *
+	 * @var array
+	 */
+	protected static $types;
 
-    /**
-     * Determine whether the given type is valid.
-     *
-     * @param string $type
-     * @return bool
-     */
-    public static function isValidType($type)
-    {
-        return ! empty(static::parseTypes($type));
-    }
+	/**
+	 * Determine whether the given type is valid.
+	 *
+	 * @param string $type
+	 * @return bool
+	 */
+	public static function isValidType($type)
+	{
+		return ! empty(static::parseTypes($type));
+	}
 
-    /**
-     * Parse a phone type into constant's value.
-     *
-     * @param string|array $types
-     * @return array
-     */
-    protected static function parseTypes($types)
-    {
-        static::loadTypes();
+	/**
+	 * Parse a phone type into constant's value.
+	 *
+	 * @param string|array $types
+	 * @return array
+	 */
+	protected static function parseTypes($types)
+	{
+		static::loadTypes();
 
-        return Collection::make(is_array($types) ? $types : func_get_args())
-                         ->map(function ($type) {
-                             // If the type equals a constant's value, just return it.
-                             if (in_array($type, static::$types, true)) {
-                                 return $type;
-                             }
+		return Collection::make(is_array($types) ? $types : func_get_args())
+						 ->map(function ($type) {
+							 // If the type equals a constant's value, just return it.
+							 if (in_array($type, static::$types, true)) {
+								 return $type;
+							 }
 
-                             // Otherwise we'll assume the type is the constant's name.
-                             return Arr::get(static::$types, strtoupper($type));
-                         })
-                         ->reject(function ($value) {
-                             return is_null($value) || $value === false;
-                         })->toArray();
-    }
+							 // Otherwise we'll assume the type is the constant's name.
+							 return Arr::get(static::$types, strtoupper($type));
+						 })
+						 ->reject(function ($value) {
+							 return is_null($value) || $value === false;
+						 })->toArray();
+	}
 
-    /**
-     * Parse a phone type into its string representation.
-     *
-     * @param string|array $types
-     * @return array
-     */
-    protected static function parseTypesAsStrings($types)
-    {
-        static::loadTypes();
+	/**
+	 * Parse a phone type into its string representation.
+	 *
+	 * @param string|array $types
+	 * @return array
+	 */
+	protected static function parseTypesAsStrings($types)
+	{
+		static::loadTypes();
 
-        return array_keys(
-            array_intersect(
-                static::$types,
-                static::parseTypes($types)
-            )
-        );
-    }
+		return array_keys(
+			array_intersect(
+				static::$types,
+				static::parseTypes($types)
+			)
+		);
+	}
 
-    /**
-     * Load all available formats once.
-     */
-    private static function loadTypes()
-    {
-        if (! static::$types) {
-            static::$types = with(new ReflectionClass(PhoneNumberType::class))->getConstants();
-        }
-    }
+	/**
+	 * Load all available formats once.
+	 */
+	private static function loadTypes()
+	{
+		if (! static::$types) {
+			static::$types = with(new ReflectionClass(PhoneNumberType::class))->getConstants();
+		}
+	}
 }
\ No newline at end of file

Spacing +4 added lines, -4 removed lines

@@ -22,7 +22,7 @@ 
      */
     public static function isValidType($type)
     {
-        return ! empty(static::parseTypes($type));
+        return !empty(static::parseTypes($type));
     }
 
     /**
@@ -36,7 +36,7 @@ 
         static::loadTypes();
 
         return Collection::make(is_array($types) ? $types : func_get_args())
-                         ->map(function ($type) {
+                         ->map(function($type) {
                              // If the type equals a constant's value, just return it.
                              if (in_array($type, static::$types, true)) {
                                  return $type;
@@ -45,7 +45,7 @@ 
                              // Otherwise we'll assume the type is the constant's name.
                              return Arr::get(static::$types, strtoupper($type));
                          })
-                         ->reject(function ($value) {
+                         ->reject(function($value) {
                              return is_null($value) || $value === false;
                          })->toArray();
     }
@@ -73,7 +73,7 @@ 
      */
     private static function loadTypes()
     {
-        if (! static::$types) {
+        if (!static::$types) {
             static::$types = with(new ReflectionClass(PhoneNumberType::class))->getConstants();
         }
     }