Tutoriel Sylius : votre premier site e-commerce en 2 heures

Ce tutoriel vous guide pas a pas pour creer une boutique Sylius fonctionnelle en 2 heures. A la fin, vous aurez un site avec des produits, un panier, un checkout et un systeme de paiement. Pret ?

Prerequis

• PHP 8.3 avec extensions : intl, gd, exif, fileinfo, mbstring
• Composer 2.x
• Node.js 18+ et Yarn
• PostgreSQL 15+ (ou MySQL 8+)
• Symfony CLI (optionnel mais recommande)

Si vous preferez Docker, consultez notre guide Sylius avec Docker.

Etape 1 : Installation (15 min)

# Creer le projet
composer create-project sylius/sylius-standard mon-ecommerce
cd mon-ecommerce

# Configurer la base de donnees
# Editez .env : DATABASE_URL="postgresql://user:pass@127.0.0.1:5432/sylius"

# Installer Sylius
php bin/console sylius:install

L'installeur interactif vous demandera :

• La devise par defaut (EUR)
• La locale par defaut (fr_FR)
• Les identifiants admin (email + mot de passe)

# Compiler les assets
yarn install
yarn build

# Lancer le serveur
symfony server:start

Rendez-vous sur https://127.0.0.1:8000 pour la boutique et https://127.0.0.1:8000/admin pour l'administration.

Etape 2 : Configurer le canal (10 min)

Dans l'admin, allez dans Configuration > Canaux et modifiez le canal par defaut :

• Nom : Ma Boutique
• Devise : EUR
• Locales : fr_FR
• Theme : laissez le theme par defaut pour l'instant
• Hostname : votre domaine (ou localhost pour le dev)

Etape 3 : Creer les categories (10 min)

Allez dans Catalogue > Taxons et creez votre arborescence :

Catalogue (racine)
  |-- T-shirts
  |-- Pantalons
  |-- Accessoires
      |-- Casquettes
      |-- Ceintures

Chaque taxon a un slug (URL), une description et une image.

Etape 4 : Ajouter des produits (20 min)

Dans Catalogue > Produits > Creer un produit simple :

1. Code : TSHIRT-NOIR (unique, non modifiable)
2. Nom : T-shirt Classique Noir
3. Description : description complete du produit
4. Prix : 29.90 EUR pour le canal "Ma Boutique"
5. Images : uploadez 2-3 photos
6. Taxons : assignez a "T-shirts"
7. Expedition : poids, dimensions

Pour un produit avec des variantes (tailles, couleurs), choisissez Produit configurable et definissez les options.

Etape 5 : Configurer les zones et taxes (10 min)

# Admin > Configuration > Zones
France :
  - Type : Pays
  - Membres : France

# Admin > Configuration > Taux de taxe
TVA 20% :
  - Zone : France
  - Taux : 0.20
  - Inclus dans le prix : Oui

Etape 6 : Methodes d'expedition (10 min)

# Admin > Configuration > Methodes d'expedition
Livraison standard :
  - Zone : France
  - Calculateur : Tarif fixe (5.90 EUR)

Livraison express :
  - Zone : France
  - Calculateur : Tarif fixe (12.90 EUR)

Etape 7 : Methodes de paiement (10 min)

Pour le dev, activez le paiement hors-ligne :

# Admin > Configuration > Methodes de paiement
Paiement hors-ligne :
  - Code : OFFLINE
  - Passerelle : Offline
  - Canal : Ma Boutique

Pour la production, integrez Stripe :

composer require stripe/stripe-php
# + configuration du plugin de paiement Stripe

Etape 8 : Tester le checkout (15 min)

1. Visitez la boutique front
2. Ajoutez un produit au panier
3. Procedez au checkout
4. Renseignez une adresse
5. Choisissez la methode d'expedition
6. Choisissez le paiement
7. Confirmez la commande

Verifiez dans l'admin que la commande apparait bien dans Ventes > Commandes.

Prochaines etapes

Vous avez une boutique fonctionnelle. Pour passer en production :

• Creer un theme personnalise
• Optimiser le SEO
• Checklist de mise en production
• Configurer le cache avec Varnish

Besoin d'accompagnement pour votre projet Sylius ? Contactez-nous pour un devis gratuit. Consultez aussi nos tarifs.