開発（PHP）：画像ファイルをWebPへ変換

画像ファイルをWebPへ変換するには、WebPConvert::convertメソッドを使用します。
Evolution CMSは標準でWebPConvertというライブラリが内蔵されています。
rosell-dk/webp-convert

※ Evolution CMSの3系に対応し、1系には対応していません。

構文

引数名		型	初期値	説明
第一引数必須	変換元ファイルパス	string		変換する対象のファイルパス。JPEGとPNGをサポート。
第二引数必須	出力ファイルパス	string		変換したファイルを保存するファイルパス。
第三引数	オプション	array	[]	変換に関するオプション。詳しくは次のページを参照。 Options - rosell-dk/webp-convert
第四引数	ロガー		null	※ 不明

戻り値

サンプルコード

次のコードはプラグインとしてOnDocFormSaveイベントで処理され、リソース保存時に本文にあるimgタグから画像ファイルパスを抜き出し、変換する例です。

use WebPConvert\WebPConvert;

preg_match_all('/<img\s+([^>]+)>/', $modx->event->params['doc']['content'], $matches);

if (!isset($matches[1]) || count($matches[1]) == 0) return;

$paths = array_map(fn ($x) => preg_replace('/.*?src=["\']?([^"\']*)["\']?.*?$/', '$1', trim($x)), $matches[1]);
								$paths = array_map(fn ($x) => str_replace('[(rb_base_url)]', $modx->config['rb_base_dir'], $x), $paths);

$results = [];

foreach ($paths as $path) {
									$pi = pathinfo($path);

$outPath = $pi['dirname'].'/'.$pi['filename'].'.'.preg_replace('/^[a-z0-9]*/', 'webp', $pi['extension']);

$result = [
										'srcPath'   => $path,
										'outPath'   => $outPath,
										'overwrite' => false,
										'success'   => false,
										'message'   => ''
									];

if (!file_exists($path)) {
										$result['message'] = 'ソースファイルが見つかりませんでした';
										$results[] = $result;
										continue;
									} else if (str_starts_with($pi['extension'], 'webp')) {
										$result['message'] = '対象の形式がWebPです';
										$results[] = $result;
										continue;
									} else if (file_exists($outPath)) {
										$result['overwrite'] = true;
									}

WebPConvert::convert($path, $outPath);

$result['success'] = file_exists($outPath);

$results[] = $result;
								}

evo()->addLog('WebP変換', $results);

WebPConvert\WebPConvertを呼び出しておく必要があり、newキーワードでインスタンスを生成して使用します。

CMS「Evolution CMS」逆引きリファレンス一覧へ戻る