PHP の Imagick で画像のサイズ変更と透かしの追加を行うには
PHP Imagick で写真のサイズを変更して透かしを追加するには、まず画像の向きを適用し、ピクセル数を変更してから、最終サイズでテキストを描画します。以下のスクリプトはローカルの JPEG または PNG を読み込み、幅が 800 ピクセルを超える場合は切り抜かずに縮小し、右下に「© Your Company」を入れた別の PNG として保存します。元の画像は変更せず、既存の出力ファイルも上書きしません。
Imagick は ImageMagick の PHP インターフェースです。メモリ上の一つの画像に対して、これらの操作を行えます。この例は、自分で管理する静止画像を対象としています。sRGB の写真または PNG を使用してください。透明度を持つ画像も使用できます。GIF、WebP、PDF、CMYK の入力は拒否します。アニメーション PNG と複数画像を含む JPEG(MPO)は、このチュートリアルの対象外です。デコーダーが最初のフレームしか公開しない場合があるため、デコード後のフレーム数を調べても、ファイルに画像が一つだけ含まれるとは確認できません。
PHP と Imagick のセットアップ
以下のセットアップでは、Linux 上で Docker と Bash 互換のターミナルを使用します。Linux x86_64 上で、PHP 8.4.27、Imagick 3.8.1、ImageMagick 7.1.2-35、DejaVu Sans 2.37 を使ってテストしました。Dockerfile は PHP と Imagick のバージョンを固定しますが、Alpine 3.23 のリポジトリから現行のパッケージをインストールします。後で再ビルドすると、Alpine パッケージの新しいリビジョンが使われる場合があります。空の作業ディレクトリを作成し、そのディレクトリでターミナルを開いてください。以下を 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
ローカルイメージをビルドします。この手順にはインターネット接続が必要です。拡張機能のインストールは、公式 PHP イメージの PECL 手順に従っています。
docker build -t imagick-demo:local .
ビルドが成功してから次に進んでください。Alpine では
JPEG コーダーが別パッケージになっているため、このセットアップでは明示的にインストールします。イメージには /usr/share/fonts/dejavu/DejaVuSans.ttf にフォントが含まれています。フォントキャッシュも構築し、実行時のキャッシュはコンテナ内の書き込み可能な
/tmp ディレクトリに保存します。この PHP/Imagick 環境をすでにローカルにインストールしている場合は、独自のフォントファイルを指定して PHP スクリプトを直接実行できます。以下のコンテナは、ホストの PHP 環境を変更せずに、必要な三つの依存関係をすべて提供します。
サイズ変更と透かし追加のスクリプトを保存
以下のコード全体を Dockerfile と同じディレクトリに
resize-watermark.php として保存します。三つの引数は、入力画像、新規の .png 出力パス、読み取り可能な TrueType フォントファイルです。出力先の親ディレクトリは、事前に作成しておく必要があります。
<?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);
スクリプトは、開いたファイルハンドルを
readImageFile()に渡すため、ImageMagick が入力ファイル名を形式プレフィックスやフレームセレクターとして解釈しません。書き込みにもファイルハンドルを使います。PHP の xb モードは、入力ファイル自体を含む既存の出力ファイルへの書き込みを拒否します。ローカルで逐次実行するコマンドとして使用してください。出力ファイルは書き込み中から見える状態になります。書き込みの失敗を捕捉した場合、新しく作成した不完全なファイルは削除されますが、プロセスが終了させられた場合は残ることがあります。
ローカル画像で実行
静止画像をこのディレクトリに input.jpg としてコピーするか、以下の入力引数を PNG ファイル名に変更してください。その後、次のコマンドを実行します。
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
ディレクトリのマウントにより、ホスト上で output.png を利用できます。回転のない 1,600 × 1,000 の入力では、コマンドは Wrote output.png (800 × 500) と表示します。そのファイルを開いてください。画像全体が残り、右下の端から少し内側にテキストが表示されるはずです。同じコマンドを再実行すると、ゼロ以外のステータスで失敗し、既存の PNG は変更されません。次の版を作成するには、新しい出力ファイル名を指定してください。
サイズと透かしの調整
autoOrient()は、幅を測定する前に、保存されている画像の向きを適用します。これはスマートフォンの写真で重要です。横向きに保存された縦長の写真は、出力寸法を決める前に回転させる必要があります。resizeImage()では、高さにゼロを指定すると、縦横比に応じた高さが計算されます。幅の確認により、小さい画像の拡大を避けています。高さの上限はありません。
$text を、短い単一行の透かしに変更してください。スクリプトはサイズ変更後にフォントサイズを設定するため、テキストのサイズは元画像のピクセル寸法に比例して変わりません。白い塗りと黒い縁取りにより、明るい領域でも暗い領域でもテキストを見やすくしています。フォントメトリクスの確認では、余白を含むテキストが収まらないほど小さい画像を拒否します。これは目に見える帰属表示であり、画像の切り抜きや編集を防ぐものではありません。
出力形式とメタデータの扱いの選択
PNG は透明な領域を背景と合成せずに保持します。サイズ変更後でも元の JPEG よりファイルサイズが大きくなる場合があり、このスクリプトはファイルサイズの削減を保証しません。出力名を .jpg に変えてもエンコーダーは変わらないため、スクリプトは .png 拡張子を必須としています。
stripImage()は、プロファイルとコメントを削除します。ここでは、画像の向きを適用した後に実行します。スクリプトは ICC カラープロファイルを復元し、PNG チャンクの設定を調整して保持します。また、デコードされた EXIF フィールドが PNG のテキストチャンクにコピーされないように、画像プロパティも消去します。ただし、エンコーダーが形式や色のメタデータを追加する場合があるため、メタデータのないファイルを保証するものではありません。このワークフローでは sRGB の元画像を使用し、印刷用や広色域の素材には、別途カラーマネジメントに対応した変換を行ってください。
エラーと信頼できないファイルへの対処
入力やフォントが見つからない場合、画像をデコードできない場合、形式が非対応の場合、または出力ファイルがすでに存在する場合は、ゼロ以外の終了コードを返し、標準エラーにメッセージを出力します。デコード、サイズ変更、描画が成功するまで、出力ファイルは開きません。フォントパスが存在しても有効なフォントでない場合は、テキストの測定時または描画時に Imagick がエラーを報告します。非常に小さいサムネイルでは、テキストを短くするか、スクリプト内の setFontSize(24) を小さくしてください。
これはローカルで画像を編集する例であり、アップロード用のエンドポイントではありません。スクリプトが形式とフレーム数を確認する前に、ImageMagick が入力をデコードする必要があります。また、デコーダーは一部の破損ファイルを許容する場合があります。処理が成功しても、入力が完全で安全であることの証明にはなりません。信頼できないアップロードを扱う場合は、リクエストサイズの制限とワーカーの分離に加え、コーダー、デリゲート、寸法、フレーム数、メモリ、ディスク、処理時間を制限する ImageMagick セキュリティポリシーを設定してください。メモリ制限だけでは、ピクセルキャッシュがディスクに退避することがあります。ジョブ全体のリソース使用量を制限するものではありません。
