Skip to Content
РуководстваУстановка

Установка Flute CMS

Минимальные требования

⚠️

Для корректной работы Flute CMS требуется MySQL 8.0 и выше!

Работа на хостингах MyArena и GreyWeb не гарантируется!

Для установки Flute CMS требуется:

  • PHP 8.2 и выше
  • Composer 2.0 и выше (только для установки через Composer)
  • Opcache
  • Ioncube Loader
  • PDO PHP расширение
  • GD PHP расширение
  • BCMath PHP расширение
  • JSON PHP расширение
  • Mbstring PHP расширение
  • SimpleXML PHP расширение
  • Zip PHP расширение
  • Curl PHP расширение
  • GMP PHP расширение

Поддерживаемые СУБД:

  • MySQL 8.0 / MariaDB 10.11 и выше
  • PostgreSQL 14 и выше
  • SQLite 3.30 и выше

Поддерживаемые серверы:

  • Apache 2.4 и выше
  • Nginx 1.20 и выше
  • Lighttpd 1.4 и выше

Способы установки

Flute CMS можно установить тремя способами:

Установка через архив (подробная инструкция)

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

⚠️

Убедитесь, что ваш хостинг поддерживает все требования, указанные выше!

Скачайте архив с Flute CMS

  1. Перейдите на страницу релизов GitHub
  2. Найдите последнюю версию (обычно первая в списке)
  3. Скачайте файл Source code (zip) или flute-cms-vX.X.X.zip

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

Подготовьте хостинг

  1. Создайте базу данных:

    • Войдите в панель управления хостингом
    • Найдите раздел “Базы данных” или “MySQL”
    • Создайте новую базу данных (например, flute_cms)
    • Создайте пользователя для этой базы данных
    • Запишите данные: имя базы, пользователь, пароль, хост
  2. Проверьте версию PHP:

    • В панели управления найдите раздел “PHP” или “Версии PHP”
    • Убедитесь, что выбрана версия PHP 8.2 или выше
    • Включите необходимые расширения (если есть такая возможность)

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

  1. Распакуйте архив на компьютере:

    • Создайте папку на компьютере (например, flute-cms)
    • Распакуйте скачанный архив в эту папку
  2. Подключитесь к серверу:

    • Используйте FTP-клиент (FileZilla, WinSCP, или встроенный файловый менеджер хостинга)
    • Введите данные для подключения (хост, логин, пароль)
  3. Загрузите файлы:

    • Перейдите в корневую папку сайта (обычно public_html, www, или htdocs)
    • Загрузите ВСЕ файлы из распакованного архива
    • Убедитесь, что структура папок сохранилась
⚠️

Загрузка может занять 10-30 минут в зависимости от скорости интернета. Не прерывайте процесс!

Настройте веб-сервер

Для Apache (большинство хостингов):

  • Файл .htaccess уже включён в архив
  • Убедитесь, что корневая папка сайта указывает на папку public

Для Nginx:

Установите зависимости (если нужно)

Если в архиве нет папки vendor или она пустая:

  1. Через терминал хостинга (если доступен):

    cd /path/to/your/site composer install --no-dev --optimize-autoloader
  2. Без терминала:

    • Скачайте готовый архив с зависимостями с releases страницы
    • Найдите файл типа flute-cms-with-vendor-vX.X.X.zip
    • Замените папку vendor из этого архива

Установите права доступа

Установите права доступа на папки (через FTP-клиент или файловый менеджер):

  • storage/ - 755 или 777
  • storage/logs/ - 755 или 777
  • storage/app/cache/ - 755 или 777
  • public/uploads/ - 755 или 777

На некоторых хостингах права устанавливаются автоматически. Если возникают ошибки с записью файлов, попробуйте права 777.

Запустите мастер установки

  1. Откройте ваш сайт в браузере
  2. Вы увидите страницу мастера установки Flute CMS
  3. Следуйте инструкциям на экране:
    • Проверка системных требований
    • Настройка базы данных
    • Создание администратора
    • Базовые настройки сайта

Завершение установки

После успешной установки:

  1. Проверьте работу сайта
  2. Войдите в админ-панель с созданными учётными данными

Возможные проблемы и их решение

Ошибка “500 Internal Server Error”

  1. Проверьте логи ошибок сервера
  2. Убедитесь, что установлены все необходимые PHP расширения
  3. Проверьте права доступа на папки
  4. Убедитесь, что файл .htaccess загружен корректно
  5. Если проблема осталась, зайдите в config/app.php и поставьте 'debug' => true, и попробуйте выяснить проблему.

Белая страница или ошибки PHP

  1. Включите отображение ошибок PHP (в config/app.php)
  2. Проверьте версию PHP (должна быть 8.2+)
  3. Убедитесь, что установлены все необходимые расширения
  4. Проверьте логи PHP

Проблемы с загрузкой файлов

  1. Проверьте права доступа на папку public/uploads/
  2. Убедитесь, что в PHP включена загрузка файлов
  3. Проверьте лимиты размера файлов в PHP

Если у вас возникли проблемы, которых нет в этом списке, обратитесь за помощью в Discord сообщество или создайте issue на GitHub.

После установки

После успешной установки Flute CMS рекомендуется:

  1. Настроить CRON для автоматических задач
  2. Настроить почту для отправки уведомлений
  3. Настроить основной шаблон
  4. Оптимизировать производительность
  5. Настроить резервное копирование базы данных

Поздравляем! Flute CMS успешно установлена и готова к использованию! 🎉