Add new methods for generating hashes, tokens, URLs, and addresses; update README and tests

Author: TS

README.md

@@ -31,6 +31,7 @@
 
     $faker->fullname(5, 10); // Sutida Ohisovis
     $faker->firstname(7, 7, Faker::FIRST_VOWEL); // Emubefy
+    $faker->lastname(5, 7); // Zusey
     $faker->email(); // punuw.honiw@ajesug.gax
     $faker->password(4, 4, 3, '.'); // W2gg.lsgq.FET0
     $faker->word(5); // focix
@@ -49,6 +50,16 @@
     $faker->pick(['CEO', 'CTO', 'Founder', 'Director'], 3, ', '); // Director, CEO, CTO
     $faker->date(); // 2001-07-21
     $faker->date('2024-01-01', '2024-12-31', 'Y.m.'); // 2024.02.
+    $faker->hash('sha256'); // random hash
+    $faker->token(32); // api token
+    $faker->url(); // https://example.com/random
+    $faker->domain(); // example.com
+    $faker->city(); // Random City
+    $faker->zipcode(4); // 1234
+    $faker->country(); // Random Country
+    $faker->streetName(); // Random Street Name
+    $faker->street(); // Random Street Name 123
+    $faker->address(); // Random Street Name 123, 1234 Random City, Random Country
 
 ```
 

examples/demo.php

@@ -160,3 +160,55 @@
 $words[] = strtoupper($faker->words(14, '.', 2, 4));
 
 print_r($words);
+
+// New examples for the added methods
+
+$hashes = [];
+$hashes[] = $faker->hash('sha256');
+$hashes[] = $faker->hash('md5');
+print_r($hashes);
+
+$tokens = [];
+$tokens[] = $faker->token(32);
+$tokens[] = $faker->token(64);
+print_r($tokens);
+
+$urls = [];
+$urls[] = $faker->url();
+$urls[] = $faker->url();
+print_r($urls);
+
+$domains = [];
+$domains[] = $faker->domain();
+$domains[] = $faker->domain();
+print_r($domains);
+
+$cities = [];
+$cities[] = $faker->city();
+$cities[] = $faker->city();
+print_r($cities);
+
+$zipcodes = [];
+$zipcodes[] = $faker->zipcode(4);
+$zipcodes[] = $faker->zipcode(6);
+print_r($zipcodes);
+
+$countries = [];
+$countries[] = $faker->country();
+$countries[] = $faker->country();
+print_r($countries);
+
+$streetNames = [];
+$streetNames[] = $faker->streetName();
+$streetNames[] = $faker->streetName();
+print_r($streetNames);
+
+$streets = [];
+$streets[] = $faker->street();
+$streets[] = $faker->street();
+print_r($streets);
+
+$addresses = [];
+$addresses[] = $faker->address();
+$addresses[] = $faker->address();
+print_r($addresses);

src/Faker.php

@@ -490,4 +490,110 @@ public function date($min = null, $max = null, $format = 'Y-m-d')
         $timestamp = random_int(strtotime($min), strtotime($max));
         return date($format, $timestamp);
     }
+
+    /**
+     * hash
+     *
+     * @param string $algorithm
+     *
+     * @return string
+     */
+    public function hash($algorithm = 'sha256')
+    {
+        return hash($algorithm, $this->word(10) . random_int(1000, 9999));
+    }
+
+    /**
+     * token
+     *
+     * @param int $length
+     *
+     * @return string
+     */
+    public function token($length = 32)
+    {
+        return $this->repeat($this->abcLower . $this->abcUpper . $this->numbers, $length, $length);
+    }
+
+    /**
+     * url
+     *
+     * @return string
+     */
+    public function url()
+    {
+        return 'https://' . $this->domain() . '/' . $this->word(5);
+    }
+
+    /**
+     * domain
+     *
+     * @return string
+     */
+    public function domain()
+    {
+        return $this->word(5) . '.' . $this->word(3);
+    }
+
+    /**
+     * city
+     *
+     * @return string
+     */
+    public function city()
+    {
+        return ucfirst($this->word(6));
+    }
+
+    /**
+     * zipcode
+     *
+     * @param int $length
+     *
+     * @return string
+     */
+    public function zipcode($length = 4)
+    {
+        return $this->repeat($this->numbers, $length, $length);
+    }
+
+    /**
+     * country
+     *
+     * @return string
+     */
+    public function country()
+    {
+        return ucfirst($this->word(7));
+    }
+
+    /**
+     * streetName
+     *
+     * @return string
+     */
+    public function streetName()
+    {
+        return ucfirst($this->word(8));
+    }
+
+    /**
+     * street
+     *
+     * @return string
+     */
+    public function street()
+    {
+        return $this->streetName() . ' ' . $this->int(1, 999);
+    }
+
+    /**
+     * address
+     *
+     * @return string
+     */
+    public function address()
+    {
+        return $this->street() . ', ' . $this->zipcode() . ' ' . $this->city() . ', ' . $this->country();
+    }
 }

tests/FakerTest.php

@@ -276,4 +276,74 @@ public function testDates()
         $this->assertSame('1999-12', \substr($dates[1], 0, 7));
         $this->assertSame('2200-04-01 00:00:00', $dates[2]);
     }
+
+    /**
+     * testNewMethods
+     *
+     * @return void
+     */
+    public function testNewMethods()
+    {
+        $faker = Faker::init();
+
+        $hashes = [];
+        $hashes[] = $faker->hash('sha256');
+        $hashes[] = $faker->hash('md5');
+        $this->assertNotEmpty($hashes[0]);
+        $this->assertNotEmpty($hashes[1]);
+
+        $tokens = [];
+        $tokens[] = $faker->token(32);
+        $tokens[] = $faker->token(64);
+        $this->assertEquals(32, strlen($tokens[0]));
+        $this->assertEquals(64, strlen($tokens[1]));
+
+        $urls = [];
+        $urls[] = $faker->url();
+        $urls[] = $faker->url();
+        $this->assertStringStartsWith('https://', $urls[0]);
+        $this->assertStringStartsWith('https://', $urls[1]);
+
+        $domains = [];
+        $domains[] = $faker->domain();
+        $domains[] = $faker->domain();
+        $this->assertStringContainsString('.', $domains[0]);
+        $this->assertStringContainsString('.', $domains[1]);
+
+        $cities = [];
+        $cities[] = $faker->city();
+        $cities[] = $faker->city();
+        $this->assertNotEmpty($cities[0]);
+        $this->assertNotEmpty($cities[1]);
+
+        $zipcodes = [];
+        $zipcodes[] = $faker->zipcode(4);
+        $zipcodes[] = $faker->zipcode(6);
+        $this->assertEquals(4, strlen($zipcodes[0]));
+        $this->assertEquals(6, strlen($zipcodes[1]));
+
+        $countries = [];
+        $countries[] = $faker->country();
+        $countries[] = $faker->country();
+        $this->assertNotEmpty($countries[0]);
+        $this->assertNotEmpty($countries[1]);
+
+        $streetNames = [];
+        $streetNames[] = $faker->streetName();
+        $streetNames[] = $faker->streetName();
+        $this->assertNotEmpty($streetNames[0]);
+        $this->assertNotEmpty($streetNames[1]);
+
+        $streets = [];
+        $streets[] = $faker->street();
+        $streets[] = $faker->street();
+        $this->assertNotEmpty($streets[0]);
+        $this->assertNotEmpty($streets[1]);
+
+        $addresses = [];
+        $addresses[] = $faker->address();
+        $addresses[] = $faker->address();
+        $this->assertNotEmpty($addresses[0]);
+        $this->assertNotEmpty($addresses[1]);
+    }
 }