Shopware 설치 · 6 min read · Dec 14, 2025

NGINX와 Let's Encrypt를 사용하여 FreeBSD 12에 Shopware 설치하기

Shopware는 차세대 오픈 소스 전자상거래 소프트웨어입니다. Symfony 3, Doctrine 2, Zend Framework와 같은 최첨단 기술을 기반으로 하여 Shopware는 다음 전자상거래 프로젝트를 위한 완벽한 플랫폼으로 제공됩니다. 이 튜토리얼에서는 NGINX를 웹 서버로 사용하여 FreeBSD 12 시스템에 Shopware 커뮤니티 에디션(CE) 설치하는 방법을 안내합니다.

요구 사항

시스템이 다음 최소 요구 사항을 충족하는지 확인하십시오:

  • NGINX 또는 Apache 2.x(모드 리라이트 포함) 웹 서버가 설치된 리눅스 기반 운영 체제.
  • ctype, gd, curl, dom, hash, iconv, zip, json, mbstring, openssl, session, simplexml, xml, zlib, fileinfo 및 pdo/mysql 확장이 포함된 PHP 5.6.4 이상. PHP 7.1 이상을 강력히 권장합니다.
  • MySQL 5.5.0 이상.
  • 크론 작업을 설정할 수 있는 가능성.
  • 최소 4GB의 사용 가능한 하드 디스크 공간.
  • 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 확장 설치

Shopware에 필요한 PHP 및 PHP 확장을 설치하십시오:

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 로더를 포함하는 줄을 추가하십시오. [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

MariaDB 보안을 개선하고 MariaDB root 사용자에 대한 비밀번호를 설정하기 위해 mysql_secure_installation 스크립트를 실행하십시오:

sudo mysql_secure_installation

각 질문에 답하십시오:

`VALIDATE PASSWORD 플러그인을 설정하시겠습니까? N  
새 비밀번호: your_secure_password  
새 비밀번호를 다시 입력하십시오: your_secure_password  
익명 사용자를 제거하시겠습니까? [Y/n] Y  
원격으로 루트 로그인을 금지하시겠습니까? [Y/n] Y  
테스트 데이터베이스 및 접근을 제거하시겠습니까? [Y/n] Y  
권한 테이블을 지금 다시 로드하시겠습니까? [Y/n] Y`

루트 사용자로 MariaDB 셸에 연결하십시오:

sudo mysql -u root -p  
# 비밀번호 입력

Shopware용 빈 MariaDB 데이터베이스와 사용자를 생성하고 자격 증명을 기억하십시오:

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로 웹사이트를 보호하는 것은 필수가 아니지만 사이트 트래픽을 보호하는 좋은 방법입니다. Let’s Encrypt에서 TLS 인증서를 받기 위해 acme.sh 클라이언트를 사용할 것입니다. Acme.sh는 종속성이 없는 순수 유닉스 셸 소프트웨어로, Let’s Encrypt에서 TLS 인증서를 받는 데 사용됩니다.

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일마다 자동으로 갱신됩니다.

인증서를 받은 후 루트 사용자에서 나가고 일반 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

Shopware를 위해 Nginx를 구성하려면 다음을 실행하십시오:

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로 증가시키고 /usr/local/etc/php.ini 파일에서 allow_url_fopen = On으로 설정하십시오(아직 설정되지 않은 경우):

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 TOS에 동의하고 다음을 클릭하십시오:

ShopWare의 서비스 약관

데이터베이스 자격 증명을 입력하고 다음을 클릭하십시오:

데이터베이스 구성

데이터베이스 테이블을 생성하기 위해 설치를 시작하십시오:

데이터베이스 테이블 생성

그 후, 성공적인 데이터베이스 가져오기에 대한 메시지가 표시됩니다:

설치 성공

라이센스를 선택하고 다음을 클릭하십시오:

라이센스

설정을 완료하기 위해 몇 가지 기본 설정을 입력하고 다음을 클릭하십시오:

기본 상점 설정

설치가 완료되었습니다.

설치 완료

관리 영역에 접근하려면 URL에 /backend를 추가하십시오.

Shopware 로그인

Shopware를 성공적으로 설치했습니다. 새로운 온라인 상점을 즐기세요!

링크

Share: X/Twitter LinkedIn
#Shopware 설치

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.