up

Author: BitsHost

.github/workflows/ci.yml

@@ -9,9 +9,23 @@ on:
 jobs:
   build-test:
     runs-on: ubuntu-latest
+    services:
+      mysql:
+        image: mysql:8.0
+        env:
+          MYSQL_ALLOW_EMPTY_PASSWORD: "yes"
+          MYSQL_DATABASE: test
+          MYSQL_ROOT_PASSWORD: ""
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping -h 127.0.0.1 --silent"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=30
     strategy:
       matrix:
-        php: [ '8.0', '8.1', '8.2', '8.3' ]
+        php: [ '8.2', '8.3' ]
 
     steps:
       - name: Checkout
@@ -30,6 +44,17 @@ jobs:
       - name: Install dependencies
         run: composer install --no-interaction --no-progress --prefer-dist
 
+      - name: Install MySQL client
+        run: sudo apt-get update && sudo apt-get install -y mysql-client
+
+      - name: Wait for MySQL
+        run: |
+          for i in {1..60}; do
+            mysqladmin ping -h 127.0.0.1 --silent && break
+            sleep 2
+          done
+          mysql -h 127.0.0.1 -uroot -e "SHOW DATABASES;"
+
       - name: Generate autoload
         run: composer dump-autoload -o
 

CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 2.0.1 - Type Safety & CI Hardening (2025-11-12)
+
+### ✅ What changed
+- Static analysis: Reduced PHPStan issues to zero with precise generics, array-shape docs, and guards across core modules.
+- App hardening: Cleaned up Router, RBAC, Cache, Authenticator, ApiController, Monitor, and middlewares for stricter typing and better error handling.
+- Tests cleanup: Modernized tests to remove always-true assertions, add return types, guard glob/file reads, and align with updated return shapes.
+- CI ready: Ensured the test suite runs green on clean environments.
+
+### 🔧 Highlights
+- RBAC: Normalized user roles mapping and removed unused state.
+- ApiController: Simplified cache-key logic and removed redundant checks; consistent return tuples.
+- Monitor & RequestLogger: Safer I/O guards; added minimal reads to satisfy analyzer without behavior change.
+- Cache: Tightened typing in manager and drivers; safer key generation and headers handling.
+- Middlewares: Fixed unreachable code in rate limiting; typed CORS config.
+- Config: Added explicit types and normalizations in `ApiConfig` and `CacheConfig` getters.
+
+### 🧪 CI (GitHub Actions)
+- Added workflow to run Composer install, PHPStan, and PHPUnit on pushes/PRs.
+- Provisioned MySQL service (database: `test`) so DB-backed tests run reliably in CI.
+- Matrix on PHP 8.2 and 8.3.
+
+### Result
+- PHPStan: 0 errors.
+- PHPUnit: All tests passing.
+
+---
+
 ## 2.0.0 - Performance & Architecture Revolution (2025-11-10)
 
 ### 🚀 Major New Features

public/index.php

@@ -1,4 +1,15 @@
 <?php
+/**
+ * Application entrypoint (bootstrap) for the PHP-CRUD-API-Generator.
+ *
+ * @package   PHP-CRUD-API-Generator
+ * @author    BitsHost
+ * @copyright 2025 BitsHost
+ * @license   MIT License
+ * @link      https://bitshost.biz/
+ * @created   2025-11-12
+ */
+
 declare(strict_types=1);
 
 require_once __DIR__ . '/../vendor/autoload.php';

src/ApiGenerator.php

@@ -1,4 +1,14 @@
 <?php
+/**
+ * Database-backed CRUD API generator.
+ *
+ * @package   PHP-CRUD-API-Generator
+ * @author    BitsHost
+ * @copyright 2025 BitsHost
+ * @license   MIT License
+ * @link      https://bitshost.biz/
+ * @created   2025-11-12
+ */
 
 namespace App;
 

src/Application/HookManager.php

@@ -1,4 +1,14 @@
 <?php
+/**
+ * Hook manager for registering and dispatching extension hooks.
+ *
+ * @package   PHP-CRUD-API-Generator
+ * @author    BitsHost
+ * @copyright 2025 BitsHost
+ * @license   MIT License
+ * @link      https://bitshost.biz/
+ * @created   2025-11-12
+ */
 declare(strict_types=1);
 
 namespace App\Application;

src/Application/Router.php

@@ -1,4 +1,14 @@
 <?php
+/**
+ * HTTP Router orchestrating middleware and controllers.
+ *
+ * @package   PHP-CRUD-API-Generator
+ * @author    BitsHost
+ * @copyright 2025 BitsHost
+ * @license   MIT License
+ * @link      https://bitshost.biz/
+ * @created   2025-11-12
+ */
 declare(strict_types=1);
 
 namespace App\Application;

src/Auth/Authenticator.php

@@ -1,4 +1,14 @@
 <?php
+/**
+ * Multi-method API Authenticator (API Key, Basic, JWT).
+ *
+ * @package   PHP-CRUD-API-Generator
+ * @author    BitsHost
+ * @copyright 2025 BitsHost
+ * @license   MIT License
+ * @link      https://bitshost.biz/
+ * @created   2025-11-12
+ */
 declare(strict_types=1);
 
 namespace App\Auth;

src/Cache/CacheInterface.php

@@ -1,4 +1,14 @@
 <?php
+/**
+ * Cache driver interface definition.
+ *
+ * @package   PHP-CRUD-API-Generator
+ * @author    BitsHost
+ * @copyright 2025 BitsHost
+ * @license   MIT License
+ * @link      https://bitshost.biz/
+ * @created   2025-11-12
+ */
 
 namespace App\Cache;
 

src/Cache/CacheManager.php

@@ -1,4 +1,14 @@
 <?php
+/**
+ * Cache Manager orchestrating cache keys, TTLs, and drivers.
+ *
+ * @package   PHP-CRUD-API-Generator
+ * @author    BitsHost
+ * @copyright 2025 BitsHost
+ * @license   MIT License
+ * @link      https://bitshost.biz/
+ * @created   2025-11-12
+ */
 
 namespace App\Cache;
 

src/Cache/Drivers/FileCache.php

@@ -1,4 +1,14 @@
 <?php
+/**
+ * File-based cache driver.
+ *
+ * @package   PHP-CRUD-API-Generator
+ * @author    BitsHost
+ * @copyright 2025 BitsHost
+ * @license   MIT License
+ * @link      https://bitshost.biz/
+ * @created   2025-11-12
+ */
 
 namespace App\Cache\Drivers;