Cách cài đặt Shopware với NGINX và Let's Encrypt trên FreeBSD 12

[theanh]

Shopware là thế hệ phần mềm thương mại điện tử nguồn mở tiếp theo. Dựa trên các công nghệ tiên tiến như Symfony 3, Doctrine2và Zend FrameworkShopware là nền tảng hoàn hảo cho dự án thương mại điện tử tiếp theo của bạn.Hướng dẫn này sẽ hướng dẫn bạn cài đặt Shopware Community Edition (CE) trên hệ thống FreeBSD 12 bằng cách sử dụng NGINX làm máy chủ web.

Yêu cầu​

Đảm bảo hệ thống của bạn đáp ứng các yêu cầu tối thiểu sau:

• Hệ điều hành dựa trên Linux với NGINX hoặc Apache 2.x (có mod_rewrite) máy chủ web được cài đặt.
• PHP 5.6.4 trở lên với ctype, gd, curl, dom, hash, iconv, zip, json, mbstring, openssl, session, simplexml, xml, zlib, fileinfo và phần mở rộng pdo/mysql.Khuyến khích sử dụng PHP 7.1 trở lên.
• MySQL 5.5.0 trở lên.
• Có thể thiết lập các tác vụ cron.
• Dung lượng ổ cứng trống tối thiểu là 4 GB.
• IonCube Loader phiên bản 5.0.0 trở lên (tùy chọn).

LƯU Ý:Shopware 5 hiện tương thích với PHP 7.2.x.

Điều kiện tiên quyết​

• Hệ điều hành chạy FreeBSD12.
• Người dùng không phải root có quyền sudo.

Tôi sẽ sử dụng tên miền example.com trong hướng dẫn này. Vui lòng thay thế từ example.com bằng tên miền của riêng bạn bất cứ khi nào nó xuất hiện trong các lệnh và tệp cấu hình bên dưới (đặc biệt là trong tệp cấu hình Nginx và các lệnh Let's encrypt).

Các bước ban đầu​

Kiểm tra phiên bản FreeBSD của bạn:

uname -ro
# FreeBSD 12.0-RELEASE

Thiết lập múi giờ:

tzsetup

Cập nhật các gói hệ điều hành (phần mềm) của bạn. Đây là bước đầu tiên quan trọng vì nó đảm bảo bạn có các bản cập nhật và bản sửa lỗi bảo mật mới nhất cho các gói phần mềm mặc định của hệ điều hành:

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

Cài đặt một số gói thiết yếu cần thiết cho việc quản trị cơ bản hệ điều hành FreeBSD 12.0:

pkg install -y sudo vim unzip wget bash socat

Bước 1 - Cài đặt PHP và tiện ích mở rộng PHP​

Cài đặt PHP cũng như các tiện ích mở rộng PHP cần thiết cho 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

Để hiển thị PHP được biên dịch trong các mô-đun, bạn có thể chạy:

php -m

ctype
curl
exif
fileinfo
. . .
. . .

Kiểm tra phiên bản PHP:

php --version

#PHP 7.2.16 (cli) (được xây dựng: 30 tháng 4 năm 2019 08:37:17) (NTS)
# Bản quyền (c) 1997-2018 The PHP Group
# Zend Engine v3.3.5, Bản quyền (c) 1998-2018 Zend Technologies
# với Zend OPcache v7.3.5, Bản quyền (c) 1999-2018, của Zend Technologies

Khởi động và kích hoạt dịch vụ PHP-FPM:

sudo sysrc php_fpm_enable=yes
sudo service php-fpm start

Chúng ta có thể chuyển sang bước tiếp theo, đó là IonCube Loader cài đặt.

Bước 2 - Cài đặt IonCube Loader (tùy chọn)​

Bước này là tùy chọn vì Shopware hiện hoạt động mà không cần IonCube, nhưng vẫn có thể có các tiện ích mở rộng hoặc chủ đề sử dụng IonCube, vì vậy, cài đặt nó không có hại gì. Tải xuống IonCube Loader:

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

Giải nén trình tải:

tar xfz ioncube_loaders_fre_*.tar.gz

Tìm thư mục tiện ích mở rộng PHP trên hệ thống bằng cách chạy lệnh bên dưới:

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

Sao chép ionCube Loader vào thư mục tiện ích mở rộng PHP:

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

Bao gồm trình tải thông qua cấu hình PHP:

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

Sau đó thêm một dòng vào tệp để bao gồm trình tải ionCube. Nó có thể ở bất kỳ đâu trong tệp bên dưới dòng [PHP]:

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

Lưu tệp và khởi động lại PHP-FPM:

sudo service php-fpm restart

Bước 3 - Cài đặt MariaDB và tạo cơ sở dữ liệu cho Shopware​

Cài đặt máy chủ cơ sở dữ liệu MariaDB:

sudo pkg install -y mariadb102-client mariadb102-server

Kiểm tra phiên bản MariaDB:

mysql --version
#mysql Ver 15.1 Distrib 10.2.23-MariaDB, dành cho Linux (x86_64) bằng readline 5.1

Khởi động và bật dịch vụ MariaDB:

sudo sysrc mysql_enable="yes"
sudo dịch vụ mysql-server start

Chạy cài đặt mysql_secure script để cải thiện bảo mật MariaDB và đặt mật khẩu cho MariaDB rootuser:

sudo mysql_secure_installation

Trả lời từng câu hỏi sau:

Bạn có muốn thiết lập plugin VALIDATE PASSWORD không? [B]N[/b]
Mật khẩu mới: [B]your_secure_password[/b]
Nhập lại mật khẩu mới: [B]your_secure_password[/b]
Xóa người dùng ẩn danh? [Y/n] [B]Y[/b]
Không cho phép đăng nhập root từ xa? [Y/n] [B]Y[/b]
Xóa cơ sở dữ liệu thử nghiệm và quyền truy cập vào cơ sở dữ liệu đó? [Y/n] [B]Y[/b]
Tải lại bảng đặc quyền ngay bây giờ? [Y/n] [B]Y[/b]

Kết nối đến shell MariaDB với tư cách là người dùng gốc:

sudo mysql -u root -p
# Nhập mật khẩu

Tạo một cơ sở dữ liệu MariaDB trống và người dùng cho Shopware và ghi nhớ thông tin đăng nhập:

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

Thoát khỏi MariaDB:

mysql>exit

Thay thế dbname, username và mật khẩu bằng tên của bạn.

Bước 4- Cài đặt máy khách Acme.sh và lấy chứng chỉ Let's Encrypt (tùy chọn)​

Không nhất thiết phải bảo mật trang web của bạn bằng HTTPS, nhưng đây là một biện pháp tốt để bảo mật lưu lượng truy cập trang web của bạn. Để lấy chứng chỉ TLS từ Let's Encrypt, chúng ta sẽ sử dụng máy khách acme.sh. Acme.sh là phần mềm shell Unix thuần túy để lấy chứng chỉ TLS từ Let's Encrypt mà không phụ thuộc vào bất kỳ thứ gì.

Tải xuống và cài đặt acme.sh:

sudo pkg install -y acme.sh

Kiểm tra phiên bản acme.sh:

acme.sh --version
# v2.8.2

Lấy chứng chỉ RSA và ECC/ECDSA cho tên miền/tên máy chủ của bạn:

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

Nếu bạn muốn có chứng chỉ giả để thử nghiệm, bạn có thể thêm --stagingcờ cho các lệnh trên.

Sau khi chạy các lệnh trên, chứng chỉvà khóacủa bạn sẽ nằm trong:

• Đối với RSA: thư mục /home/username/example.com.
• Đối với ECC/ECDSA: thư mục /home/username/example.com_ecc.

Để liệt kê các chứng chỉ đã cấp, bạn có thể chạy:

acme.sh --list

Tạo một thư mục để lưu trữ các chứng chỉ của bạn. Chúng tôi sẽ sử dụng thư mục /etc/letsencrypt.

mkdir -p /etc/letsecnrypt/example.com
[ICODE]sudo mkdir -p /etc/letsencrypt/example.com_ecc

Cài đặt/sao chép chứng chỉ vào/etc/letsencryptthư mục.

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

Tất cả các chứng chỉ sẽ được tự động gia hạn sau mỗi 60 ngày.

Sau khi lấy được chứng chỉ, hãy thoát khỏi người dùng root và trở lại người dùng sudo bình thường:

exit

Bước 5- Cài đặt và configureNGINX​

Cài đặt máy chủ web NGINX:

sudo pkg install -y nginx

Kiểm tra phiên bản NGINX:

nginx -v
#nginx phiên bản: nginx/1.14.2

Khởi động và kích hoạt dịch vụ NGINX:

sudo sysrc nginx_enable=yes
sudo service nginx start

Cấu hình Nginx cho Shopware bằng cách chạy:

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

Và điền cấu hình sau vào tệp:

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; } vị trí ~ \.php$ { bao gồm fastcgi.conf; fastcgi_pass 127.0.0.1:9000; }}

