LimageCMS

Расширенная инструкция по установке LimageCMS

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

Я бы оформил её так — более подробно, чем пользовательскую, но без лишней воды.

Установка LimageCMS — расширенная инструкция

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

Если вам не требуется ручная настройка сервера, используйте простую инструкцию по установке LimageCMS.

1. Требования к серверу

Для работы LimageCMS требуется:

  • PHP 8.1 или выше;
  • MySQL или MariaDB;
  • веб-сервер Apache или Nginx;
  • доступ PHP к базе данных;
  • возможность записи PHP в необходимые каталоги сайта.

PHP

Необходимые расширения PHP:

  • pdo_mysql — для подключения к MySQL/MariaDB;
  • curl — для сетевых запросов;
  • sodium — для криптографических операций.

Проверить установленную версию PHP можно командой:

php -v

Список загруженных расширений:

php -m

Проверка конкретных расширений:

php -m | grep -E 'pdo_mysql|curl|sodium'

Все три расширения должны присутствовать в результате.

2. Требования к базе данных

LimageCMS работает с:

  • MySQL;
  • MariaDB.

Для таблиц используется InnoDB.

Основная кодировка базы и таблиц — utf8mb4.

На большинстве современных хостингов эти параметры доступны по умолчанию.

Права пользователя базы данных

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

В частности, требуются права:

CREATE CREATE TABLE ALTER INDEX INSERT UPDATE DELETE

На обычном хостинге проще всего предоставить пользователю базы полные права на используемую базу:

ALL PRIVILEGES

Это позволяет установщику самостоятельно создать необходимую структуру базы данных.

3. Подготовка базы данных

Перед установкой необходимо создать базу данных и пользователя.

Например:

Имя базы: limagecms Пользователь: limagecms Пароль: ******** Сервер: localhost

Конкретные названия не имеют значения.

Важно

База данных, используемая для новой установки, должна быть пустой.

Если в базе уже присутствуют таблицы LimageCMS, установщик не будет устанавливать CMS поверх существующей установки. Это сделано для защиты существующих данных от случайного перезаписывания.

4. Загрузка файлов LimageCMS

Загрузите файлы CMS на сервер.

Это можно сделать через:

  • файловый менеджер хостинга;
  • FTP;
  • SFTP;
  • SCP;
  • другой доступный способ передачи файлов.

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

index.php

Например:

/var/www/limagecms/

Внутри него должны находиться файлы и каталоги LimageCMS.

После настройки виртуального хоста обращение:

https://example.ru/

должно попадать в эту директорию.

5. Настройка Apache

Для Apache необходимо обеспечить корректную обработку адресов LimageCMS.

LimageCMS использует маршрутизацию через основной файл:

index.php

Поэтому Apache должен поддерживать правила .htaccess.

В типичной конфигурации необходимо убедиться, что используется модуль:

mod_rewrite

Проверить его наличие можно:

apache2ctl -M | grep rewrite

В результате должно присутствовать:

rewrite_module

Если модуль не включён, на Debian/Ubuntu его можно включить:

sudo a2enmod rewrite

После изменения конфигурации:

sudo systemctl restart apache2

Проверка конфигурации Apache

Перед перезапуском рекомендуется выполнить:

sudo apache2ctl configtest

Ожидаемый результат:

Syntax OK
6. Настройка Nginx

LimageCMS также может работать за Nginx.

В этом случае необходимо обеспечить передачу запросов на основной файл приложения:

index.php

Конкретная конфигурация зависит от используемой схемы PHP-FPM и настроек сервера.

Основной принцип:

Запрос пользователя ↓ Nginx ↓ index.php ↓ LimageCMS

При использовании Nginx необходимо самостоятельно настроить обработку PHP и перенаправление маршрутов приложения.

7. Права на файлы

Веб-сервер должен иметь возможность записывать данные в каталоги, используемые CMS.

В частности, запись необходима для:

storage/ uploads/

а также для создания файла настроек:

.env

при первоначальной установке.

