Sylius est une plateforme de commerce électronique moderne pour PHP, basée sur Symfony Framework. Le code source de Sylius est hébergé sur GitHub .
Ce guide vous guidera à travers le processus d'installation de Sylius sur une nouvelle instance de FreeBSD 12 Vultr utilisant PHP, MariaDB comme base de données et Nginx comme serveur Web.
Exigences
Pour pouvoir installer Sylius, vous aurez besoin de:
- Instance de serveur Vultr avec au moins 2048 Mo de mémoire.
- Nginx ou Apache. Dans ce guide, nous utilisons Nginx.
- PHP version 7.2 ou plus , avec quelques extensions PHP spécifique:
gd
, exif
, fileinfo
,intl
- Paramètres de configuration PHP:
memory_limit
égaux ou supérieurs à 1024M
,date.timezone
- MySQL version 5.7 ou 8.0 ou équivalent MariaDB
- Compositeur
- Node.js
- Fil
Avant que tu commences
Vérifiez la version de FreeBSD.
uname -ro
# FreeBSD 12.0-RELEASE
Assurez-vous que votre système FreeBSD est à jour.
freebsd-update fetch install
pkg update && pkg upgrade -y
Installez les packages nécessaires.
pkg install -y sudo vim unzip curl wget bash socat git
Créez un nouveau compte utilisateur avec votre nom d'utilisateur préféré. Nous utiliserons 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!
Exécutez la visudo
commande et décommentez la %wheel ALL=(ALL) ALL
ligne pour permettre aux membres du wheel
groupe d'exécuter n'importe quelle commande.
visudo
# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL
Maintenant, passez à votre nouvel utilisateur avec su
.
su - johndoe
REMARQUE: remplacez johndoe
par votre nom d'utilisateur.
Configurez le fuseau horaire.
sudo tzsetup
Installer PHP
Installez PHP et les extensions PHP requises.
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
Vérifiez la version.
php --version
# PHP 7.3.8 (cli) (built: Aug 8 2019 01:28:36) ( NTS )
Lien logiciel php.ini-production
vers php.ini
.
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Activez et démarrez PHP-FPM.
sudo sysrc php_fpm_enable=yes
sudo service php-fpm start
Exécutez sudo vim /usr/local/etc/php.ini
et définissez memory_limit
sur 1024M
ou plus, puis configurez date.timezone
.
memory_limit = 1024M
date.timezone = Region/City
Redémarrez PHP-FPM.
sudo service php-fpm restart
Installez MariaDB et créez une base de données
Installez MariaDB.
sudo pkg install -y mariadb102-client mariadb102-server
Vérifiez la version.
mysql --version
# mysql Ver 15.1 Distrib 10.2.25-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1
Démarrez et activez MariaDB.
sudo sysrc mysql_enable="yes"
sudo service mysql-server start
Exécutez le mysql_secure installation
script pour améliorer la sécurité et définissez le mot de passe de l' root
utilisateur.
sudo mysql_secure_installation
Connectez-vous au shell en tant qu'utilisateur root.
sudo mysql -u root -p
# Enter password
Créez une base de données et un utilisateur vides pour Sylius, et souvenez-vous des informations d'identification.
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit
REMARQUE: remplacez dbname
et username
par des noms appropriés pour votre configuration. Remplacez-le password
par un mot de passe fort.
Installer Nginx
Installez Nginx.
sudo pkg install -y nginx
Vérifiez la version.
nginx -v
# nginx version: nginx/1.16.1
Activez et démarrez Nginx.
sudo sysrc nginx_enable=yes
sudo service nginx start
Configurez Nginx pour Sylius. Exécutez sudo vim /usr/local/etc/nginx/sylius.conf
et remplissez le fichier avec la configuration suivante.
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;
}
Enregistrez le fichier et quittez avec :+ W+ Q.
Maintenant, nous devons inclure sylius.conf
dans le nginx.conf
fichier principal .
Exécutez sudo vim /usr/local/etc/nginx/nginx.conf
et ajoutez la ligne suivante au http {}
bloc.
include sylius.conf;
Testez la configuration.
sudo nginx -t
Recharger Nginx.
sudo service nginx restart
Installer Composer
Installez Composer globalement.
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
Vérifiez la version.
composer --version
# Composer version 1.9.0 2019-08-02 20:55:32
Installez Node.js
Installez Node.js.
sudo pkg install -y node
Vérifiez la version.
node --version
# v12.4.0
Installer le fil
Installez le gestionnaire de packages Yarn.
sudo pkg install -y yarn
Vérifiez la version.
yarn --version
# 1.16.0
Installer Sylius
Créez un répertoire racine de document.
sudo mkdir -p /usr/local/www/sylius
Changez la propriété du /usr/local/www/sylius
répertoire en johndoe
.
sudo chown -R johndoe:johndoe /usr/local/www/sylius
Accédez au dossier racine du document.
cd /usr/local/www/sylius
Lancez un nouveau projet Sylius en exécutant cette commande:
composer create-project sylius/sylius-standard .
Exécutez vim .env.local
pour entrer les détails de la base de données et pour exécuter Sylius dans un environnement de choix.
APP_ENV=prod
DATABASE_URL=mysql://username:[email protected]/dbname
REMARQUE: Remplacer username
, password
et dbname
avec les détails de votre base de données.
Une fois que tout est en place, exécutez la commande suivante pour installer Sylius:
php bin/console sylius:install -e prod
Afin de voir un frontal entièrement fonctionnel, vous devrez installer ses actifs. Sylius utilise Gulp pour créer des ressources frontales en utilisant Yarn comme gestionnaire de packages JavaScript. Une fois Yarn installé, accédez à votre répertoire de projet pour installer les dépendances.
yarn install
Créez ensuite les ressources frontales en exécutant:
yarn build
Changez la propriété du /usr/local/www/sylius
répertoire en www
.
sudo chown -R www:www /usr/local/www/sylius
Créez un /var/lib/php/session/
répertoire et changez de propriétaire en www
.
sudo mkdir -p /var/lib/php/session && sudo chown -R www:www /var/lib/php/session
Redémarrez le service PHP-FPM.
sudo service php-fpm restart
La plateforme de commerce électronique Sylius est installée. Par défaut, le panneau d'administration est dirigé vers /admin
.