Manche Anwendungen brauchen für die Bildbearbeitung nicht nur die PHP-Erweiterung Imagick, sondern die eigentlichen ImageMagick-Kommandozeilenprogramme convert, identify und composite. Ein typisches Beispiel ist TYPO3: Im Processor-Modus ruft TYPO3 diese Programme direkt über exec() auf. Die PHP-Erweiterung allein reicht dafür nicht aus. Hier erfährst du, wie du prüfst, ob die Programme verfügbar sind, und wie du sie in deinem CMS einträgst.
Voraussetzungen
- Du hast Zugriff auf das HostPress-Kundencenter und darüber auf Plesk.
- Optional: Du hast SSH-Zugriff auf dein Hosting, um die Programme selbst zu prüfen.
- Du hast Administratorzugriff auf dein CMS, zum Beispiel auf das TYPO3 Install Tool.
- Gut zu wissen: HostPress ist auf WordPress spezialisiert. Serverseitige Programme stellen wir bereit, die Konfiguration innerhalb von TYPO3 oder anderen CMS liegt aber bei dir.
Schritt-für-Schritt-Anleitung
1. Unterschied zwischen PHP-Erweiterung und Kommandozeilenprogrammen verstehen
- PHP-Erweiterung Imagick: Sie wird von PHP-Code direkt genutzt, zum Beispiel von WordPress beim Erzeugen von Vorschaubildern.
- ImageMagick-Kommandozeilenprogramme: Das sind eigenständige Programme (
convert,identify,composite), die eine Anwendung über die Kommandozeile startet. TYPO3 braucht sie, wenn als Processor „ImageMagick“ eingestellt ist.
2. Verfügbarkeit per SSH prüfen
- Verbinde dich per SSH mit deinem Hosting.
- Führe diese Befehle aus:
which convert identify composite convert --version - Werden Pfade wie
/usr/bin/convertund eine Versionsnummer angezeigt, sind die Programme installiert. Gibt es keine Ausgabe, fehlen sie.
3. Installation beim Support anfragen
Fehlen die Programme, schreib dem HostPress-Support. Nenne dabei:
- die betroffene Domain,
- welche Programme du brauchst (z. B.
convert,identify,composite), - wofür du sie brauchst (z. B. „TYPO3 13 im Processor-Modus ImageMagick“).
Der Support prüft die Installation und teilt dir den Pfad mit.
4. Pfad in TYPO3 eintragen
- Öffne in TYPO3 das Install Tool und dort Settings → Image Processing.
- Setze
processorauf ImageMagick. - Trage bei
processor_pathden Pfad ein, den du in Schritt 2 ermittelt oder vom Support erhalten hast, zum Beispiel/usr/bin/. - Speichere die Einstellungen.
5. Bildverarbeitung testen
- Öffne im Install Tool den Bereich Environment → Test images.
- Prüfe, ob die Testbilder korrekt erzeugt werden. Erzeuge zusätzlich eine PDF-Vorschau, falls du sie brauchst.
- Leere anschließend die TYPO3-Caches.
Fazit & Support-Hinweis
Die PHP-Erweiterung Imagick und die ImageMagick-Kommandozeilenprogramme sind zwei verschiedene Dinge. TYPO3 und andere CMS, die Bilder über exec() verarbeiten, brauchen die Kommandozeilenprogramme. Prüfe deshalb zuerst per SSH, ob sie vorhanden sind, und frag sie sonst beim Support an. Melde dich beim Support, wenn die Testbilder trotz korrektem Pfad nicht erzeugt werden. Nenne dabei die Domain, die TYPO3-Version und die Fehlermeldung aus dem Install Tool.