ADR-006: Дизайн API

Статус

Принято

Контекст

XOOPS должна предоставить стабильный и предсказуемый API для разработчиков модулей.

Решение

Используйте классы, методы и соглашения об именовании, которые соответствуют PHP стандартам.

Обоснование

• Предсказуемость API
• Легкость изучения
• Совместимость с инструментами
• Лучший код IDE

Соглашения

Тип	Соглашение	Пример
Классы	PascalCase	XoopsUser
Методы	camelCase	getVar()
Свойства	camelCase	$userId
Константы	UPPER_CASE	XOBJ_DTYPE_INT

Примеры

class XoopsUser extends XoopsObject
{
    public function getVar(string $key): mixed
    {
        // Реализация
    }
}

---

API дизайн обеспечивает стабильность и предсказуемость интерфейса.