Les différents paramètres de l’application sont configurés dans le fichier .env se trouvant dans la racine de l’installation burotex.
On procedera d’abord a copier et à ouvrir le fichier .env
nano .env
NB: Il est crucial de placer des valeurs dans les sections dites “REQUIRED” notamment
- # REQUIRED: BASIC APP SETTINGS
- # REQUIRED: DATABASE SETTINGS
- # REQUIRED: OUTGOING MAIL SERVER SETTINGS
- # REQUIRED: IMAGE LIBRARY
a) # REQUIRED: BASIC APP SETTINGS
# --------------------------------------------
APP_ENV=production
APP_DEBUG=false
APP_KEY=ChangeMe
APP_URL=http://dgmggm.local
APP_TIMEZONE='Africa/Niamey'
APP_LOCALE=fr
MAX_RESULTS=500
APP_ENV: doit etre égale à production (peut etre developement si besoin).
APP_DEBUG: true mettra l’installation en mode debug . Il est fortement recommendé de mettre false dans un environnement Production.
APP_KEY key généré de maniere aleatoire et est utilisé par l’app pour storer des données encryptées.
NB Ne Pas changer le key manuellement mais utiliser la commande php artisan key:generate pour creer un nouveau key. (Vous completerez cette etape apres avoir installe les dependances – Voir etape 5 plus haut.)
NB: SVP assurez vous de garder une copie de la key en backup (password manager, etc).
APP_URL Le url de l’application, commencant par http:// or https://. Cela ne doit avoir un trailing slash, ne doit etre null, et ne doit contenir le mot ‘public’ dans le URL.
b) # REQUIRED: DATABASE SETTINGS
# --------------------------------------------
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=dgmggm
DB_USERNAME=userdgmg
DB_PASSWORD=mdpasse
DB_PREFIX=null
DB_DUMP_PATH='/usr/bin'
DB_CHARSET=utf8mb4
DB_COLLATION=utf8mb4_unicode_ci
Ici on configure les paramètres de la db (voir ci dessus comme ex)
c) # REQUIRED: OUTGOING MAIL SERVER SETTINGS
# --------------------------------------------
MAIL_DRIVER=smtp
MAIL_HOST=smtp.dreamhost.com
MAIL_PORT=465
MAIL_USERNAME=direction@dgmggestionmateriel.com
MAIL_PASSWORD=@lnvd7eqxc19
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDR=direction@dgmggestionmateriel.com
MAIL_FROM_NAME='BuroTEX'
MAIL_REPLYTO_ADDR=direction@dgmggestionmateriel.com
MAIL_REPLYTO_NAME='BuroTEX'
MAIL_AUTO_EMBED_METHOD='attachment'
Ces paramètres sont requis pour permettre à burotex d’envoyer des emails. En cas de non configuration, les fonctionnalites comme les reinitialisation des mots de passe pour les utilisateurs, les alertes sur les niveaux des stocks etc.. ne peuvent etre éxécutées.
MAIL_DRIVER ‘smtp’ est par defaut. Autres options sont ‘mail’ (PHP mail function), ou ‘sendmail’
MAIL_HOST Le hostname du serveur sortant. NB: Ce serveur doit etre accessible à partir du serveur qui ‘run’ BuroTex.
MAIL_PORT Le # du port du serveur sortant. Les plus communs sont entre autres:
- 25 (connections non encryptees)
- 587 (connections encryptees)
Pour ceux qui utilisent gmail SVP nous recommandons les paramètres suivants:
driver smtp
host smtp.gmail.com
port 587
encryption tls
username votre_gmail_username
password votre_gmail_password
Vous devez aussi configurer quelques parametres dans le compte gmail pour gérer le ‘Google's security’
d) # REQUIRED: IMAGE LIBRARY
# Doit etre gd ou imagick
# --------------------------------------------
IMAGE_LIB=gd
GD Library or Imagemagick sont requis pour la création des barcodes et pour redimensionner les images téléchargées des actifs et autres items. Specifiez lequel est disponible sur votre serveur.
e) Requis: Permissions sur le répertoire
Les repertoires ‘storage’ et ‘uploads’ qui sont dans le repertoire ‘public’ ainsi que leurs sous-repertoires, doivent etre “writable” par le serveur web (apache/nginx) étant donné que les ‘caches’, fichiers logs et les autres items téléchargés sont ‘écrits’ dans ces repertoires.
Par ex pour apache2, l'on pourrait lancer les commandes suivantes
sudo chown www-data:www-data /var/www/dgmggm.com/ -R
cd dgmggm.com
sudo chmod -R 775 storage
sudo chmod -R 775 public/uploads
NB: Assurez vous que le repertoire de l’appli n’est pas ‘owned’ par root. Pour eviter des surprises, votre serveur devrait rouler avec www-data pour les serveurs apache2 par exemple.