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

[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 Fedora 30 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 Fedora 29.
• 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 Fedora của bạn:

cat /etc/fedora-release
# Fedora phát hành 29 (Hai mươi chín)

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

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

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:

sudo dnf 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 Fedora:

sudo dnf install -y curl wget vim gitsudo unzip socat bash-completion

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 dnf install -y php php-cli php-fpm php-common php-mysqlnd php-curl php-json php-zip php-gd php-xml php-mbstring php-opcache

Để hiển thị PHP đã 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 systemctl start php-fpm.service
sudo systemctl enable php-fpm.service

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

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_lin_x86-64.tar.gz

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

tar xfz ioncube_loaders_lin_*.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/lib64/php/modules = > /usr/lib64/php/modules

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

sudo cp /tmp/ioncube/ioncube_loader_lin_7.2.so /usr/lib64/php/modules

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

sudo vim /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ể nằm ở bất kỳ đâu trong tệp bên dưới dòng [PHP]:

zend_extension = /usr/lib64/php/modules/ioncube_loader_lin_7.2.so

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

sudo systemctl restart php-fpm.service

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 dnf install -y mariadb-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 cách sử dụng readline 5.1

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

sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

Chạy tập lệnh mysql_secure installation để 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 với 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, tên người dùng và mật khẩu bằng tên của bạn.

Bước 4- Cài đặt ứng dụng 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 ứng dụng 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 cần bất kỳ sự phụ thuộc nào.

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

sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh 
./acme.sh --install --accountemail [emailprotected]
source ~/.bashrc
cd ~

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

acme.sh --version
# v2.8.1

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 --stagingflag vào 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 "sudo systemctl reload nginx.service"

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à cấu hình NGINX​

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

sudo dnf install -y nginx

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

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

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

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

Cấu hìnhNGINX cho Shopware. Chạy sudo vim /etc/nginx/conf.d/shopware.conf[/ICODE] và thêm cấu hình sau:

server { listen 80; listen [::]:80; server_name example.com; root /var/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 unix:/run/php-fpm/www.sock; }}

Kiểm tracấu hình NGINX để tìm lỗi cú pháp:

sudo nginx -t

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

sudo systemctl reload nginx.service

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

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

sudo mkdir -p /var/www/shopware

Thay đổi quyền sở hữu của /var/www/shopware thành{your_user}. Thay thế {your_user} bằng tên người dùng của người dùng mà bạn hiện đang đăng nhập:

sudo chown -R {your_user}:{your_user} /var/www/shopware

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

cd /var/www/shopware

Tải xuống và giải nén bản phát hành mới nhấtShopware qua wget:

wget https://releases.shopware.com/install_5.5.8_d5bf50630eeaacc6679683e0ab0dcba89498be6d.zip?_ga=2.141661361.269357371.1556739808-1418008019.1556603459 -O shopware.zip
giải nén shopware.zip
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.

Thay đổi quyền sở hữu thư mục /var/www/shopware thành nginx.

sudo chown -R nginx:nginx /var/www/shopware

Chạy sudo vim /etc/php-fpm.d/www.conf và đặt người dùng và nhóm thành nginx. Ban đầu, chúng sẽ được đặt thành apache:

sudo vim /etc/php-fpm.d/www.conf

user = nginx
group = nginx

Tạo thư mục /var/lib/php/session/ và thay đổi quyền sở hữu thành nginx.

sudo mkdir -p /var/lib/php/session && sudo chown -R nginx:nginx /var/lib/php/session

Tăng memory_limit = 256M và upload_max_filesize = 6M, đồng thời đặt allow_url_fopen = On nếu chưa đặt trong tệp /etc/php/7.2/fpm/php.ini.

sudo vim /etc/php.ini

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

sudo systemctl reload php-fpm.service

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