---
title: Lunar
created: 2026-06-08
updated: 2026-06-08
type: app
tags: [catalogue, e-commerce, laravel, php, headless, app-marathon3-batch-a]
confidence: medium
contested: false
sources: [https://selfh.st/apps/?tag=E-Commerce, https://lunarphp.io/]
---

# 🛍️ Lunar

> Plateforme e-commerce headless basée sur Laravel, conçue pour être extensible.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Site web** | [lunarphp.io](https://lunarphp.io/) |
| **GitHub** | [lunarcms/lunar](https://github.com/lunarcms/lunar) |
| **License** | MIT |
| **Langage** | PHP (Laravel) |
| **Étoiles GitHub** | 3.2k ⭐ |
| **Catégorie** | [[cat-e-commerce|E-commerce]] |

## 📝 Description

**Lunar** est une plateforme e-commerce **headless** moderne, construite sur Laravel. Approche API-first : pas de front-end imposé, vous construisez votre UI (Next.js, Nuxt, etc.) et consommez l'API GraphQL. Architecture extensible, support multi-canaux, multi-devises, multi-boutiques.

**Différence vs [[app-evershop]]** : Lunar est **headless** pur (pas de front inclus, vous choisissez). Evershop inclut un front React complet. Lunar cible les devs Laravel familiers.

**Pour qui** : agences e-commerce, projets custom sur Laravel, équipes avec front-end séparé.

## 🚀 Installation

### Docker Compose (Laravel + Lunar)

```yaml
version: '3.8'
services:
  app:
    image: php:8.3-fpm
    container_name: lunar-app
    restart: unless-stopped
    volumes:
      - ./lunar:/var/www/html
    working_dir: /var/www/html
    command: sh -c "php artisan serve --host=0.0.0.0"
    ports:
      - "8000:8000"
    environment:
      - DB_CONNECTION=pgsql
      - DB_HOST=db
      - DB_DATABASE=lunar
      - DB_USERNAME=lunar
      - DB_PASSWORD=secret
      - APP_URL=https://shop.example.com
    depends_on:
      - db
  db:
    image: postgres:16
    container_name: lunar-db
    restart: unless-stopped
    environment:
      POSTGRES_DB: lunar
      POSTGRES_USER: lunar
      POSTGRES_PASSWORD: secret
    volumes:
      - ./pgdata:/var/lib/postgresql/data
```

## 🔄 Alternatives

### Open Source
- [[app-woocommerce]] — PHP WP
- [[app-prestashop]] — PHP FR
- [[app-evershop]] — Node.js
- **Bagisto** — Laravel e-commerce (avec front)
- **AvoRed** — Laravel e-commerce

### Propriétaires
- **Shopify Hydrogen** — React headless
- **BigCommerce** — API-first

## 🔐 Sécurité
- **Laravel Sanctum/Passport** : auth API
- **OAuth2** : serveur
- **CSRF** : protection native
- **Rate limiting** : middleware Laravel
- **HTTPS** : obligatoire

## 📚 Ressources
- [Documentation Lunar](https://docs.lunarphp.io/)
- [GitHub Lunar](https://github.com/lunarcms/lunar)

## Pages Liées
- [[cat-e-commerce]] — Catégorie E-commerce
- [[app-evershop]] — Concurrent headless
- [[recettes-docker-compose]] — Templates Docker
