Was ist Imagick

Imagick ist eine PHP-Erweiterungen, mit der die wichtigsten Funktionen der freien Bildbearbeitungssoftware "ImageMagick" innerhalb von PHP verwendet werden könne, ohne dass ImageMagick selbst installiert sein muss.

Somit ist Imagick eine Alternative zu GD-Lib (GD-Bibliothek), ebenfalls eine PHP-Bildbearbeitungs-Erweiterung - siehe http://docs.php.net/manual/de/ref.image.php

Im Gegensatz zu GD-Lib ist Imagick kaum dokumentiert. Trotz vielfacher Anfragen in Foren findet man so gut wie keine Anleitungen im Netz, was Anlass für mich war, diese Seite einzurichten.

Bei der Suche nach Informationen zu Imagick scheint es wenig sinnvoll zu sein, mit dem Suchbegriff "ImageMagick" zu arbeiten, da dort keine Hilfestellungen zum PHP-Programmierung mittels Imagick zu finden sind.

Basics

Homepage von Imagick (PHP-Extension)
http://pecl.php.net/package/imagick

Einführung in Imagick im offiziellen PHP-Handbuch
http://de.php.net/imagick

Homepage von ImageMagick allgemein
http://www.imagemagick.org/script/index.php

Wikipedia-Seite zu ImageMagick allgemein
http://de.wikipedia.org/wiki/ImageMagick
(für Webworker wenig informativ)

Mikko's Blog:
http://valokuva.org/?page_id=2
Blog von Mikko Koppanen ("one of the lead developers in PECL/Imagick PHP extension") mit vielen Anleitungen und PHP-Skripten für Imagick-Anwendungen

Imagick-Extension für Windows
Imagick Windows Builds
http://valokuva.org/?page_id=50
Downloads der von Koppanen weiterentwickelten "unofficial dynamic builds for the PECL/Imagick"

Kurze Hinweise zur Installation

Installation von Imagick

Auf Linux-Umgebung sind die erforderlichen Dateien im PHP-Softwarepaket enthalten. Sofern die Imagick-Funktionen nicht aktiviert sind, ist in der php.ini die Einbindung (das Laden) der Extension zu aktivieren. Dazu muss der (stets vorhandene) Ladebefehl auskommentiert werden, also das Semikolon zu Beginn der Zeile entfernt werden.

extension=php_imagick.dll

Wer keinen Zugriff auf den Server hat, muss den Webmaster darum bitten.

Um festzustellen, ob die Funktionen aktiviert sind, also die Extension geladen ist, kann man mit Hilfe des php-Befehls

<?php

echo phpinfo();

?>

die Konfigurationsdaten des Servers anzeigen lassen. In der folgenden Auflistung muss ein Abschnitt "Imagick" vorhanden sein.

Installation unter Windows

Bei der Installation unter Windows sind Besonderheiten zu beachten, die allgemein die User zur Verzweiflung bringen, wie zahlreichen Foren-Beiträge belegen. Die Hinweise sind ebenso unvollständig wie verwirrend, weshalb eine brauchbare Komplettanleitung derzeit fehlt (Stand Dez 07).

Notwendig sind auf alle Fälle spezielle Windows-Dateien; ansonsten muss wieder die php.ini geändert oder überprüft werden.

Die größte Stolperfalle ist für viele User die fehlende Einbindung des installierten ImageMagick-Programms in die so genannte Pfad-Umgebung (Pfadvariable, Path-Variablen), sofern das nicht schon bei der Installation beachtet wurde. Diese Einbidnung muss evtl. nachgeholt werden UND Windows neu gestartet werden.

Diese Pfadvariablen haben nichts mit der httpconf oder der php.ini zu tun, sondern sind eine Besonderheit im Windows-Betriebssystem, deren Funktion ich hier nicht näher erklären will (ältere Semester wie ich, insbesondere DOS-Anwender, werden sie noch kennen. Aber selbst die müssen sich bei Windows XP neu informieren).

Die Änderung selbst ist ein minimaler Aufwand. Eine knappe Anleitung zum Ändern der Pfadvariablen findet man z.B. unter http://www.pcwelt.de/know-how/tipps_tricks/betriebssysteme/windows/allgemein/37176/index.html

Wenn es noch schneller gehen soll: Windows Systemsteuerung Erweitert Umgebungsvariablen. Dort untere Box "Systemvariable"

Bei "Path" erscheinen rechts eine Reihe von Pfaden zu Programmen, unter anderem sollte dort ein Pfad zum ImageMagick-Programm stehen.

PS:

Einem aktuellem Kommentar von Mikko Koppanen zufolge, dem Hauptentwickler von Imagick, gibt es neben der dynamischen DLL auch eine statische DLL, die ohne Installation von ImageMagick auskommt und die wichtigsten Funktionen, wenn auch eingeschränkt, in sich trägt.

Kommentar vom 14.11.2007 auf http://valokuva.org/?page_id=50

1. To simplify the differences between dynamic and static build: dynamic requires you to install ImageMagick and static doesn’t. The latter would ideal, but seems like static builds have all kind of funky stuff going on; transparent pngs turn out black, drawing mysteriously fails in some cases and so on. .....