3. Configuration du .env


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

cp .env.example .env
nano .env


# 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
# --------------------------------------------
# REQUIRED: UPLOADED FILE STORAGE SETTINGS
# --------------------------------------------
PRIVATE_FILESYSTEM_DISK=local
PUBLIC_FILESYSTEM_DISK=local_public
# --------------------------------------------
# REQUIRED: DATABASE SETTINGS
# --------------------------------------------
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=dgmggm
DB_USERNAME=userdgmg
DB_PASSWORD=V1Lm2*Vfxqk@kr6Eqv!
DB_PREFIX=null
DB_DUMP_PATH='/usr/bin'
DB_CHARSET=utf8mb4
DB_COLLATION=utf8mb4_unicode_ci
# --------------------------------------------
# OPTIONAL: SSL DATABASE SETTINGS
# --------------------------------------------
DB_SSL=false
DB_SSL_IS_PAAS=false
DB_SSL_KEY_PATH=null
DB_SSL_CERT_PATH=null
DB_SSL_CA_PATH=null
DB_SSL_CIPHER=null
# --------------------------------------------
# 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'
# --------------------------------------------
# REQUIRED: IMAGE LIBRARY
# This should be gd or imagick
# --------------------------------------------
IMAGE_LIB=gd
# --------------------------------------------
# OPTIONAL: SESSION SETTINGS
# --------------------------------------------
SESSION_LIFETIME=60
EXPIRE_ON_CLOSE=false
ENCRYPT=false
COOKIE_NAME=snipeit_session
COOKIE_DOMAIN=null
SECURE_COOKIES=false
API_TOKEN_EXPIRATION_YEARS=40
# --------------------------------------------
# OPTIONAL: SECURITY HEADER SETTINGS
# --------------------------------------------
APP_TRUSTED_PROXIES=192.168.1.1,10.0.0.1
ALLOW_IFRAMING=false
REFERRER_POLICY=same-origin
ENABLE_CSP=false
CORS_ALLOWED_ORIGINS=null
ENABLE_HSTS=false
# --------------------------------------------
# OPTIONAL: CACHE SETTINGS
# --------------------------------------------
CACHE_DRIVER=file
SESSION_DRIVER=file
QUEUE_DRIVER=sync
CACHE_PREFIX=snipeit
# --------------------------------------------
# OPTIONAL: REDIS SETTINGS
# --------------------------------------------
REDIS_HOST=null
REDIS_PASSWORD=null
REDIS_PORT=null
# --------------------------------------------
# OPTIONAL: MEMCACHED SETTINGS
# --------------------------------------------
MEMCACHED_HOST=null
MEMCACHED_PORT=null
# --------------------------------------------
# OPTIONAL: PUBLIC S3 Settings
# --------------------------------------------
PUBLIC_AWS_SECRET_ACCESS_KEY=null
PUBLIC_AWS_ACCESS_KEY_ID=null
PUBLIC_AWS_DEFAULT_REGION=null
PUBLIC_AWS_BUCKET=null
PUBLIC_AWS_URL=null
PUBLIC_AWS_BUCKET_ROOT=null
# --------------------------------------------
# OPTIONAL: PRIVATE S3 Settings
# --------------------------------------------
PRIVATE_AWS_ACCESS_KEY_ID=null
PRIVATE_AWS_SECRET_ACCESS_KEY=null
PRIVATE_AWS_DEFAULT_REGION=null
PRIVATE_AWS_BUCKET=null
PRIVATE_AWS_URL=null
PRIVATE_AWS_BUCKET_ROOT=null
# --------------------------------------------
# OPTIONAL: LOGIN THROTTLING
# --------------------------------------------
LOGIN_MAX_ATTEMPTS=5
LOGIN_LOCKOUT_DURATION=60
# --------------------------------------------
# OPTIONAL: MISC
# --------------------------------------------
APP_LOG=single
APP_LOG_MAX_FILES=10
APP_LOCKED=false
APP_CIPHER=AES-256-CBC
GOOGLE_MAPS_API=null
BACKUP_ENV=true
LDAP_MEM_LIM=500M
LDAP_TIME_LIM=600

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.


Avez-vous trouvé cet article utile ?



  • Introduction

    Burotex est une application PHP qui requiert un serveur web sur LAMP pour pouvoir etre installée. Etant donné que l’application est ba...

  • Securité

    Nous utilisons bcrypt (une hash fonction basée sur Blowfish symmetric block cipher cryptographic algorithm ) pour gérer les mots de passe. E...

  • Pré -requis

    Les pré-requis du buroTex sont pratiquement standard pour un serveur web moderne. General System: Ubuntu 18.04 + PHP >= 7.4 MySQL ou MariaDB ...

  • Installation

    Une fois que l’application est téléchargée, vous devez compléter toutes les étapes ci-dessous en plus de configurer vot...

  • 1. Téléchargement du source code

    Le lien est envoyé aux clients par email...