pimcore-studio-backend-code-style

name	pimcore-studio-backend-code-style
description	Pimcore Studio PHP code style rules — strict types, class modifiers, final/readonly patterns, formatting (120 chars), named arguments, imports, PHPDoc, @throws documentation, and constructor promotion
metadata	{"audience":"pimcore-developers","focus":"backend"}

Architecture Context

The StudioBackendBundle uses a layered architecture: Controllers (HTTP only) -> Services (business logic) -> Hydrators (DTO creation). Events provide extension points. All APIs are OpenAPI-documented.

These code style rules apply to ALL PHP code written for Studio bundles.

---

Strict Types

Every PHP file starts with:

<?php
declare(strict_types=1);

---

Class Modifiers

Class Type	Modifier	Why
Service implementation	final readonly class	No inheritance, immutable after construction
Hydrator implementation	final readonly class	Same
Controller	final class	Cannot be readonly (extends AbstractApiController with mutable state)
Response/Parameter DTO	final class or final readonly class	final class when using (has mutable array); for parameter-only DTOs