Mise en ligne

Lien isolé Accueil docs Formation
Déploiement

Procédure générale de mise en ligne de l'application.

Mise en ligne – Shop Manager Pro V2 (app.shopmanagerpro.net)

Ce guide prépare le projet pour l’upload sur votre domaine et permet à l’app mobile de se connecter à https://app.shopmanagerpro.net/api/mobile.


1. Préparer les fichiers en local (sur votre PC)

Exécutez ces commandes à la racine du projet (boutique-app_v2) avant d’uploader.

1.1 Build des assets (obligatoire)

cd "e:\projet shopmanager pro\boutique-app_v2"
npm ci
npm run build

Cela génère le dossier public/build/ (JS/CSS compilés). Il doit être uploadé.

1.2 Dépendances PHP (à faire en local OU sur le serveur)

Option A – Vous uploadez tout (y compris vendor) : en local :

composer install --optimize-autoloader --no-dev

Puis uploadez le dossier vendor/.

Option B – Vous n’uploadez pas vendor : n’exécutez pas composer install en local. Uploadez tout sauf vendor, puis sur le serveur (SSH ou terminal hébergeur) :

composer install --optimize-autoloader --no-dev

1.3 Clé d’application

En local :

php artisan key:generate

Copiez la valeur APP_KEY=base64:... du fichier .env pour la mettre dans le .env sur le serveur.
Si vous préférez générer la clé sur le serveur après l’upload, vous pourrez y lancer php artisan key:generate (voir plus bas).


2. Fichiers à uploader sur le serveur

Uploadez tout le projet vers le répertoire prévu pour le site (ex. public_html, www, ou app.shopmanagerpro.net) sauf :

  • node_modules/ (ne pas uploader)
  • .env (ne pas uploader – on le crée sur le serveur)
  • .git/ (optionnel, souvent exclu)
  • Fichiers de dev (.idea, .vscode, *.log, etc.) si vous les excluez

À inclure impérativement :

  • app/, bootstrap/, config/, database/, public/, resources/, routes/, storage/, vendor/ (si vous l’avez généré en local)
  • Fichiers racine : artisan, composer.json, composer.lock, vite.config.js, package.json, etc.
  • public/build/ (résultat de npm run build)

Si vous n’avez pas uploadé vendor/, exécutez sur le serveur après l’upload :
composer install --optimize-autoloader --no-dev.


3. Fichier .env sur le serveur

Créez un fichier .env à la racine du projet sur le serveur (même niveau que artisan). Vous pouvez vous baser sur le fichier env.production.example à la racine du projet : copiez-le en .env sur le serveur puis modifiez les valeurs. Contenu type :

APP_NAME="Shop Manager Pro V2"
APP_ENV=production
APP_KEY=base64:VOTRE_CLE_GENEREE_ICI
APP_DEBUG=false
APP_URL=https://app.shopmanagerpro.net

LOG_CHANNEL=stack
LOG_LEVEL=error

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=nom_de_votre_base
DB_USERNAME=utilisateur_db
DB_PASSWORD=mot_de_passe_db
DB_PREFIX=v2_

BROADCAST_DRIVER=log
CACHE_DRIVER=file
FILESYSTEM_DISK=local
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120

MAIL_MAILER=smtp
MAIL_HOST=
MAIL_PORT=587
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS="noreply@shopmanagerpro.net"
MAIL_FROM_NAME="${APP_NAME}"

À adapter :

  • APP_KEY : copier depuis votre .env local après php artisan key:generate, ou générer sur le serveur avec php artisan key:generate.
  • DB_* :** identifiants de la base MySQL fournis par votre hébergeur.
  • DB_PREFIX=v2_ : si vous utilisez le préfixe de tables V2 (recommandé).

4. Configuration du serveur web (domaine / document root)

Le document root (racine du site) doit pointer vers le dossier public du projet, pas vers la racine du projet.

Exemples :

  • Chemin projet : /home/user/app.shopmanagerpro.net/
  • Document root à configurer : /home/user/app.shopmanagerpro.net/public

Ainsi, les URLs seront :

  • Site : https://app.shopmanagerpro.net
  • API mobile : https://app.shopmanagerpro.net/api/mobile (login : /api/mobile/auth/login)

Apache (ex. .htaccess dans public/)

Le fichier public/.htaccess Laravel est normalement déjà correct. À la racine du projet, un .htaccess peut rediriger tout vers public/ :

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteRule ^(.*)$ public/$1 [L]
</IfModule>

(Si votre hébergeur permet de définir directement le document root sur public, c’est préférable.)

Nginx (exemple)

server {
    listen 80;
    server_name app.shopmanagerpro.net;
    root /chemin/vers/boutique-app_v2/public;
    index index.php;
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

5. Après l’upload – commandes sur le serveur

Si vous avez SSH (ou un terminal type “Execute” dans le panel) :

cd /chemin/vers/boutique-app_v2

# Clé (si pas encore faite)
php artisan key:generate

# Dépendances (si vendor non uploadé)
composer install --optimize-autoloader --no-dev

# Migrations
php artisan migrate --force

# Lien symbolique storage (fichiers uploadés, logs, etc.)
php artisan storage:link

# Caches production
php artisan config:cache
php artisan route:cache
php artisan view:cache

Sans SSH : certaines hébergements proposent des scripts PHP ou des boutons “Run migrations” ; à utiliser selon ce que propose votre hébergeur. Le storage link peut parfois être fait via un script fourni (ex. create_storage_link.php déjà présent dans le projet).


6. Permissions (Linux / hébergement typique)

Sur un serveur Linux, souvent :

chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

(Remplacez www-data par l’utilisateur du serveur web si différent.)


7. Vérifications après mise en ligne

  1. Site web
    Ouvrir https://app.shopmanagerpro.net → page de connexion Laravel / Inertia.

  2. API mobile
    Tester le login depuis l’app mobile :

  3. Logs
    En cas d’erreur 500 : regarder storage/logs/laravel.log sur le serveur.


8. Résumé des étapes

Étape Où Action
1 Local npm ci puis npm run build
2 Local (Optionnel) composer install --no-dev si vous uploadez vendor
3 Local php artisan key:generate et noter APP_KEY
4 Serveur Uploader les fichiers (sans node_modules, sans .env)
5 Serveur Créer .env avec APP_URL=https://app.shopmanagerpro.net et BDD
6 Serveur Document root → dossier public
7 Serveur php artisan migrate --force, storage:link, caches
8 Mobile Configurer l’URL : https://app.shopmanagerpro.net/api/mobile

Une fois tout en place, l’app mobile pourra se connecter à https://app.shopmanagerpro.net/api/mobile sans erreur 404, à condition que le domaine pointe bien vers ce projet et que le document root soit public.