PHPackages zenstruck/foundry - 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. [Testing & Quality](/categories/testing) 4. / 5. zenstruck/foundry ActiveLibrary[Testing & Quality](/categories/testing) zenstruck/foundry ================= A model factory library for creating expressive, auto-completable, on-demand dev/test fixtures with Symfony and Doctrine. v2.9.2(3mo ago)78611.9M↓11.7%111[25 issues](https://github.com/zenstruck/foundry/issues)[7 PRs](https://github.com/zenstruck/foundry/pulls)20MITPHPPHP >=8.1CI passing Since Jul 10Pushed 1w ago6 watchersCompare [ Source](https://github.com/zenstruck/foundry)[ Packagist](https://packagist.org/packages/zenstruck/foundry)[ Docs](https://github.com/zenstruck/foundry)[ GitHub Sponsors](https://github.com/kbond)[ GitHub Sponsors](https://github.com/nikophil)[ RSS](/packages/zenstruck-foundry/feed)WikiDiscussions 2.x Synced 1mo ago READMEChangelog (10)Dependencies (34)Versions (134)Used By (20) Foundry ======= [](#foundry) [![CI Status](https://github.com/zenstruck/foundry/workflows/CI/badge.svg)](https://github.com/zenstruck/foundry/actions?query=workflow%3ACI)[![Code Coverage](https://camo.githubusercontent.com/27a53f8228f91e1eac0c1875723f39dfcbf7c5d225085f3d4f4ee130312bb56f/68747470733a2f2f636f6465636f762e696f2f67682f7a656e73747275636b2f666f756e6472792f6272616e63682f6d61737465722f67726170682f62616467652e7376673f746f6b656e3d37374a49465953554335)](https://codecov.io/gh/zenstruck/foundry)[![Latest Version](https://camo.githubusercontent.com/cbe851d60b60596b7ad76e1039913e16a4ecdc47ecad688876d84f0a27a7a53a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7a656e73747275636b2f666f756e6472792e737667)](https://packagist.org/packages/zenstruck/foundry)[![Downloads](https://camo.githubusercontent.com/272d201a13a1ec9eedb5d49a445217b707f79b7f63ce77ce40ad144a380b3feb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f7a656e73747275636b2f666f756e647279)](https://packagist.org/packages/zenstruck/foundry) "Fixtures you'll actually enjoy writing!" Foundry turns fixture creation into a joy, via an expressive, auto-completable, on-demand fixtures system with Symfony and Doctrine: ``` $post = PostFactory::new() // Create the factory for Post objects ->published() // Make the post in a "published" state ->create([ // create & persist the Post object 'slug' => 'post-a' // This Post object only requires the slug field - all other fields are random data ]) ; ``` The factories can be used inside [DoctrineFixturesBundle](https://symfony.com/bundles/DoctrineFixturesBundle/current/index.html)to load fixtures or inside your tests, [where it has even more features](https://symfony.com/bundles/ZenstruckFoundryBundle/current/index.html#using-in-your-tests). Foundry supports `doctrine/orm` (with [doctrine/doctrine-bundle](https://github.com/doctrine/doctrinebundle)), `doctrine/mongodb-odm` (with [doctrine/mongodb-odm-bundle](https://github.com/doctrine/DoctrineMongoDBBundle)) or a combination of these. Want to watch a screencast 🎥 about it? Check out **[Read the Documentation](https://symfony.com/bundles/ZenstruckFoundryBundle/current/index.html)** **[Upgrade guide to v2](https://github.com/zenstruck/foundry/blob/v2.0.0/UPGRADE-2.0.md)** How to contribute ----------------- [](#how-to-contribute) ### Running the Test Suite [](#running-the-test-suite) The test suite of this library needs one or more databases, then it comes with a docker compose configuration. Note Docker and PHP installed locally (with `mysql`, `pgsql` & `mongodb` extensions) is required. You can start the containers and run the test suite: ``` # start the container $ docker compose up --detach # install dependencies $ composer update # run main testsuite (with "schema" reset database strategy) $ ./phpunit # run "reset-database" testsuite $ ./phpunit --testsuite reset-database ``` ### Overriding the default configuration [](#overriding-the-default-configuration) You can override default environment variables by creating a `.env.local` file, to easily enable permutations: ``` # .env.local # change the database to postgreSQL... DATABASE_URL="postgresql://zenstruck:zenstruck@127.0.0.1:5433/zenstruck_foundry?serverVersion=15" # ...or to SQLite DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db" MONGO_URL="" # disables Mongo USE_DAMA_DOCTRINE_TEST_BUNDLE="1" # enables dama/doctrine-test-bundle PHPUNIT_VERSION="11" # possible values: 9, 10, 11, 11.4 # test reset database with migrations, # only relevant for "reset-database" testsuite DATABASE_RESET_MODE="migrate" MIGRATION_CONFIGURATION_FILE="tests/Fixture/MigrationTests/configs/migration-configuration.php" # run test suite with postgreSQL $ vendor/bin/phpunit ``` The `.env.local` file can also be used to override the port of the database containers, if it does not meet your local requirements. You'll also need to override docker compose configuration: Here is an example to use MySQL on port `3308`: ``` # docker-compose.override.yml version: '3.9' services: mysql: ports: - "3308:3306" ``` ``` # .env.local DATABASE_URL="mysql://root:1234@127.0.0.1:3308/foundry_test?serverVersion=5.7.42" ``` ### Run the tests locally faster [](#run-the-tests-locally-faster) As long as you don't want to test Mongo, you can use the following `.env.local` file to run the tests faster locally: ``` # dama/doctrine-test-bundle makes Foundry testsuite really faster USE_DAMA_DOCTRINE_TEST_BUNDLE="1" # using both ODM and ORM makes the "reset db" mechanism slower MONGO_URL="" # Use the last version of PHPUnit PHPUNIT_VERSION="12" # Enable all features of Foundry USE_FOUNDRY_PHPUNIT_EXTENSION="1" ``` "maker" tests are also quite slow, so you can skip them with using the following command: ``` $ ./phpunit --exclude-group=maker ``` Enjoy blazing fast tests! 🚀 ### Running the documentation linter locally [](#running-the-documentation-linter-locally) This section provides guidance on how to run the documentation linter, contained within a Docker image, locally on your machine. This linter is designed to verify and ensure that the document syntax adheres to the required standards. The following command runs the linter in the local directory: ``` docker run --rm -it -e DOCS_DIR='/docs' -v ${PWD}/docs:/docs oskarstark/doctor-rst:latest ``` Credit ------ [](#credit) The [AAA](https://www.thephilocoder.com/unit-testing-aaa-pattern/) style of testing was first introduced to me by [Adam Wathan's](https://adamwathan.me/) excellent [Test Driven Laravel Course](https://course.testdrivenlaravel.com/). The inspiration for this libraries API comes from [Laravel factories](https://laravel.com/docs/master/database-testing)and [christophrumpel/laravel-factories-reloaded](https://github.com/christophrumpel/laravel-factories-reloaded). ### Health Score 75 — ExcellentBetter than 100% of packages Maintenance90 Actively maintained with recent releases Popularity70 Solid adoption and visibility Community46 Growing community involvement Maturity81 Battle-tested with a long release history Bus Factor2 2 contributors hold 50%+ of commits 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 ~15 days Recently: every ~10 days Total 133 Last Release 63d ago Major Versions v1.38.4 → v2.3.22025-02-01 v1.38.5 → v2.3.102025-03-31 v1.38.6 → v2.4.02025-04-14 1.x-dev → v2.5.22025-05-26 v2.9.1 → 3.x-dev2026-02-10 PHP version history (5 changes)v1.0.0PHP >=7.2.5 v1.8.0PHP >=7.2.12 v1.24.0PHP >=8.0 v2.0.0PHP >=8.1 3.x-devPHP >=8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/707369cc916e0ea1aacbf077dcba464f611cef879f024d8944311a54a15224b3?d=identicon)[kbond](/maintainers/kbond) --- Top Contributors [![nikophil](https://avatars.githubusercontent.com/u/10139766?v=4)](https://github.com/nikophil "nikophil (462 commits)")[![kbond](https://avatars.githubusercontent.com/u/127811?v=4)](https://github.com/kbond "kbond (386 commits)")[![wouterj](https://avatars.githubusercontent.com/u/749025?v=4)](https://github.com/wouterj "wouterj (15 commits)")[![OskarStark](https://avatars.githubusercontent.com/u/995707?v=4)](https://github.com/OskarStark "OskarStark (11 commits)")[![HypeMC](https://avatars.githubusercontent.com/u/2445045?v=4)](https://github.com/HypeMC "HypeMC (10 commits)")[![Chris53897](https://avatars.githubusercontent.com/u/7104259?v=4)](https://github.com/Chris53897 "Chris53897 (7 commits)")[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (5 commits)")[![BackEndTea](https://avatars.githubusercontent.com/u/14289961?v=4)](https://github.com/BackEndTea "BackEndTea (4 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![gnito-org](https://avatars.githubusercontent.com/u/70450336?v=4)](https://github.com/gnito-org "gnito-org (4 commits)")[![jmsche](https://avatars.githubusercontent.com/u/3929498?v=4)](https://github.com/jmsche "jmsche (4 commits)")[![GrinWay](https://avatars.githubusercontent.com/u/175572154?v=4)](https://github.com/GrinWay "GrinWay (3 commits)")[![mpiot](https://avatars.githubusercontent.com/u/10453508?v=4)](https://github.com/mpiot "mpiot (3 commits)")[![jdreesen](https://avatars.githubusercontent.com/u/424602?v=4)](https://github.com/jdreesen "jdreesen (3 commits)")[![javiereguiluz](https://avatars.githubusercontent.com/u/73419?v=4)](https://github.com/javiereguiluz "javiereguiluz (3 commits)")[![seb-jean](https://avatars.githubusercontent.com/u/12116264?v=4)](https://github.com/seb-jean "seb-jean (3 commits)")[![smnandre](https://avatars.githubusercontent.com/u/1359581?v=4)](https://github.com/smnandre "smnandre (3 commits)")[![ndench](https://avatars.githubusercontent.com/u/2062388?v=4)](https://github.com/ndench "ndench (2 commits)")[![jschaedl](https://avatars.githubusercontent.com/u/1880467?v=4)](https://github.com/jschaedl "jschaedl (2 commits)")[![NorthBlue333](https://avatars.githubusercontent.com/u/43409865?v=4)](https://github.com/NorthBlue333 "NorthBlue333 (2 commits)") --- Tags doctrinefactoryfakerfixturessymfonytestsymfonytestfactorydevFixturefakerdoctrine ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/zenstruck-foundry/health.svg) ``` [![Health](https://phpackages.com/badges/zenstruck-foundry/health.svg)](https://phpackages.com/packages/zenstruck-foundry) ``` ### Alternatives [nelmio/alice Expressive fixtures generator 2.5k43.4M133](/packages/nelmio-alice)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[zenstruck/messenger-test Assertions and helpers for testing your symfony/messenger queues. 2774.8M13](/packages/zenstruck-messenger-test)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.2M386](/packages/shopware-core)[zenstruck/browser A fluent interface for your Symfony functional tests. 2272.2M21](/packages/zenstruck-browser)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M152](/packages/sulu-sulu) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)