README

Svg Parser PHP

Applies CSS document styles to an SVG without modifying the original SVG file. It also parses CSS variables and inserts their values directly into CSS selectors styles, as it is intendent for broader use than just for browser rendering.

Installation

You can install the package via composer:

composer require gymmed/svg-parser-php

Use Case

Dompdf or laravel wrapper laravel-dompdf don't support direct SVG import or requires the inclusion of external SVG files. This library provides a way to attach CSS documents to SVG files without needing to directly modify the SVG.

If you stumble upon the same problem, I highly recommend using imagick or rasterize-svg to convert the SVG to PNG and include it in the PDF. This way, you reduce the chances of the styles being rendered incorrectly by Dompdf and won't need two different CSS documents or two SVG files.

Usage

use GymMed\SvgParser;

//provide full path
$svgPath = realpath(__DIR__ . "./assets/example.svg");
$cssPath = realpath(__DIR__ . "./assets/css/index.css");

$svgWithCSS = SvgParser::formatSvgFromPath($svgPath, [$cssPath]);

or use SVG content:

use GymMed\SvgParser;

//provide full path
$svgPath = realpath(__DIR__ . "./assets/example.svg");
$cssPath = realpath(__DIR__ . "./assets/css/index.css");
$svg = file_get_contents($svgPath);

$svgWithCSS = SvgParser::formatSvg($svg, [$cssPath]);

If you want to write simple CSS and apply it inside SVG:

use GymMed\SvgParser;

//provide full path
$svgPath = realpath(__DIR__ . "./assets/example.svg");
$svg = file_get_contents($svgPath);

$svgWithCSS = SvgParser::getParsedCSSToSvg($svg, ".circle { background-color: red; border-radius: 50% }");

If you want to provide only full path instead of SVG itself:

use GymMed\SvgParser;

//provide full path
$svgPath = realpath(__DIR__ . "./assets/example.svg");

$svgWithCSS = SvgParser::getParsedCSSToSvgFromPath($svgPath, ".circle { background-color: red; border-radius: 50% }");