Не следует без необходимости выдавать всему сайту права 777.

Правильные права зависят от конфигурации конкретного сервера и от того, от какого пользователя работает PHP-FPM/Apache.

Например, на Ubuntu веб-сервер часто работает от имени:

www-data

Проверить пользователя процесса можно:

ps aux | grep apache2

или для PHP-FPM:

ps aux | grep php-fpm
8. Запуск установщика

После загрузки файлов и подготовки сервера откройте сайт:

https://example.ru/

Если LimageCMS ещё не установлена, приложение автоматически откроет установщик.

На странице установки необходимо заполнить данные сайта и базы данных.

9. Параметры установки

Форма установки содержит следующие параметры.

Название сайта

Название, которое будет использоваться сайтом.

Например:

Моя фотогалерея

Логин администратора

Логин для входа в административную панель.

Пароль администратора

Пароль администратора.

Минимальная длина:

8 символов

Подтверждение пароля

Повторное введение пароля.

Email администратора

Рабочий адрес электронной почты администратора.

Он используется для учётной записи и восстановления доступа.

Сервер базы данных

Адрес сервера MySQL/MariaDB.

В стандартной конфигурации:

localhost

Имя базы данных

Имя базы, подготовленной для LimageCMS.

Пользователь базы данных

Имя пользователя MySQL/MariaDB.

Пароль базы данных

Пароль пользователя базы данных.

Отдельно указывать порт базы данных не требуется. Используется стандартный порт:

3306

если сервер настроен на стандартный порт.

10. Что делает установщик

После отправки формы установщик выполняет необходимые операции автоматически.

В частности:

  1. проверяет введённые параметры;
  2. устанавливает соединение с базой данных;
  3. при необходимости создаёт базу;
  4. создаёт необходимые таблицы;
  5. выполняет первоначальную настройку;
  6. создаёт учётную запись администратора;
  7. сохраняет настройки сайта;
  8. создаёт файл .env.

Файл .env содержит параметры конфигурации, необходимые CMS для работы.

После успешной установки настройки приложения не требуется вводить при каждом запуске.

11. Вход в административную панель

После завершения установки административная панель доступна по адресу:

https://example.ru/admin/login

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

12. Лицензирование

LimageCMS использует систему лицензирования.

На реальном домене после установки CMS самостоятельно обращается к серверу лицензий и получает Free-лицензию, привязанную к домену.

Дополнительная настройка для Free-лицензии не требуется.

Pro-лицензия

Если приобретена Pro-лицензия, ключ активируется в административной панели:

/admin/license

После активации соответствующие возможности Pro становятся доступны в CMS.

Тестовые адреса

Для технических и локальных адресов лицензирование не выполняется.

К таким адресам относятся, например:

localhost *.test *.local

а также локальные IP-адреса.

Это нормальное поведение и позволяет свободно тестировать CMS до размещения на реальном домене.

13. Отправка электронной почты

LimageCMS использует стандартный механизм отправки почты PHP:

mail()

Отдельная настройка SMTP непосредственно в CMS не требуется.

Это касается системных писем, например восстановления доступа.

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

14. Типичные проблемы при установке

Не удаётся подключиться к базе данных

Проверьте:

  • адрес сервера базы;
  • имя базы;
  • имя пользователя;
  • пароль;
  • наличие пользователя базы;
  • права пользователя;
  • доступность MySQL/MariaDB.

На стандартном сервере адресом обычно является:

localhost

База данных уже содержит таблицы

Если установщик сообщает, что база не подходит для установки, убедитесь, что база действительно пустая.

Не следует использовать существующую рабочую базу без предварительной проверки.

Не хватает прав у пользователя базы

Проверьте, что пользователь имеет необходимые права:

CREATE CREATE TABLE ALTER INDEX INSERT UPDATE DELETE

На обычном хостинге можно предоставить пользователю полные права на соответствующую базу.

Белая страница

