maatify/data-fakes

Complete fake simulation layer for MySQL, DBAL, Redis, and Mongo adapters.

v1.0.0 2025-11-22 05:38 UTC

Requires

• php: >=8.4
• maatify/common: ^1.0
• maatify/data-adapters: ^1.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^11.0

MIT

• redis
• database
• dbal
• mongodb
• php
• testing
• storage
• phpunit
• mysql
• mock
• mongo
• adapter
• fake
• unit-test
• in-memory
• PHPStan
• simulation
• maatify
• integration-test
• maatify-dev
• data-adapters
• fake-database
• mock-database

README

📘 Maatify Data Fakes

In-Memory Fake Adapters for MySQL, Redis, and MongoDB Version: 1.0.0 Project: maatify/data-fakes Author: Maatify.dev

🚀 Overview

maatify/data-fakes is a lightweight, deterministic in-memory data simulation engine compatible with all official Maatify Data Adapters.

It allows any repository or service to be tested without real databases, providing:

• Fake MySQL Adapter
• Fake MySQL DBAL Adapter
• Fake Redis Adapter
• Fake MongoDB Adapter
• Fully deterministic test isolation
• Zero external services required (ideal for CI)

All Fake Adapters follow the exact same contracts used by real adapters.

🔑 Core Dependencies

The entire library depends on two interfaces:

1. Maatify\Common\Contracts\Adapter\AdapterInterface
2. Maatify\DataAdapters\Contracts\ResolverInterface

This ensures 1:1 behavior between fake and real data layers.

🧩 Features

• In-memory table/collection simulation

• Auto-increment support

• MQL-like operators for fake Mongo

• Redis-like lists, hashes, counters, TTL

• SQL-like filtering, ordering, limit/offset

• Adapter lifecycle support:

  • connect(), disconnect()
  • healthCheck()
  • isConnected()
  • getDriver()

• Test isolation using a shared FakeStorageLayer

📦 Installation

composer require maatify/data-fakes --dev

This library is intended for testing environments, not production.

🧪 Basic Usage

Use Fake Resolver

use Maatify\DataFakes\Resolvers\FakeResolver;

$resolver = new FakeResolver();
$db = $resolver->resolve('mysql:main', true);

$rows = $db->select('users', ['id' => 1]);

Reset Between Tests

FakeStorageLayer::reset();

📁 Fake Adapters Included

• FakeMySQLAdapter
• FakeMySQLDbalAdapter
• FakeRedisAdapter
• FakeMongoAdapter
• FakeResolver

📝 Documentation

For full implementation details, see:

👉 README.full.md

This includes:

• Architecture design
• Phase breakdown
• API Map
• Class overview
• Tests summary
• Internal notes

🪪 License

MIT license © Maatify.dev
You’re free to use, modify, and distribute this library with attribution.

👤 Author

© 2025 Maatify.dev
Engineered by Mohamed Abdulalim (@megyptm) — https://www.maatify.dev

📘 Full documentation & source code:
https://github.com/Maatify/data-fakes

🤝 Contributors

Special thanks to the Maatify.dev engineering team and open-source contributors.

_{Built with ❤️ by Maatify.dev — Unified Ecosystem for Modern PHP Libraries}