Как установить PyroCMS на сервере Ubuntu 24.04

PyroCMS — это система управления контентом с открытым исходным кодом, основанная на PHP и Laravel. Это мощная система управления контентом с MySQL/MariaDB в качестве базы данных и также предоставляет интуитивно понятное и простое веб-администрирование для более легкого управления.

В этом руководстве мы проведем вас через установку PyroCMS на Ubuntu 24.04 с использованием стека LEMP (Linux, Nginx, MySQL/MariaDB и PHP-FPM) и Composer.

Предварительные требования

Перед тем как начать, убедитесь, что у вас есть следующее:

Сервер Ubuntu 24.04.
Пользователь, не являющийся root, с правами администратора.
Доменное имя, указывающее на IP-адрес сервера.

Установка зависимостей

PyroCMS — это система управления контентом на основе Laravel с MySQL/MariaDB в качестве базы данных. Перед установкой PyroCMS вам нужно установить стек LEMP (Linux, Nginx, MySQL/MariaDB и PHP-FPM) и Composer на вашу систему Ubuntu.

Сначала выполните следующую команду apt для обновления индекса пакетов и установки стека LEMP (Linux, Nginx, MySQL/MariaDB и PHP-FPM) и Composer.

sudo apt update sudo apt install nginx mariadb-server composer php-cli php-fpm php-mysql php-curl php-sqlite3 php-mbstring php-gd php-xml

Введите Y, чтобы подтвердить установку.

install deps

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

Проверьте веб-сервер Nginx с помощью команды systemctl ниже.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Теперь проверьте статус сервера MariaDB с помощью следующей команды:

check nginx

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadbn

Далее выполните следующую команду, чтобы проверить службу PHP-FPM.

sudo systemctl is-enabled php8.3-fpm  
sudo systemctl status php8.3-fpm

check php-fpm

Наконец, проверьте версию Composer с помощью команды ниже. Вы увидите, что установлена версия Composer 2.4.7.

sudo -u www-data composer --version

Настройка PHP-FPM

После установки зависимостей вам нужно настроить PHP-FPM, изменив некоторые параметры конфигурации по умолчанию через файл php.ini и перезапустив службу PHP-FPM.

Откройте файл php.ini для PHP-FPM с помощью редактора nano.

sudo nano /etc/php/8.3/fpm/php.ini

Измените параметры конфигурации по умолчанию следующим образом и настройте параметры date.timezone и memory_limit в соответствии с вашей текущей средой.

date.timezone = Europe/Amsterdam  
max_execution_time = 130  
memory_limit = 256M  
allow_url_fopen = On  
allow_url_include = Off  
post_max_size = 128M  
upload_max_filesize = 128M  
max_input_vars = 5000

Когда закончите, сохраните файл и выйдите из редактора.

Теперь выполните команду systemctl ниже, чтобы перезапустить службу PHP-FPM и применить ваши изменения в php.ini.

sudo systemctl restart php8.3-fpm

Настройка сервера MariaDB

Теперь, когда вы настроили PHP-FPM, вам нужно защитить установку сервера MariaDB и создать новую базу данных и пользователя для PyroCMS.

Защитите установку вашего сервера MariaDB с помощью команды mariadb-secure-installation ниже.

sudo mariadb-secure-installation

Вас спросят о следующих конфигурациях:

Переключиться на аутентификацию unix_socket? Введите n и нажмите ENTER.
Стандартный пользователь root MariaDB уже защищен. При желании вы также можете включить его, введя y для подтверждения.
Изменить пароль root. Введите y, чтобы подтвердить и установить новый пароль root для MariaDB.
Удалить анонимных пользователей? Введите y, чтобы подтвердить.
Запретить удаленный вход root? Введите y, чтобы подтвердить. Будет разрешено только локальное соединение, если вы используете MariaDB.
Удалить тестовую базу данных и доступ к ней. Введите y, чтобы подтвердить и удалить стандартную базу данных ‘test’.
Наконец, введите y еще раз, чтобы перезагрузить все привилегии таблиц на вашем сервере MariaDB и применить новые изменения.

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

Войдите на сервер MariaDB с помощью команды mariadb ниже. Введите свой пароль root, когда будет предложено.

sudo mariadb -u root -p

Теперь выполните следующие запросы, чтобы создать новую базу данных pyrocmsdb, нового пользователя pyrocms@localhost и установить пароль passw0rd. Измените данные о названии базы данных, имени пользователя и пароле по мере необходимости.

CREATE DATABASE pyrocmsdb;  
GRANT ALL PRIVILEGES ON pyrocmsdb.* TO pyrocms@localhost IDENTIFIED BY 'passw0rd';  
FLUSH PRIVILEGES;

create database and user

