giggsey / libphonenumber-for-php

build/libphonenumber/buildtools/GeneratePhonePrefixData.php

Doc Comments +7 added lines, -1 removed lines

@@ -157,7 +157,7 @@ 
      * Reads phone prefix data from the provides file path and invokes the given handler for each
      * mapping read.
      *
-     * @param $filePath
+     * @param string $filePath
      * @param $handler
      * @return array
      * @throws \InvalidArgumentException
@@ -204,6 +204,9 @@ 
         return $this->getFilePath($language . DIRECTORY_SEPARATOR . $code . self::DATA_FILE_EXTENSION);
     }
 
+    /**
+     * @param string $fileName
+     */
     private function getFilePath($fileName)
     {
         $path = $this->inputDir . $fileName;
@@ -279,6 +282,9 @@ 
         $this->compressAccordingToEnglishData($this->englishMaps[$countryCode], $mappings);
     }
 
+    /**
+     * @param string $textFile
+     */
     private function getEnglishDataPath($textFile)
     {
         return "en" . DIRECTORY_SEPARATOR . substr($textFile, 3, 2) . self::DATA_FILE_EXTENSION;

src/libphonenumber/geocoding/PhoneNumberOfflineGeocoder.php

Doc Comments +4 added lines, -1 removed lines

@@ -25,6 +25,9 @@ 
      */
     private $prefixFileReader = null;
 
+    /**
+     * @param string $phonePrefixDataDirectory
+     */
     private function __construct($phonePrefixDataDirectory)
     {
         if(!extension_loaded('intl')) {
@@ -104,7 +107,7 @@ 
      * number is from. If it could be from many territories, nothing is returned.
      *
      * @param PhoneNumber $number
-     * @param $locale
+     * @param string $locale
      * @return string
      */
     private function getCountryNameForNumber(PhoneNumber $number, $locale)

src/libphonenumber/PhoneNumberUtil.php

Doc Comments +7 added lines, -3 removed lines

@@ -829,7 +829,7 @@ 
      * This version exists since calculating the phone number type is expensive; if we have already
      * done this, we don't want to do it again.
      *
-     * @param PhoneNumber|int $phoneNumberObjOrType A PhoneNumber object, or a PhoneNumberType integer
+     * @param integer $phoneNumberObjOrType A PhoneNumber object, or a PhoneNumberType integer
      * @param int|null $countryCallingCode Used when passing a PhoneNumberType
      * @return bool
      */
@@ -1781,7 +1781,7 @@ 
      * Normalizes a string of characters representing a phone number. This converts wide-ascii and
      * arabic-indic numerals to European numerals, and strips punctuation and alpha characters.
      *
-     * @param $number string  a string of characters representing a phone number
+     * @param string $number string  a string of characters representing a phone number
      * @return string the normalized string version of the phone number
      */
     public static function normalizeDigitsOnly($number)
@@ -2743,7 +2743,7 @@ 
      *
      * @param PhoneNumber $number the phone number to be formatted
      * @param int $numberFormat the format the phone number should be formatted into
-     * @param array $userDefinedFormats formatting rules specified by clients
+     * @param NumberFormat[] $userDefinedFormats formatting rules specified by clients
      * @return String the formatted phone number
      */
     public function formatByPattern(PhoneNumber $number, $numberFormat, array $userDefinedFormats)
@@ -3136,6 +3136,10 @@ 
         $this->stringEndsWithString($secondNumberNationalNumber, $firstNumberNationalNumber);
     }
 
+    /**
+     * @param string $hayStack
+     * @param string $needle
+     */
     protected function stringEndsWithString($hayStack, $needle)
     {
         $revNeedle = strrev($needle);

src/libphonenumber/prefixmapper/MappingFileProvider.php

Doc Comments +3 added lines

@@ -42,6 +42,9 @@
         return "";
     }
 
+    /**
+     * @param string $countryCallingCode
+     */
     protected function inMap($language, $countryCallingCode)
     {
         return (array_key_exists($language, $this->map) && in_array($countryCallingCode, $this->map[$language]));

build/libphonenumber/buildtools/BuildMetadataFromXml.php

Doc Comments +3 added lines, -4 removed lines

@@ -62,7 +62,7 @@ 
 
     /**
      * @internal
-     * @param $regex
+     * @param string $regex
      * @param bool $removeWhitespace
      * @return string
      */
@@ -129,7 +129,6 @@ 
     /**
      * @param string $regionCode
      * @param \DOMElement $element
-     * @param string $liteBuild
      * @param string $isShortNumberMetadata
      * @param string $isAlternateFormatsMetadata
      * @return PhoneMetadata
@@ -323,7 +322,7 @@ 
      * @internal
      * @param \DOMElement $element
      * @param string $nationalPrefix
-     * @return mixed|string
+     * @return string
      */
     public static function getDomesticCarrierCodeFormattingRuleFromElement(\DOMElement $element, $nationalPrefix)
     {
@@ -796,7 +795,7 @@ 
     }
 
     /**
-     * @param $metadataCollection PhoneMetadata[]
+     * @param PhoneMetadata[] $metadataCollection PhoneMetadata[]
      * @return array
      */
     public static function buildCountryCodeToRegionCodeMap($metadataCollection)