PHPackages bit3/faker-cli - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [CLI & Console](/categories/cli) 4. / 5. bit3/faker-cli AbandonedArchivedProject[CLI & Console](/categories/cli) bit3/faker-cli ============== A command line command for the Faker PHP library. 1.4(9y ago)1752.0k161MITPHPPHP >=5.4 Since May 26Pushed 8y ago1 watchersCompare [ Source](https://github.com/bit3/faker-cli)[ Packagist](https://packagist.org/packages/bit3/faker-cli)[ RSS](/packages/bit3-faker-cli/feed)WikiDiscussions master Synced 1w ago READMEChangelog (8)Dependencies (2)Versions (13)Used By (1) Faker Command Line Tool ======================= [](#faker-command-line-tool) [Faker](https://github.com/fzaninotto/faker) is a PHP library that generates fake data for you. This is a command line tool for easy generation of fake data in a static way. Usage ----- [](#usage) ### As a Phar (Recommended) [](#as-a-phar-recommended) You can find the latest phar on the [releases page](https://github.com/bit3/faker-cli/releases). ``` $ wget https://github.com/bit3/faker-cli/releases/download/1.4/faker.phar $ ./faker.phar ``` ### As a Composer Install [](#as-a-composer-install) ``` $ composer create-project bit3/faker-cli $ cd faker-cli $ ./bin/faker.php ``` ### Parameters and arguments [](#parameters-and-arguments) ``` $ ./bin/faker.php --locale (-l) # The locale to used. (default: "en_US") --seed (-s) # The generators seed. --pattern (-p) # The printf pattern. (default: "%s") --delimiter (-d) # The delimiter is used by the csv and printf format. --enclosure (-e) # The enclosure is used by the csv and printf format. --escape (-E) # The escape character is used by the printf format. (default: "\\") --format (-f) # The output format (json, xml, csv, php, printf, vprintf) (default: "printf") --count (-c) # The count of generated data. (default: 1) # The data type to generate (e.g. "randomDigit", "words", "name", "city") .. # Arguments for the type, e.g. "words 5" will generate 5 words. ``` ### Single value generator example [](#single-value-generator-example) ``` $ ./bin/faker.php word culpa consequatur quisquam recusandae asperiores accusamus nihil repellat vero omnis ``` ### Multi value generator example [](#multi-value-generator-example) ``` $ ./bin/faker.php --count 5 words 2 culpa,consequatur quisquam,recusandae asperiores,accusamus nihil,repellat vero,omnis ``` ### Output formats [](#output-formats) You can use different output formats by definint the `--format` option. JSON is the default format. #### JSON output [](#json-output) ``` $ ./bin/faker.php word [ "culpa", "consequatur", "quisquam", "recusandae", "asperiores", "accusamus", "nihil", "repellat", "vero", "omnis" ] ``` ``` $ ./bin/faker.php --count 5 words 2 [ [ "culpa", "consequatur" ], [ "quisquam", "recusandae" ], [ "asperiores", "accusamus" ], [ "nihil", "repellat" ], [ "vero", "omnis" ] ] ``` #### XML output [](#xml-output) ``` $ ./bin/faker.php --format xml word culpa consequatur quisquam recusandae asperiores accusamus nihil repellat vero omnis ``` #### CSV output [](#csv-output) ``` $ ./bin/faker.php --format csv word culpa consequatur quisquam recusandae asperiores accusamus nihil repellat vero omnis ``` #### PHP output [](#php-output) ``` $ ./bin/faker.php --format php word array ( 0 => 'culpa', 1 => 'consequatur', 2 => 'quisquam', 3 => 'recusandae', 4 => 'asperiores', 5 => 'accusamus', 6 => 'nihil', 7 => 'repellat', 8 => 'vero', 9 => 'omnis', ) ``` #### printf and vprintf output [](#printf-and-vprintf-output) The printf and vprintf output are mostly equal. But `printf` is designed for single value generator types e.g. `safeEmail` and `vprintf` is designed for multi value generator types e.g. `words 5`. ``` $ ./bin/faker.php --format printf \ --pattern "INSERT INTO emails (uuid, email) VALUES (UUID(), %s);" \ --enclosure "'" \ safeEmail INSERT INTO emails (uuid, email) VALUES (UUID(), 'dbednar@example.com'); INSERT INTO emails (uuid, email) VALUES (UUID(), 'xhettinger@example.net'); INSERT INTO emails (uuid, email) VALUES (UUID(), 'gerald62@example.org'); INSERT INTO emails (uuid, email) VALUES (UUID(), 'miles91@example.com'); INSERT INTO emails (uuid, email) VALUES (UUID(), 'to\'conner@example.com'); INSERT INTO emails (uuid, email) VALUES (UUID(), 'bridgette.runolfsdottir@example.com'); INSERT INTO emails (uuid, email) VALUES (UUID(), 'fgoldner@example.org'); INSERT INTO emails (uuid, email) VALUES (UUID(), 'grimes.leo@example.org'); INSERT INTO emails (uuid, email) VALUES (UUID(), 'lilian.reynolds@example.net'); INSERT INTO emails (uuid, email) VALUES (UUID(), 'ratke.darlene@example.net'); ``` ``` ./bin/faker.php --format vprintf \ --pattern "INSERT INTO keywords (uuid, keyword1, keyword2, keyword3) VALUES (UUID(), %s, %s, %s);" \ --enclosure "'" \ words 3 INSERT INTO keywords (uuid, keyword1, keyword2, keyword3) VALUES (UUID(), 'est', 'illo', 'consequuntur'); INSERT INTO keywords (uuid, keyword1, keyword2, keyword3) VALUES (UUID(), 'dolorem', 'temporibus', 'commodi'); INSERT INTO keywords (uuid, keyword1, keyword2, keyword3) VALUES (UUID(), 'sint', 'reiciendis', 'sint'); INSERT INTO keywords (uuid, keyword1, keyword2, keyword3) VALUES (UUID(), 'sunt', 'eum', 'id'); INSERT INTO keywords (uuid, keyword1, keyword2, keyword3) VALUES (UUID(), 'tempora', 'rerum', 'occaecati'); INSERT INTO keywords (uuid, keyword1, keyword2, keyword3) VALUES (UUID(), 'corrupti', 'impedit', 'doloribus'); INSERT INTO keywords (uuid, keyword1, keyword2, keyword3) VALUES (UUID(), 'amet', 'consectetur', 'repudiandae'); INSERT INTO keywords (uuid, keyword1, keyword2, keyword3) VALUES (UUID(), 'est', 'id', 'amet'); INSERT INTO keywords (uuid, keyword1, keyword2, keyword3) VALUES (UUID(), 'odio', 'facere', 'nesciunt'); INSERT INTO keywords (uuid, keyword1, keyword2, keyword3) VALUES (UUID(), 'voluptas', 'quia', 'rerum'); ``` You can also use `printf` with multi value generator types, which will joined by the `--delimiter` char, which is `,` by default. ``` $ ./bin/faker.php --format printf \ --pattern "INSERT INTO words (uuid, words) VALUES (UUID(), %s);" \ --delimiter ' / ' \ --enclosure "'" \ words 10 INSERT INTO words (uuid, words) VALUES (UUID(), 'est / illo / consequuntur / dolorem / temporibus / commodi / sint / reiciendis / sint / sunt'); INSERT INTO words (uuid, words) VALUES (UUID(), 'eum / id / tempora / rerum / occaecati / corrupti / impedit / doloribus / amet / consectetur'); INSERT INTO words (uuid, words) VALUES (UUID(), 'repudiandae / est / id / amet / odio / facere / nesciunt / voluptas / quia / rerum'); INSERT INTO words (uuid, words) VALUES (UUID(), 'ad / sed / esse / sed / exercitationem / sed / et / rem / esse / excepturi'); INSERT INTO words (uuid, words) VALUES (UUID(), 'animi / minus / qui / perferendis / quo / repudiandae / aliquam / dolorem / voluptas / fugiat'); INSERT INTO words (uuid, words) VALUES (UUID(), 'at / odit / dolorem / a / aperiam / dignissimos / ipsa / sunt / consequatur / alias'); INSERT INTO words (uuid, words) VALUES (UUID(), 'accusantium / voluptatum / autem / nobis / cumque / neque / modi / iure / voluptatem / error'); INSERT INTO words (uuid, words) VALUES (UUID(), 'molestiae / consequatur / alias / eligendi / corrupti / illum / commodi / molestiae / aut / repellat'); INSERT INTO words (uuid, words) VALUES (UUID(), 'id / quisquam / et / sit / consequuntur / aut / et / ullam / asperiores / molestiae'); INSERT INTO words (uuid, words) VALUES (UUID(), 'cupiditate / culpa / voluptatem / et / mollitia / dolor / sit / nisi / praesentium / qui'); ``` It is recommend to use the `--enclosure` option. each occurrence of the `--enclosure` char will be escaped with the `--escape` char, which is `\\` by default. Build your own Phar ------------------- [](#build-your-own-phar) Install and run php-box: ``` $ curl -LSs https://box-project.github.io/box2/installer.php | php $ ./box.phar build ``` License ------- [](#license) Faker Command Line Tool is released under the MIT Licence. See the bundled LICENSE file for details. ### Health Score 37 — LowBetter than 83% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity33 Limited adoption so far Community17 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 90.6% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~83 days Recently: every ~164 days Total 10 Last Release 3628d ago PHP version history (2 changes)1.0PHP >=5.3.3 1.0.4PHP >=5.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/4e61f74ea186c1e79e072b2974ccdeef39414730476d5a8adac501eb9449b2a3?d=identicon)[tril](/maintainers/tril) --- Top Contributors [![tristanlins](https://avatars.githubusercontent.com/u/343404?v=4)](https://github.com/tristanlins "tristanlins (48 commits)")[![EHER](https://avatars.githubusercontent.com/u/398034?v=4)](https://github.com/EHER "EHER (4 commits)")[![thiagorock22](https://avatars.githubusercontent.com/u/2721852?v=4)](https://github.com/thiagorock22 "thiagorock22 (1 commits)") --- Tags clifakerfixturesdata ### Embed Badge ![Health badge](/badges/bit3-faker-cli/health.svg) ``` [![Health](https://phpackages.com/badges/bit3-faker-cli/health.svg)](https://phpackages.com/packages/bit3-faker-cli) ``` ### Alternatives [willdurand/faker-bundle Put the awesome Faker lib into the DIC and populate your database with fake data. 2751.2M14](/packages/willdurand-faker-bundle)[laminas/laminas-cli Command-line interface for Laminas projects 563.7M54](/packages/laminas-laminas-cli)[bheller/images-generator Generator of placeholder images for Faker 573.1M3](/packages/bheller-images-generator)[mahocommerce/maho Free and open source ecommerce platform, created in 2024 on the M1 platform, PHP 8.3+ 1322.1k12](/packages/mahocommerce-maho)[hydreflab/jedi-faker Faker extension for Star Wars junkie 1429.5k1](/packages/hydreflab-jedi-faker)[andrefigueira/blog-article-faker Generate random blog article titles and content (including markdown) using faker 1415.0k](/packages/andrefigueira-blog-article-faker) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)