Search by

quoin / math

dan-onelearningcommunity

Math layout for PHP: fractions, roots, scripts and stretchy delimiters from an OpenType MATH font, read from MathML and TeX, with SVG, MathML, TeX and Word OMML writers.

v0.16.0 2026-11-17 15:01 UTC

This package is auto-updated.

Last update: 2026-11-17 15:52:32 UTC


README

Math typesetting in plain PHP. It reads TeX or MathML and writes SVG, PNG, MathML, TeX, Word equations (OMML) or plain text. It needs PHP 8.4. No Node, no browser, no fonts on the server.

It is part of a monorepo that uses it for equations in PDF, Word and HTML documents, but it does not depend on the rest of it.

composer require quoin/math
use Quoin\Math\Math;
use Quoin\Math\Render\SvgRenderer;

$box = Math::layout(Math::tex('x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}'), size: 16.0);
echo (new SvgRenderer(Math::stixTwoMath()))->render($box, pad: 1.0);

Every glyph is a path, so the SVG needs no web font.

  • Reads what KaTeX reads, and MathML from equation editors, Word and the web.
  • Converts TeX to MathML, MathML to TeX, either to Word.
  • Never throws on input. Fixed limits keep hostile formulas cheap, and anything not drawn as written is reported.
  • About 0.1 ms per formula once the font is loaded.

Documentation

  • Overview, with a comparison to KaTeX and MathJax
  • Recipes: web pages, email, Word, conversion, alt text, untrusted input
  • Input: the builder, TeX, MathML, notes and limits
  • Output: layout options and every writer
  • Custom backends: the display list, glyph outlines, fonts

Testing

vendor/bin/phpunit
composer analyse
php tests/render-fixtures.php   # writes tests/out/*.svg, .png (needs rsvg-convert) and index.html

tests/Fixtures.php holds the sample formulas. A fixture name ending in -inline is laid out in text style; all others use display style.

Spacing, stretching and large-operator behavior come from the W3C MathML Core operator dictionary. The snapshot used is recorded in the header of resources/operators.php, which bin/gen-operators.php generates.

Credits

The layout design follows ziamath (MIT). The bundled STIX Two Math is under the SIL Open Font License 1.1 (resources/fonts/OFL.txt).