https://github.com/k-kinzal/ztd-query-php

A Zero Table Dependency testing library
https://github.com/k-kinzal/ztd-query-php

cte database pdo php testing

Last synced: 3 months ago
JSON representation

A Zero Table Dependency testing library

• Host: GitHub
• URL: https://github.com/k-kinzal/ztd-query-php
• Owner: k-kinzal
• License: mit
• Created: 2026-01-07T13:10:50.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2026-03-22T14:25:36.000Z (3 months ago)
• Last Synced: 2026-04-04T04:56:05.668Z (3 months ago)
• Topics: cte, database, pdo, php, testing
• Language: PHP
• Homepage:
• Size: 1.44 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 168
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Security: SECURITY.md
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# ZTD Query PHP

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![PHP Version](https://img.shields.io/badge/PHP-8.1%2B-blue.svg)](https://www.php.net/)

A Zero Table Dependency testing library for PHP 8.1+ that enables SQL unit testing without modifying physical databases.

ZTD Query PHP wraps PDO/MySQLi to intercept and transform SQL queries using CTE (Common Table Expression) shadowing. This allows you to test SQL queries against fixture data using the real MySQL engine, without migrations, data seeding, or cleanup.

## Packages

| Package | Description |

|---------|-------------|

| [ztd-query-core](packages/ztd-query-core/) | Core library: interfaces, session management, query routing |

| [ztd-query-mysql](packages/ztd-query-mysql/) | MySQL platform: SQL parsing, classification, rewriting, schema reflection |

| [ztd-query-pdo-adapter](packages/ztd-query-pdo-adapter/) | PDO adapter: drop-in `ZtdPdo` / `ZtdPdoStatement` |

| [ztd-query-mysqli-adapter](packages/ztd-query-mysqli-adapter/) | MySQLi adapter: drop-in `ZtdMysqli` / `ZtdMysqliStatement` |

| [sql-faker](packages/sql-faker/) | Faker provider for generating syntactically valid SQL |

| [sql-fixture](packages/sql-fixture/) | Faker provider for generating test fixture data from schemas |

## Quick Start

```bash

composer require --dev k-kinzal/ztd-query-pdo-adapter

```

```php

use ZtdQuery\Adapter\Pdo\ZtdPdo;

$pdo = new ZtdPdo('mysql:host=localhost;dbname=test', 'user', 'password');

$pdo->exec('CREATE TABLE users (id INT PRIMARY KEY, name VARCHAR(255))');

$pdo->exec("INSERT INTO users (id, name) VALUES (1, 'Alice')");

$stmt = $pdo->prepare('SELECT * FROM users WHERE id = ?');

$stmt->execute([1]);

$result = $stmt->fetchAll();

// [['id' => 1, 'name' => 'Alice']]

```

See [packages/ztd-query-core/README.md](packages/ztd-query-core/README.md) for full documentation.

## License

MIT License. See [LICENSE](LICENSE) for details.