Если после открытия сайта отображается пустая страница, необходимо проверить:

  • версию PHP;
  • установленные расширения;
  • журнал ошибок PHP;
  • журнал ошибок веб-сервера;
  • права на файлы;
  • конфигурацию Apache/Nginx.

Для Apache:

sudo tail -f /var/log/apache2/error.log

Браузер скачивает index.php

Если вместо открытия сайта браузер предлагает скачать index.php, PHP не обрабатывается веб-сервером.

Необходимо проверить:

  • установлен ли PHP;
  • настроен ли PHP-FPM/модуль PHP;
  • конфигурацию Apache или Nginx;
  • обработку файлов .php.

Ошибки маршрутизации

Если главная страница открывается, но внутренние адреса возвращают 404, необходимо проверить маршрутизацию.

Для Apache в первую очередь:

apache2ctl -M | grep rewrite

и настройки .htaccess.

Для Nginx необходимо проверить правило передачи запросов в index.php.

15. Логи

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

Apache

sudo tail -f /var/log/apache2/error.log

и:

sudo tail -f /var/log/apache2/access.log

PHP

Расположение PHP-логов зависит от версии PHP и конфигурации PHP-FPM.

Например:

/var/log/php/

или:

/var/log/php8.3-fpm.log

Конкретное расположение необходимо проверять в конфигурации сервера.

16. Проверка конфигурации после установки

После установки рекомендуется проверить:

  • главную страницу;
  • несколько страниц сайта;
  • административную панель;
  • загрузку изображений;
  • отображение изображений;
  • создание галереи;
  • создание категорий;
  • статистику;
  • отправку системных писем;
  • работу обновлений.

Также желательно убедиться, что сайт открывается по HTTPS.

17. Обновление LimageCMS

Обновления доступны непосредственно из административной панели.

Раздел:

Обновления

CMS самостоятельно проверяет наличие новой версии.

При необходимости проверку можно запустить вручную.

После обнаружения обновления его можно установить через интерфейс панели управления.

Безопасность обновления

Механизм обновления предусматривает сохранение пользовательских данных.

При обновлении не должны затрагиваться:

  • загруженные изображения;
  • созданные страницы;
  • пользовательский контент.

Перед обновлением рабочего сайта рекомендуется иметь актуальную резервную копию сайта и базы данных.

18. Резервное копирование

Перед обновлением или выполнением серьёзных изменений на рабочем сервере рекомендуется сделать резервную копию.

Минимальный набор:

Файлы сайта + База данных

Особое внимание следует уделять пользовательским данным:

uploads/

а также базе данных.

Резервная копия позволяет восстановить сайт в случае ошибки сервера, повреждения файлов или неудачного изменения конфигурации.

19. Рекомендуемая схема размещения

Для типичного Linux-сервера структура может выглядеть следующим образом:

/var/www/limagecms/ │ ├── index.php ├── .htaccess ├── .env │ ├── app/ ├── config/ ├── database/ ├── routes/ ├── templates/ ├── assets/ ├── storage/ └── uploads/

Корень виртуального хоста должен указывать на:

/var/www/limagecms/

а запросы сайта должны попадать в:

index.php
20. Краткая схема установки

Для администратора сервера весь процесс выглядит следующим образом:

1. Подготовить сервер ↓ 2. Установить PHP 8.1+ ↓ 3. Проверить pdo_mysql, curl, sodium ↓ 4. Настроить Apache или Nginx ↓ 5. Создать MySQL/MariaDB ↓ 6. Создать пользователя БД ↓ 7. Выдать необходимые права ↓ 8. Загрузить LimageCMS ↓ 9. Настроить корневую папку сайта ↓ 10. Проверить права записи ↓ 11. Открыть домен ↓ 12. Заполнить форму установки ↓ 13. Завершить установку ↓ 14. Войти в /admin/login

Для опытных пользователей

Если требуется детальная диагностика или ручная настройка сервера, основными компонентами, которые необходимо проверить, являются:

Веб-сервер → PHP → расширения PHP → база данных → права файлов → маршрутизация → почта → лицензирование.