18 lines
1.5 KiB
Markdown
18 lines
1.5 KiB
Markdown
---
|
||
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]].
|