Manuel d'utilisation

Installer CAMPP

CAMPP est un environnement de développement web local : Caddy (serveur web), PHP, MySQL ou MariaDB, PostgreSQL, phpMyAdmin et Adminer réunis dans une seule application. Il s'exécute depuis votre dossier utilisateur, donc aucun droit administrateur n'est nécessaire.

Windows : CAMPP-x64.exe (recommandé) ou .msi. Les fichiers .zip portables fonctionnent sans installation ; la version hors ligne inclut déjà tous les runtimes.
macOS : le fichier universal.dmg fonctionne sur Apple Silicon et Intel. Ouvrez-le et faites glisser CAMPP dans Applications.
Linux : .deb (Ubuntu/Debian), .rpm (Fedora/openSUSE), .AppImage ou une archive portable .tar.gz.

Sous Windows, SmartScreen peut afficher un avertissement concernant une application inconnue. Cliquez sur More info puis sur Run anyway. Les versions macOS sont signées et notariées par Apple.

Premier lancement

Au premier lancement de CAMPP, un court assistant de configuration télécharge les runtimes que vous choisissez.

Cliquez sur Get Started sur l'écran d'accueil.
Choisissez les composants souhaités et sélectionnez une version pour chacun. Caddy et PHP sont obligatoires.
Sur le même écran, définissez un mot de passe root pour chaque base de données installée (MySQL/MariaDB et PostgreSQL). Retenez-le : il vous servira à vous connecter aux bases de données.
Cliquez sur Download & Install. CAMPP télécharge et configure tout.
Une fois terminé, cliquez sur Continue to Dashboard.

Sous Linux, si l'assistant indique des paquets système manquants, installez-les avec votre gestionnaire de paquets puis cliquez sur Retry Check.

Démarrer et arrêter les services

La page Services de CAMPP avec Caddy, PHP-FPM, MySQL et PostgreSQL en cours d'exécution — Services : chaque ligne affiche la version, le port et l'état, avec un interrupteur pour démarrer ou arrêter le service.

La page Services liste tous les services installés. Utilisez l'interrupteur d'une ligne pour démarrer ou arrêter le service, la flèche circulaire pour le redémarrer, ou Start all / Stop all en haut de la page.

Les cartes situées sous la liste ouvrent votre Website, phpMyAdmin, Adminer ou votre Projects folder. Les trois premières nécessitent que Caddy soit démarré.

Service	Port par défaut	Adresse
Serveur web (Caddy)	8080	`http://localhost:8080`
PHP-FPM	9000	Interne, utilisé par Caddy
MySQL / MariaDB	3307	`127.0.0.1:3307`
PostgreSQL	5433	`127.0.0.1:5433`

CAMPP utilise ces ports non standard afin de pouvoir fonctionner à côté d'un MySQL ou d'un PostgreSQL que vous auriez déjà installé.

Vos projets

Placez chaque site web dans son propre dossier à l'intérieur du dossier des projets. Pour l'ouvrir, cliquez sur la carte Projects folder de la page Services.

projects/
├── my-site/
│   ├── index.php
│   └── style.css
└── shop/
    └── index.html

http://localhost:8080/my-site/ exécute my-site/index.php.
Un dossier contenant un index.html est servi comme site statique.
Une page inexistante, ou un dossier sans index.php ni index.html, affiche 404 Not Found. Créez un lien direct vers le fichier, par exemple /my-site/report.php.

La page d'accueil de CAMPP affichant les versions de PHP et de Caddy et des liens vers PHP info, phpMyAdmin et Adminer — http://localhost:8080 affiche la page d'accueil de CAMPP avec votre version de PHP et des liens rapides.

Bases de données

Paramètre	MySQL / MariaDB	PostgreSQL
Hôte	`127.0.0.1`	`127.0.0.1`
Port	`3307`	`5433`
Utilisateur	`root`	`root`
Mot de passe	Le mot de passe root défini lors de la configuration	Le mot de passe root défini lors de la configuration

Connexion depuis PHP avec PDO :

<?php
$mysql = new PDO('mysql:host=127.0.0.1;port=3307;dbname=test;charset=utf8mb4', 'root', 'your-password');
$pgsql = new PDO('pgsql:host=127.0.0.1;port=5433;dbname=postgres', 'root', 'your-password');

Utilisez 127.0.0.1 plutôt que localhost pour MySQL. Avec localhost, PHP tente d'utiliser un socket local au lieu du port TCP.

