update v1.0.3.3

vendor/giggsey/libphonenumber-for-php/src/libphonenumber/PhoneNumberToCarrierMapper.php

@@ -0,0 +1,135 @@
+<?php
+/**
+ *
+ *
+ * @author giggsey
+ * @created: 02/10/13 16:52
+ * @project libphonenumber-for-php
+ */
+
+namespace libphonenumber;
+
+
+use libphonenumber\prefixmapper\PrefixFileReader;
+
+class PhoneNumberToCarrierMapper
+{
+    /**
+     * @var PhoneNumberToCarrierMapper[]
+     */
+    private static $instance = array();
+
+    const MAPPING_DATA_DIRECTORY = '/carrier/data/';
+
+    /**
+     * @var PhoneNumberUtil
+     */
+    private $phoneUtil;
+    /**
+     * @var PrefixFileReader
+     */
+    private $prefixFileReader;
+
+    private function __construct($phonePrefixDataDirectory)
+    {
+        if(!extension_loaded('intl')) {
+            throw new \RuntimeException('The intl extension must be installed');
+        }
+
+        $this->prefixFileReader = new PrefixFileReader(dirname(__FILE__) . $phonePrefixDataDirectory);
+        $this->phoneUtil = PhoneNumberUtil::getInstance();
+    }
+
+    /**
+     * Gets a {@link PhoneNumberToCarrierMapper} instance to carry out international carrier lookup.
+     *
+     * <p> The {@link PhoneNumberToCarrierMapper} is implemented as a singleton. Therefore, calling
+     * this method multiple times will only result in one instance being created.
+     *
+     * @param string $mappingDir
+     * @return PhoneNumberToCarrierMapper
+     */
+    public static function getInstance($mappingDir = self::MAPPING_DATA_DIRECTORY)
+    {
+        if (!array_key_exists($mappingDir, self::$instance)) {
+            self::$instance[$mappingDir] = new self($mappingDir);
+        }
+
+        return self::$instance[$mappingDir];
+    }
+
+    /**
+     * Returns a carrier name for the given phone number, in the language provided. The carrier name
+     * is the one the number was originally allocated to, however if the country supports mobile
+     * number portability the number might not belong to the returned carrier anymore. If no mapping
+     * is found an empty string is returned.
+     *
+     * <p>This method assumes the validity of the number passed in has already been checked, and that
+     * the number is suitable for carrier lookup. We consider mobile and pager numbers possible
+     * candidates for carrier lookup.
+     *
+     * @param PhoneNumber $number a valid phone number for which we want to get a carrier name
+     * @param string $languageCode the language code in which the name should be written
+     * @return string a carrier name for the given phone number
+     */
+    public function getNameForValidNumber(PhoneNumber $number, $languageCode)
+    {
+        $languageStr = \Locale::getPrimaryLanguage($languageCode);
+        $scriptStr = "";
+        $regionStr = \Locale::getRegion($languageCode);
+
+        return $this->prefixFileReader->getDescriptionForNumber($number, $languageStr, $scriptStr, $regionStr);
+    }
+
+
+    /**
+     * Gets the name of the carrier for the given phone number, in the language provided. As per
+     * {@link #getNameForValidNumber(PhoneNumber, Locale)} but explicitly checks the validity of
+     * the number passed in.
+     *
+     * @param PhoneNumber $number The phone number  for which we want to get a carrier name
+     * @param string $languageCode Language code for which the description should be written
+     * @return string a carrier name for the given phone number, or empty string if the number passed in is
+     *     invalid
+     */
+    public function getNameForNumber(PhoneNumber $number, $languageCode)
+    {
+        $numberType = $this->phoneUtil->getNumberType($number);
+        if ($this->isMobile($numberType)) {
+            return $this->getNameForValidNumber($number, $languageCode);
+        }
+        return "";
+    }
+
+    /**
+     * Gets the name of the carrier for the given phone number only when it is 'safe' to display to
+     * users. A carrier name is considered safe if the number is valid and for a region that doesn't
+     * support
+     * {@linkplain http://en.wikipedia.org/wiki/Mobile_number_portability mobile number portability}.
+     *
+     * @param $number PhoneNumber the phone number for which we want to get a carrier name
+     * @param $languageCode String the language code in which the name should be written
+     * @return string a carrier name that is safe to display to users, or the empty string
+     */
+    public function getSafeDisplayName(PhoneNumber $number, $languageCode)
+    {
+        if ($this->phoneUtil->isMobileNumberPortableRegion($this->phoneUtil->getRegionCodeForNumber($number))) {
+            return "";
+        }
+
+        return $this->getNameForNumber($number, $languageCode);
+    }
+
+    /**
+     * Checks if the supplied number type supports carrier lookup.
+     * @param int $numberType A PhoneNumberType int
+     * @return bool
+     */
+    private function isMobile($numberType)
+    {
+        return ($numberType === PhoneNumberType::MOBILE ||
+            $numberType === PhoneNumberType::FIXED_LINE_OR_MOBILE ||
+            $numberType === PhoneNumberType::PAGER
+        );
+    }
+}