---
title: "FrankenPHP : le serveur d'applications PHP moderne, écrit en Go"
sidebar:
  label: "Introduction"
seo:
  description: "FrankenPHP est un serveur d'applications moderne pour PHP construit à partir du serveur web Caddy."
---
FrankenPHP est un serveur d'applications moderne pour PHP construit à partir du serveur web [Caddy](https://caddyserver.com/).

FrankenPHP donne des super-pouvoirs à vos applications PHP grâce à ses fonctionnalités à la pointe : [_Early Hints_](/fr/docs/early-hints), [mode worker](/fr/docs/worker), [fonctionnalités en temps réel](/fr/docs/mercure), HTTPS automatique, prise en charge de HTTP/2 et HTTP/3...

FrankenPHP fonctionne avec n'importe quelle application PHP et rend vos projets Laravel et Symfony plus rapides que jamais grâce à leurs intégrations officielles avec le mode worker.

FrankenPHP peut également être utilisé comme une bibliothèque Go autonome qui permet d'intégrer PHP dans n'importe quelle application en utilisant `net/http`.

Découvrez plus de détails sur ce serveur d'application dans le replay de cette conférence donnée au Forum PHP 2022 :

<a href="https://dunglas.dev/2022/10/frankenphp-the-modern-php-app-server-written-in-go/"><img src="https://dunglas.dev/wp-content/uploads/2022/10/frankenphp.png" alt="Diapositives" width="600"></a>

## Pour commencer

Sur Windows, utilisez [WSL](https://learn.microsoft.com/windows/wsl/) pour exécuter FrankenPHP.

### Script d'installation

Vous pouvez copier cette ligne dans votre terminal pour installer automatiquement
une version adaptée à votre plateforme :

```console
curl https://frankenphp.dev/install.sh | sh
```

### Binaire autonome

Nous fournissons des binaires statiques de FrankenPHP pour le développement, pour Linux et macOS,
contenant [PHP 8.4](https://www.php.net/releases/8.4/fr.php) et la plupart des extensions PHP populaires.

[Télécharger FrankenPHP](https://github.com/php/frankenphp/releases)

**Installation d'extensions :** Les extensions les plus courantes sont incluses. Il n'est pas possible d'en installer davantage.

### Paquets rpm

Nos mainteneurs proposent des paquets rpm pour tous les systèmes utilisant `dnf`. Pour installer, exécutez :

```console
sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm
sudo dnf module enable php-zts:static-8.4 # 8.2-8.5 disponibles
sudo dnf install frankenphp
```

**Installation d'extensions :** `sudo dnf install php-zts-<extension>`

Pour les extensions non disponibles par défaut, utilisez [PIE](https://github.com/php/pie) :

```console
sudo dnf install pie-zts
sudo pie-zts install asgrim/example-pie-extension
```

### Paquets deb

Nos mainteneurs proposent des paquets deb pour tous les systèmes utilisant `apt`. Pour installer, exécutez :

```console
sudo curl -fsSL https://key.henderkes.com/static-php.gpg -o /usr/share/keyrings/static-php.gpg && \
echo "deb [signed-by=/usr/share/keyrings/static-php.gpg] https://deb.henderkes.com/ stable main" | sudo tee /etc/apt/sources.list.d/static-php.list && \
sudo apt update
sudo apt install frankenphp
```

**Installation d'extensions :** `sudo apt install php-zts-<extension>`

Pour les extensions non disponibles par défaut, utilisez [PIE](https://github.com/php/pie) :

```console
sudo apt install pie-zts
sudo pie-zts install asgrim/example-pie-extension
```

### Docker

Des [images Docker](/fr/docs/docker) sont également disponibles :

```console
docker run -v .:/app/public \
    -p 80:80 -p 443:443 -p 443:443/udp \
    dunglas/frankenphp
```

Rendez-vous sur `https://localhost`, c'est parti !

<div class="fp-callout" data-callout="tip">
<p class="fp-callout-title">Astuce</p>

Ne tentez pas d'utiliser `https://127.0.0.1`. Utilisez `https://localhost` et acceptez le certificat auto-signé.
Utilisez [la variable d'environnement `SERVER_NAME`](/fr/docs/config#variables-denvironnement) pour changer le domaine à utiliser.

</div>

### Homebrew

FrankenPHP est également disponible sous forme de paquet [Homebrew](https://brew.sh) pour macOS et Linux.

Pour l'installer :

```console
brew install dunglas/frankenphp/frankenphp
```

**Installation d'extensions :** Utilisez [PIE](https://github.com/php/pie).

### Utilisation

Pour servir le contenu du répertoire courant, exécutez :

```console
frankenphp php-server
```

Vous pouvez également exécuter des scripts en ligne de commande avec :

```console
frankenphp php-cli /path/to/your/script.php
```

Pour les paquets deb et rpm, vous pouvez aussi démarrer le service systemd :

```console
sudo systemctl start frankenphp
```

## Documentation

- [Le mode classique](/fr/docs/classic)
- [Le mode worker](/fr/docs/worker)
- [Le support des Early Hints (code de statut HTTP 103)](/fr/docs/early-hints)
- [Temps réel](/fr/docs/mercure)
- [Servir efficacement les fichiers statiques volumineux](/fr/docs/x-sendfile)
- [Configuration](/fr/docs/config)
- [Écrire des extensions PHP en Go](/fr/docs/extensions)
- [Images Docker](/fr/docs/docker)
- [Déploiement en production](/fr/docs/production)
- [Optimisation des performances](/fr/docs/performance)
- [Créer des applications PHP **standalone**, auto-exécutables](/fr/docs/embed)
- [Créer un build statique](/fr/docs/static)
- [Compiler depuis les sources](/fr/docs/compile)
- [Surveillance de FrankenPHP](/fr/docs/metrics)
- [Intégration Laravel](/fr/docs/laravel)
- [Problèmes connus](/fr/docs/known-issues)
- [Application de démo (Symfony) et benchmarks](https://github.com/dunglas/frankenphp-demo)
- [Documentation de la bibliothèque Go](https://pkg.go.dev/github.com/dunglas/frankenphp)
- [Contribuer et débugger](/fr/docs/contributing)

## Exemples et squelettes

- [Symfony](https://github.com/dunglas/symfony-docker)
- [API Platform](https://api-platform.com/docs/distribution/)
- [Laravel](/fr/docs/laravel)
- [Sulu](https://sulu.io/blog/running-sulu-with-frankenphp)
- [WordPress](https://github.com/StephenMiracle/frankenwp)
- [Drupal](https://github.com/dunglas/frankenphp-drupal)
- [Joomla](https://github.com/alexandreelise/frankenphp-joomla)
- [TYPO3](https://github.com/ochorocho/franken-typo3)
- [Magento2](https://github.com/ekino/frankenphp-magento2)