README

PHP binding for seedfaker — deterministic synthetic data with 200+ fields, 68 locales, same seed = same output.

CLI · Node.js · Python · Browser/WASM · Go · PHP · Ruby · MCP

Requirements

• PHP >= 8.1 with FFI extension
• libseedfaker_ffi shared library (built from Rust source)

Pre-1.0: API may change between minor versions. Pin your version.

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
• Guides — library usage, seed databases, mock APIs, anonymize data, NER training
• Full documentation

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.