La page de connexion de phpMyAdmin — phpMyAdmin (http://localhost:8080/phpmyadmin) : connectez-vous en tant que root avec le mot de passe de votre base de données.

Le lanceur Adminer de CAMPP avec des boutons de connexion pour MySQL et PostgreSQL — Adminer (http://localhost:8080/adminer) : choisissez MySQL ou PostgreSQL, puis saisissez le mot de passe de votre base de données.

phpMyAdmin et Adminer demandent toujours votre mot de passe. Vos bases de données restent ainsi protégées si vous partagez votre site sur le réseau.

Composants

La page Components listant Caddy, PHP, MySQL, phpMyAdmin, PostgreSQL, Adminer et ngrok — Components : installez, réinstallez ou supprimez les logiciels utilisés par CAMPP.

La page Components affiche chaque composant et sa version installée. Install ajoute un composant manquant, Uninstall le supprime et Reinstall vous permet de choisir une autre version.

La boîte de dialogue de réinstallation de PHP avec un sélecteur de version — Reinstall : choisissez une version, puis cliquez sur Reinstall.

Pour obtenir les derniers correctifs de sécurité de PHP, ouvrez Components → PHP → Reinstall et choisissez la version marquée Latest.

Arrêtez tous les services avant d'installer, de réinstaller ou de supprimer un composant.

Paramètres

La page Settings avec Network, Ports, Database passwords et la zone de danger — Settings : les modifications s'appliquent au prochain démarrage des services.

Network : Local only (par défaut) signifie que seul cet ordinateur peut ouvrir vos sites. LAN permet aux autres appareils de votre réseau d'y accéder.
Ports : changez un port si un autre programme l'utilise déjà.
Database passwords : saisissez un nouveau mot de passe root, ou laissez le champ vide pour conserver l'actuel. Le mot de passe actuel n'est jamais affiché.
Delete all projects and databases : vide le dossier des projets et supprime toutes les bases de données. Aucune sauvegarde n'est effectuée, alors faites-en une avant.

Les paramètres ne peuvent être modifiés que lorsque tous les services sont arrêtés. Le thème (System, Light, Dark) peut être changé à tout moment grâce aux icônes en bas de la barre latérale.

Sauvegarde et restauration

La page Backup avec les boutons Open folder et Back up now — Backup : un seul zip contenant vos projets et toutes les données de vos bases.

Cliquez sur Stop all dans la page Services.
Ouvrez Backup et cliquez sur Back up now. Le zip apparaît dans la liste.
Pour revenir à une sauvegarde, cliquez sur Restore. CAMPP enregistre d'abord votre état actuel (marqué before restore), de sorte qu'une restauration peut être annulée.
Cliquez sur Delete pour supprimer une sauvegarde dont vous n'avez plus besoin.

Open folder indique où sont stockées les sauvegardes. Pour passer à un autre ordinateur, copiez le zip dans le dossier des sauvegardes de cet ordinateur.

Les données des bases ne peuvent être restaurées que sur le même système d'exploitation (Windows, macOS ou Linux). Pour transférer des bases de données entre systèmes, exportez-les avec phpMyAdmin ou Adminer et importez-les sur l'autre ordinateur.

Partager avec d'autres appareils

Par défaut, CAMPP ne répond que sur 127.0.0.1 : personne d'autre ne peut accéder à vos sites ni à vos bases de données.

Le mode LAN (Settings → Network) permet aux téléphones et aux autres ordinateurs du même réseau d'ouvrir votre site, par exemple http://192.168.1.20:8080.
ngrok (Windows) donne à votre site une adresse publique sur Internet. Installez ngrok depuis la page Components, collez votre authtoken obtenu sur ngrok.com dans Settings, puis démarrez ngrok depuis la page Services.

N'utilisez le mode LAN et ngrok que sur des réseaux de confiance, et définissez des mots de passe de base de données robustes. Settings vous avertit lorsqu'un mot de passe est faible alors que le mode LAN est activé.

Dépannage

La page Debug avec les informations système, les dossiers, la vérification des ports et la réinitialisation — Debug : versions, dossiers, vérification des ports et réinitialisation complète.

Un service ne démarre pas : ouvrez Debug → Port check. Si un port est In Use, un autre programme l'utilise ; changez le port dans Settings.
Impossible de se connecter à phpMyAdmin ou Adminer : utilisez root et le mot de passe de la base de données. Définissez-en un nouveau dans Settings → Database passwords.
Besoin d'aide : cliquez sur Copy diagnostics et collez le résultat dans une issue GitHub.
Repartir de zéro : Reset installation supprime les runtimes, les bases de données et les paramètres. Votre dossier des projets et vos sauvegardes sont conservés.

Où CAMPP stocke vos fichiers

Système	Emplacement
Windows	Le dossier d'installation de CAMPP (par défaut `%LOCALAPPDATA%\CAMPP`), ou l'endroit où vous avez décompressé la version portable
macOS	`~/Library/Application Support/campp`
Linux	`~/.local/share/campp`

On y trouve : projects (vos sites), mysql/data et pgsql/data (les bases de données), backups, logs et runtime (les programmes téléchargés). Debug → Folders affiche les chemins exacts sur votre ordinateur.