Установка X‑Cart 5 на Debian 10

Обкладка: панель управления интернет-магазином X‑Cart

Что включает этот гайд

Быстрая сводка требований и команд для Debian 10.
Полный набор команд для установки PHP, MariaDB, Nginx и X‑Cart.
Инструкция по получению TLS‑сертификата с помощью acme.sh.
Рекомендации по безопасности, тестированию и устранению проблем.

Important: этот гайд рассчитан на Debian 10 и X‑Cart 5. Перед началом сделайте резервную копию данных и убедитесь, что у вас есть доступ sudo.

Требования и совместимость

PHP версии 7.2 или выше. Рекомендуется PHP 7.3/7.4 для лучшей совместимости. Определите версию командой php --version.
PHP‑расширения: pdo, phar, mysql (или mysqli), mbstring, curl, json, xml, gd.
MySQL версии 5.7.7+ или эквивалент MariaDB.
Nginx (стабильная ветка в репозиториях Debian 10).

Фактбокс:

Минимальные требования: PHP ≥7.2, MySQL ≥5.7.7.
Рекомендуемые права: каталог веб‑документов — владелец www-data.

Начальные шаги (проверки и обновления)

Проверьте версию Debian:

lsb_release -ds

Установите часовой пояс (интерактивно):

sudo dpkg-reconfigure tzdata

Обновите систему и установите базовые утилиты:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget vim git unzip socat bash-completion

Установка PHP и необходимых расширений

Установите PHP и расширения:

sudo apt install -y php php-cli php-fpm php-common php-mbstring php-curl php-mysql php-json php-xml php-phar php-pdo php-gd

Проверьте загруженные модули PHP:

php -m

Пример вывода (среди модулей должны быть ctype, curl, exif, fileinfo и т.д.).

Проверьте версию PHP:

php --version

PHP‑FPM в Debian 10 обычно запускается и включается автоматически. Если нужно — проверьте статус:

sudo systemctl status php7.3-fpm

Установка MariaDB и создание базы данных

Установите MariaDB:

sudo apt install -y mariadb-server

Проверьте версию сервера:

mysql --version

Выведите скрипт безопасной настройки MariaDB:

sudo mysql_secure_installation

Войдите в MariaDB как root и создайте базу и пользователя (замените dbname, username, password на свои значения):

sudo mysql -u root -p
# Enter password:
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit;

Получение TLS‑сертификата через acme.sh (опционально)

HTTPS не обязателен, но настоятельно рекомендуется.

Установите acme.sh и зарегистрируйте почту:

sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
./acme.sh --install --accountemail your-email@example.com
source ~/.bashrc
cd ~

Проверьте версию:

acme.sh --version

Выдайте сертификаты RSA и ECDSA (замените example.com на ваш домен):

# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256

Для тестовой выдачи добавьте --staging.

Сертификаты будут в директориях /home/username/example.com и /home/username/example.com_ecc.

Создайте директорию для копирования сертификатов (корректное написание):

sudo mkdir -p /etc/letsencrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc

Скопируйте/установите сертификаты и укажите команду перезагрузки Nginx:

# RSA
acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"
# ECC/ECDSA
acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"

Все сертификаты acme.sh по умолчанию автоматически обновляются.

Выйдите из root:

exit

Note: для автоматизации на серверах с брандмауэрами откройте порт 80 на период подтверждения --standalone или используйте --webroot с уже запущенным Nginx.

Установка и конфигурация Nginx

Установите Nginx:

sudo apt install -y nginx

Проверьте версию:

sudo nginx -v

Создайте конфигурацию сайта для X‑Cart:

sudo vim /etc/nginx/sites-available/xcart.conf

Пример содержимого (замените example.com и путь root при необходимости):

server {
  listen 80;
  listen [::]:80;
  root /var/www/xcart;
  index index.php index.html index.htm;
  server_name example.com;
  location @handler {
    index cart.php;
    rewrite ^/sitemap.xml(\?.+)?$ /cart.php?target=sitemap;
    rewrite ^/(.*)$ /cart.php?url=$1 last;
  }
  location / {
    try_files $uri $uri/ @handler;
  }
  location ~ \.php$ {
    try_files     $uri @handler;
    fastcgi_split_path_info  ^(.+\.php)(/.+)$;
    fastcgi_index index.php;
    fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
    include fastcgi_params;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  }
}

Активируйте сайт и проверьте конфигурацию:

sudo ln -s /etc/nginx/sites-available/xcart.conf /etc/nginx/sites-enabled
sudo nginx -t
sudo systemctl reload nginx

Если используете HTTPS, добавьте серверный блок для 443 с путями к /etc/letsencrypt/.../fullchain.pem и private.key.