Merge pull request #677 from flightphp/simple-pdo

Added SimplePdo class to replace PdoWrapper

Author: n0nag0n

.gemini/GEMINI.md

@@ -0,0 +1,27 @@
+# FlightPHP/Core Project Instructions
+
+## Overview
+This is the main FlightPHP core library for building fast, simple, and extensible PHP web applications. It is dependency-free for core usage and supports PHP 7.4+.
+
+## Project Guidelines
+- PHP 7.4 must be supported. PHP 8 or greater also supported, but avoid PHP 8+ only features.
+- Keep the core library dependency-free (no polyfills or interface-only repositories).
+- All Flight projects are meant to be kept simple and fast. Performance is a priority.
+- Flight is extensible and when implementing new features, consider how they can be added as plugins or extensions rather than bloating the core library.
+- Any new features built into the core should be well-documented and tested.
+- Any new features should be added with a focus on simplicity and performance, avoiding unnecessary complexity.
+- This is not a Laravel, Yii, Code Igniter or Symfony clone. It is a simple, fast, and extensible framework that allows you to build applications quickly without the overhead of large frameworks.
+
+## Development & Testing
+- Run tests: `composer test` (uses phpunit/phpunit and spatie/phpunit-watcher)
+- Run test server: `composer test-server` or `composer test-server-v2`
+- Lint code: `composer lint` (uses phpstan/phpstan, level 6)
+- Beautify code: `composer beautify` (uses squizlabs/php_codesniffer, PSR1)
+- Check code style: `composer phpcs`
+- Test coverage: `composer test-coverage`
+
+## Coding Standards
+- Follow PSR1 coding standards (enforced by PHPCS)
+- Use strict comparisons (`===`, `!==`)
+- PHPStan level 6 compliance
+- Focus on PHP 7.4 compatibility (avoid PHP 8+ only features)

composer.json

@@ -61,16 +61,21 @@
         "sort-packages": true
     },
     "scripts": {
-        "test": "phpunit",
-        "test-watcher": "phpunit-watcher watch",
-        "test-ci": "phpunit",
-        "test-coverage": "rm -f clover.xml && XDEBUG_MODE=coverage vendor/bin/phpunit --coverage-html=coverage --coverage-clover=clover.xml && vendor/bin/coverage-check clover.xml 100",
-        "test-server": "echo \"Running Test Server\" && php -S localhost:8000 -t tests/server/",
-        "test-server-v2": "echo \"Running Test Server\" && php -S localhost:8000 -t tests/server-v2/",
+        "test": "@php vendor/bin/phpunit",
+        "test-watcher": "@php vendor/bin/phpunit-watcher watch",
+        "test-ci": "@php vendor/bin/phpunit",
+        "test-coverage": [
+            "rm -f clover.xml",
+            "@putenv XDEBUG_MODE=coverage",
+            "@php vendor/bin/phpunit --coverage-html=coverage --coverage-clover=clover.xml",
+            "@php vendor/bin/coverage-check clover.xml 100"
+        ],
+        "test-server": "echo \"Running Test Server\" && @php -S localhost:8000 -t tests/server/",
+        "test-server-v2": "echo \"Running Test Server\" && @php -S localhost:8000 -t tests/server-v2/",
         "test-coverage:win": "del clover.xml && phpunit --coverage-html=coverage --coverage-clover=clover.xml && coverage-check clover.xml 100",
         "test-performance": [
             "echo \"Running Performance Tests...\"",
-            "php -S localhost:8077 -t tests/performance/ > /dev/null 2>&1 & echo $! > server.pid",
+            "@php -S localhost:8077 -t tests/performance/ > /dev/null 2>&1 & echo $! > server.pid",
             "sleep 2",
             "bash tests/performance/performance_tests.sh",
             "kill `cat server.pid`",

flight/database/PdoWrapper.php

@@ -9,6 +9,9 @@
 use PDO;
 use PDOStatement;
 
+/**
+ * @deprecated version 3.18.0 - Use SimplePdo instead
+ */
 class PdoWrapper extends PDO
 {
     /** @var bool $trackApmQueries Whether to track application performance metrics (APM) for queries. */