Color
extends Color
in package
Table of Contents
- $allColorNames : mixed
- $generator : Generator
- $safeColorNames : mixed
- $unique : UniqueGenerator
- __construct() : mixed
- asciify() : string
- Replaces * signs with random numbers and letters and special characters
- bothify() : string
- Replaces hash signs ('#') and question marks ('?') with random numbers and letters An asterisk ('*') is replaced with either a random number or a random letter
- colorName() : string
- hexColor() : string
- hslColor() : string
- hslColorAsArray() : array<string|int, mixed>
- lexify() : string
- Replaces all question mark ('?') occurrences with a random letter
- numberBetween() : int
- Returns a random number between $int1 and $int2 (any order)
- numerify() : string
- Replaces all hash sign ('#') occurrences with a random number Replaces all percentage sign ('%') occurrences with a not null number
- optional() : mixed|null
- Chainable method for making any formatter optional.
- passthrough() : mixed
- Returns the passed value
- randomAscii() : string
- Returns a random ASCII character (excluding accents and special chars)
- randomDigit() : int
- Returns a random number between 0 and 9
- randomDigitNot() : int
- Generates a random digit, which cannot be $except
- randomDigitNotNull() : int
- Returns a random number between 1 and 9
- randomElement() : mixed
- Returns a random element from a passed array
- randomElements() : array<string|int, mixed>
- Returns randomly ordered subsequence of $count elements from a provided array
- randomFloat() : float
- Return a random float number
- randomKey() : int|string|null
- Returns a random key from a passed associative array
- randomLetter() : string
- Returns a random letter from a to z
- randomNumber() : int
- Returns a random integer with 0 to $nbDigits digits.
- regexify() : string
- Transforms a basic regular expression into a random string satisfying the expression.
- rgbaCssColor() : string
- rgbColor() : string
- rgbColorAsArray() : array<string|int, mixed>
- rgbCssColor() : string
- safeColorName() : string
- safeHexColor() : string
- shuffle() : array<string|int, mixed>|string
- Returns a shuffled version of the argument.
- shuffleArray() : array<string|int, mixed>
- Returns a shuffled version of the array.
- shuffleString() : string
- Returns a shuffled version of the string.
- toLower() : string
- Converts string to lowercase.
- toUpper() : string
- Converts string to uppercase.
- unique() : UniqueGenerator
- Chainable method for making any formatter unique.
- valid() : ValidGenerator
- Chainable method for forcing any formatter to return only valid values.
- replaceWildcard() : mixed
Properties
$allColorNames
protected
static mixed
$allColorNames
= ['黑色', '昏灰', '灰色', '暗灰', '銀色', '亮灰色', '庚斯博羅灰', '白煙色', '白色', '雪色', '鐵灰色', '沙棕', '玫瑰褐', '亮珊瑚色', '印度紅', '褐色', '耐火磚紅', '栗色', '暗紅', '鮮紅', '紅色', '柿子橙', '霧玫瑰色', '鮭紅', '腥紅', '蕃茄紅', '暗鮭紅', '珊瑚紅', '橙紅', '亮鮭紅', '朱紅', '赭黃', '熱帶橙', '駝色', '杏黃', '椰褐', '海貝色', '鞍褐', '巧克力色', '燃橙', '陽橙', '粉撲桃色', '沙褐', '古銅色', '亞麻色', '蜜橙', '秘魯色', '烏賊墨色', '赭色', '陶坯黃', '橘色', '暗橙', '古董白', '日曬色', '硬木色', '杏仁白', '那瓦霍白', '萬壽菊黃', '蕃木瓜色', '灰土色', '卡其色', '鹿皮鞋色', '舊蕾絲色', '小麥色', '桃色', '橙色', '花卉白', '金菊色', '暗金菊色', '咖啡色', '茉莉黃', '琥珀色', '玉米絲色', '鉻黃', '金色', '檸檬綢色', '亮卡其色', '灰金菊色', '暗卡其色', '含羞草黃', '奶油色', '象牙色', '米黃色', '亮黃', '亮金菊黃', '香檳黃', '芥末黃', '月黃', '橄欖色', '鮮黃', '黃色', '苔蘚綠', '亮檸檬綠', '橄欖軍服綠', '黃綠', '暗橄欖綠', '蘋果綠', '綠黃', '草綠', '草坪綠', '查特酒綠', '葉綠', '嫩綠', '明綠', '鈷綠', '蜜瓜綠', '暗海綠', '亮綠', '灰綠', '常春藤綠', '森林綠', '檸檬綠', '暗綠', '綠色', '鮮綠色', '孔雀石綠', '薄荷綠', '青瓷綠', '碧綠', '綠松石綠', '鉻綠', '蒼色', '海綠', '中海綠', '薄荷奶油色', '春綠', '孔雀綠', '中春綠色', '中碧藍色', '碧藍色', '青藍', '水藍', '綠松石藍', '綠松石色', '亮海綠', '中綠松石色', '亮青', '淺藍', '灰綠松石色', '暗岩灰', '鳧綠', '暗青', '青色', '水色', '暗綠松石色', '軍服藍', '孔雀藍', '嬰兒粉藍', '濃藍', '亮藍', '灰藍', '薩克斯藍', '深天藍', '天藍', '亮天藍', '水手藍', '普魯士藍', '鋼青色', '愛麗絲藍', '岩灰', '亮岩灰', '道奇藍', '礦藍', '湛藍', '韋奇伍德瓷藍', '亮鋼藍', '鈷藍', '灰丁寧藍', '矢車菊藍', '鼠尾草藍', '暗嬰兒粉藍', '藍寶石色', '國際奇連藍', '蔚藍', '品藍', '暗礦藍', '極濃海藍', '天青石藍', '幽靈白', '薰衣草紫', '長春花色', '午夜藍', '藏青', '暗藍', '中藍', '藍色', '紫藤色', '暗岩藍', '岩藍', '中岩藍', '木槿紫', '紫丁香色', '中紫紅', '紫水晶色', '淺灰紫紅', '纈草紫', '礦紫', '藍紫', '紫羅蘭色', '靛色', '暗蘭紫', '暗紫', '三色堇紫', '錦葵紫', '優品紫紅', '中蘭紫', '淡紫丁香色', '薊紫', '鐵線蓮紫', '梅紅色', '亮紫', '紫色', '暗洋紅', '洋紅', '品紅', '蘭紫', '淺珍珠紅', '陳玫紅', '淺玫瑰紅', '中青紫紅', '洋玫瑰紅', '玫瑰紅', '紅寶石色', '山茶紅', '深粉紅', '火鶴紅', '淺珊瑚紅', '暖粉紅', '勃艮第酒紅', '尖晶石紅', '胭脂紅', '淺粉紅', '樞機紅', '薰衣草紫紅', '灰紫紅', '櫻桃紅', '淺鮭紅', '緋紅', '粉紅', '亮粉紅', '殼黃紅', '茜紅']
$generator
protected
Generator
$generator
$safeColorNames
protected
static mixed
$safeColorNames
= ['黑色', '粟色', '綠色', '藏青', '橄欖色', '紫', '鳧綠', '鮮綠色', '藍色', '銀色', '灰色', '黃色', '品紅', '水色', '白色']
Tags
$unique
protected
UniqueGenerator
$unique
Methods
__construct()
public
__construct(Generator $generator) : mixed
Parameters
- $generator : Generator
Return values
mixed —asciify()
Replaces * signs with random numbers and letters and special characters
public
static asciify([string $string = '****' ]) : string
Parameters
- $string : string = '****'
-
String that needs to bet parsed
Tags
Return values
string —bothify()
Replaces hash signs ('#') and question marks ('?') with random numbers and letters An asterisk ('*') is replaced with either a random number or a random letter
public
static bothify([string $string = '## ??' ]) : string
Parameters
- $string : string = '## ??'
-
String that needs to bet parsed
Return values
string —colorName()
public
static colorName() : string
Tags
Return values
string —hexColor()
public
static hexColor() : string
Tags
Return values
string —hslColor()
public
static hslColor() : string
Tags
Return values
string —hslColorAsArray()
public
static hslColorAsArray() : array<string|int, mixed>
Tags
Return values
array<string|int, mixed> —lexify()
Replaces all question mark ('?') occurrences with a random letter
public
static lexify([string $string = '????' ]) : string
Parameters
- $string : string = '????'
-
String that needs to bet parsed
Return values
string —numberBetween()
Returns a random number between $int1 and $int2 (any order)
public
static numberBetween(int $int1[, int $int2 = 2147483647 ]) : int
Parameters
- $int1 : int
-
default to 0
- $int2 : int = 2147483647
-
defaults to 32 bit max integer, ie 2147483647
Tags
Return values
int —numerify()
Replaces all hash sign ('#') occurrences with a random number Replaces all percentage sign ('%') occurrences with a not null number
public
static numerify([string $string = '###' ]) : string
Parameters
- $string : string = '###'
-
String that needs to bet parsed
Return values
string —optional()
Chainable method for making any formatter optional.
public
optional([float|int $weight = 0.5 ][, mixed $default = null ]) : mixed|null
Parameters
- $weight : float|int = 0.5
-
Set the probability of receiving a null value. "0" will always return null, "1" will always return the generator. If $weight is an integer value, then the same system works between 0 (always get false) and 100 (always get true).
- $default : mixed = null
Return values
mixed|null —passthrough()
Returns the passed value
public
static passthrough(mixed $value) : mixed
Parameters
- $value : mixed
Return values
mixed —randomAscii()
Returns a random ASCII character (excluding accents and special chars)
public
static randomAscii() : string
Return values
string —randomDigit()
Returns a random number between 0 and 9
public
static randomDigit() : int
Return values
int —randomDigitNot()
Generates a random digit, which cannot be $except
public
static randomDigitNot(int $except) : int
Parameters
- $except : int
Return values
int —randomDigitNotNull()
Returns a random number between 1 and 9
public
static randomDigitNotNull() : int
Return values
int —randomElement()
Returns a random element from a passed array
public
static randomElement([array<string|int, mixed> $array = ['a', 'b', 'c'] ]) : mixed
Parameters
- $array : array<string|int, mixed> = ['a', 'b', 'c']
Return values
mixed —randomElements()
Returns randomly ordered subsequence of $count elements from a provided array
public
static randomElements([array<string|int, mixed> $array = ['a', 'b', 'c'] ][, int $count = 1 ][, bool $allowDuplicates = false ]) : array<string|int, mixed>
Parameters
- $array : array<string|int, mixed> = ['a', 'b', 'c']
-
Array to take elements from. Defaults to a-c
- $count : int = 1
-
Number of elements to take.
- $allowDuplicates : bool = false
-
Allow elements to be picked several times. Defaults to false
Tags
Return values
array<string|int, mixed> —New array with $count elements from $array
randomFloat()
Return a random float number
public
static randomFloat([int $nbMaxDecimals = null ], float|int $min[, float|int $max = null ]) : float
Parameters
- $nbMaxDecimals : int = null
- $min : float|int
- $max : float|int = null
Tags
Return values
float —randomKey()
Returns a random key from a passed associative array
public
static randomKey([array<string|int, mixed> $array = [] ]) : int|string|null
Parameters
- $array : array<string|int, mixed> = []
Return values
int|string|null —randomLetter()
Returns a random letter from a to z
public
static randomLetter() : string
Return values
string —randomNumber()
Returns a random integer with 0 to $nbDigits digits.
public
static randomNumber([int $nbDigits = null ][, bool $strict = false ]) : int
The maximum value returned is mt_getrandmax()
Parameters
- $nbDigits : int = null
-
Defaults to a random number between 1 and 9
- $strict : bool = false
-
Whether the returned number should have exactly $nbDigits
Tags
Return values
int —regexify()
Transforms a basic regular expression into a random string satisfying the expression.
public
static regexify([string $regex = '' ]) : string
Parameters
- $regex : string = ''
-
A regular expression (delimiters are optional)
Tags
Return values
string —rgbaCssColor()
public
static rgbaCssColor() : string
Tags
Return values
string —rgbColor()
public
static rgbColor() : string
Tags
Return values
string —rgbColorAsArray()
public
static rgbColorAsArray() : array<string|int, mixed>
Tags
Return values
array<string|int, mixed> —rgbCssColor()
public
static rgbCssColor() : string
Tags
Return values
string —safeColorName()
public
static safeColorName() : string
Tags
Return values
string —safeHexColor()
public
static safeHexColor() : string
Tags
Return values
string —shuffle()
Returns a shuffled version of the argument.
public
static shuffle([array<string|int, mixed>|string $arg = '' ]) : array<string|int, mixed>|string
This function accepts either an array, or a string.
Parameters
- $arg : array<string|int, mixed>|string = ''
-
The set to shuffle
Tags
Return values
array<string|int, mixed>|string —The shuffled set
shuffleArray()
Returns a shuffled version of the array.
public
static shuffleArray([array<string|int, mixed> $array = [] ]) : array<string|int, mixed>
This function does not mutate the original array. It uses the Fisher–Yates algorithm, which is unbiased, together with a Mersenne twister random generator. This function is therefore more random than PHP's shuffle() function, and it is seedable.
Parameters
- $array : array<string|int, mixed> = []
-
The set to shuffle
Tags
Return values
array<string|int, mixed> —The shuffled set
shuffleString()
Returns a shuffled version of the string.
public
static shuffleString([string $string = '' ][, string $encoding = 'UTF-8' ]) : string
This function does not mutate the original string. It uses the Fisher–Yates algorithm, which is unbiased, together with a Mersenne twister random generator. This function is therefore more random than PHP's shuffle() function, and it is seedable. Additionally, it is UTF8 safe if the mb extension is available.
Parameters
- $string : string = ''
-
The set to shuffle
- $encoding : string = 'UTF-8'
-
The string encoding (defaults to UTF-8)
Tags
Return values
string —The shuffled set
toLower()
Converts string to lowercase.
public
static toLower([string $string = '' ]) : string
Uses mb_string extension if available.
Parameters
- $string : string = ''
-
String that should be converted to lowercase
Return values
string —toUpper()
Converts string to uppercase.
public
static toUpper([string $string = '' ]) : string
Uses mb_string extension if available.
Parameters
- $string : string = ''
-
String that should be converted to uppercase
Return values
string —unique()
Chainable method for making any formatter unique.
public
unique([bool $reset = false ][, int $maxRetries = 10000 ]) : UniqueGenerator
// will never return twice the same value
$faker->unique()->randomElement(array(1, 2, 3));
Parameters
- $reset : bool = false
-
If set to true, resets the list of existing values
- $maxRetries : int = 10000
-
Maximum number of retries to find a unique value, After which an OverflowException is thrown.
Tags
Return values
UniqueGenerator —A proxy class returning only non-existing values
valid()
Chainable method for forcing any formatter to return only valid values.
public
valid([Closure $validator = null ][, int $maxRetries = 10000 ]) : ValidGenerator
The value validity is determined by a function passed as first argument.
$values = array();
$evenValidator = function ($digit) {
return $digit % 2 === 0;
};
for ($i=0; $i < 10; $i++) {
$values []= $faker->valid($evenValidator)->randomDigit;
}
print_r($values); // [0, 4, 8, 4, 2, 6, 0, 8, 8, 6]
Parameters
- $validator : Closure = null
-
A function returning true for valid values
- $maxRetries : int = 10000
-
Maximum number of retries to find a unique value, After which an OverflowException is thrown.
Tags
Return values
ValidGenerator —A proxy class returning only valid values
replaceWildcard()
private
static replaceWildcard(mixed $string[, mixed $wildcard = '#' ][, mixed $callback = 'static::randomDigit' ]) : mixed
Parameters
- $string : mixed
- $wildcard : mixed = '#'
- $callback : mixed = 'static::randomDigit'