Generate valid individual identification numbers kk_KZ

readme.md

@@ -1122,6 +1122,9 @@ echo $faker->bankAccountNumber; // "KZ1076321LO4H6X41I37"
 
 // Generates an individual identification number
 echo $faker->individualIdentificationNumber; // "780322300455"
+
+// Generates an individual identification number based on his/her birth date
+echo $faker->individualIdentificationNumber(new \DateTime('1999-03-01')); // "990301300455"
 ```
 
 ### `Faker\Provider\ko_KR\Address`

src/Faker/Provider/kk_KZ/Person.php

@@ -2,9 +2,52 @@
 
 namespace Faker\Provider\kk_KZ;
 
+use \Faker\Provider\DateTime;
+
 class Person extends \Faker\Provider\Person
 {
 
+    const GENDER_MALE = 0;
+    const GENDER_FEMALE = 1;
+
+    const CENTURY_19TH = 0;
+    const CENTURY_20TH = 1;
+    const CENTURY_21ST = 2;
+
+    const MALE_CENTURY_19TH = 1;
+    const MALE_CENTURY_20TH = 3;
+    const MALE_CENTURY_21ST = 5;
+
+    const FEMALE_CENTURY_19TH = 2;
+    const FEMALE_CENTURY_20TH = 4;
+    const FEMALE_CENTURY_21ST = 6;
+
+    /**
+     * @var array
+     */
+    public static $firstSequenceBitWeights = array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11);
+
+    /**
+     * @var array
+     */
+    public static $secondSequenceBitWeights = array(3, 4, 5, 6, 7, 8, 9, 10, 11, 1, 2);
+
+    /**
+     * @var array
+     */
+    public static $genderCenturyMap = array(
+        self::GENDER_MALE   => array(
+            self::CENTURY_19TH => self::MALE_CENTURY_19TH,
+            self::CENTURY_20TH => self::MALE_CENTURY_20TH,
+            self::CENTURY_21ST => self::MALE_CENTURY_21ST,
+        ),
+        self::GENDER_FEMALE => array(
+            self::CENTURY_19TH => self::FEMALE_CENTURY_19TH,
+            self::CENTURY_20TH => self::FEMALE_CENTURY_20TH,
+            self::CENTURY_21ST => self::FEMALE_CENTURY_21ST,
+        ),
+    );
+
     /**
      * @see https://ru.wikipedia.org/wiki/%D0%9A%D0%B0%D0%B7%D0%B0%D1%85%D1%81%D0%BA%D0%B0%D1%8F_%D1%84%D0%B0%D0%BC%D0%B8%D0%BB%D0%B8%D1%8F
      *
@@ -133,23 +176,81 @@ class Person extends \Faker\Provider\Person
         'Ісмет',
     );
 
+    /**
+     * @param  integer $year
+     *
+     * @return integer|null
+     */
+    private static function getCenturyByYear($year)
+    {
+        if ($year >= 2000 && $year <= DateTime::year()) {
+            return self::CENTURY_21ST;
+        } elseif ($year >= 1900) {
+            return self::CENTURY_20TH;
+        } elseif ($year >= 1800) {
+            return self::CENTURY_19TH;
+        }
+    }
+
     /**
      * National Individual Identification Numbers
      *
      * @link   http://egov.kz/wps/portal/Content?contentPath=%2Fegovcontent%2Fcitizen_migration%2Fpassport_id_card%2Farticle%2Fiin_info&lang=en
+     * @link   https://ru.wikipedia.org/wiki/%D0%98%D0%BD%D0%B4%D0%B8%D0%B2%D0%B8%D0%B4%D1%83%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D0%B9_%D0%B8%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D1%8B%D0%B9_%D0%BD%D0%BE%D0%BC%D0%B5%D1%80
+     *
      * @param  \DateTime $birthDate
+     * @param  integer   $gender
+     *
      * @return string 12 digits, like 780322300455
      */
-    public static function individualIdentificationNumber(\DateTime $birthDate = null)
+    public static function individualIdentificationNumber(\DateTime $birthDate = null, $gender = self::GENDER_MALE)
     {
         if (!$birthDate) {
-            $birthDate = \Faker\Provider\DateTime::dateTimeBetween();
+            $birthDate = DateTime::dateTimeBetween();
         }
 
-        $dateAsString       = $birthDate->format('ymd');
-        $genderAndCenturyId = (string) static::numberBetween(1, 6);
-        $randomDigits       = (string) static::numerify('#####');
+        $totalPopulation  = mt_rand(1000, 2000);
+        $century          = self::getCenturyByYear((int)$birthDate->format('Y'));
+        $iin              = $birthDate->format('ymd');
+        $calculatedResult = array();
+
+        $iin .= (string)self::$genderCenturyMap[$gender][$century];
+        $iin .= (string)$totalPopulation;
+
+        $controlDigit         = self::checkSum($iin, $calculatedResult);
+        $calculatedResult[11] = $controlDigit;
+
+        return implode('', $calculatedResult);
+    }
+
+    /**
+     * @param  string $iinValue
+     * @param  array  $calculatedResult
+     *
+     * @return integer
+     */
+    public static function checkSum($iinValue, &$calculatedResult = array())
+    {
+        $sum = 0;
+
+        for ($i = 0; $i <= 10; $i++) {
+            $calculatedResult[$i] = (int)substr($iinValue, $i, 1);
+            $sum += $calculatedResult[$i] * Person::$firstSequenceBitWeights[$i];
+        }
+
+        $controlDigit = $sum % 11;
+
+        if ($controlDigit === 10) {
+            $sum = 0;
+
+            for ($i = 0; $i <= 10; $i++) {
+                $calculatedResult[$i] = (int)substr($iinValue, $i, 1);
+                $sum += $calculatedResult[$i] * Person::$secondSequenceBitWeights[$i];
+            }
+
+            $controlDigit = $sum % 11;
+        }
 
-        return $dateAsString . $genderAndCenturyId . $randomDigits;
+        return $controlDigit;
     }
 }

test/Faker/Provider/kk_KZ/PersonTest.php

@@ -2,6 +2,7 @@
 namespace Faker\Test\Provider\kk_KZ;
 
 use Faker\Generator;
+use Faker\Provider\DateTime;
 use Faker\Provider\kk_KZ\Person;
 
 class PersonTest extends \PHPUnit_Framework_TestCase
@@ -19,13 +20,10 @@ public function setUp()
 
     public function testIndividualIdentificationNumberIsValid()
     {
-        $birthDate                      = new \DateTime('now');
+        $birthDate                      = DateTime::dateTimeBetween('-30 years', '-10 years');
         $individualIdentificationNumber = $this->faker->individualIdentificationNumber($birthDate);
-        $birthDateAsString              = $birthDate->format('ymd');
+        $controlDigit                   = Person::checkSum($individualIdentificationNumber);
 
-        $this->assertRegExp(
-            "/^(" . $birthDateAsString . ")([1-6]{1})(\\d{5})$/",
-            $individualIdentificationNumber
-        );
+        $this->assertTrue($controlDigit === (int)substr($individualIdentificationNumber, 11, 1));
     }
 }