ave-cms/help/database/tables.md

Имена таблиц (резолверы)

← Назад к разделу БД

Префиксы у разных доменов данных различаются (контент, системные таблицы админки, таблицы модулей, публичная оболочка), поэтому имя таблицы всегда получают через резолвер, а не пишут строкой. Это даёт правильный префикс и защиту от опечаток.

---

Резолверы

Класс	Домен	Пример результата
App\Content\ContentTables::table($s)	Контент: документы, рубрики, поля	ave_documents
App\Common\SystemTables::table($s)	Системные таблицы админки (по whitelist)	ave_admin_notes
App\Content\ExtensionTables::table($s)	Таблицы ядра контента	ave_todos
App\Content\PublicShellTables::table($s)	Публичная оболочка (сессии и т. п.)	ave_public_sessions

use App\Content\ContentTables;

$t = ContentTables::table('documents');
$rows = DB::query('SELECT * FROM ' . $t . ' WHERE Id = %i', 42)->getAssoc();

---

Валидация суффикса

• ContentTables::table() проверяет суффикс регуляркой ^[a-z0-9_]+$ и бросает исключение при недопустимом имени.
• SystemTables::table() дополнительно сверяет суффикс с whitelist — новую системную таблицу нужно сперва добавить в список разрешённых.

ContentTables::table('documents');       // ok
ContentTables::table('users; DROP …');   // InvalidArgumentException

---

Почему не хардкод

// ПЛОХО — префикс зашит, сломается в другом окружении/домене данных
$rows = DB::query('SELECT * FROM ' . ContentTables::table('documents'))->getAll();

// ХОРОШО — префикс подставит резолвер
$t = ContentTables::table('documents');
$rows = DB::query('SELECT * FROM ' . $t)->getAll();

---

Частый приём: константа таблицы в модели

class Model
{
    public static function documentsTable() { return ContentTables::table('documents'); }
    public static function rubricsTable()   { return ContentTables::table('rubrics'); }

    public static function one($id)
    {
        return DB::query(
            'SELECT d.*, r.rubric_title FROM ' . self::documentsTable() . ' d'
            . ' LEFT JOIN ' . self::rubricsTable() . ' r ON r.Id = d.rubric_id'
            . ' WHERE d.Id = %i',
            (int) $id
        )->getAssoc();
    }
}

Список доступных таблиц контента — в исходниках схемы; системные — в whitelist внутри SystemTables.