# Berlioz Framework

> Berlioz is a slim, lightweight PHP framework for building websites, intranets, APIs, CLI tools and web applications.

## Overview

Berlioz Framework is an open-source PHP framework (MIT license) designed for simplicity, modularity and performance. It follows PSR standards (PSR-4, PSR-7, PSR-11, PSR-12, PSR-14, PSR-15, PSR-16, PSR-17, PSR-18) and provides a full-featured stack: dependency injection with auto-wiring, attribute-based routing, middleware pipeline, Twig templating, HTTP client, mailer, queue processing, and a modular package architecture.

## Key Features

- **Lightweight & Modular**: Minimal footprint, each component is a standalone package usable independently
- **PSR Compliant**: Built on PSR-4 (Autoloading), PSR-7 (HTTP Messages), PSR-11 (Container), PSR-12 (Coding Style), PSR-14 (Event Dispatcher), PSR-15 (HTTP Handlers), PSR-16 (Simple Cache), PSR-17 (HTTP Factories), PSR-18 (HTTP Client)
- **Dependency Injection**: Service container with auto-wiring, service providers, and inflectors
- **Attribute Routing**: PHP 8 attribute-based route definitions with regex parameters and optional segments
- **Middleware Pipeline**: PSR-15 middleware stack (Russian doll pattern)
- **Twig Templating**: Full Twig integration with custom extensions
- **Event System**: PSR-14 event dispatcher with listeners and subscribers
- **HTTP Client**: PSR-18 client with cURL/stream adapters, sessions, retry and redirect handling
- **Mailer**: Email sending via SMTP or PHP mail
- **Queue Processing**: Background job processing with multiple backends (AMQP, Redis, SQS, database)
- **Form Handling**: HTML forms with validation, hydration, transformation and PSR-7 integration
- **CLI Support**: Console application framework with attribute-based argument declaration
- **PHP Compatibility**: PHP 8.2 to 8.5+

## Quick Start

```shell
composer create-project berlioz/website-skeleton my-project --remove-vcs
```

## Packages

- **berlioz/core**: Framework kernel with configuration, service container, and package lifecycle management
- **berlioz/router**: HTTP routing with attribute-based route definitions, regex parameters, and optional segments
- **berlioz/http-core**: HTTP application with PSR-15 middleware pipeline and controller handling
- **berlioz/http-message**: PSR-7/PSR-17 HTTP messages and factories implementation
- **berlioz/http-client**: PSR-18 HTTP client with cURL/stream adapters, sessions, retry and redirect support
- **berlioz/config**: Multi-source configuration (JSON, YAML, INI) with priority merging and dynamic interpolation (env, config, var, constant, file)
- **berlioz/service-container**: PSR-11 dependency injection container with auto-wiring and service providers
- **berlioz/event-manager**: PSR-14 event dispatcher with listener and subscriber providers
- **berlioz/mailer**: Email sending via SMTP or PHP mail with strategy pattern transports
- **berlioz/form**: HTML form handling with composite element tree, collectors, validators, hydrators and PSR-7 integration
- **berlioz/flash-bag**: Session-backed flash messages with consume-on-read semantics
- **berlioz/html-selector**: CSS selector queries on HTML documents via CSS-to-XPath translation
- **berlioz/queue-manager**: Background job processing with multiple backends (AMQP, Redis, SQS, database, memory)
- **berlioz/cli-core**: CLI application framework with attribute-based argument declaration
- **berlioz/twig-package**: Twig template engine integration package
- **berlioz/hector-package**: Hector ORM integration package
- **berlioz/queue-manager-package**: Queue manager integration package

## Documentation

- [Version 3.x](https://getberlioz.com/docs/3.x/)
- [Version 2.x](https://getberlioz.com/docs/2.x/)
- [Version 1.x](https://getberlioz.com/docs/1.x/)

## Links

- Documentation: https://getberlioz.com
- Source Code: https://github.com/BerliozFramework/Berlioz
- Packagist: https://packagist.org/packages/berlioz/berlioz
- License: MIT (https://spdx.org/licenses/MIT)