PHP中Imagemagick使用newPseudoImage搭配CAPTION生成俄文标题的编码异常问题

解决方案 #

问题根因

CAPTION参数的底层文字排版逻辑独立于annotateImage和LABEL参数，默认会读取系统默认编码，未显式指定UTF-8的场景下，西里尔字符等非拉丁字符极易出现编码解析错误。同时html_entity_decode如果不指定输出编码，可能因PHP环境默认配置差异导致解码结果不符合预期。 #

修复步骤

1. 调用newPseudoImage前显式设置Imagick的文本编码为UTF-8，适配CAPTION的解析逻辑
2. 给html_entity_decode指定输出编码为UTF-8，避免环境差异导致的解码异常

修复后完整代码

$postTitle = 'Нуорунен в Карелии';
// 显式指定解码规则和输出编码为UTF-8
$postTitle = html_entity_decode($postTitle, ENT_QUOTES | ENT_HTML5, 'UTF-8');

$mainImage = new Imagick('source.jpg');
$title = new Imagick();
$colorize = new Imagick();
        
$mainImage->setImageCompressionQuality(85);

$title->setBackgroundColor('transparent');
$title->setFont('/fonts/roboto-slab_semibold.ttf');
$title->setGravity(imagick::GRAVITY_CENTER);
// 新增：显式指定文本编码为UTF-8
$title->setOption('text.encoding', 'UTF-8');
$title->newPseudoImage( 780, 480, "CAPTION:" . $postTitle );
    
$colorize->newImage(1, 1, new ImagickPixel('#f8bb00'));
$title->clutImage($colorize);
$colorize->destroy();
    
$mainImage->compositeImage($title, imagick::COMPOSITE_DEFAULT, 210, 110);
        
$mainImage->writeImage('image.jpg');

如果仍存在空格换行不符合预期的问题，可以额外将解码后的非打断空格统一替换为标准UTF-8格式的U+00A0字符，即可保留不换行的属性同时适配CAPTION的排版规则。

内容的提问来源于stack exchange，提问作者v_k