Как установить 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.