PHP Library to generate PNGs from LaTeX math formula
Pull request Compare This branch is 1 commit ahead, 21 commits behind Gregwar:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This class provides a way to create easily LaTeX formulas.

With it, you can convert raw formulas like:

\sum_{i = 0}^{i = n} \frac{i}{2}

To nice images like:

Sum formula


To use this library you'll need :

  • latex : to compile formulas (with math support)
  • dvipng : to convert dvis to png
  • shell_exec : you need to be able to call the php shell_exec() function

You'll also need a temporary folder and, of courses, enough permissions to write to the target directory


Just include the Tex2png.php file or register this repository directory as the Gregwar\Tex2png\ namespace and do the following :


// This will create a formula and save it to sum.png
Tex2png::create('\sum_{i = 0}^{i = n} \frac{i}{2}')

You can have a look at the example in example/ directory.

Using the cache

Tex2png library includes a caching system allowing you to generate images only one time. To do so, just don't tell Tex2png what is the target file :


Tex2png::create('\sum_{i = 0}^{i = n} \frac{i}{2}')

// The filename will be choosen using an hash of the formula and
// the image density. (file name will look like cache/tex/3/0/2/e/6/8febefe7aaed9eeb8abf09070d10e02e93e.png)

If the file already exists, it will not generate anything, else, it will generate it. This results in a tiny but powerful caching system avoiding to regenerate a formula PNG twice.

Note that you can change the cache directory calling the setCacheDirectory() function

Changing the density

The second constructor/create() parameter is the image density :


Tex2png::create('\sum_{i = 0}^{i = n} \frac{i}{2}', 300)

Default density is 155, you can choose to generate really big images, this is an example of the formula with a density of 1000 :

Sum formula (density=1000)


This class is under MIT license, for more information, please refer to the LICENSE file