Sur cette page

• Prérequis
  • Extensions optionnelles
• Télécharger le PHAR
• Installation globale
  • macOS et Linux
  • Windows
  • PHIVE
  • Composer
• Vérifier l’installation
• Mise à jour
• Dépannage
  • command not found: cecil
  • Erreur de version ou d’extension PHP
  • Diagnostiquer un site

Installation

Cecil est distribué sous la forme d’un unique fichier exécutable, cecil.phar, qui fonctionne partout où PHP est installé.

Prérequis

• PHP 8.3+
• Extensions PHP : fileinfo, gd et mbstring

Vérifiez votre version de PHP et les extensions chargées :

php -v
php -m

Extensions optionnelles

Extension	Usage
intl	Localisation des dates avec d’autres locales que en (améliore les performances sinon).
imagick	Traitement des images, préféré à GD si disponible.
ffi	Traitement des images avec libvips (nécessite une installation via Composer).

Télécharger le PHAR

Téléchargez cecil.phar depuis votre terminal :

curl -LO https://cecil.app/cecil.phar

Puis exécutez-le avec PHP :

php cecil.phar --version

Installation globale

Installer Cecil globalement permet d’exécuter la commande cecil depuis n’importe quel dossier, au lieu de php cecil.phar.

macOS et Linux

Avec Homebrew :

brew install cecilapp/tap/cecil

Ou manuellement, en déplaçant le PHAR dans un dossier de votre PATH :

mv cecil.phar /usr/local/bin/cecil
chmod +x /usr/local/bin/cecil

Windows

Avec Scoop :

scoop install https://cecil.app/scoop/cecil.json

Ou manuellement :

1. Déplacez cecil.phar dans un dossier dédié tel que C:\bin
2. Renommez cecil.phar en cecil
3. Ajoutez ;C:\bin à votre variable d’environnement PATH
4. Créez un « wrapping batch script » à côté

PHIVE

Avec PHIVE (The PHAR Installation and Verification Environment) :

phive install cecil

Composer

Avec Composer :

composer global require cecil/cecil

Vérifier l’installation

cecil --version

Mise à jour

Mettez à jour Cecil vers la dernière version selon votre méthode d’installation :

# PHAR
php cecil.phar self-update
# Homebrew
brew upgrade cecilapp/tap/cecil
# Scoop
scoop update cecil
# PHIVE
phive update cecil
# Composer
composer global update cecil/cecil

La commande self-update (PHAR uniquement) accepte également les options suivantes :

• --rollback : revient à la version précédemment installée
• --stable : force la mise à jour vers la dernière version stable
• --preview : force la mise à jour vers la dernière version instable

Dépannage

command not found: cecil

Le dossier d’installation n’est pas dans votre PATH : ajoutez-le, ou exécutez Cecil avec php cecil.phar depuis le dossier contenant le PHAR.

Erreur de version ou d’extension PHP

Le PHP utilisé en ligne de commande peut différer de celui attendu (plusieurs versions installées) : vérifiez-le avec php -v et php --ini, puis activez les extensions manquantes dans le fichier php.ini chargé.

Diagnostiquer un site

Une fois un site créé, exécutez la commande doctor pour diagnostiquer sa configuration.