Sylius è una moderna piattaforma di e-commerce per PHP, basata su Symfony Framework. Il codice sorgente di Sylius è ospitato su GitHub .
Questa guida ti guiderà attraverso il processo di installazione di Sylius su una nuova istanza di FreeBSD 12 Vultr usando PHP, MariaDB come database e Nginx come web server.
Requisiti
Per poter installare Sylius avrai bisogno di:
- Istanza del server Vultr con almeno 2048 MB di memoria.
- Nginx o Apache. In questa guida, utilizziamo Nginx.
- PHP versione 7.2 o superiore con alcune estensioni specifiche PHP:
gd
, exif
, fileinfo
,intl
- Impostazioni di configurazione PHP:
memory_limit
uguale o maggiore di 1024M
,date.timezone
- MySQL versione 5.7 o 8.0 o equivalente MariaDB
- Compositore
- Node.js
- Filato
Prima di iniziare
Controlla la versione di FreeBSD.
uname -ro
# FreeBSD 12.0-RELEASE
Assicurati che il tuo sistema FreeBSD sia aggiornato.
freebsd-update fetch install
pkg update && pkg upgrade -y
Installa i pacchetti necessari.
pkg install -y sudo vim unzip curl wget bash socat git
Crea un nuovo account utente con il tuo nome utente preferito. Useremo johndoe
.
adduser
# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!
Esegui il visudo
comando e decommenta la %wheel ALL=(ALL) ALL
riga per consentire ai membri del wheel
gruppo di eseguire qualsiasi comando.
visudo
# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL
Ora passa al nuovo utente creato con su
.
su - johndoe
NOTA: sostituisci johndoe
con il tuo nome utente.
Imposta il fuso orario.
sudo tzsetup
Installa PHP
Installa PHP e le estensioni PHP richieste.
sudo pkg install -y php73 php73-mbstring php73-tokenizer php73-pdo php73-pdo_mysql php73-openssl php73-hash php73-json php73-phar php73-filter php73-zlib php73-dom php73-xml php73-xmlwriter php73-xmlreader php73-curl php73-session php73-ctype php73-iconv php73-gd php73-simplexml php73-zip php73-filter php73-tokenizer php73-calendar php73-fileinfo php73-intl php73-phar php73-soap php73-xmlrpc php73-opcache php73-mysqli php73-bcmath php73-gmp php73-exif
Controlla la versione
php --version
# PHP 7.3.8 (cli) (built: Aug 8 2019 01:28:36) ( NTS )
Soft-link php.ini-production
a php.ini
.
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Abilita e avvia PHP-FPM.
sudo sysrc php_fpm_enable=yes
sudo service php-fpm start
Esegui sudo vim /usr/local/etc/php.ini
e imposta memory_limit
su 1024M
o più e imposta date.timezone
.
memory_limit = 1024M
date.timezone = Region/City
Riavvia PHP-FPM.
sudo service php-fpm restart
Installa MariaDB e crea un database
Installa MariaDB.
sudo pkg install -y mariadb102-client mariadb102-server
Controlla la versione
mysql --version
# mysql Ver 15.1 Distrib 10.2.25-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1
Avviare e abilitare MariaDB.
sudo sysrc mysql_enable="yes"
sudo service mysql-server start
Esegui lo mysql_secure installation
script per migliorare la sicurezza e impostare la password per l' root
utente.
sudo mysql_secure_installation
Connettiti alla shell come utente root.
sudo mysql -u root -p
# Enter password
Crea un database e un utente vuoti per Sylius e ricorda le credenziali.
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit
NOTA: sostituire dbname
e username
con nomi appropriati per la configurazione. Sostituisci password
con una password complessa.
Installa Nginx
Installa Nginx.
sudo pkg install -y nginx
Controlla la versione
nginx -v
# nginx version: nginx/1.16.1
Abilita e avvia Nginx.
sudo sysrc nginx_enable=yes
sudo service nginx start
Configura Nginx per Sylius. Esegui sudo vim /usr/local/etc/nginx/sylius.conf
e popola il file con la seguente configurazione.
server {
listen 80;
server_name example.com;
root /usr/local/www/sylius/public;
location / {
try_files $uri /index.php$is_args$args;
}
location ~ ^/index\.php(/|$) {
fastcgi_pass 127.0.0.1:9000;
fastcgi_split_path_info ^(.+\.php)(/.*)$;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
fastcgi_param DOCUMENT_ROOT $realpath_root;
internal;
}
location ~ \.php$ {
return 404;
}
client_max_body_size 6m;
}
Salvare il file e uscire con :+ W+ Q.
Ora dobbiamo includere sylius.conf
nel nginx.conf
file principale .
Esegui sudo vim /usr/local/etc/nginx/nginx.conf
e aggiungi la seguente riga al http {}
blocco.
include sylius.conf;
Prova la configurazione.
sudo nginx -t
Ricarica Nginx.
sudo service nginx restart
Installa Composer
Installa Composer a livello globale.
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'a5c698ffe4b8e849a443b120cd5ba38043260d5c4023dbf93e1558871f1f07f58274fc6f4c93bcfd858c6bd0775cd8d1') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer
Controlla la versione
composer --version
# Composer version 1.9.0 2019-08-02 20:55:32
Installa Node.js
Installa Node.js.
sudo pkg install -y node
Controlla la versione
node --version
# v12.4.0
Installa filato
Installa il gestore pacchetti Yarn.
sudo pkg install -y yarn
Controlla la versione
yarn --version
# 1.16.0
Installa Sylius
Creare una directory radice del documento.
sudo mkdir -p /usr/local/www/sylius
Cambia la proprietà della /usr/local/www/sylius
directory in johndoe
.
sudo chown -R johndoe:johndoe /usr/local/www/sylius
Passare alla cartella principale del documento.
cd /usr/local/www/sylius
Avvia un nuovo progetto Sylius eseguendo questo comando:
composer create-project sylius/sylius-standard .
Esegui vim .env.local
per inserire i dettagli del database ed eseguire Sylius in un ambiente di scelta.
APP_ENV=prod
DATABASE_URL=mysql://username:[email protected]/dbname
NOTA: Sostituire username
, password
e dbname
con i dati del database.
Dopo che tutto è a posto, esegui il comando seguente per installare Sylius:
php bin/console sylius:install -e prod
Per vedere un front-end completamente funzionale, dovrai installare i suoi asset. Sylius utilizza Gulp per creare risorse front-end utilizzando Yarn come gestore di pacchetti JavaScript. Dopo aver installato Yarn, vai alla directory del tuo progetto per installare le dipendenze.
yarn install
Quindi creare le risorse front-end eseguendo:
yarn build
Cambia la proprietà della /usr/local/www/sylius
directory in www
.
sudo chown -R www:www /usr/local/www/sylius
Crea /var/lib/php/session/
directory e cambia la proprietà in www
.
sudo mkdir -p /var/lib/php/session && sudo chown -R www:www /var/lib/php/session
Riavvia il servizio PHP-FPM.
sudo service php-fpm restart
La piattaforma di e-commerce Sylius è installata. Per impostazione predefinita, il pannello di amministrazione indirizza a /admin
.