Winter Boot: PHP Microservices Framework Documentation

Welcome to the Winter Boot documentation. Winter Boot is a modern PHP 8 microservices framework inspired by Spring Boot, bringing attribute-driven dependency injection, AOP, REST routing, async task execution, caching, transactions, and scheduling to the PHP ecosystem. Whether you know Spring Boot or are starting fresh, these docs cover everything you need to build, configure, and deploy production-ready PHP microservices.

Quick StartInstall Winter Boot, create your first service and REST controller, and have a running HTTP server in minutes.

Core ConceptsUnderstand the application context, bean lifecycle, dependency injection, and AOP weaving that power every Winter Boot service.

Web & RESTMap HTTP routes with #[RestController], handle path variables and request bodies, and return typed ResponseEntity objects.

Data AccessConnect datasources, run schema migrations, and manage transactions declaratively with #[Transactional].

Async & SchedulingOffload work to background workers with #[Async] and run recurring jobs at fixed intervals with #[Scheduled].

OperationsAdd caching, distributed locking, structured logging, Prometheus metrics, and OpenTelemetry tracing to your services.

What a Winter Boot service looks like

A service is a plain PHP class with attributes. The framework finds it at startup, wires its dependencies, and serves its routes from the built-in HTTP server:

src/HelloController.php

#[RestController]
class HelloController
{
    #[Autowired]
    private HelloService $helloService;

    #[GetMapping(path: '/api/hello')]
    public function hello(#[RequestParam(required: false)] string $name = 'World'): ResponseEntity
    {
        return ResponseEntity::ok()->withJson([
            'message' => $this->helloService->sayHello($name),
        ]);
    }
}

Ready to build one? Start with Installation, then follow the Quickstart to get a live endpoint running in a few minutes.