Merge pull request #1493 from browner12/patch-1

create `passthrough` function

Author: fzaninotto

readme.md

@@ -371,6 +371,12 @@ try {
 }
 ```
 
+If you would like to use a modifier with a value not generated by Faker, use the `passthrough()` method. `passthrough()` simply returns whatever value it was given.
+
+```php
+$faker->optional()->passthrough(mt_rand(5, 15));
+```
+
 ## Localization
 
 `Faker\Factory` can take a locale as an argument, to return localized data. If no localized provider is found, the factory fallbacks to the default locale (en_US).

src/Faker/Provider/Base.php

@@ -139,6 +139,18 @@ public static function numberBetween($int1 = 0, $int2 = 2147483647)
         $max = $int1 < $int2 ? $int2 : $int1;
         return mt_rand($min, $max);
     }
+    
+    /**
+     * Returns the passed value
+     *
+     * @param mixed $value
+     *
+     * @return mixed
+     */
+    public static function passthrough($value)
+    {
+        return $value;
+    }
 
     /**
      * Returns a random letter from a to z