Laravel 中 faker 的方法總結

安裝

composer require fzaninotto/faker

可透過在 config/app.php 增加如下配置使其支援中文：

'faker_locale' => 'zh_CN',

基本用法

• Faker\Provider\Base 基本

  $randomDigit = $faker->randomDigit;//生成0-9之間的隨機數
  $randomDigitNotNull = $faker->randomDigitNotNull;//生成1-9之間的隨機數
  $randomNumber = $faker->randomNumber(5, true);//生成5位整數，true表示嚴格模式，即只能5位
  $randomFloat = $faker->randomFloat(2, 0, 10);//生成浮點數，兩位小數點，範圍是0-10之間
  $numberBetween = $faker->numberBetween(0, 100);//生成隨機整數，範圍是0-100之間
  $randomLetter = $faker->randomLetter;//返回a-z之間任意的一個小寫字元
  $randomElements = $faker->randomElements(['a', 'b', 'c', 'd'], 2);//返回陣列中的隨機兩個元素
  $randomElement = $faker->randomElement(['aa', 'bb', 'cc', 'dd']);//隨機返回陣列中的一個元素
  $suffle = $faker->shuffle('hello, world'); //將字串中的字元打亂返回
  $suffle = $faker->shuffle(['aa', 'bb', 'cc', 'dd']); //將陣列中的元素打亂返回
  $numerify = $faker->numerify('Hello #####');//#####替換為隨機數字，輸出類似：Hello 03501
  $lexify = $faker->lexify('Hello ???');//???替換為3個隨機小寫字元，輸出類似：Hello krg
  $bothify = $faker->bothify('hello ##??');//#替換為隨機數字,?替換為隨機小寫字元.輸出類似：hello 15cr
  $asciify = $faker->asciify('hello *****');//*替換為隨機字元，輸出類似：hello 5Ynt[
  $regexify = $faker->regexify('[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}');//根據正規表示式返回字串

• Faker\Provider\Lorem 文字

  $word = $faker->word;//返回一個單詞
  $words = $faker->words(3, false);//返回3個單詞，false表示返回一個陣列；true表示返回一個字串，單詞之間用空格分開
  $sentence = $faker->sentence(5, true);//返回一個句子，false表示只能含有5個單詞，true表示可以在5個單詞左右
  $sentences = $faker->sentences(3, false);//返回3條句子，false表示返回一個陣列，true表示將三條句子拼成一條返回
  $paragraph = $faker->paragraph(3, true);//返回一個段落，由3條句子組成。false表示只能有3條句子，true表示可以在3條句子左右
  $paragraphs = $faker->paragraphs(4, false);//返回4個段落。false表示返回一個陣列，true表示將段落拼接在一起，並且用換行符分割
  $text = $faker->text(200);//返回一段文字，最多隻能含有200個字元

• Faker\Provider\en_US\Person 人物

  $title = $faker->title('female');//引數：title($gender = null|'male'|'female') .返回稱呼。例如：Mrs.|Prof.|Dr.
  $titleMale = $faker->titleMale;//返回男性稱呼
  $titleFemale = $faker->titleFemale;//返回女性稱呼
  $name = $faker->name('female');//引數：name($gender = null|'male'|'female') .返回姓名
  $firstName = $faker->firstName('female');//引數：firstName($gender = null|'male'|'female') .返回名
  $firstNameMale = $faker->firstNameMale;//男性名字
  $firstNameFemale = $faker->firstNameFemale;//女性名字
  $lastName = $faker->lastName;//姓

