Download the PHP package mrpc/pramnosframework without Composer

Pramnos Framework v1.2

Pramnos Framework is a comprehensive PHP MVC framework designed for building robust, scalable web applications. The v1.2 release brings major infrastructure improvements, a complete ORM layer, advanced API support, and enhanced developer experience.

📖 Full documentation: mrpc.github.io/PramnosFramework

Released: July 2026
Minimum PHP Version: 8.1
Database Support: MySQL 8.0+, PostgreSQL 17+, TimescaleDB 2.26.4+

The suite runs against MySQL 8.0, PostgreSQL 17 and TimescaleDB 2.26.4 — the TimescaleDB floor being the newest package installable on Debian 11, which is where a real deployment found three migrations failing that every latest run had passed. PostgreSQL 14 worked in every test up to the day the lane moved to 17 and is very likely still fine; it is simply no longer verified here, and an unverified claim is not a supported version.

🚀 What's New in v1.2?

Database & Query Layer

• Read/Write Replicas — Automatic routing of queries to primary and replica connections
• Connection Health & Auto-reconnect — Transparent reconnection on dropped connections
• DML Query Builder — Fluent interface for SELECT, INSERT, UPDATE, DELETE with dialect support
• DDL Schema Builder — Programmatic schema definition with support for migrations
• DatabaseCapabilities — Runtime detection of database features (TimescaleDB, JSON, spatial, etc.)
• timeBucket() & Time Series Support — Dialect-transparent time bucketing for TimescaleDB/PostgreSQL

Infrastructure & Architecture

• Complete ORM — Models with relationships, scopes, and casting
• Migration System v2 — Framework-managed migrations with auto-run, versioning, and rollback
• Service Providers — Application bootstrap and dependency injection
• Feature Registry — Declarative feature management and wiring
• Policy Engine — Authorization framework with condition-based access control
• Middleware Pipeline — Request/response filtering with composable middleware
• Health Check System — Built-in application health monitoring and diagnostics

API & Web Features

• PSR Compliance Layer — PSR-7/PSR-15 compatibility for interoperability
• Modern Routing — Attribute-based routing with parameter binding and groups
• REST API Framework — Scaffolding and conventions for API-first development
• Database-Driven CORS — Configuration stored in database with runtime validation
• Response Object — Formal HTTP response abstraction
• HTTP Testing Infrastructure — Built-in testing helpers for API/web testing

Security Enhancements

• CSRF Hardening — Strengthened token validation with session binding
• Session Cookie Hardening — Secure cookie attributes and regeneration
• View Escaping Helpers — Safe output escaping with context-aware strategies
• OAuth2 Server — Full OAuth2 authorization server implementation
• 2FA/TOTP — Two-factor authentication and time-based one-time passwords
• Login Lockout — Brute-force protection with exponential backoff

Developer Experience

• Scaffolding System — Generate controllers, views, models, tests with smart defaults
• Rich CLI — Comprehensive command-line tools with progress reporting
• MCP Server — AI-powered developer assistance (Claude/ChatGPT integration)
• Enhanced DebugBar — Migrations, request timeline, cache tracking, and profiling
• Form Requests — Validation-focused request objects with automatic routing
• Notification Channels — Email, database, and webhook notifications
• Admin CRUD Generators — Automatic admin interfaces for database tables

Database Features

• Window Functions — RANK(), ROW_NUMBER(), LAG/LEAD support across MySQL 8+ and PostgreSQL
• CTEs & Subqueries — Common Table Expressions with with() and subquery builders
• Set Operations — UNION/UNION ALL with type coercion
• Upsert Operations — INSERT...ON DUPLICATE KEY / INSERT...ON CONFLICT
• Aggregate Functions — COUNT, SUM, AVG, MIN, MAX with proper cloning

📚 Documentation

The full documentation is available as a live site at mrpc.github.io/PramnosFramework.

Running the docs locally (Docker required)

No local Python or pip installation is required — everything runs inside Docker.

Getting Started

• Installation & Setup - Quick start guide for new projects
• v1.2 New Features Reference - Comprehensive feature documentation (implementation reference)

Core Guides by Topic

Database & ORM

• Database API Guide - Legacy Database::query() API and patterns
• DML Query Builder Guide - Fluent query construction for SELECT/INSERT/UPDATE/DELETE (new in v1.2)
• DDL Schema Builder Guide - Programmatic schema definition (new in v1.2)
• ORM Guide - Model definition, relationships, scopes, and casting (new in v1.2)
• Migration System Guide - Database versioning and auto-run system (new in v1.2)

Web & API

• Framework Guide - Controllers, views, and MVC architecture
• REST API Guide - Building and deploying REST APIs (updated for v1.2)
• Routing Guide - Modern attribute-based routing (new in v1.2)
• Response & Status Guide - HTTP response abstraction (new in v1.2)

Authentication & Security

• Authentication Guide - Authentication drivers, session management, OAuth2
• Authorization & Policies Guide - Policy engine and access control (new in v1.2)
• Security Best Practices - CSRF, XSS, injection prevention, and hardening (new in v1.2)

Backend & Infrastructure

• Console Commands Guide - Building and running CLI commands
• Service Providers Guide - Application bootstrap and dependency injection (new in v1.2)
• Health Check Guide - Monitoring and diagnostics (new in v1.2)
• Scheduled Tasks Guide - Background job scheduling (new in v1.2)
• Queue System Guide - Asynchronous job processing

Developer Tools

