Як встановити Contao на Ubuntu

Contao – це надійна система управління контентом (CMS) з відкритим вихідним кодом, відома своїм зручним інтерфейсом і гнучкістю. Створена для професіоналів і розробників, Contao пропонує широкий спектр можливостей, включно з багатомовною підтримкою, чуйним дизайном і надійними заходами безпеки. Усе це робить його чудовим вибором для створення динамічних і масштабованих веб-сайтів.

Встановлення Contao на Ubuntu 24.04 LTS забезпечує стабільне і безпечне середовище, спираючись на довгострокову підтримку Ubuntu і великі ресурси спільноти. Цей посібник допоможе вам пройти процес встановлення крок за кроком, забезпечуючи плавне налаштування Contao на вашому сервері Ubuntu. Незалежно від того, досвідчений ви розробник чи новачок, цей повний посібник дасть вам знання, необхідні для ефективної роботи Contao.

Попередні умови

Перш ніж приступити до встановлення, переконайтеся, що ваша система відповідає таким попереднім вимогам:

  • Системні вимоги: Сервер під керуванням Ubuntu 24.04 LTS з щонайменше 2 ГБ оперативної пам’яті та достатнім обсягом дискового простору. Переконайтеся, що у вас встановлені останні оновлення за допомогою sudo apt update && sudo apt upgrade.
  • Програмні залежності: Для роботи Contao потрібен PHP 8.1 або вище, сервер бази даних MySQL 8 або MariaDB, а також веб-сервер Apache або Nginx.
  • Вимоги до доступу: Для встановлення та налаштування системних пакетів необхідні права Root або sudo. Крім того, для віддаленого виконання команд необхідний SSH-доступ до сервера.
  • Додаткові інструменти: Для полегшення завантаження і вилучення необхідних файлів слід встановити такі базові утиліти, як wget, curl і unzip.

Оновлення системи та встановлення основних утиліт

Почніть з оновлення системних пакетів, щоб переконатися, що все наявне програмне забезпечення є актуальним. Це дасть змогу звести до мінімуму проблеми сумісності в процесі встановлення.

sudo apt update && sudo apt upgrade -y

Потім встановіть основні утиліти, необхідні для завантаження та управління файлами:

sudo apt install wget curl unzip -y

Встановлення та налаштування веб-сервера

Contao може працювати на веб-серверах Apache або Nginx. Виберіть той, який найкраще відповідає вашим потребам.

Варіант A: Apache

Встановіть Apache за допомогою такої команди:

sudo apt install apache2 -y

Увімкніть модуль mod_rewrite, який необхідний для переписування URL у Contao:

sudo a2enmod rewrite

Перезапустіть Apache, щоб застосувати зміни:

sudo systemctl restart apache2

Варіант B: Nginx

Якщо ви віддаєте перевагу Nginx, встановіть його за допомогою:

sudo apt install nginx -y

Налаштуйте Nginx на обслуговування Contao, створивши серверний блок:

sudo nano /etc/nginx/sites-available/contao

Додайте таку конфігурацію:

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/contao/web;

    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

Увімкніть конфігурацію і перезапустіть Nginx:

sudo ln -s /etc/nginx/sites-available/contao /etc/nginx/sites-enabled/
sudo systemctl restart nginx

Встановлення PHP і необхідних розширень

Для роботи Contao потрібен PHP 8.1 або вище. Встановіть PHP разом із необхідними розширеннями:

sudo apt install php8.1 php8.1-xml php8.1--pear php8.1-intl php8.1--common php8.1-json php8.1--curl php8.1--mbstring php8.1--mysql php8.1--gd php8.1-imagick php8.1-zip php8.1-opcache -y

Для користувачів Apache встановіть модуль PHP:

sudo apt install libapache2-mod-php8.1 -y

Перевірте встановлення PHP:

php -v

Ви маєте побачити результат, схожий на:

PHP 8.1.x (cli) (built: ...)

Встановіть сервер баз даних

Contao підтримує як MySQL, так і MariaDB. Ось як встановити MariaDB:

sudo apt install mariadb-server mariadb-client -y

Захистіть установку MariaDB:

sudo mysql_secure_installation

Дотримуйтесь підказок, щоб встановити надійний пароль root, видалити анонімних користувачів, заборонити віддалений вхід root, видалити тестову базу даних і перезавантажити таблиці привілеїв.

Створіть базу даних і виділеного користувача для Contao:

