README

• A trifle; an insubstantial thing.
• (literature, music) A short piece of literature or of instrumental music, typically light or playful in character.

― bagatelle - Wiktionary, the free dictionary
(Named in contrast to Symfony)

Introduction

Bagatelle is an opinionated PHP boilerplate bundle for simple websites and APIs. It bundles and pre-configures common components from the PHP ecosystem, making it easy to get started while having full control of all the details.

Contents

Bagatelle centers around Symfony's HttpKernel, Routing, EventDispatcher and Console packages for building web and CLI applications.

Well known packages Monolog (PSR-3 logging), PHP-DI (PSR-11 dependency injection container), Twig (templating engine), phpdotenv (environment variables) and nyholm/psr7 (HTTP messages) are bundled and preconfigured as well.

A basic but functional implementation for adding middleware to routes and controllers along with CORS support is also included.

Additionally, a Docker image based on FrankenPHP is ready for development and production use-cases.

Get Started

Create project

Create a new application based on Bagatelle (replace "my-project" with your name of choice):

composer create-project tthe/bagatelle my-project

Run application

When developing you can either use PHPs built-in development server:

php -S localhost:8080 -t public

or using Docker:

docker compose up -d

# or, for production config (using port 80):
SERVER_NAME="your-domain.com" docker compose -f compose.yaml -f compose.prod.yaml up

Both development servers will start your Bagatelle-based application at localhost:8080.

The console application is executed using:

php bin/console.php

Documentation

• HttpKernel and Request/Response Lifecycle
• Routing (only parts related to the #[Route] attribute are relevant)
• HttpFoundation and PSR-7: HTTP message interfaces for HTTP messages
• The Dependency Injection Container
• Console Commands