Skip to content

Commit 22c9c0c

Browse files
author
Ibrahim BinAlshikh
committed
docs: add Motivation section to README
1 parent 806aaf5 commit 22c9c0c

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,16 @@
2626

2727
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.
2828

29+
## Motivation
30+
31+
WebFiori is designed around two architectural decisions:
32+
33+
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.
34+
35+
2. **Interface-driven extensibility.** Storage backends for sessions, cache, queues, and authorization are defined by interfaces. Swap implementations without modifying application code.
36+
37+
The framework provides the orchestration layer. The libraries can be used together as a full stack or independently in any PHP project.
38+
2939
## Requirements
3040

3141
- PHP 8.1 or later

0 commit comments

Comments
 (0)