Albireo CMS 2025.06.08

Установка Albireo CMS

Для установки Albireo CMS достаточно загрузить файлы из полученного архива на свой сервер.

Архив состоит из:

system/
website/
index.php
  • Каталог system хранит системные файлы ядра, а также файл лицензии. Вам не нужно в нём ничего менять.
  • Каталог website — хранит все файлы вашего сайта. Это ваш рабочий каталог.
  • Файл index.php — это входящий файл вашего сайта.

После загрузки файлов на сервер, наберите в браузере ваш-сайт/index.php. В основном каталоге должен появится файл .htaccess, который отвечает за организацию адресов ЧПУ («человеко понятный УРЛ»). Если файл не появился или возникли какие-то сложности, то файл можно создать вручную на основе каркаса: system/install/htaccess.txt.

Если уже есть .htaccess, то система его не будет менять — вам нужно будет переименовать старый .htaccess, потом зайти на сайт и система создаст новый .htaccess.

На некоторых хостингах файл .htaccess также служит для указания версии PHP. В этом случае вам лучше вначале создать .htaccess согласно правил хостинга, а потом добавить в него ниже код из system/install/htaccess.txt. Помните, что требуется минимальная версия PHP 8.3.

Если вы используете не сервер Apache, а какой-то другой, то нужно чтобы сервер все обращение отправлял на корневой index.php. Используйте system/install/htaccess.txt в качестве образца.

Изменение рабочего каталога сайта

Вы можете изменить имя каталога сайта с website на любое другое, например my. Для этого просто переименуйте website, а потом укажите его в корневом index.php в строчке:

// имя каталога web-сайта
define('FRONT_NAME', 'website'); 

на

// имя каталога web-сайта
define('FRONT_NAME', 'my'); 

Каталог основного сайта должен иметь имя, которое не будет использоваться в адресах страниц сайта, потому что для посетителя это одно и тоже, а для сервера это уже реальный каталог.

Мультисайтинг. Создание «подсайтов»

Например ваш сайт mysite.com. Когда происходит обращение по этому адресу, то система автоматически подключит сайт, указанный в FRONT_NAME (по умолчанию это website). Если вам нужен ещё один сайт, например mysite.com/blog, то вам нужно сделать копию каталога website как каталог blog. Больше ничего нигде указывать не нужно.

При первом обращении к mysite.com/blog в нём появится файл .htaccess, как и в корне сайта, только будет уже учитываться путь к blog.

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

Если вы используете несколько сайтов на одном ядре, то возможно вам будет удобней использовать и общий каталог шаблонов. По умолчанию он расположен в website/templates. Вы можете вынести его в корень своего сайта, а потом создать файл base-constants.php в каталоге каждого своего сайта, например website/base-constants.php, blog/base-constants.php и т.п.

<?php
// каталог шаблонов на уровень выше
define('TEMPLATES_DIR', LEVEL_UP_DIR . 'templates' . DIRECTORY_SEPARATOR);
define('TEMPLATES_URL', LEVEL_UP_URL . 'templates/');

# end of file

Избегайте смешивания протоколов http и https

Albireo CMS автоматически определяет протокол сайта и может работать с любым из них. Но учитывайте, что одновременная работа и по http и по https может вызывать некоторые проблемы. На уровне системы адреса хранятся в полном виде, включая протокол. Если смешать протоколы, то часть данных окажется недоступна, поскольку это будут другие адреса страниц. Например это может привести к неотображению части комментариев, хотя все они будут находиться в базе.

Чтобы исключить подобные ситуации, лучше сделать автоматический редирект с http-адресов на https. В файле .htaccess уже есть готовый для этого код (нужно убрать комментарии в исходном файле):

# for 301-redirect http to https
RewriteCond %{HTTPS} !=on
RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI} [R=301,QSA,L] 

После этого желательно обновить кэш сайта. Для этого вы можете изменить файл любой страницы — Albireo CMS автоматически перестроит кэш. Или вручную удалить файл website/service/storage/filesinfo.sqlite.