• Faker\Provider\en_US\Address 地址

  $cityPrefix = $faker->cityPrefix;//城市字首.如：Lake
  $secondaryAddress = $faker->secondaryAddress;//二級地址.如：Suite 061
  $state = $faker->state;//州、省（如：Colorado、四川省）
  $stateAbbr = $faker->stateAbbr;//省份簡稱.如：晉、蒙、浙、冀
  $citySuffix = $faker->citySuffix;//城市字尾.如：side、land、port、Ville
  $streetSuffix = $faker->streetSuffix;//街道字尾.如：Ramp、Plains
  $buildingNumber = $faker->buildingNumber;//建築物編號
  $city = $faker->city;//城市
  $streetName = $faker->streetName;//街道名稱
  $streetAddress = $faker->streetAddress;//街道地址
  $postcode = $faker->postcode;//郵政編碼
  $address = $faker->address;//地址（城市+區）
  $country = $faker->country;//國家
  $latitude = $faker->latitude;//緯度 latitude($min = -90, $max = 90)
  $longitude = $faker->longitude;//經度 longitude($min = -180, $max = 180)

• Faker\Provider\en_US\PhoneNumber 電話號碼

  $phoneNumber = $faker->phoneNumber;//手機號碼
  $tollFreePhoneNumber = $faker->tollFreePhoneNumber;
  $e164PhoneNumber = $faker->e164PhoneNumber;

• Faker\Provider\en_US\Company 公司

  $catchPhrase = $faker->catchPhrase;//口號
  $bs = $faker->bs;
  $company = $faker->company;//公司名稱
  $companySuffix = $faker->companySuffix;//公司名稱字尾
  $jobTitle = $faker->jobTitle;//職稱

• Faker\Provider\en_US\Text 文字

  $realText = $faker->realText();//一段敘事文字

• Faker\Provider\DateTime 日期時間

  $unixTime = $faker->unixTime;//返回隨機時間戳
  $unixTime = $faker->unixTime('now');//返回隨機時間戳 可選最後截止時間
  $dateTime = $faker->dateTime;//返回一個隨機的DateTime物件
  $dateTime = $faker->dateTime('now', 'PRC');//返回一個隨機的DateTime物件，可選擇最後截止時間和時區
  $dateTimeAD = $faker->dateTimeAD;//返回一個隨機的DateTime物件
  $dateTimeAD = $faker->dateTimeAD('now', 'PRC');//返回一個隨機的DateTime物件，可選擇最後截止時間和時區
  $iso8601 = $faker->iso8601;//返回一個隨機的字串形式的時間
  $iso8601 = $faker->iso8601('now');//返回一個隨機的字串形式的時間,可選擇最後截止時間
  $date = $faker->date("Y-m-d H:i:s", 'now');//指定格式返回時間,可選擇最後截止時間
  $time = $faker->time('Y-m-d H:i:s', 'now');//(同上)指定格式返回時間,可選擇最後截止時間
  $dateTimeBetween = $faker->dateTimeBetween('2019-01-01', 'now', 'PRC');//返回指定時間區間的DateTime物件，可選時區
  $dateTimeInInterval = $faker->dateTimeInInterval('-5 years', '+5 days', 'PRC');//返回指定時間區間的DateTime物件，可選時區(第一個引數：開始時間，第二個引數：時間範圍)
  $dateTimeThisCentury = $faker->dateTimeThisCentury;//返回一個本世紀內的DateTime物件
  $dateTimeThisCentury = $faker->dateTimeThisCentury('1950-01-01', 'PRC');//返回一個本世紀內的DateTime物件.指定截止時間和時區
  $dateTimeThisDecade = $faker->dateTimeThisDecade;//返回一個前十年內的DateTime物件
  $dateTimeThisDecade = $faker->dateTimeThisDecade('2015-01-01', 'PRC');//返回一個前十年內的DateTime物件.指定允許的最後時間和時區
  $dateTimeThisYear = $faker->dateTimeThisYear;//返回一個前一年內的DateTime物件
  $dateTimeThisYear = $faker->dateTimeThisYear('now', 'PRC');//返回一個前一年內的DateTime物件.指定允許的最後時間和時區
  $dateTimeThisMonth = $faker->dateTimeThisMonth;//返回一個前一個月內的DateTime物件
  $dateTimeThisMonth = $faker->dateTimeThisMonth('-15 days', 'PRC');//返回一個前一個月內的DateTime物件.指定允許的最後時間和時區
  $amPm = $faker->amPm;//上午/下午
  $dayOfMonth = $faker->dayOfMonth;//返回幾號
  $dayOfWeek = $faker->dayOfWeek;//返回星期幾
  $month = $faker->month;//返回月份
  $monthName = $faker->monthName;//返回月份名稱
  $year = $faker->year;//返回年份
  $year = $faker->year('2000-01-01');//返回年份.可指定最後截止日期
  $timezone = $faker->timezone;//返回時區

