Sur cette page

• Prérequis
  • Extensions optionnelles
• Télécharger le PHAR
• Binaire autonome
• 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é, ainsi que sous forme de binaires autonomes qui ne nécessitent pas PHP.

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

Binaire autonome

Si PHP n’est pas installé, téléchargez le binaire autonome correspondant à votre plateforme depuis la dernière version GitHub. Il embarque PHP et les extensions requises.

Plateforme	Fichier
Linux x64	cecil-linux-x64
Linux ARM64	cecil-linux-arm64
macOS Intel	cecil-macos-x64
macOS Apple Silicon	cecil-macos-arm64
Windows x64	cecil-windows-x64.exe

Par exemple, sous Linux x64 :

curl -Lo cecil https://github.com/Cecilapp/Cecil/releases/latest/download/cecil-linux-x64
chmod +x cecil
./cecil --version

Sous macOS, les binaires ne sont pas signés : supprimez l’attribut de quarantaine avant la première exécution avec xattr -d com.apple.quarantine cecil.

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

Le binaire autonome se met à jour en le téléchargeant à nouveau.

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.