Need help with php-liquid?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

226 Stars 103 Forks MIT License 271 Commits 28 Opened issues


A PHP port of Ruby's Liquid Templates

Services available


Need anything else?

Contributors list

Liquid template engine for PHP Build Status

Liquid is a PHP port of the Liquid template engine for Ruby, which was written by Tobias Lutke. Although there are many other templating engines for PHP, including Smarty (from which Liquid was partially inspired), Liquid had some advantages that made porting worthwhile:

  • Readable and human friendly syntax, that is usable in any type of document, not just html, without need for escaping.
  • Quick and easy to use and maintain.
  • 100% secure, no possibility of embedding PHP code.
  • Clean OO design, rather than the mix of OO and procedural found in other templating engines.
  • Seperate compiling and rendering stages for improved performance.
  • Easy to extend with your own "tags and filters":
  • 100% Markup compatibility with a Ruby templating engine, making templates usable for either.
  • Unit tested: Liquid is fully unit-tested. The library is stable and ready to be used in large projects.

Why Liquid?

Why another templating library?

Liquid was written to meet three templating library requirements: good performance, easy to extend, and simply to use.


You can install this lib via composer:

composer create-project liquid/liquid

Example template

{% if products %}
    {% for product in products %}
  • {{ }}

    Only {{ product.price | price }}
        {{ product.description | prettyprint | paragraph }}
        {{ 'it rocks!' | paragraph }}
    {% endfor %}

    {% endif %}

    How to use Liquid

    The main class is

    class. There are two separate stages of working with Liquid templates: parsing and rendering. Here is a simple example:
    use Liquid\Template;

    $template = new Template(); $template->parse("Hello, {{ name }}!"); echo $template->render(array('name' => 'World');

    // Will echo // Hello, World!

    To find more examples have a look at the

    directory or at the original Ruby implementation repository's wiki page.


    • PHP 5.3+


    Have a bug? Please create an issue here on GitHub!

    Fork notes and contributors

    This fork is based on php-liquid by Mateo Murphy. kalimatas has contributed a lot in his fork to bring Liquid to the new state. Thank you so much!

    It contains several improvements:

    • namespaces
    • installing via composer
    • new standard filters
    • raw
      tag added

    Any help is appreciated!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.