Chạy sudo vim /usr/local/etc/nginx/nginx.conf[/ICODE] và thêm dòng bên dưới vào khối http {} để includeShopware config.

include shopware.conf;

Kiểm tra cấu hình Nginx xem có lỗi cú pháp không:

sudo nginx -t

Tải lại dịch vụ Nginx:

sudo service nginx reload

Bước 6 - Cài đặt Shopware​

Tạo thư mục gốc tài liệu cho Shopware:

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

Điều hướng đến thư mục gốc tài liệu:

cd /usr/local/www/shopware

Tải xuống và giải nén 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

LƯU Ý:Cập nhật URL tải xuống nếu có bản phát hành mới hơn.

Cung cấp quyền sở hữu phù hợp:

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

Tăng memory_limit = 256M và upload_max_filesize = 6M, và đặt allow_url_fopen = On nếu tùy chọn này chưa được đặt trong tệp /usr/local/etc/php.ini:

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

Sau khi thực hiện các thay đổi trong tệp /etc/php/7.2/fpm/php.ini, hãy tải lại php-fpm.service:

sudo service php-fpm reload

Mở tên miền/IP của bạn trong trình duyệt web và làm theo trình hướng dẫn cài đặt. Phần phụ trợ của Shopware nằm tại /backend ví dụ: http://example.com/backend.

Bước 7 - Hoàn tất thiết lập Shopware​

Bắt đầu bằng cách chọn ngôn ngữ và nhấp vào Tiếp theo:



Tiếp theo, hãy đảm bảo bạn đáp ứng mọi yêu cầu của Shopware:



Đồng ý với TOS của Shopware và nhấp vào Tiếp theo:



Nhập thông tin xác thực cơ sở dữ liệu và nhấp vào Tiếp theo:



Bắt đầu cài đặt để tạo bảng cơ sở dữ liệu:



Sau đó, bạn sẽ thấy thông báo về việc nhập cơ sở dữ liệu thành công:



Chọn giấy phép và nhấp vào Tiếp theo:



Điền một vài thiết lập cơ bản để hoàn tất quá trình thiết lập và nhấp vào Tiếp theo:



Quá trình cài đặt hoàn tất.



Để truy cập vào khu vực quản trị, hãy thêm /backend vào URL của bạn.



Bạn đã cài đặt Shopware thành công. Hãy tận hưởng cửa hàng trực tuyến mới của bạn!

Liên kết​

• https://en.shopware.com/
• https://github.com/shopware/shopware