https://github.com/uzulla/powerpdo
THIS IS EXPERIMENTAL, DO NOT USE IT.
https://github.com/uzulla/powerpdo
experimental pdo php
Last synced: about 1 month ago
JSON representation
THIS IS EXPERIMENTAL, DO NOT USE IT.
- Host: GitHub
- URL: https://github.com/uzulla/powerpdo
- Owner: uzulla
- Created: 2025-03-17T06:57:53.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-03-17T08:48:06.000Z (about 1 month ago)
- Last Synced: 2025-03-17T09:38:30.039Z (about 1 month ago)
- Topics: experimental, pdo, php
- Language: PHP
- Homepage:
- Size: 25.4 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PowerPdo
A PHP library that extends PDO to provide comprehensive SQL query logging with debug information, supporting PHP versions 7.4-8.3.
## Features
- Extends PDO with full compatibility
- Logs all database operations with detailed context
- Captures debug backtrace to show where queries are executed
- Processes and modifies queries before execution
- Modular design with separate components
- Compatible with PHP 7.4-8.3
- Comprehensive test suite with SQLite
## Installation
```bash
composer require php-pdo-logger/php-pdo-logger
```
## Requirements
- PHP 7.4 or higher
- PDO extension
- SQLite extension (for running tests)
## Basic Usage
```php
exec('CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT)');
$stmt = $pdo->prepare('INSERT INTO users (name) VALUES (:name)');
$stmt->execute(['name' => 'John Doe']);
$users = $pdo->query('SELECT * FROM users')->fetchAll(PDO::FETCH_ASSOC);
```
## Advanced Usage: Query Processing
```php
addFilter(function(string $query): string {
return "/* Application: MyApp */ $query";
});
// Add another filter
$processor->addFilter(function(string $query): string {
return "$query /* Timestamp: " . time() . " */";
});
// Create PDO instance with logger and processor
$pdo = new PDOLogger(
'sqlite::memory:',
null,
null,
null,
new FileLogger('/path/to/sql.log'),
$processor
);
// The query will be processed by all filters before execution
$stmt = $pdo->prepare('SELECT * FROM users');
```
## Log Format
The logs are written in JSON format with the following structure:
```json
{
"timestamp": "2025-03-17 05:50:52",
"action": "prepare",
"caller": "/path/to/file.php:24",
"data": {
"query": "SELECT * FROM users WHERE id = :id",
"options": [],
"trace": [
{
"file": "/path/to/file.php",
"line": 24,
"function": "prepare",
"class": "PowerPdo\\Core\\PDOLogger",
"type": "->"
}
]
}
}
```
## Available Loggers
- `FileLogger`: Logs to a file in JSON format
- `NullLogger`: Disables logging (useful for production or testing)
## Available Query Processors
- `DefaultQueryProcessor`: Passes queries through unchanged
- `FilterableQueryProcessor`: Allows adding multiple filters to modify queries
## Version Compatibility
For detailed information about compatibility with different PHP versions, see [COMPATIBILITY.md](COMPATIBILITY.md) and [VERSION_SUPPORT.md](VERSION_SUPPORT.md).
## License
MIT