PHPackages webfiori/framework - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. webfiori/framework ActiveLibrary[Framework](/categories/framework) webfiori/framework ================== WebFiori framework. Made to make the web bloom. 3.0.1(3w ago)2223.3k1[10 issues](https://github.com/WebFiori/framework/issues)6MITPHPPHP >=8.1 Since Mar 10Pushed 3w ago2 watchersCompare [ Source](https://github.com/WebFiori/framework)[ Packagist](https://packagist.org/packages/webfiori/framework)[ Docs](https://webfiori.com)[ RSS](/packages/webfiori-framework/feed)WikiDiscussions main Synced 1w ago READMEChangelog (10)Dependencies (37)Versions (126)Used By (6) WebFiori Framework ================== [](#webfiori-framework) [![](https://camo.githubusercontent.com/f4abc7aa878a4465db6ab6ae18bbfb7c763af4a6d12d4a379692e0886be589f5/68747470733a2f2f77656266696f72692e636f6d2f6173736574732f696d616765732f66617669636f6e2e706e67)](https://camo.githubusercontent.com/f4abc7aa878a4465db6ab6ae18bbfb7c763af4a6d12d4a379692e0886be589f5/68747470733a2f2f77656266696f72692e636f6d2f6173736574732f696d616765732f66617669636f6e2e706e67) [![](https://github.com/WebFiori/framework/actions/workflows/php85.yml/badge.svg?branch=main)](https://github.com/WebFiori/framework/actions) [ ![](https://camo.githubusercontent.com/6c35bd361555e6ecfe1c0a10c369e8a2ae1e47a21a3b3d063a5ae60053601998/68747470733a2f2f636f6465636f762e696f2f67682f57656246696f72692f6672616d65776f726b2f6272616e63682f6d61696e2f67726170682f62616467652e737667) ](https://codecov.io/gh/WebFiori/framework) [ ![](https://camo.githubusercontent.com/b776519f55b6604740ef45fe0c3eb3f86f7a9161e4d200d9f35e614d9447d24e/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d57656246696f72695f6672616d65776f726b266d65747269633d616c6572745f737461747573) ](https://sonarcloud.io/dashboard?id=WebFiori_framework) [ ![](https://camo.githubusercontent.com/c505861d399dfb82ae5987cdbdb618d6fcd02afc01d9b4a5b94daa39250e6c6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f6672616d65776f726b2e7376673f6c6162656c3d6c6174657374) ](https://github.com/WebFiori/framework/releases) [ ![](https://camo.githubusercontent.com/47652ac58f45fffaa0050edd3beab204a4484f35a9e30327c85ca34ba375d983/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f77656266696f72692f6672616d65776f726b3f636f6c6f723d6c696768742d677265656e) ](https://packagist.org/packages/webfiori/framework) > **Note:** This repo contains the core of the framework. The application template can be found at [`webfiori/app`](https://github.com/webfiori/app). Overview -------- [](#overview) WebFiori is a modular, object-oriented PHP framework designed for building secure web applications and APIs. It provides a complete toolkit — routing, middleware, authorization, database management, job queues, and more — while remaining lightweight and free of heavy external dependencies. Motivation ---------- [](#motivation) WebFiori is designed around two architectural decisions: 1. **Self-contained ecosystem.** Each component (HTTP, database, cache, sessions, mail, queue, CLI, authorization) is an independent library with no external runtime dependencies. This eliminates transitive dependency conflicts and simplifies security auditing. 2. **Interface-driven extensibility.** Storage backends for sessions, cache, queues, and authorization are defined by interfaces. Swap implementations without modifying application code. The framework provides the orchestration layer. The libraries can be used together as a full stack or independently in any PHP project. Requirements ------------ [](#requirements) - PHP 8.1 or later - Extensions: `json`, `mbstring`, `fileinfo`, `openssl` - Composer Supported PHP Versions ---------------------- [](#supported-php-versions) PHP VersionStatus8.1[![](https://github.com/WebFiori/framework/actions/workflows/php81.yml/badge.svg?branch=main)](https://github.com/WebFiori/framework/actions/workflows/php81.yml)8.2[![](https://github.com/WebFiori/framework/actions/workflows/php82.yml/badge.svg?branch=main)](https://github.com/WebFiori/framework/actions/workflows/php82.yml)8.3[![](https://github.com/WebFiori/framework/actions/workflows/php83.yml/badge.svg?branch=main)](https://github.com/WebFiori/framework/actions/workflows/php83.yml)8.4[![](https://github.com/WebFiori/framework/actions/workflows/php84.yml/badge.svg?branch=main)](https://github.com/WebFiori/framework/actions/workflows/php84.yml)8.5[![](https://github.com/WebFiori/framework/actions/workflows/php85.yml/badge.svg?branch=main)](https://github.com/WebFiori/framework/actions/workflows/php85.yml)Quick Start ----------- [](#quick-start) ``` composer create-project webfiori/app my-project cd my-project php -S localhost:8080 -t public ``` Key Features ------------ [](#key-features) ### Routing & HTTP [](#routing--http) - Route groups, URI parameters, and middleware assignment - OpenAPI 3.1 specification generation from annotated controllers ### Security [](#security) - CSRF protection middleware with automatic token injection - CORS middleware with per-route configuration - Rate limiting with configurable windows and trusted IPs - Session encryption at rest (AES-256-GCM) - Maintenance mode with IP allowlisting and Retry-After headers ### Authorization [](#authorization) - Role-Based Access Control (RBAC) with role inheritance - Attribute-Based Access Control (ABAC) with policy evaluation - Database-backed or in-memory storage for roles and permissions - `#[PreAuthorize]` and `#[RequiresAuth]` attributes for declarative access control ### Database [](#database) - Query builder supporting MySQL, MSSQL, and SQLite - Schema migrations with run, rollback, dry-run, fresh, and status commands - Database seeders - Connection management with environment variable resolution ### Middleware [](#middleware) - Priority-based execution with dependency resolution - Before, after, and after-send lifecycle hooks - Middleware groups for bulk assignment to routes - Built-in: session, CSRF, CORS, rate limiting, caching, maintenance mode, authorization ### Job Queue [](#job-queue) - Dispatching with priority and delayed execution - Automatic retry with configurable attempts and backoff - Payload encryption (AES-256-GCM) via environment key - Failed job tracking and retry commands - Pluggable storage backends via `QueueStorage` interface ### Dependency Injection [](#dependency-injection) - Container with `bind()`, `singleton()`, and `instance()` registration - Automatic constructor dependency resolution - Integrated with framework core services ### Task Scheduling [](#task-scheduling) - CRON-based background task execution - Scheduler daemon for development environments - Task arguments and conditional execution ### Observability [](#observability) - Health check system with HTTP endpoint (200/503) - Built-in checks for cache and storage availability - Extensible via `HealthCheckInterface` - Structured file-based logging with daily rotation and level filtering ### Additional Capabilities [](#additional-capabilities) - Internationalization (i18n) with LTR/RTL support - Theming system for multiple UI variants - Programmatic DOM manipulation in PHP - Templated HTML email delivery with attachments - CLI scaffolding commands for controllers, middleware, migrations, and more - Event dispatcher for decoupled application components - Pluggable cache layer with full-response and HTTP caching (ETag/304) - Environment variable resolution in configuration (`env:` prefix) - File upload handling with validation Architecture ------------ [](#architecture) WebFiori is composed of independent, interface-driven packages. Storage backends for sessions, cache, queues, and authorization are pluggable — implement the interface and swap the default. Request lifecycle: **Request → Middleware (before) → Route Dispatch → Middleware (after) → Response → Middleware (afterSend)** Standard Libraries ------------------ [](#standard-libraries) LibraryBuildLatest[HTTP](https://github.com/WebFiori/http)[![](https://github.com/WebFiori/http/actions/workflows/php84.yml/badge.svg?branch=master)](https://github.com/WebFiori/http/actions)[![](https://camo.githubusercontent.com/e78fa3e990f31c36962797564042eb40e5ea1edd45e2de1703658eba16a30d3e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f687474702e737667)](https://github.com/WebFiori/http/releases)[Database](https://github.com/WebFiori/database)[![](https://github.com/WebFiori/database/actions/workflows/php84.yml/badge.svg?branch=main)](https://github.com/WebFiori/database/actions)[![](https://camo.githubusercontent.com/143f84408507c7dc313b4b031a169088d70136dfaea372c72ae49715667514c7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f64617461626173652e737667)](https://github.com/WebFiori/database/releases)[CLI](https://github.com/WebFiori/cli)[![](https://github.com/WebFiori/cli/actions/workflows/php84.yml/badge.svg?branch=main)](https://github.com/WebFiori/cli/actions)[![](https://camo.githubusercontent.com/2070452932f9911f8ec52338027d298a573b18b84451fdf66f69aa067cc5c646/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f636c692e737667)](https://github.com/WebFiori/cli/releases)[Cache](https://github.com/WebFiori/cache)[![](https://github.com/WebFiori/cache/actions/workflows/php84.yml/badge.svg?branch=main)](https://github.com/WebFiori/cache/actions)[![](https://camo.githubusercontent.com/d93f87c1cca7e938605b580da221444c94fcfb59e60d00fc42d8db5079dbd901/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f63616368652e737667)](https://github.com/WebFiori/cache/releases)[UI](https://github.com/WebFiori/ui)[![](https://github.com/WebFiori/ui/actions/workflows/php84.yml/badge.svg?branch=master)](https://github.com/WebFiori/ui/actions)[![](https://camo.githubusercontent.com/7907f59f1cfce2fc5dbd874b2596e1d46636f0e5901e0d8cb154a6cbbee1da47/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f75692e737667)](https://github.com/WebFiori/ui/releases)[Mailer](https://github.com/WebFiori/mail)[![](https://github.com/WebFiori/mail/actions/workflows/php84.yml/badge.svg?branch=main)](https://github.com/WebFiori/mail/actions)[![](https://camo.githubusercontent.com/94dcdb083f7d409d8efd9cf58159d45242c53b15c2b0546452c1d91dfa1ad519/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f6d61696c2e737667)](https://github.com/WebFiori/mail/releases)[File](https://github.com/WebFiori/file)[![](https://github.com/WebFiori/file/actions/workflows/php84.yml/badge.svg?branch=main)](https://github.com/WebFiori/file/actions)[![](https://camo.githubusercontent.com/323e1a66f61c877d3b93c1f9f9e311f5a8b849b1ee4bcae7ea09850f4755c75d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f66696c652e737667)](https://github.com/WebFiori/file/releases)[Json](https://github.com/WebFiori/json)[![](https://github.com/WebFiori/json/actions/workflows/php84.yml/badge.svg?branch=master)](https://github.com/WebFiori/json/actions)[![](https://camo.githubusercontent.com/fbf64710b0bbb25c49636a2c5c8fc20fde5c92f126b4846737bf492fc2f78f70/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f6a736f6e2e737667)](https://github.com/WebFiori/json/releases)[Collections](https://github.com/WebFiori/collections)[![](https://github.com/WebFiori/collections/actions/workflows/php84.yml/badge.svg?branch=master)](https://github.com/WebFiori/collections/actions)[![](https://camo.githubusercontent.com/8a836c357808d8a2f0c86bf0a1c2b44bb49983d564125c7e913490a041626a67/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f636f6c6c656374696f6e732e737667)](https://github.com/WebFiori/collections/releases)[Error Handler](https://github.com/WebFiori/err)[![](https://github.com/WebFiori/err/actions/workflows/php84.yml/badge.svg?branch=main)](https://github.com/WebFiori/err/actions)[![](https://camo.githubusercontent.com/10e8639a1f1b68998be15fd80ebeae2a1db272f9f61fa63cec83a510a24949a2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f6572722e737667)](https://github.com/WebFiori/err/releases)[Container](https://github.com/WebFiori/container)[![](https://github.com/WebFiori/container/actions/workflows/php84.yml/badge.svg?branch=main)](https://github.com/WebFiori/container/actions)[![](https://camo.githubusercontent.com/024ff3835d67ad60c686c2401ece14e9be20003f1e90d5749b95fd8c10b23cfb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f636f6e7461696e65722e737667)](https://github.com/WebFiori/container/releases)[Queue](https://github.com/WebFiori/queue)[![](https://github.com/WebFiori/queue/actions/workflows/php84.yml/badge.svg?branch=main)](https://github.com/WebFiori/queue/actions)[![](https://camo.githubusercontent.com/e22655d0ebefe2e7fae75def43fca70a1b5167c1565484d3e625dce07ba7a4e1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f71756575652e737667)](https://github.com/WebFiori/queue/releases)[Event](https://github.com/WebFiori/event)[![](https://github.com/WebFiori/event/actions/workflows/php84.yml/badge.svg?branch=main)](https://github.com/WebFiori/event/actions)[![](https://camo.githubusercontent.com/8628a18acf46aa350257dac5dbbfe992fa38edad597182e1d0aac84f858ce913/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f6576656e742e737667)](https://github.com/WebFiori/event/releases)[Log](https://github.com/WebFiori/log)[![](https://github.com/WebFiori/log/actions/workflows/php84.yml/badge.svg?branch=main)](https://github.com/WebFiori/log/actions)[![](https://camo.githubusercontent.com/2645f19f579a1cb109b1d898c2092b306504af6582e97545abcd27ceb8bb1c2a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f57656246696f72692f6c6f672e737667)](https://github.com/WebFiori/log/releases)Documentation ------------- [](#documentation) - [Getting Started Guide](https://webfiori.com/learn) - [API Reference](https://webfiori.com/docs) Contributing ------------ [](#contributing) See [CONTRIBUTING.md](https://webfiori.com/contribute) for guidelines. Security -------- [](#security-1) To report security vulnerabilities, please email . See [SECURITY.md](SECURITY.md) for supported versions. License ------- [](#license) MIT — see [LICENSE](LICENSE) for details. ### Health Score 61 — FairBetter than 99% of packages Maintenance85 Actively maintained with recent releases Popularity35 Limited adoption so far Community21 Small or concentrated contributor base Maturity87 Battle-tested with a long release history Bus Factor1 Top contributor holds 99.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~28 days Recently: every ~16 days Total 96 Last Release 25d ago Major Versions v1.1.0-beta-3 → v2.0.0-beta.12020-11-14 v2.4.7 → v3.0.0-RC02022-08-22 PHP version history (3 changes)v1.0.0PHP >=5.6 v3.0.0-RC0PHP >=7.0 3.0.0-Beta.29PHP >=8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/4c25e43acaa22b4fb758a710b69c2ab75947a6642925e3bec9c98196b1f2a433?d=identicon)[usernane](/maintainers/usernane) --- Top Contributors [![usernane](https://avatars.githubusercontent.com/u/12120015?v=4)](https://github.com/usernane "usernane (5675 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (28 commits)")[![ibeladi-mrsool](https://avatars.githubusercontent.com/u/11488356?v=4)](https://github.com/ibeladi-mrsool "ibeladi-mrsool (8 commits)") --- Tags frameworkhacktoberfesthactoberfesthtmlmvcmysqlphpphp-languagerest-apiwebweb-developmentwebfioriwebfiori-frameworkwebsitephpapiframeworkthemeswebfioriWeb APIs ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/webfiori-framework/health.svg) ``` [![Health](https://phpackages.com/badges/webfiori-framework/health.svg)](https://phpackages.com/packages/webfiori-framework) ``` ### Alternatives [digitalstars/simplevk Powerful PHP library/framework for VK API bots, supporting LongPoll & Callback & OAuth 924.7k3](/packages/digitalstars-simplevk)[patricksavalle/slim-rest-api Production-grade REST-API App-class for PHP SLIM, in production on https://zaplog.pro (https://api.zaplog.pro/v1) 101.4k](/packages/patricksavalle-slim-rest-api) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)