Установка Shopware · 6 min read · Dec 14, 2025

Как установить Shopware с NGINX и Let's Encrypt на FreeBSD 12

Shopware — это программное обеспечение для электронной коммерции следующего поколения с открытым исходным кодом. Основанное на передовых технологиях, таких как Symfony 3, Doctrine 2 и Zend Framework, Shopware является идеальной платформой для вашего следующего проекта в области электронной коммерции. Этот учебник проведет вас через установку Shopware Community Edition (CE) на системе FreeBSD 12, используя NGINX в качестве веб-сервера.

Требования

Убедитесь, что ваша система соответствует следующим минимальным требованиям:

  • Операционная система на базе Linux с установленным веб-сервером NGINX или Apache 2.x (с mod_rewrite).
  • PHP 5.6.4 или выше с расширениями ctype, gd, curl, dom, hash, iconv, zip, json, mbstring, openssl, session, simplexml, xml, zlib, fileinfo и pdo/mysql. Рекомендуется использовать PHP 7.1 или выше.
  • MySQL 5.5.0 или выше.
  • Возможность настройки cron-заданий.
  • Минимум 4 ГБ доступного места на жестком диске.
  • IonCube Loader версии 5.0.0 или выше ( необязательно).

*ПРИМЕЧАНИЕ: Shopware 5 в настоящее время совместим с PHP 7.2.x.*

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

  • Операционная система FreeBSD 12.
  • Непривилегированный пользователь с правами sudo.

В этом учебнике я буду использовать доменное имя example.com. Пожалуйста, замените слово example.com на ваше собственное доменное имя в командах и конфигурационных файлах ниже (особенно в конфигурационном файле Nginx и командах Let’s Encrypt).

Начальные шаги

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

uname -ro  
# FreeBSD 12.0-RELEASE

Настройте часовой пояс:

tzsetup

Обновите пакеты вашей операционной системы (программное обеспечение). Это важный первый шаг, поскольку он гарантирует, что у вас есть последние обновления и исправления безопасности для стандартных пакетов программного обеспечения вашей операционной системы:

freebsd-update fetch install  
pkg update && pkg upgrade -y

Установите несколько необходимых пакетов, которые необходимы для базового администрирования операционной системы FreeBSD 12.0:

pkg install -y sudo vim unzip wget bash socat

Шаг 1 - Установка PHP и расширений PHP

Установите PHP, а также необходимые расширения PHP для Shopware:

sudo pkg install -y php72 php72-ctype php72-curl php72-dom php72-hash php72-iconv php72-gd php72-json php72-mbstring php72-openssl php72-session php72-simplexml php72-xml php72-zip php72-zlib php72-pdo php72-pdo_mysql php72-filter php72-ftp php72-tokenizer php72-calendar php72-pecl-APCu php72-opcache

Чтобы показать скомпилированные модули PHP, вы можете выполнить:

php -m  
  
ctype  
curl  
exif  
fileinfo  
. . .  
. . .

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

php --version  
  
# PHP 7.2.16 (cli) (built: Apr 30 2019 08:37:17) ( NTS )  
# Copyright (c) 1997-2018 The PHP Group  
# Zend Engine v3.3.5, Copyright (c) 1998-2018 Zend Technologies  
# with Zend OPcache v7.3.5, Copyright (c) 1999-2018, by Zend Technologies

Запустите и включите службу PHP-FPM:

sudo sysrc php_fpm_enable=yes  
sudo service php-fpm start

Мы можем перейти к следующему шагу, который заключается в установке IonCube Loader.

Шаг 2 - Установка IonCube Loader (необязательно)

Этот шаг является необязательным, потому что Shopware работает без IonCube, но могут быть расширения или темы, которые используют IonCube, поэтому установка не повредит. Скачайте IonCube Loader:

cd /tmp && wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_fre_11_x86-64.tar.gz

Извлеките загрузчик:

tar xfz ioncube_loaders_fre_*.tar.gz

Найдите каталог расширений PHP в системе, выполнив команду ниже:

php -i | grep extension_dir  
# extension_dir => /usr/local/lib/php/20170718 => /usr/local/lib/php/20170718

Скопируйте IonCube Loader в каталог расширений PHP:

sudo cp /tmp/ioncube/ioncube_loader_fre_7.2.so /usr/local/lib/php/20170718

Включите загрузчик через конфигурацию PHP:

sudo vim /usr/local/etc/php.ini

Затем добавьте строку в файл для включения IonCube Loader. Она может находиться в любом месте файла ниже строки [PHP]:

zend_extension = /usr/local/lib/php/20170718/ioncube_loader_fre_7.2.so

Сохраните файл и перезапустите PHP-FPM:

sudo service php-fpm restart

Шаг 3 - Установка MariaDB и создание базы данных для Shopware

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

sudo pkg install -y mariadb102-client mariadb102-server

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

mysql --version  
# mysql  Ver 15.1 Distrib 10.2.23-MariaDB, for Linux (x86_64) using readline 5.1

Запустите и включите службу MariaDB:

sudo sysrc mysql_enable="yes"  
sudo service mysql-server start

Запустите скрипт mysql_secure_installation, чтобы улучшить безопасность MariaDB и установить пароль для пользователя MariaDB root:

sudo mysql_secure_installation

Ответьте на каждый из вопросов:

`Would you like to setup VALIDATE PASSWORD plugin? N  
New password: your_secure_password  
Re-enter new password: your_secure_password  
Remove anonymous users? [Y/n] Y  
Disallow root login remotely? [Y/n] Y  
Remove test database and access to it? [Y/n] Y  
Reload privilege tables now? [Y/n] Y`