• Logging System Guide - Structured logging and analytics
• Caching Guide - Query, data, and application-level caching
• Testing Guide - HTTP tests, factories, seeders (updated for v1.2)
• Scaffolding Guide - Code generation tools (new in v1.2)
• DebugBar Guide - Development profiling and debugging (updated for v1.2)

Content & UI

• Theme System Guide - Template system, widgets, and theming
• Document & Output Guide - Multi-format output (HTML, PDF, JSON, etc.)
• Validation Guide - Form validation and custom rules
• Internationalization Guide - Multi-language support
• Email Guide - Email delivery and templates
• Media & Storage Guide - File uploads and storage abstraction (updated for v1.2)
• Environment Variables Guide - Configuration management

Requirements

• Docker and Docker Compose (Recommended for development)
• PHP 8.1 or higher (if running natively). Development and CI run PHP 8.5.
• ext-mbstring
• ext-mysqli (MySQL) and/or ext-pgsql (PostgreSQL / TimescaleDB)
• ext-sodium, for encrypting stored credentials (bundled with PHP 8 and enabled by default)
• Optional: Redis/Memcached for caching

The database layer talks to mysqli and pgsql directly — not through PDO. ext-pdo is neither used nor required, and prepareInput() now refuses to escape a value rather than fall back to something charset-unaware, so a missing driver extension fails loudly instead of half-working.

Installation

The recommended way to start a new project is using the Pramnos Application, which provides a one-line setup experience:

Alternatively, you can manually add the framework as a dependency to an existing project:

The init command will guide you through the setup with smart defaults (e.g., automatic namespace generation and database naming).

✨ Key Features

🏗️ Architecture

• MVC Design Pattern - Clean separation of concerns
• Component-Based - Modular and reusable components
• Namespace Support - PSR-4 compliant autoloading
• Factory Pattern - Centralized object creation and management

🔐 Authentication & Security

• JWT Token Support - Secure token-based authentication
• Session Management - Robust session handling with multiple storage backends
• Permission System - Granular access control and user permissions
• OAuth2 Support - Built-in OAuth2 server capabilities
• CSRF Protection - Request validation and security
• Nonce-based CSP - Automatic Content Security Policy with per-request nonces

💾 Database & Caching

• Database Abstraction - Support for MySQL, PostgreSQL
• Query Builder - Secure parameterized queries with printf-style formatting
• Multiple Cache Backends - Redis, Memcached, File-based caching
• Database Migrations - Version-controlled database schema changes
• Connection Pooling - Efficient database connection management

🌐 Web Features

• RESTful Routing - Flexible URL routing with parameter binding
• API Framework - Built-in REST API support with versioning
• Multiple Output Formats - JSON, XML, HTML, PDF, RSS
• Theme System - Pluggable theming with template inheritance
• Multilingual Support - Complete internationalization framework

🛠️ Developer Tools

• Console Commands - Code generators and maintenance tools
• Logging System - Structured logging with multiple handlers
• Debug Tools - Built-in debugging and profiling utilities
• Testing Support - PHPUnit integration and test helpers

📦 Additional Components

• Media Handling - Image processing and file management
• Email System - SMTP support with template rendering
• Geolocation - Geographic utilities and distance calculations
• HTML Utilities - Form builders, datatables, and UI components

Directory Structure

🚀 Quick Start

Basic Application Setup

Creating Your First Controller

Database Operations

Console Commands

The framework includes powerful console commands for development. If using Docker, run these via docker-compose exec php-apache-environment ....

🏗️ Architecture Overview

Framework Components

Configuration Structure

🔧 Configuration

Database Configuration

Cache Configuration

Application Configuration

🌟 Advanced Features

Custom Authentication Addon

API Controller Example

Custom Cache Usage

📄 Documentation

🌐 All of the guides below are also published as a searchable site at mrpc.github.io/PramnosFramework.

The framework includes comprehensive documentation for all major subsystems:

Core System Documentation

• Framework Guide - Core framework architecture and concepts
• Database API Guide - Database operations and query building
• Authentication Guide - User authentication and session management
• Cache System Guide - Caching strategies and implementation
• Console Guide - Command-line interface and console commands

Feature Documentation

• Logging Guide - Logging system and debugging tools
• Document & Output Guide - Document generation and output management
• Theme System Guide - Theming, templates, and UI customization
• Email System Guide - Email sending, templates, and tracking
• Media System Guide - File uploads, image processing, and media management
• Internationalization Guide - Multi-language support and localization

📄 License

MIT License - see the LICENSE.txt file for details.

👨‍💻 Author

Yannis - Pastis Glaros
Email: [email protected]

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

The framework includes a fully containerized development and testing environment.

1. Clone the repository:

2. Start the Docker environment:

   This will start PHP 8.5 (for testing), MySQL, PostgreSQL/TimescaleDB, and Redis.

3. Install dependencies and initialize:

4. Run tests:

Guidelines

• Core framework code (src/Pramnos/) targets PHP 8.1 (composer.json's floor) and is developed and tested on PHP 8.5.
• Tests (tests/) run on the same PHP 8.5 and use modern PHP features freely.
• Follow PSR-4 autoloading standards.
• Write tests for new features using PHPUnit 11 with native attributes.
• Update documentation when adding features.

If you are developing the framework and want to test the full "new project" experience locally, you can use this one-liner (adjust APP_NAME and the path to PramnosFramework as needed):

🆘 Support

• Documentation: Check the docs/ directory
• Issues: Submit issues on the project repository
• Community: Join our community discussions