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 denpm 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
.envlocal aprèsphp artisan key:generate, ou générer sur le serveur avecphp 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
Site web
Ouvrirhttps://app.shopmanagerpro.net→ page de connexion Laravel / Inertia.API mobile
Tester le login depuis l’app mobile :- URL du serveur : https://app.shopmanagerpro.net/api/mobile
- Code boutique, email et mot de passe d’un utilisateur existant.
Logs
En cas d’erreur 500 : regarderstorage/logs/laravel.logsur 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.