如何用PHP的meyfa/php-svg库将SVG正确转换为原尺寸PNG？

1. 先确认SVG文件的尺寸属性是否规范 #

SVG尺寸不符的常见根源是自身缺少明确的width/height属性，或者viewBox与这两个属性不匹配：

• 若SVG仅有viewBox但无width/height，库可能无法识别默认尺寸，会用兜底值（通常100x100）
• 若width/height使用相对单位（如%、em），转换时会被解析为默认值

修正SVG示例：给SVG添加明确的绝对尺寸和匹配的viewBox：

<svg xmlns="http://www.w3.org/2000/svg" width="500" height="300" viewBox="0 0 500 300">
  <!-- 你的SVG内容 -->
</svg>

2. 在PHP代码中显式匹配SVG原生尺寸 #

避免直接硬编码固定尺寸，而是读取SVG自身的尺寸参数进行渲染：

正确读取SVG原生尺寸的代码示例 #

use SVG\SVG;
use SVG\Rasterization\Renderer\PNGRenderer;

$svg = SVG::fromFile('input.svg');
// 优先获取SVG的width/height属性
$width = $svg->getWidth();
$height = $svg->getHeight();

// 如果没有设置width/height，从viewBox提取尺寸
if ($width === null || $height === null) {
    $viewBox = $svg->getViewBox();
    if ($viewBox !== null) {
        $width = $viewBox->getWidth();
        $height = $viewBox->getHeight();
    } else {
        // 兜底设置默认尺寸，可根据需求调整
        $width = 800;
        $height = 600;
    }
}

$renderer = new PNGRenderer();
$svg->render($renderer, $width, $height);
file_put_contents('output.png', $renderer->finish());

如需缩放且保持比例的代码示例 #

use SVG\SVG;
use SVG\Rasterization\Renderer\PNGRenderer;

$svg = SVG::fromFile('input.svg');
$viewBox = $svg->getViewBox();
// 优先从viewBox取原始尺寸，无则用width/height或兜底值
$originalWidth = $viewBox ? $viewBox->getWidth() : ($svg->getWidth() ?? 800);
$originalHeight = $viewBox ? $viewBox->getHeight() : ($svg->getHeight() ?? 600);

// 设置目标宽度，按比例计算高度
$targetWidth = 1000;
$scale = $targetWidth / $originalWidth;
$targetHeight = $originalHeight * $scale;

$renderer = new PNGRenderer();
$svg->render($renderer, $targetWidth, $targetHeight);
file_put_contents('output.png', $renderer->finish());

3. 检查SVG元素的范围 #

如果SVG内的元素超出viewBox定义的范围，转换后的PNG可能会出现裁剪或空白。确保所有元素都包含在viewBox范围内，或调整viewBox参数覆盖所有内容。

4. 更新到最新版库 #

旧版本的meyfa/php-svg可能存在尺寸解析bug，通过Composer更新到最新版：

composer update meyfa/php-svg

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