gsoftsolutions/gsoft-framework-php

Clean PHP 8.3 micro-framework skeleton for Web/API projects.

v1.0.0 2026-05-31 13:06 UTC

Requires

• php: ^8.3

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

• GSoftSolutions

• framework
• queue
• php
• api
• web
• mvc
• micro-framework
• reports
• jwt
• enterprise
• rest-api

README

Clean PHP 8.3 micro-framework skeleton for Web/API projects.

Setup

cp .env.example .env
composer dump-autoload
php framework migrate
php framework db:seed
composer serve

Included

• MVC/Web/API routing
• Middleware pipeline
• Dependency Injection container
• Service Providers with auto-discovery
• SQL database manager: mysql, pgsql, sqlite, sqlsrv
• NoSQL manager: MongoDB adapter when extension is available
• QueryBuilder with filters, joins, pagination and transactions
• Auth foundation: JWT access/refresh, password reset, email verification
• Configurable cache: file and redis
• Configurable queues: sync, database, redis, rabbitmq, kafka
• Events/listeners
• Logger, request id and request logging
• Mail: log and SMTP
• Storage: local disk
• Audit logging
• Gate/policy authorization
• Report generation with CSV/JSON/HTML exporters and web/API delivery modes
• PHPUnit setup

Reports

Reports are clean by default and must be registered in config/reports.php before they can be generated through HTTP.

Delivery modes are supported for both Web and API:

• inline: open in the browser/new tab with Content-Disposition: inline.
• download: force file download.
• api: return metadata and links to the generated file.

See docs/reports.md for the full report workflow.

Clean application

This project ships without example resources/controllers. Only framework infrastructure, auth infrastructure, migrations, and base providers are included.

PDF reports

The report layer supports csv, json, html and pdf. PDF reports work with web inline preview, browser download and API delivery modes. The built-in PDF exporter is dependency-free and can be replaced by a custom exporter later when advanced layouts are needed.

Testing

The framework includes a ready-to-use testing module with PHPUnit, HTTP helpers, database refresh support and fakes for mail, queue, events and storage. See docs/testing.md.

Enterprise completeness

This package includes health checks, migration lock, config/route cache, idempotency keys, generic webhooks, outbox pattern, queue failure tooling, secrets abstraction, metrics, query profiling, transactions, API resources, OpenAPI generation, API versioning, tenancy and modular domain scaffolding. See docs/enterprise.md and docs/framework-guide.pdf.