• Faker\Provider\Internet 網際網路

  $email = $faker->email;//返回一個隨機郵箱
  $safeEmail = $faker->safeEmail;//返回一個以@example.com結尾的安全郵箱
  $freeEmail = $faker->freeEmail;//返回一個隨機郵箱
  $companyEmail = $faker->companyEmail;//返回企業郵箱（中文語言包下不可用）
  $freeEmailDomain = $faker->freeEmailDomain;//返回一個郵件域名
  $safeEmailDomain = $faker->safeEmailDomain;//返回安全的郵件域名
  $userName = $faker->userName;//使用者名稱
  $password = $faker->password;//密碼
  $domainName = $faker->domainName;//域名（中文語言包下不可用）
  $domainWord = $faker->domainWord;//不帶字尾的域名（中文語言包下不可用）
  $tld = $faker->tld;//域名字尾：如com、org（中文語言包下不可用）
  $url = $faker->url;//返回一個隨機url（中文語言包下不可用）
  $slug = $faker->slug;
  $ipv4 = $faker->ipv4;//返回一個ipv4地址
  $ipv6 = $faker->ipv6;//返回一個ipv6地址
  $localIpv4 = $faker->localIpv4;
  $macAddress = $faker->macAddress;//mac地址

• Faker\Provider\UserAgent 使用者代理

  $userAgent = $faker->userAgent;//返回一個隨機的使用者代理資訊
  $chrome = $faker->chrome;//返回一個chrome瀏覽器的使用者代理資訊
  $firefox = $faker->firefox;//返回一個firefox瀏覽器的使用者代理資訊
  $safari = $faker->safari;//返回一個safari瀏覽器的使用者代理資訊
  $opera = $faker->opera;//返回一個opera瀏覽器的使用者代理資訊
  $internetExplorer = $faker->internetExplorer;//返回一個internetExplorer瀏覽器的使用者代理資訊

• Faker\Provider\Payment 支付

  $creditCardType = $faker->creditCardType;//信用卡型別
  $creditCardNumber = $faker->creditCardNumber;//信用卡號
  $creditCardExpirationDate = $faker->creditCardExpirationDate;//信用卡到期日 (DateTime物件)
  $creditCardExpirationDateString = $faker->creditCardExpirationDateString;//信用卡到期日期字串
  $creditCardDetails = $faker->creditCardDetails;//信用卡詳情（陣列）
  $swiftBicNumber = $faker->swiftBicNumber;
  $iban = $faker->iban;//國際銀行賬戶

• Faker\Provider\Color 顏色

  $hexcolor = $faker->hexcolor;//十六進位制的隨機色：'#fa3cc2'
  $rgbcolor = $faker->rgbcolor;//RGB格式的隨機色（字串形式）：'0,255,122'
  $rgbColorAsArray = $faker->rgbColorAsArray;//RGB格式的隨機色（陣列形式）：array(0,255,122)
  $rgbCssColor = $faker->rgbCssColor;//RGB格式的隨機色的css表示：'rgb(0,255,122)'
  $safeColorName = $faker->safeColorName;//一個安全的隨機色名稱
  $colorName = $faker->colorName;//隨機色名稱

