PHP と jpegoptim による効率的な JPEG 最適化
一時コピーに対して jpegoptim を実行し、終了ステータスを確認してから、指定した出力名がまだ使われていない場合にのみ結果を保存します。この PHP CLI の例では、元の JPEG を変更せず、入力が破損している場合も含めて、既存の出力の置き換えを拒否します。
変更内容の選択
JPEG の可逆最適化は、画質を低下させる再エンコードを行わずに圧縮データを再構成します。出力ファイルのバイト列が元と同一になるという意味ではありません。以下のスクリプトには、独立した三つのモードがあります。
| モード | jpegoptim オプション | 変更の目的 |
|---|---|---|
lossless(デフォルト) | --strip-none | メタデータを保持しながら圧縮を最適化 |
strip | --strip-all --force | JPEG の画質を低下させずにメタデータを削除 |
quality80 | --strip-none --max=80 | メタデータを保持しながら画質の低減を許可 |
jpegoptim のマニュアルでは、--max はファイルサイズの削減率ではなく、画質の上限とされています。すでにその画質を下回る JPEG は、可逆処理になる場合があります。画質の保持が要件の場合は、--max と --size を避けてください。
メタデータについては、別途判断が必要です。EXIF を削除すると向きの情報が失われる場合があり、ICC プロファイルを削除すると色の表示が変わる場合があります。strip は、これらの変更を許容できる場合にのみ使用してください。このオプションは書き換えを強制し、サイズ削減が見込めない場合もメタデータの削除を実行します。--strip-all でも、エンコーダーが生成した JFIF や Adobe のマーカーが残る場合があります。--strip-none も、これらのマーカーの再生成を許可します。どちらのモードも、メタデータをバイト単位で完全に保存することは保証しません。
CLI ツールのインストール
自身で管理するローカルの Linux ディレクトリを使用してください。一時コピー用の空き容量と、ハードリンクをサポートするファイルシステムが必要です。proc_open() を有効にした PHP CLI と、jpegoptim の実行ファイルを用意します。Ubuntu 24.04 では、両方を APT でインストールします。
sudo apt-get update &&
sudo apt-get install -y php-cli jpegoptim &&
php --version &&
jpegoptim --version
Ubuntu 24.04 には、ここで使用するオプションに対応した jpegoptim 1.4.7 がパッケージとして提供されています。このワークフローは、PHP 8.3 と jpegoptim 1.4.7、および PHP 8.5.10 と jpegoptim 1.5.6 の組み合わせで検証済みです。Composer、GD、Web サーバーは不要です。
新しい作業ディレクトリを作成します。
mkdir jpeg-demo && cd jpeg-demo
このコマンドが失敗した場合は作業を止め、未使用のディレクトリ名を選んでください。所有する JPEG を、このディレクトリに input.jpg として配置します。同じ場所に、以下のスクリプトを optimize-jpeg.php として保存してください。
PHP から別ファイルへの出力
出力先ディレクトリは、あらかじめ存在している必要があります。スクリプトは処理前に名前の衝突を確認し、PHP の link() を使って、処理済みの一時ファイルに最終的な名前を付けます。この操作は、jpegoptim の実行中に同名の出力が作成された場合も拒否します。クリーンアップでは、一時ファイル名だけを削除します。
<?php
declare(strict_types=1);
function main(array $args): void
{
if (count($args) < 3 || count($args) > 4) {
throw new InvalidArgumentException(
'Usage: php optimize-jpeg.php INPUT OUTPUT [lossless|strip|quality80]'
);
}
$options = match ($args[3] ?? 'lossless') {
'lossless' => ['--strip-none'],
'strip' => ['--strip-all', '--force'],
'quality80' => ['--strip-none', '--max=80'],
default => throw new InvalidArgumentException('Unknown optimization mode.'),
};
$binary = getenv('JPEGOPTIM_BINARY') ?: '/usr/bin/jpegoptim';
if (!str_starts_with($binary, '/') || !is_file($binary) || !is_executable($binary)) {
throw new RuntimeException('Set JPEGOPTIM_BINARY to an executable absolute path.');
}
$input = realpath($args[1]);
if ($input === false || !is_file($input) || !is_readable($input)) {
throw new RuntimeException('Input must be a readable local file.');
}
$directory = realpath(dirname($args[2]));
if ($directory === false || !is_dir($directory) || !is_writable($directory)) {
throw new RuntimeException('Output directory must exist and be writable.');
}
$output = $directory . '/' . basename($args[2]);
if (file_exists($output) || is_link($output)) {
throw new RuntimeException('Output already exists; choose a new filename.');
}
$before = filesize($input);
if ($before === false || $before === 0) {
throw new RuntimeException('Input is empty or its size cannot be read.');
}
$temporary = tempnam($directory, '.jpegoptim-');
if ($temporary === false) {
throw new RuntimeException('Cannot create a temporary file.');
}
try {
// tempnam can fall back to the system temp directory; keep publication on one filesystem.
if (dirname($temporary) !== $directory || !copy($input, $temporary)) {
throw new RuntimeException('Cannot create the working copy in the output directory.');
}
$process = proc_open(
[$binary, '--nofix', '--quiet', ...$options, '--', $temporary],
[0 => ['file', '/dev/null', 'r'], 1 => STDERR, 2 => STDERR],
$pipes
);
if (!is_resource($process)) {
throw new RuntimeException('Cannot start jpegoptim.');
}
$status = proc_close($process);
if ($status !== 0) {
throw new RuntimeException("jpegoptim failed (exit $status); no output published.");
}
clearstatcache(true, $temporary);
$after = filesize($temporary);
if ($after === false || $after === 0) {
throw new RuntimeException('jpegoptim did not leave a nonempty output.');
}
if (!link($temporary, $output)) {
throw new RuntimeException('Cannot publish output; check for a collision or filesystem error.');
}
} finally {
unlink($temporary);
}
printf("Created %s: %d -> %d bytes; saved %d bytes\n", $output, $before, $after, $before - $after);
}
try {
main($argv);
} catch (Throwable $error) {
fwrite(STDERR, 'Error: ' . $error->getMessage() . "\n");
exit(1);
}
proc_open() は引数の配列を受け取るため、パスがシェルコマンドになることはありません。jpegoptim に渡されるのは一時ファイルだけで、元のファイルや最終的な出力先は渡されません。--nofix オプションは、破損した JPEG の修復を試みず、エラーだけでなく展開時の警告も失敗として扱います。MIME の確認だけでは、画像全体をデコードできるとは判断できません。
デフォルトの可逆モードを実行します。
php optimize-jpeg.php input.jpg lossless.jpg
スクリプトは、Ubuntu パッケージの配置先である /usr/bin/jpegoptim を使用します。別の場所にインストールした場合は、呼び出し時に JPEGOPTIM_BINARY に絶対パスを設定してください。この設定や任意の最適化フラグを HTTP リクエストから受け取らないでください。
実行に成功すると、終了ステータスはゼロになり、出力パス、入力と出力のバイト数、削減バイト数が表示されます。削減量がゼロでも正常です。その場合も別の出力ファイルが得られます。削減量が負の場合は出力が大きくなったことを意味し、強制書き換えを行う
strip モードではこれを許容します。同じ出力名で再実行すると、そのファイルを変更せずに失敗します。入力名を出力名に指定した場合も失敗します。
入力の破損、実行ファイルの不在、jpegoptim プロセスの失敗がある場合は、終了ステータスがゼロ以外になります。これらの失敗時には最終出力を保存せず、通常の例外処理で一時コピーを削除します。既存の出力と元のファイルはそのまま残ります。
圧縮結果の測定
新しい出力名を使って、ほかのモードを比較します。
php optimize-jpeg.php input.jpg stripped.jpg strip &&
php optimize-jpeg.php input.jpg quality80.jpg quality80
バイト数とともに、インストール済みのバージョンとモードを記録してください。代表的な写真、小さなサムネイル、別のツールですでに最適化した画像を比較します。ある画像でサイズを削減できても、別の画像で削減できるとは限りません。このスクリプトは画像のサイズ変更を行わず、目標のファイルサイズも保証しません。
出力を画像ビューアーで開いてください。quality80 では、画質の変化を受け入れる前に、細部、グラデーション、文字を原寸で確認します。strip では、向きと色を元の画像と比較してください。可逆性の確認を自動化する場合は、元の画像と出力を同じデコーダーでデコードし、ピクセルバッファーと画像の寸法を比較します。JPEG ファイルのハッシュの比較で確認できるのは、バイト列の同一性です。
ワーカーからのスクリプト呼び出し
バッチ処理や Laravel アプリケーションでは、元のファイルを保持し、画像ごとに新しい出力先を割り当ててください。この CLI 処理をワーカーで実行し、終了ステータスを確認してから、出力を利用可能として記録します。処理が失敗した場合は、原因調査や再試行のために元のファイルを保持する必要があります。Composer のラッパーを使用する場合も、ネイティブの実行ファイルと、失敗や出力先の衝突に対する明示的な方針が必要です。
セキュリティ上の考慮事項
この例は、同じ信頼できるアカウントが管理するディレクトリ内のローカルファイルを処理します。アップロード用エンドポイントでも、悪意のあるファイルを処理するサンドボックスでもありません。出力のアクセス権限は非公開のままです(一時ファイルはモード 0600で作成されます)。後から Web 配信用の権限が必要になる場合は、意図的に設定してください。
アップロードサービスには、バイト数とピクセル数の制限、処理の隔離、外部プロセスを終了させるワーカーの実行期限も必要です。PHP の set_time_limit() は、Linux で外部処理に費やす時間を制限しません。この小規模な CLI スクリプトにはプロセスのタイムアウトがなく、強制終了によって一時ファイルが残る場合があります。作業ディレクトリを非公開に保ち、それらのファイルを所有するワーカーで、中断された処理のクリーンアップを行ってください。
