---
name: feedback-naming-phpdoc
description: Правила именования PHP (snake_case переменные, camelCase методы, PascalCase классы) и обязательный PHPDoc везде
metadata:
  type: feedback
---

В проекте Bicycle соблюдать конвенции именования и документирования PHP:

- **Переменные** — `$snake_case`, имена понятные и отражающие, что в них хранится (не `$x`, `$tmp`).
- **Функции/методы** — `camelCase`, с маленькой буквы, имена понятные (`getResponse`, `detectUri`, `isAjax`).
- **Классы** — `PascalCase` (CamelCase с большой буквы).
- **PHPDoc** — писать везде: на классах, методах (с `@param`/`@return`/`@throws`) и свойствах.

**Why:** Пользователь явно задал эти правила и попросил исправить весь код под них.

**How to apply:** При создании или правке любого PHP-кода сразу применять эти правила без напоминаний. Исключение: классы `HTTPException_302/403/404` намеренно содержат суффикс `_код` — это load-bearing паттерн для `HTTPException::factory()`, не переименовывать. Связано с [[feedback-update-claude-md]] и [[project-bicycle-overview]].