Packagist · #115 most downloaded on Packagist

mtdowling/jmespath.php

2.9.2546M downloads/mojmespath/jmespath.php ↗New releases in your daily digest, changelog included.

Declaratively specify how to extract elements from a JSON document

Last release 3 months ago
06 Jul 2026
Release timing varies
gaps range from 4 weeks to 3.1 years
Most releases are documented
notes for 15 of 20 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
20 releases · first in 2014

Release timeline

20 releases since 2014

2014201620182020

Releases

2.9.26 Jul 20262 sources agree
Pass explicit trim characters ahead of the PHP 8.6 trim default change.
Pass explicit trim characters ahead of the PHP 8.6 trim default change.
Open source →
2.9.111 Jun 20262 sources agree
Fixed the compiled runtime to emit function names as string literals, preventing arbitrary code execution.
Fixed the compiled runtime to emit function names as string literals, preventing arbitrary code execution.

Fixed the parser to reject non-identifier function callees, such as literal and raw string callees.
Open source →

One column per quarter.

Fixed to_number() to parse number strings using the JSON number grammar.

Added PHP 8.5 support.
Fixed to_number() to parse number strings using the JSON number grammar.
Fixed reverse() and string slicing to operate on UTF-8 characters rather than bytes.
Fixed slicing of array-like (ArrayAccess + Countable) values.
Fixed equality and contains() to use JSON semantics, e.g. 1 == 1.0 is now true.
Fixed multi-select hashes to end projections, so following tokens apply to the projected list.
Fixed sort() and sort_by() to compare numbers numerically.
Changed sort(), sort_by(), max(), min(), max_by() and min_by() to order strings by code point.
Fixed max_by() and min_by() to error on mixed-type keys instead of returning arbitrary elements.
Fixed max() returning null or erroring when the first array element is falsy, e.g. max([0, 1]).
Fixed sum() and join() to return 0 and an empty string respectively for empty arrays.
Fixed 0.0 to be truthy in filters and logical operators, like every other number.
Fixed the compiled runtime to apply JMESPath truthiness to || and &&.
Fixed @(foo), foo[-] and oversized index literals to throw syntax errors.
Fixed PHP warnings emitted while parsing certain invalid expressions.
Fixed the caret position in syntax error messages for errors at the end of an expression.
Fixed map() to error on non-array second arguments instead of returning [].
Fixed Env::cleanCompileDir() when JP_PHP_COMPILE=on.

Open source →

2.8.04 Sept 20242 sources agree

Add support for PHP 8.4.

Add support for PHP 8.4.

Open source →

2.7.025 Aug 20232 sources agree

Fixed flattening in arrays starting with null.

Fixed flattening in arrays starting with null.
Drop support for HHVM and PHP earlier than 7.2.5.
Add support for PHP 8.1, 8.2, and 8.3.

Open source →

2.6.114 Jun 2021

Fixed edge case crash on PHP 8.0.

Fixed edge case crash on PHP 8.0.

Open source →

2.6.031 Jul 20202 sources agree

Support for PHP 8.0.

Support for PHP 8.0.

Open source →

2.5.030 Dec 20192 sources agree

Fixed autoloading when run from within vendor folder.

Full support for PHP 7.0-7.4.
Fixed autoloading when run from within vendor folder.
Full multibyte (UTF-8) string support.

Open source →

2.4.03 Dec 20162 sources agree

Added support for floats when interpreting data.

Added support for floats when interpreting data.
Added a function_exists check to work around redeclaration issues.

Open source →

2.3.05 Jan 20162 sources agree

Added support for JEP-9 , including unary filter expressions, and && filter expressions.

Added support for JEP-9,
including unary filter expressions, and && filter expressions.
Fixed various parsing issues, including not removing escaped single quotes
from raw string literals.
Added support for the map function.
Fixed several issues with code generation.

Open source →

2.2.027 May 2015

Added support for JEP-12 and raw string literals (e.g., 'foo').

Added support for JEP-12 and raw string literals (e.g., 'foo').

Open source →

2.1.013 Jan 2015

Added JmesPath\Env::cleanCompileDir() to delete any previously compiled JMESPath expressions.

Added JmesPath\Env::cleanCompileDir() to delete any previously compiled JMESPath expressions.

Open source →

2.0.012 Jan 2015

Moving to a flattened namespace structure.

Moving to a flattened namespace structure.
Runtimes are now only PHP callables.
Fixed an error in the way empty JSON literals are parsed so that they now return an empty string to match the Python and JavaScript implementations.
Removed functions from runtimes. Instead there is now a function dispatcher class, FnDispatcher, that provides function implementations behind a single dispatch function.
Removed ExprNode in lieu of just using a PHP callable with bound variables.
Removed debug methods from runtimes and instead into a new Debugger class.
Heavily cleaned up function argument validation.
Slice syntax is now properly validated (i.e., colons are followed by the appropriate value).
Lots of code cleanup and performance improvements.
Added a convenient JmesPath\search() function.
IMPORTANT: Relocating the project to https://github.com/jmespath/jmespath.php

Open source →

1.1.18 Oct 2014

Added support for using ArrayAccess and Countable as arrays and objects.

Added support for using ArrayAccess and Countable as arrays and objects.

Open source →

1.1.06 Aug 2014

Added the ability to search data returned from json_decode() where JSON objects are returned as stdClass objects.

Added the ability to search data returned from json_decode() where JSON objects are returned as stdClass objects.

Open source →

1.0.019 Jun 2014