Подключитесь к оболочке MariaDB как пользователь root:

sudo mysql -u root -p  
# Введите пароль  

Создайте пустую базу данных MariaDB и пользователя для Shopware и запомните учетные данные:

mysql> CREATE DATABASE dbname;  
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';  
mysql> FLUSH PRIVILEGES;

Выйдите из MariaDB:

mysql> exit

Замените dbname, username и password на ваши собственные имена.

Шаг 4 - Установка клиента Acme.sh и получение сертификата Let’s Encrypt (необязательно)

Защита вашего веб-сайта с помощью HTTPS не является обязательной, но это хорошая практика для защиты трафика вашего сайта. Чтобы получить TLS-сертификат от Let’s Encrypt, мы будем использовать клиент acme.sh. Acme.sh — это чистое программное обеспечение Unix shell для получения TLS-сертификатов от Let’s Encrypt без зависимостей.

Скачайте и установите acme.sh:

sudo pkg install -y acme.sh

Проверьте версию acme.sh:

acme.sh --version  
# v2.8.2

Получите RSA и ECC/ECDSA сертификаты для вашего домена/имени хоста:

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

Если вы хотите получить поддельные сертификаты для тестирования, вы можете добавить флаг --staging к вышеуказанным командам.

После выполнения вышеуказанных команд ваши сертификаты и ключи будут находиться в:

  • Для RSA: директория /home/username/example.com.
  • Для ECC/ECDSA: директория /home/username/example.com_ecc.

Чтобы перечислить выданные сертификаты, вы можете выполнить:

acme.sh --list

Создайте каталог для хранения ваших сертификатов. Мы будем использовать каталог /etc/letsencrypt.

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

Установите/скопируйте сертификаты в каталог /etc/letsencrypt.

# 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 service nginx reload"

Все сертификаты будут автоматически обновляться каждые 60 дней.

После получения сертификатов выйдите из пользователя root и вернитесь к обычному пользователю с правами sudo:

exit

Шаг 5 - Установка и настройка NGINX

Установите веб-сервер NGINX:

sudo pkg install -y nginx

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

nginx -v  
# nginx version: nginx/1.14.2

Запустите и включите службу NGINX:

sudo sysrc nginx_enable=yes  
sudo service nginx start

Настройте Nginx для Shopware, выполнив:

sudo vim /usr/local/etc/nginx/shopware.conf

И заполните файл следующей конфигурацией:

server {
    listen 80;
    listen [::]:80;
    
    server_name example.com;
    root /usr/local/www/shopware;

    index shopware.php index.php;

    location / {
        try_files $uri $uri/ /shopware.php$is_args$args;
    }

    location /recovery/install {
      index index.php;
      try_files $uri /recovery/install/index.php$is_args$args;
    }

    location ~ \.php$ {
        include fastcgi.conf;
        fastcgi_pass 127.0.0.1:9000;
    }
}

Запустите sudo vim /usr/local/etc/nginx/nginx.conf и добавьте следующую строку в блок http {} для включения конфигурации Shopware.

include shopware.conf;

Проверьте конфигурацию Nginx на наличие синтаксических ошибок:

sudo nginx -t

Перезагрузите службу Nginx:

sudo service nginx reload

Шаг 6 - Установка Shopware

Создайте каталог корневого документа для Shopware:

sudo mkdir -p /usr/local/www/shopware

Перейдите в каталог корневого документа:

cd /usr/local/www/shopware

Скачайте и распакуйте Shopware:

sudo wget https://releases.shopware.com/install_5.5.8_d5bf50630eeaacc6679683e0ab0dcba89498be6d.zip?_ga=2.141661361.269357371.1556739808-1418008019.1556603459 -O shopware.zip  
sudo unzip shopware.zip  
sudo rm shopware.zip

ПРИМЕЧАНИЕ: Обновите URL для загрузки, если есть более новая версия.

Обеспечьте соответствующее владение:

sudo chown -R www:www /usr/local/www/shopware

Увеличьте memory_limit = 256M и upload_max_filesize = 6M, и установите allow_url_fopen = On, если это еще не установлено в файле /usr/local/etc/php.ini:

sudo vim /usr/local/etc/php.ini

После внесения изменений в файл /etc/php/7.2/fpm/php.ini перезагрузите php-fpm.service:

sudo service php-fpm reload

Откройте ваш домен/IP в веб-браузере и следуйте мастеру установки. Административная панель Shopware находится по адресу /backend, например: http://example.com/backend.

Шаг 7 - Завершение настройки Shopware

Начните с выбора языка и нажмите Далее:

Мастер установки Shopware

Затем убедитесь, что вы соответствуете всем требованиям Shopware:

Системные требования Shopware

Согласитесь с условиями использования Shopware и нажмите Далее:

Условия использования ShopWare

Введите учетные данные базы данных и нажмите Далее:

Настройка базы данных

Начните установку для создания таблиц базы данных:

Создание таблиц базы данных

После этого вы увидите сообщение об успешном импорте базы данных:

Установка успешна

Выберите лицензию и нажмите Далее:

Лицензирование

Заполните несколько основных настроек, чтобы завершить настройку, и нажмите Далее:

Основная настройка магазина

Установка завершена.

Установка завершена

** Чтобы получить доступ к административной области, добавьте /backend к вашему URL.

Вход в Shopware

Вы успешно установили Shopware. Наслаждайтесь вашим новым интернет-магазином!

Ссылки

Share: X/Twitter LinkedIn

Get new posts in your inbox

No spam. Unsubscribe anytime.