Welche PHP-Mindestanforderungen müssen für die Nutzung von Couscous erfüllt sein?

Melden

Für die Nutzung von Couscous (dem statischen Website-Generator für PHP) gelten die folgenden Mindestanforderungen:

1. PHP-Version

  • Mindestens PHP 7.1: Obwohl Couscous in älteren Versionen noch mit PHP 5.x funktionierte, setzen aktuelle Versionen und deren Abhängigkeiten mindestens PHP 7.1 voraus.
  • Empfehlung: Für eine bessere Performance und Sicherheit wird die Nutzung einer aktuellen stabilen Version wie PHP 8.1 oder 8.2 empfohlen.

2. Erforderliche PHP-Erweiterungen

Damit Couscous reibungslos funktioniert, müssen bestimmte Erweiterungen in der php.ini aktiviert sein:

  • mbstring: Für die korrekte Verarbeitung von Multibyte-Zeichenketten (wichtig für die Markdown-Konvertierung).
  • openssl: Wird benötigt, um via HTTPS auf Ressourcen zuzugreifen (z. B. beim Deployment auf GitHub Pages).
  • json: Für das Einlesen der Konfigurationsdateien (couscous.yml nutzt intern oft JSON-Parser oder Abhängigkeiten, die dies benötigen).
  • phar: Falls du Couscous als .phar-Datei (ausführbares Archiv) verwendest.

3. Composer

Da Couscous als PHP-Projekt verwaltet wird, ist Composer zwingend erforderlich, um das Tool zu installieren:

  • Die Installation erfolgt meist global über: composer global require couscous/couscous

4. Git (Optional, aber empfohlen)

Da Couscous häufig genutzt wird, um Dokumentationen direkt auf GitHub Pages zu veröffentlichen, sollte Git auf deinem System installiert und im Pfad (PATH) verfügbar sein.

Zusammenfassung der Prüfung

Du kannst auf deinem Terminal prüfen, ob dein System bereit ist, indem du folgende Befehle ausführst:

php -v               # Zeigt die PHP-Version (sollte >= 7.1 sein)
php -m | grep mbstring  # Prüft, ob mbstring installiert ist
php -m | grep openssl   # Prüft, ob openssl installiert ist

Hinweis: Falls du Couscous auf einem sehr modernen Server mit PHP 8.3 einsetzt, stelle sicher, dass du die aktuellste Version von Couscous verwendest, da ältere Versionen möglicherweise Probleme mit den strengeren Typisierungen von PHP 8 haben könnten.

0