sudo mysql -u root -p
CREATE DATABASE contaodb;
CREATE USER 'contaouser'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON contaodb.* TO 'contaouser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Завантаження та налаштування файлів Contao

Перейдіть у тимчасовий каталог і завантажте Contao Manager:

cd /tmp/
wget https://download.contao.org/contao-manager/stable/contao-manager.phar -O contao-manager.phar.php

Створіть каталог встановлення Contao і перемістіть туди завантажений файл:

sudo mkdir -p /var/www/contao/web
sudo mv contao-manager.phar.php /var/www/contao/web/

Встановіть відповідні дозволи, щоб веб-сервер міг отримати доступ до файлів:

sudo chown -R www-data:www-data /var/www/contao

Налаштування веб-сервера для Contao

Залежно від обраного вами веб-сервера, налаштуйте його для обслуговування файлів Contao.

Для Apache:

Створіть конфігурацію віртуального хоста для Contao:

sudo nano /etc/apache2/sites-available/contao.conf

Додайте такий вміст:

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /var/www/contao/web

 <Directory /var/www/contao/web>
  AllowOverride All
  Require all granted
 </Directory>

    ErrorLog ${APACHE_LOG_DIR}/contao_error.log
    CustomLog ${APACHE_LOG_DIR}/contao_access.log combined
</VirtualHost>

Увімкніть модуль сайту і перезапису, потім перезапустіть Apache:

sudo a2ensite contao.conf
sudo systemctl reload apache2

Для Nginx:

Переконайтеся, що блок сервера вказує на правильний корінь документа, як було налаштовано раніше. За необхідності перезапустіть Nginx:

sudo systemctl restart nginx

Завершення встановлення за допомогою Contao Manager

Зайдіть у Contao Manager через веб-браузер, щоб завершити встановлення:

  • Перейдіть за адресою http://yourdomain.com/contao-manager.phar.php.
  • Створіть обліковий запис адміністратора, заповнивши необхідні дані.
  • Виберіть потрібну версію Contao і продовжте встановлення.
  • Введіть облікові дані бази даних, створені раніше:
Database Host: localhost
Database Name: contaodb
Database User: contaouser
Database Password: your_password
  • Завершіть установку, оновивши схему бази даних.
  • Дочекайтеся завершення процесу встановлення. Це може зайняти кілька хвилин, поки Contao завантажує необхідні пакети і виконує конфігурацію.

Після завершення ви будете перенаправлені в бекенд Contao:

http://yourdomain.com/contao

Кроки після встановлення

Після інсталяції Contao виконайте такі дії, щоб переконатися в безпеці та оптимальності вашої інсталяції:

  • Доступ до бекенда: Увійдіть у систему, використовуючи створені вами облікові дані адміністратора. Ознайомтеся з панеллю приладів і вивчіть параметри початкового налаштування.
  • Увімкніть HTTPS: захистіть свій сайт, встановивши SSL-сертифікат за допомогою Let’s Encrypt:
sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache -d yourdomain.com
  • Регулярні оновлення: Підтримуйте Contao і пакети вашого сервера в актуальному стані для захисту від вразливостей:
sudo apt update && sudo apt upgrade -y
  • Стратегія резервного копіювання: Регулярно створюйте резервні копії бази даних і файлів Contao, щоб запобігти втраті даних.

Усунення загальних проблем

Виникли проблеми під час встановлення? Ось рішення поширених проблем:

  • Помилки розширень PHP: Переконайтеся, що всі необхідні розширення PHP встановлені. Повний список див. у кроці 4.
  • Проблеми з підключенням до бази даних: Перевірте облікові дані бази даних і переконайтеся, що сервер бази даних запущено. Для перевірки використовуйте sudo systemctl status mariadb.
  • Проблеми з правами доступу: Переконайтеся, що користувач веб-сервера (зазвичай www-data) має правильні дозволи на доступ до файлів Contao:
sudo chown -R www-data:www-data /var/www/contao

Вітаємо! Ви успішно встановили Contao. Для отримання додаткової допомоги або корисної інформації ми рекомендуємо вам відвідати офіційний сайт Contao.

Поділіться своєю любов'ю

Залишити відповідь

0 комментариев
Новіші
Старіші Найпопулярніші
Вбудовані Відгуки
Переглянути всі коментарі
0
Ми любимо ваші думки, будь ласка, прокоментуйте.x