NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2276 most downloaded on Packagist
Liquid template engine for PHP
Latest stable
1.4.48
Last release 17 days ago
05 Nov 2026
Release timing varies
gaps range from 1 weeks to 13 months
Nearly every release is documented
notes for 52 of 56 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
56 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Update StandardFilters::map() to skip non-object callables by @sanmai in https://github.com/kalimatas/php-liquid/pull/244
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.47...1.4.48
Update Filterbank::addFilter() to skip private methods by @sanmai in https://github.com/kalimatas/php-liquid/pull/243
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.46...1.4.47
Added optional timezone string to StandardFilters::date() by @fulstadev in https://github.com/kalimatas/php-liquid/pull/241
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.45...1.4.46
Fix deprecation str_replace by @PNixx in https://github.com/kalimatas/php-liquid/pull/239
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.44...1.4.45
AbstractTag: add cached instance of the config, to improve performance by @sanmai in https://github.com/kalimatas/php-liquid/pull/220
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.43...1.4.44
Mutation testing on PHP 8.3 by @sanmai in https://github.com/kalimatas/php-liquid/pull/219
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.42...1.4.43
Improve StandardFiltersTest by @sanmai in https://github.com/kalimatas/php-liquid/pull/214
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.41...1.4.42
Fix where method with multiple input types by @PNixx in https://github.com/kalimatas/php-liquid/pull/211
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.40...1.4.41
Add filter for array by @PNixx in https://github.com/kalimatas/php-liquid/pull/209
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.39...1.4.40
Fix sort different array keys by @PNixx in https://github.com/kalimatas/php-liquid/pull/202
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.38...1.4.39
Update PHP Coding Standards Fixer, bump PHP version support by @sanmai in https://github.com/kalimatas/php-liquid/pull/205
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.37...1.4.38
add support for json filter by @jkrenge in https://github.com/kalimatas/php-liquid/pull/201
json filter by @jkrenge in https://github.com/kalimatas/php-liquid/pull/201Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.36...1.4.37
Test improvements by @sanmai in https://github.com/kalimatas/php-liquid/pull/191
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.35...1.4.36
Improve compatibility for array operands by @live627 in https://github.com/kalimatas/php-liquid/pull/190
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.34...1.4.35
Ignore non-essential files for the composer package by @live627 in https://github.com/kalimatas/php-liquid/pull/181
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.33...1.4.34
Test on PHP 8.2 by @sanmai in https://github.com/kalimatas/php-liquid/pull/172
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.32...1.4.33
Align split filter behaviour with Shopify/Ruby Liquid by @funkjedi in https://github.com/kalimatas/php-liquid/pull/167
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.31...1.4.32
Fix PHP 8.1 error in preg_split by replacing null with default value by @PNixx in https://github.com/kalimatas/php-liquid/pull/165
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.30...1.4.31
Fix PHP 8.1 error in preg_split by replacing null with default value by @peterjaap in https://github.com/kalimatas/php-liquid/pull/163
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.29...1.4.30
fix parse exception "Variable was not properly terminated" with line … by @PNixx in https://github.com/kalimatas/php-liquid/pull/162
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.28...1.4.29
fix parse exception "Unknown tag endfor" with line break by @PNixx in https://github.com/kalimatas/php-liquid/pull/161
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.27...1.4.28
fix parse exception "tag was never closed" with line break by @PNixx in https://github.com/kalimatas/php-liquid/pull/159
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.26...1.4.27
Fix truncate, capitalize, upcase, downcase methods for UTF-8 by @PNixx in https://github.com/kalimatas/php-liquid/pull/158
Full Changelog: https://github.com/kalimatas/php-liquid/compare/1.4.25...1.4.26
We no longer throw an exception on an array. Instead we display arrays verbatim, with print_r. Kudos to @schmoove, #156.
We no longer throw an exception on an array. Instead we display arrays verbatim, with print_r. Kudos to @schmoove, #156.
Kudos to @PNixx and @PATROMO for working on this PR.
See #150
Kudos to @PNixx and @PATROMO for working on this PR.
Fixes the problem with REQUEST_URI in default context, #151
Fixes the problem with REQUEST_URI in default context, #151
Kudos to @shawngoh87
Nothing published for this version
As per #145. Kudos to @schmitty42.
As per #145. Kudos to @schmitty42.
Nothing published for this version
Support for iterating and working with generators.
Nothing published for this version
Comes with .first/.last support for arrays. Kudos to @funkjedi!
Comes with .first/.last support for arrays. Kudos to @funkjedi!
Comes with .size support for \Countable variables. Kudos to @funkjedi!
Comes with .size support for \Countable variables. Kudos to @funkjedi!
The library now should work nicely with objects with virtual properties, that is accessible only with __get.
The library now should work nicely with objects with virtual properties, that is accessible only with __get.
Not passing a date format to the date filter now results in a common and expected LiquidException instead of surprising TypeError under PHP 7.1+. Othe
Not passing a date format to the date filter now results in a common and expected LiquidException instead of surprising TypeError under PHP 7.1+. Other filters may also be affected.
Kudos to @PATROMO for raising the issue and providing a fix.
This release also the first one to be thoroughly tested under PHP 7.3, although earlier releases should work just as fine.
This release comes with a much more solid implementation for the whitespace control. Kudos to @funkjedi!
This release comes with a much more solid implementation for the whitespace control. Kudos to @funkjedi!
Fixes #114. This issue is particularly important because $_SERVER may contain sensitive data, like AWS access keys, which then can be accessed from us
Fixes #114. This issue is particularly important because $_SERVER may contain sensitive data, like AWS access keys, which then can be accessed from user-provided templates.
To re-enable old unsafe behavior, use:
Liquid::set('EXPOSE_SERVER', true);
#113: Content ticks allow us to track the rendering cost at runtime, abort it or do something else if a template takes too much time to render. (Kudos
#113: Content ticks allow us to track the rendering cost at runtime, abort it or do something else if a template takes too much time to render. (Kudos to @timglabisch!)
Filterbank shall now ignore use of __construct as a filter (by @PATROMO)
Filterbank shall now ignore use of __construct as a filter (by @PATROMO)Whitespace control implemented for tags (see #109).
Now we return null for missing properties, like we do for missing keys for arrays.
null for missing properties, like we do for missing keys for arrays. (#101)Paginate tag shall now respect request parameters.
Major thanks to @edwardoka and @asacarter.
TagPaginate shall not pollute the global scope, but work in own scope. (Thanks @edwardoka and @asacarter)
Now a capture tag will save a variable in the global context. (Fixes #90)
Now a capture tag will save a variable in the global context. (Fixes #90)
TagUnless is an inverted TagIf: simplified implementation
escape and escape_once filters now escape everything, but arrays
escape and escape_once filters now escape everything, but arrays__toString method in conjunction with filtersBetter caching for non-extending templates
Unquoted template names in include tag, as in Jekyll (thanks @jfoucher)
include tag, as in Jekyll (thanks @jfoucher)extends tagDropped support for EOL'ed versions of PHP (< 5.6)
Support for numeric and variable array indicies
Many thanks to @schmoove, @NathanBaulch, @Eun, and all other reporters and contributors.
Version 1.3 will be the last minor version tested under PHP 5.3 not only because this version is not readily supported on Travis, but because it reached EOL quite a long time ago in 2014. At least we can be sure there are no obvious bugs in this version.
Support Traversable loops and filters
Nothing published for this version
Remove content injection from $_GET.
$_GET.Added ESCAPE_BY_DEFAULT setting for context-aware auto-escaping
Changelog (thanks to @sanmai):
ESCAPE_BY_DEFAULT setting for context-aware auto-escapingContext work with plain objectsescape now uses htmlentitiesescape_nowNew tags: "paginate", "unless", "ifchanged" were added
- Add namespaces - Add composer support - Implement new standard filters - Add raw tag
raw tagOne column per quarter.