• Faker\Provider\File 檔案

  $fileExtension = $faker->fileExtension;//檔案字尾
  $mimeType = $faker->mimeType;//mime型別
  // 將一個隨機檔案從原始檔複製到目標目錄，並返回fullpath
  $file = $faker->file($sourceDir = './up1', $targetDir = './up2');
  // 將一個隨機檔案從原始檔複製到目標目錄，並返回basename
  $file = $faker->file($sourceDir = './up1', $targetDir = './up2', false);

• Faker\Provider\Image 圖片

  $imageUrl = $faker->imageUrl();//https://lorempixel.com/640/480/?93028
  $imageUrl = $faker->imageUrl(320, 320, 'cats');//https://lorempixel.com/320/320/cats/?68416
  $imageUrl = $faker->imageUrl(320, 320, 'cats', true, 'Faker');//https://lorempixel.com/320/320/cats/Faker/?68118
  $imageUrl = $faker->imageUrl(320, 320, 'cats', true, 'Faker', true);//https://lorempixel.com/gray/320/320/cats/Faker/?28732
  //生成圖片並儲存到本地 '/tmp/13b73edae8443990be1aa8f1a483bc27.jpg'
  $image = $faker->image('./tmp', 320, 320);
  //設定類別並生成圖片儲存到本地  'tmp/13b73edae8443990be1aa8f1a483bc27.jpg'
  $image = $faker->image('./tmp', 320, 320, 'cats');
  //設定類別並生成圖片儲存到本地，只返回檔名 '13b73edae8443990be1aa8f1a483bc27.jpg'
  $image = $faker->image('./tmp', 320, 320, 'cats', false);
  // 生成沒有隨機化的影像
  $image = $faker->image('./tmp', 320, 320, 'cats', true, false);
  //生成圖片並加上水印字型  'tmp/13b73edae8443990be1aa8f1a483bc27.jpg'
  $image = $faker->image('./tmp', 320, 320, 'cats', true, true, 'Faker');

• Faker\Provider\Uuid UUID

  $uuid = $faker->uuid;//生成一個uuid

• Faker\Provider\Barcode 條形碼

  $ean13 = $faker->ean13;//8105964964473
  $ean8 = $faker->ean8;//05994441
  $isbn13 = $faker->isbn13;//9780971408739
  $isbn10 = $faker->isbn10;//0813387299

• Faker\Provider\Miscellaneous 各種各樣的

  $boolean = $faker->boolean;//生成一個布林值
  $md5 = $faker->md5;//生成一個md5碼
  $sha1 = $faker->sha1;//生成一個sha1
  $sha256 = $faker->sha256;//生成一個sha256
  $locale = $faker->locale;//生成一個地區編碼：如zh_CN
  $countryCode = $faker->countryCode;//生成一個國家編碼。如：UK
  $languageCode = $faker->languageCode;//生成一個語言編碼.如：en
  $currencyCode = $faker->currencyCode;//生成一個貨幣程式碼.如：EUR
  $emoji = $faker->emoji;//生成一個emoji表情

• Faker\Provider\Biased 偏向的

  //得到10到20之間的隨機數，並且更多機會接近20
  $biasedNumberBetween = $faker->biasedNumberBetween($min = 10, $max = 20, $function = 'sqrt');

• Faker\Provider\HtmlLorem html文字

  //生成不超過2級深度的HTML文件，並且在任何級別上都不超過3個元素。
  $randomHtml = $faker->randomHtml(2, 3);

• Faker\Provider\zh_CN\Payment

  // 生成一個隨機的銀行名稱(基於真實的中國銀行的列表)
  echo $faker->bank; // '中國建設銀行'

• Faker\Provider\zh_TW\Person

  // Generates a random personal identify number
  echo $faker->personalIdentityNumber; // A223456789

• Faker\Provider\zh_TW\Company

  // Generates a random VAT / Company Tax number
  echo $faker->VAT; //23456789### `Faker\Provider\Base 基本`

本作品採用《CC 協議》，轉載必須註明作者和本文連結