Logo de Cecil Cecil
Logo de Cecil Cecil
Sur cette page

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 pour les locales autres que en (sinon facultative, améliore les performances).
curl Contrôle des liens externes avec la commande doctor:links.
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 :

Linux

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

macOS

curl -Lo cecil https://github.com/Cecilapp/Cecil/releases/latest/download/cecil-macos-arm64
chmod +x cecil
xattr -d com.apple.quarantine cecil
./cecil --version

Les binaires ne sont pas signés : la commande xattr supprime l’attribut de quarantaine avant la première exécution.

Windows

curl.exe -Lo cecil.exe https://github.com/Cecilapp/Cecil/releases/latest/download/cecil-windows-x64.exe
.\cecil.exe --version

Installation globale

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

Linux

En déplaçant le PHAR dans un dossier de votre PATH :

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

macOS

Avec Homebrew :

brew install cecilapp/tap/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 script batch d’encapsulation à 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

Ou, si Cecil n’est pas installé globalement :

php cecil.phar --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 (alias selfupdate, 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 préversion

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.

Afficher en Markdown
Suggérer une modification
← Démarrage rapide Structure des dossiers →