Далее выполните запрос ниже, чтобы проверить привилегии для пользователя pyrocms@localhost. Вы увидите, что база данных pyrocmsdb доступна для пользователя pyrocms@localhost.

SHOW GRANTS FOR pyrocms@localhost;

Наконец, введите quit, чтобы выйти из сервера MariaDB.

show db privileges

Скачивание исходного кода PyroCMS

Создайте новые директории для Composer и PyroCMS, перейдите в /var/www/pyrocms, а затем измените владельца новых директорий на пользователя www-data. В этом случае /var/www/pyrocms будет использоваться в качестве корневого каталога для PyroCMS.

mkdir -p /var/www/{.config,.cache,pyrocms}; cd /var/www/pyrocms  
sudo chown -R www-data:www-data /var/www/{.config,.cache,pyrocms}

Теперь выполните команду composer ниже, чтобы скачать исходный код PyroCMS и установить и обновить зависимости PHP.

sudo -u www-data composer create-project pyrocms/pyrocms .  
sudo -u www-data composer update

Ниже вы можете увидеть установку PyroCMS через команду composer:

download and install pyrocms dependencies

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

Настройка блока сервера Nginx

В этом разделе вы создадите новую конфигурацию блока сервера Nginx для установки PyroCMS. Убедитесь, что у вас есть доменное имя, указывающее на IP-адрес вашего сервера Ubuntu. В этом примере вы будете использовать доменное имя howtoforge.local.

Создайте новый блок сервера Nginx /etc/nginx/sites-available/pyrocms.conf с помощью редактора nano.

sudo nano /etc/nginx/sites-available/pyrocms.conf

Скопируйте и вставьте следующую конфигурацию и убедитесь, что вы изменили server_name на ваше доменное имя.

server {  
 listen 80;  
 server_name howtoforge.local;  
  
 index index.php index.html;  
 root /var/www/pyro/public;  
   
 location / {  
  try_files $uri $uri/ /index.php?$args;  
 }  
  
 location ~ \.php$ {  
  include fastcgi_params;  
  fastcgi_pass unix:/run/php/php-8.3-fpm.sock;  
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
  fastcgi_index index.php;  
 }  
}

Когда закончите, сохраните и выйдите из файла.

Теперь выполните команду ниже, чтобы создать символическую ссылку на файл pyrocms.conf в директории /etc/nginx/sites-enabled и проверьте синтаксис вашего Nginx.

sudo ln -s /etc/nginx/sites-available/pyrocms.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Если у вас правильный синтаксис Nginx, вы увидите вывод test is successful - syntax is ok.

setup nginx

Наконец, выполните следующую команду systemctl, чтобы перезапустить веб-сервер Nginx и применить ваши изменения.

sudo systemctl restart nginx

Защита PyroCMS с помощью HTTPS через Letsencrypt

Чтобы защитить PyroCMS, вы реализуете HTTPS через Letsencrypt. Для этого вам нужно установить Certbot для генерации SSL/TLS сертификатов и автоматического внедрения HTTPS в вашу установку PyroCMS.

Установите пакеты certbot и python3-certbot-nginx с помощью следующей команды. Введите Y, чтобы подтвердить установку.

sudo apt install certbot python3-certbot-nginx

Теперь выполните команду certbot ниже, чтобы сгенерировать SSL сертификаты и защитить PyroCMS с помощью HTTPS.

sudo certbot --nginx --agree-tos --no-eff-email --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

После завершения процесса вы получите свои сертификаты в директории /etc/letsencrypt/live/domain.com, и ваш PyroCMS теперь защищен с помощью HTTPS.

Установка PyroCMS с помощью веб-установщика

Откройте веб-браузер и посетите ваше доменное имя, например https://howtoforge.local/. Теперь вы увидите единую страницу установки PyroCMS:

Выберите I Agree, чтобы принять лицензию на установку PyroCMS.
Введите имя вашей базы данных, пользователя и пароль.
Введите нового администратора, адрес электронной почты и пароль для вашего PyroCMS.
Введите данные сайта для вашей установки, такие как доменное имя, язык и часовой пояс.
Нажмите Установить, чтобы подтвердить установку.

install pyrocms

После завершения установки вы увидите следующую страницу:

install complete

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

homepage

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

Если все прошло успешно, вы увидите панель управления PyroCMS, как показано ниже:

dashboard

Заключение

Поздравляем! Вы завершили установку PyroCMS на сервере Ubuntu 24.04. У вас установлен PyroCMS с использованием стека LEMP (Linux, Nginx, MySQL/MariaDB и PHP-FPM). Вы также скачали PyroCMS с помощью Composer и защитили PyroCMS с помощью HTTPS через Certbot и Letsencrypt.