Bilder mit PHP Imagick skalieren und Wasserzeichen hinzufügen
Um ein Foto mit PHP Imagick zu skalieren und mit einem Wasserzeichen zu versehen, wenden Sie zuerst seine Ausrichtung an, skalieren dann die Pixel und zeichnen anschließend den Text in der endgültigen Größe. Das folgende Skript verarbeitet ein lokales JPEG oder PNG, reduziert Breiten über 800 Pixel ohne Zuschnitt und speichert ein separates PNG mit „© Your Company“ in der unteren rechten Ecke. Ihr Original bleibt unverändert, und eine vorhandene Ausgabedatei wird nie überschrieben.
Imagick ist die PHP-Schnittstelle zu ImageMagick. Damit können Sie diese Vorgänge an einem Bild im Arbeitsspeicher ausführen. Dieses Beispiel ist für Standbilder gedacht, die Sie selbst kontrollieren: Verwenden Sie ein sRGB-Foto oder PNG, auch mit Transparenz. GIF, WebP, PDF und CMYK-Eingaben werden abgelehnt. Animierte PNGs und JPEGs mit mehreren Bildern (MPO) liegen außerhalb dieses Tutorials. Der Decoder kann nur das erste Einzelbild bereitstellen. Die Prüfung der decodierten Einzelbildanzahl belegt daher nicht, dass eine Datei nur ein Bild enthält.
PHP und Imagick einrichten
Die folgende Einrichtung verwendet Docker und ein Bash-kompatibles Terminal unter Linux. Sie wurde
unter Linux x86_64 mit PHP 8.4.27, Imagick 3.8.1, ImageMagick 7.1.2-35 und DejaVu Sans 2.37 getestet.
Das Dockerfile legt die Versionen von PHP und Imagick fest, installiert aber die aktuellen Pakete
aus den Repositorys von Alpine 3.23. Spätere Builds können neuere Alpine-Paketrevisionen verwenden.
Erstellen Sie ein leeres Arbeitsverzeichnis und öffnen Sie dort Ihr Terminal. Speichern Sie
Folgendes als Dockerfile:
FROM php:8.4.27-cli-alpine3.23
RUN apk add --no-cache imagemagick imagemagick-jpeg font-dejavu \
&& apk add --no-cache --virtual .build-deps $PHPIZE_DEPS imagemagick-dev \
&& pecl install imagick-3.8.1 \
&& docker-php-ext-enable imagick \
&& apk del .build-deps \
&& fc-cache -f
ENV XDG_CACHE_HOME=/tmp
WORKDIR /work
Erstellen Sie das lokale Image. Dieser Schritt benötigt Internetzugriff. Die Installation der Erweiterung folgt der PECL-Anleitung zum offiziellen PHP-Image.
docker build -t imagick-demo:local .
Warten Sie auf einen erfolgreichen Build, bevor Sie fortfahren. Alpine stellt den
JPEG-Coder als separates Paket bereit,
daher installiert die Einrichtung ihn explizit. Das Image enthält die Schrift unter
/usr/share/fonts/dejavu/DejaVuSans.ttf, erstellt deren Schriftcache und speichert Laufzeit-Caches im
beschreibbaren Verzeichnis /tmp des Containers. Wenn Sie diesen
PHP/Imagick-Stack bereits lokal installiert haben, können Sie das PHP-Skript direkt mit Ihrer eigenen
Schriftdatei ausführen. Der folgende Container stellt alle drei Abhängigkeiten bereit, ohne Ihre
PHP-Installation auf dem Host zu ändern.
Skript für Größenänderung und Wasserzeichen speichern
Speichern Sie den vollständigen Code unten als resize-watermark.php neben dem Dockerfile.
Die drei Argumente sind das Eingabebild, ein neuer Ausgabepfad mit der Erweiterung
.png und eine lesbare TrueType-Schriftdatei. Das übergeordnete Verzeichnis
der Ausgabedatei muss bereits existieren.
<?php
declare(strict_types=1);
$image = null;
$input = null;
$output = null;
$created = false;
$status = 0;
try {
if ($argc !== 4) {
throw new RuntimeException('Usage: php resize-watermark.php INPUT OUTPUT.png FONT.ttf');
}
if (!extension_loaded('imagick')) {
throw new RuntimeException('Enable the Imagick extension in your CLI PHP.');
}
$inputPath = realpath($argv[1]);
$outputDirectory = realpath(dirname($argv[2]));
$fontPath = realpath($argv[3]);
if ($inputPath === false || !is_file($inputPath) || !is_readable($inputPath)) {
throw new RuntimeException('Input must be a readable local image file.');
}
if ($fontPath === false || !is_file($fontPath) || !is_readable($fontPath)) {
throw new RuntimeException('Font must be a readable local TrueType file.');
}
if ($outputDirectory === false || strtolower(pathinfo($argv[2], PATHINFO_EXTENSION)) !== 'png') {
throw new RuntimeException('Use a .png output in an existing directory.');
}
$outputPath = $outputDirectory . DIRECTORY_SEPARATOR . basename($argv[2]);
$input = fopen($inputPath, 'rb');
if ($input === false) {
throw new RuntimeException('Could not open the input.');
}
$image = new Imagick();
$image->setOption('png:preserve-iCCP', 'true');
$image->readImageFile($input);
if ($image->getNumberImages() !== 1 || !in_array($image->getImageFormat(), ['JPEG', 'PNG'], true)) {
throw new RuntimeException('Use a still JPEG or PNG image.');
}
if ($image->getImageColorspace() === Imagick::COLORSPACE_CMYK) {
throw new RuntimeException('Convert CMYK images to sRGB before using this example.');
}
$image->autoOrient();
if ($image->getImageWidth() > 800) {
$image->resizeImage(800, 0, Imagick::FILTER_LANCZOS, 1);
}
$image->setImagePage(0, 0, 0, 0);
$text = '© Your Company';
$draw = new ImagickDraw();
$draw->setFont($fontPath);
$draw->setFontSize(24);
$draw->setFillColor('white');
$draw->setFillOpacity(0.8);
$draw->setStrokeColor('black');
$draw->setStrokeWidth(1);
$draw->setGravity(Imagick::GRAVITY_SOUTHEAST);
$metrics = $image->queryFontMetrics($draw, $text);
if ($metrics['textWidth'] + 32 > $image->getImageWidth()
|| $metrics['textHeight'] + 32 > $image->getImageHeight()) {
throw new RuntimeException('Image is too small for this watermark. Shorten the text or reduce its font size.');
}
$image->annotateImage($draw, 16, 16, 0, $text);
$profiles = $image->getImageProfiles('icc', true);
$image->stripImage();
// stripImage also tells the PNG encoder to omit ICC, even if we restore the profile.
$image->setImageArtifact('png:exclude-chunk', 'eXIf,date');
if (isset($profiles['icc'])) {
$image->profileImage('icc', $profiles['icc']);
}
// Decoded EXIF properties can otherwise be copied into PNG text chunks.
foreach ($image->getImageProperties('*', false) as $property) {
$image->deleteImageProperty($property);
}
$image->setImageFormat('png');
$output = @fopen($outputPath, 'xb');
if ($output === false) {
throw new RuntimeException('Cannot create output: it already exists or the directory is not writable.');
}
$created = true;
if (!$image->writeImageFile($output, 'png') || !fflush($output)) {
throw new RuntimeException('Could not finish writing the PNG.');
}
printf("Wrote %s (%d × %d)\n", $argv[2], $image->getImageWidth(), $image->getImageHeight());
} catch (Throwable $error) {
fwrite(STDERR, 'Resize failed: ' . $error->getMessage() . PHP_EOL);
$status = 1;
} finally {
if (is_resource($input)) {
fclose($input);
}
if (is_resource($output)) {
fclose($output);
}
if ($status !== 0 && $created) {
unlink($outputPath);
}
$image?->clear();
}
exit($status);
Das Skript übergibt ein geöffnetes Datei-Handle an
readImageFile(), damit ImageMagick den Namen der
Eingabedatei nicht als Formatpräfix oder Einzelbildauswahl interpretiert. Es schreibt ebenfalls über
ein Datei-Handle: Der Modus xb von PHP
verweigert das Öffnen einer vorhandenen Ausgabedatei, auch der Eingabedatei selbst. Verwenden Sie dies
als sequenziellen lokalen Befehl. Die Ausgabe wird bereits während des Schreibens sichtbar. Ein
abgefangener Schreibfehler entfernt die neue Teildatei, ein beendeter Prozess kann sie jedoch
zurücklassen.
Auf ein lokales Bild anwenden
Kopieren Sie ein Standbild als input.jpg in dieses Verzeichnis oder ändern Sie
das Eingabeargument unten in den Namen Ihrer PNG-Datei. Führen Sie dann Folgendes aus:
docker run --rm --network none --user "$(id -u):$(id -g)" \
--mount "type=bind,source=$PWD,target=/work" --workdir /work \
imagick-demo:local php resize-watermark.php input.jpg output.png \
/usr/share/fonts/dejavu/DejaVuSans.ttf
Durch das eingebundene Verzeichnis ist output.png auf Ihrem Host verfügbar.
Bei einer Eingabe von 1.600 × 1.000 ohne Drehung meldet der Befehl
Wrote output.png (800 × 500). Öffnen Sie diese Datei: Das vollständige Bild sollte vorhanden sein,
der Text mit Abstand zum unteren rechten Rand. Wenn Sie denselben Befehl erneut ausführen, schlägt
er mit einem Status ungleich null fehl und lässt das vorhandene PNG unverändert. Wählen Sie für die
nächste Version einen neuen Ausgabedateinamen.
Größe und Wasserzeichen anpassen
autoOrient() wendet die gespeicherte Ausrichtung an,
bevor die Breite gemessen wird. Das ist bei Handyfotos wichtig: Ein seitlich gespeichertes
Hochformatfoto muss gedreht werden, bevor Sie seine Ausgabeabmessungen wählen. Bei
resizeImage() wird mit einer Höhe von null die
proportionale Höhe berechnet. Die Breitenprüfung verhindert, dass kleinere Bilder vergrößert werden.
Eine Höhenbegrenzung gibt es nicht.
Ändern Sie $text in Ihr kurzes, einzeiliges Wasserzeichen. Das Skript legt
die Schriftgröße nach der Größenänderung fest. Der Text skaliert daher nicht mit den Pixelabmessungen
des Quellbilds. Weiße Füllung mit schwarzer Kontur hilft, den Text auf hellen wie dunklen Flächen
sichtbar zu halten. Die Prüfung der Schriftmetriken lehnt Bilder ab, die zu klein für den Text samt
Randabstand sind. Dies ist eine sichtbare Kennzeichnung der Urheberschaft, kein Schutz davor, dass
jemand das Bild zuschneidet oder bearbeitet.
Verhalten von Ausgabe und Metadaten festlegen
PNG erhält transparente Bereiche, statt sie mit einem Hintergrund zusammenzuführen. Es kann auch
nach der Größenänderung größer als das ursprüngliche JPEG sein. Dieses Skript verspricht keine
Reduzierung der Dateigröße. Das Umbenennen der Ausgabe in .jpg ändert den
Encoder nicht. Deshalb verlangt das Skript die Erweiterung .png.
stripImage() entfernt Profile und Kommentare.
Hier wird es ausgeführt, nachdem die Ausrichtung angewendet wurde. Das Skript stellt das
ICC-Farbprofil wieder her und passt die PNG-Chunk-Einstellungen an,
um es zu erhalten. Außerdem löscht es Bildeigenschaften, damit decodierte EXIF-Felder nicht in
PNG-Text-Chunks kopiert werden. Der Encoder kann weiterhin Format- und Farbmetadaten hinzufügen.
Eine metadatenfreie Datei ist damit nicht garantiert. Verwenden Sie für diesen Ablauf
sRGB-Quellbilder und für Druckdaten oder Dateien mit großem Farbumfang eine separate Konvertierung
mit Farbmanagement.
Fehler und nicht vertrauenswürdige Dateien behandeln
Eine fehlende Eingabedatei, eine fehlende Schrift, ein nicht decodierbares Bild, ein nicht
unterstütztes Format oder eine vorhandene Ausgabedatei führen zu einem Exit-Status ungleich null und
einer Meldung auf der Standardfehlerausgabe. Die Ausgabedatei wird erst geöffnet, nachdem das
Decodieren, die Größenänderung und das Zeichnen erfolgreich waren. Wenn der Schriftpfad existiert,
aber keine gültige Schrift enthält, meldet Imagick den Fehler beim Messen oder Zeichnen des Texts.
Verkürzen Sie bei einem winzigen Thumbnail den Text oder reduzieren Sie
setFontSize(24) im Skript.
Dies ist ein Beispiel für lokale Bildbearbeitung, kein Upload-Endpunkt. ImageMagick muss die Eingabe decodieren, bevor das Skript ihr Format und ihre Einzelbildanzahl prüfen kann. Ein Decoder kann zudem manche beschädigten Dateien tolerieren. Eine erfolgreiche Verarbeitung bescheinigt nicht, dass eine Eingabe vollständig oder sicher ist. Konfigurieren Sie für nicht vertrauenswürdige Uploads eine ImageMagick-Sicherheitsrichtlinie, die Coder, Delegates, Abmessungen, Einzelbilder, Arbeitsspeicher, Festplattenspeicher und Verarbeitungszeit begrenzt. Ergänzen Sie Größenlimits für Anfragen und isolieren Sie die Worker. Arbeitsspeicherlimits allein können dazu führen, dass der Pixelcache auf die Festplatte ausgelagert wird. Sie begrenzen nicht den gesamten Auftrag.
Möchten Sie das lieber nicht selbst betreiben?
Transloadit ändert Bildgrößen, schneidet Bilder zu und optimiert sie über eine einzige API.
