ALBIREO CMS
version: 2025.07.15
© Albireo CMS, 2020-2025

Константы Albireo CMS

Переопределение констант

Albireo CMS задаёт основные константы в момент запуска и инициализации системы. В основном это формирование путей к каталогам и корректные url-адреса.

При необходимости можно переопределить эти константы. Сделать это можно несколькими способами.

  1. Файл website/constants.php — это самое раннее определение констант.
  2. Файл website/myconstants.php — это самое позднее определение констант, где доступны другие.
  3. Файл website/base-constants.php — это определение констант перед основными.

В большинстве случаев будет удобно использовать файл website/base-constants.php.

Пример такого файла:

<?php
# base-constants.php

// отладка-профилирование для LOCALHOST
if (LOCALHOST) define('DEBUG_BENCHMARK', '');

// каталог шаблонов на уровне выше
define('TEMPLATES_DIR', LEVEL_UP_DIR . 'templates' . DIRECTORY_SEPARATOR);
define('TEMPLATES_URL', LEVEL_UP_URL . 'templates/');
ВАЖНО! В константах используются пути с закрывающимся слэшем и учетом используемой системы (Windows/Linux). Поэтому используйте DIRECTORY_SEPARATOR в качестве корректного разделителя.

Использование констант

Старайтесь использовать константы, вместо сложных путей.

Например вместо 'website/templates/default/parts/head/rss.php' лучше сделать так TEMPLATE_PARTS_DIR. 'head/rss.php'

Во многих функциях Albireo CMS нужно указывать полные пути к файлам. Поэтому константы позволяют сделать это просто и удобно, например:

// TPL_DIR — это каталог website/templates/default/tpl
echo tpl(data: $rows['files'], tpl: TPL_DIR . 'shorts.php');

Список констант Albireo CMS

Ниже приведен список констант (и их дефолтное значение). Те константы, которые отмечены как Нельзя переопределить формируются динамически.

  • RUN_IS_ROOT = true Признак того, что сайт запущен из-под корня сайта. Нельзя переопределить
  • FRONT_NAME = website Имя каталога сайта пользователя. Задаётся в корневом index.php.
  • BASE_DIR = путь на сервере Полный путь на сервере к каталогу пользователя. Нельзя переопределить
  • LEVEL_UP_DIR = путь на сервере Полный путь к каталогу уровнем выше, чем каталог пользователя. Нельзя переопределить
  • LEVEL_UP_URL = url-адрес URL уровнем выше, чем основной каталог сайта (website). Нельзя переопределить
  • SYS_DIR = путь на сервере Полный путь на сервере к системному каталогу system.
  • TIME_START = метка времени Начальная метка времени для оценки скорости работы сайта. Нельзя переопределить
  • SITE_URL = url-адрес Полный адрес сайта.
  • SITE_HOST = хост Хост сайта (без протокола).
  • FRONT_URL = url-адрес Адрес-url к FRONT_NAME.
  • FRONT_URL_NAME = хост FRONT_URL без протокола.
  • PAGES_DIR = путь на сервере Полный путь на сервере к каталогу pages.
  • PAGES_URL = url-адрес Полный адрес к каталогу pages.
  • TEMPLATES_DIR = путь на сервере Полный путь на сервере к каталогу templates.
  • TEMPLATES_URL = url-адрес Полный адрес к каталогу templates.
  • SERVICE_DIR = путь на сервере Полный путь на сервере к каталогу service.
  • SERVICE_URL = url-адрес Полный адрес к каталогу service.
  • RESOURCES_DIR = путь на сервере Полный путь на сервере к каталогу _resources.
  • RESOURCES_URL = url-адрес Полный адрес к каталогу _resources.
  • UPLOADS_DIR = путь на сервере Полный путь на сервере к каталогу uploads.
  • UPLOADS_URL = url-адрес Полный адрес к каталогу uploads.
  • TEMPLATE_DIR = путь на сервере Полный путь на сервере к каталогу шаблона. Нельзя переопределить
  • TEMPLATE_URL = url-адрес Полный адрес к каталогу шаблона. Нельзя переопределить
  • ASSETS_DIR = путь на сервере Полный путь на сервере к каталогу шаблона assets. Нельзя переопределить
  • ASSETS_URL = url-адрес Полный адрес к каталогу шаблона assets. Нельзя переопределить
  • TEMPLATE_MODULES_DIR = путь на сервере Полный путь на сервере к каталогу шаблона modules. Нельзя переопределить
  • TEMPLATE_LAYOUT_DIR = путь на сервере Полный путь на сервере к каталогу шаблона layout. Нельзя переопределить
  • TEMPLATE_PARTS_DIR = путь на сервере Полный путь на сервере к каталогу шаблона parts. Нельзя переопределить
  • TPL_DIR = путь на сервере Полный путь на сервере к каталогу шаблона tpl. Нельзя переопределить
  • TEMPLATE_SNIPPETS_DIR = путь на сервере Полный путь на сервере к каталогу шаблона snippets. Нельзя переопределить
  • EXTRAS_DIR = путь на сервере Полный путь на сервере к каталогу шаблона extras. Нельзя переопределить
  • CACHE_DIR = путь на сервере Полный путь на сервере к каталогу cache.
  • BACKUP_DIR = путь на сервере Полный путь на сервере к каталогу backup.
  • EVENTS_DIR = путь на сервере Полный путь на сервере к каталогу events.
  • STORAGE_DIR = путь на сервере Полный путь на сервере к каталогу storage.
  • SEEDER_DIR = путь на сервере Полный путь на сервере к каталогу seeder.
  • SESSIONS_DIR = путь на сервере Полный путь на сервере к каталогу сессий (лучше не использовать!).
  • CONFIG_DIR = путь на сервере Полный путь на сервере к каталогу config.
  • SNIPPETS_DIR = путь на сервере Полный путь на сервере к каталогу snippets.
  • WIDGETS_DIR = путь на сервере Полный путь на сервере к каталогу system/widgets.
  • WIDGETS_DIR_SITE = путь на сервере Полный путь на сервере к каталогу service/widgets.
  • COMPOSER_DIR = путь на сервере Полный путь на сервере к каталогу vendor.
  • REQUEST_AJAX = url-адрес Адрес для отправки AJAX-запросов.
  • METHOD_AJAX = строка Содержит method = _ajax. Нельзя переопределить
  • ALBIREO_ADMIN_NAME = admin Каталог админ-панели. Нельзя переопределить
  • ALBIREO_ADMIN_URL = url-адрес Адрес админ-панели. Нельзя переопределить
  • ALBIREO_ADMIN_DIR = путь на сервере Полный путь на сервере к админ-панели. Нельзя переопределить
  • ALBIREO_ADMIN_LINK_EDIT_FILE = url-адрес Базовая ссылка на админ-страницу редактирования файла. Нельзя переопределить
  • LOCALHOST = true/false Если это 127.0.0.1. Нельзя переопределить
  • LF = \n Перевод строки
  • APOS = ' Одиночная кавычка
  • BSOL = \ Обратный слэш