seedfaker-php

PHP FFI binding for seedfaker — deterministic synthetic data generator with 200+ fields and 68 locales.

This repository is a release mirror for Packagist. Source code lives in the main repository. Releases are pushed here automatically by CI on every tagged version, including pre-built native FFI binaries for supported platforms.

Install

composer require opendsr/seedfaker

Requirements

• PHP >= 8.1 with the FFI extension enabled
• Linux (x86_64, arm64) or macOS (x86_64, arm64)

The native libseedfaker_ffi binary is bundled with the package — no separate build step required.

Usage

use Seedfaker\SeedFaker;

$f = new SeedFaker(seed: "ci", locale: "en");

$f->field("name");                                        // "Zoe Kumar"
$f->field("phone", e164: true);                           // "+14155551234"

$f->record(["name", "email"], ctx: "strict");             // single record
$f->records(["name", "email"], n: 5, ctx: "strict");      // batch
$f->validate(["name", "email:e164"]);                     // check without generating

$f->records(["name", "email"], n: 100, corrupt: "high");  // corrupted data

SeedFaker::fingerprint();                                 // "sf0-..."
SeedFaker::fields();                                      // all field names

Documentation

• Quick start
• Field reference (200+ fields)
• Library API
• Full documentation

Issues

Please file issues in the main repository, not here. This mirror only receives release commits.

License

MIT — see LICENSE.

Disclaimer

This software generates synthetic data that may resemble real-world identifiers, credentials, or personal information. All output is artificial. See LICENSE for the full legal disclaimer.