Caching Expressions Using Parser Caches
Warning: You are browsing the documentation for Symfony 2.x, which is no longer maintained.
Read the updated version of this page for Symfony 7.2 (the current stable version).
The ExpressionLanguage component already provides a compile() method to be able to cache the expressions in plain PHP. But internally, the component also caches the parsed expressions, so duplicated expressions can be compiled/evaluated quicker.
The Workflow
Both evaluate()
and compile()
need to do some things before each can provide the return
values. For evaluate()
, this overhead is even bigger.
Both methods need to tokenize and parse the expression. This is done by the
parse()
method. It returns a ParsedExpression.
Now, the compile()
method just returns the string conversion of this object.
The evaluate()
method needs to loop through the "nodes" (pieces of an
expression saved in the ParsedExpression
) and evaluate them on the fly.
To save time, the ExpressionLanguage
caches the ParsedExpression
so
it can skip the tokenize and parse steps with duplicate expressions.
The caching is done by a
ParserCacheInterface
instance (by default, it uses an
ArrayParserCache).
You can customize this by creating a custom ParserCache
and injecting this
in the object using the constructor:
1 2 3 4 5
use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
use Acme\ExpressionLanguage\ParserCache\MyDatabaseParserCache;
$databaseParserCache = new MyDatabaseParserCache(...);
$expressionLanguage = new ExpressionLanguage($databaseParserCache);
Note
The DoctrineBridge provides a Parser Cache implementation using the doctrine cache library, which gives you caching for all sorts of cache strategies, like Apc, Filesystem and Memcached.
Using Parsed and Serialized Expressions
Both evaluate()
and compile()
can handle ParsedExpression
and
SerializedParsedExpression
:
1 2 3 4 5 6
// ...
// the parse() method returns a ParsedExpression
$expression = $expressionLanguage->parse('1 + 4', array());
var_dump($expressionLanguage->evaluate($expression)); // prints 5
1 2 3 4 5 6 7 8 9
use Symfony\Component\ExpressionLanguage\SerializedParsedExpression;
// ...
$expression = new SerializedParsedExpression(
'1 + 4',
serialize($expressionLanguage->parse('1 + 4', array())->getNodes())
);
var_dump($expressionLanguage->evaluate($expression)); // prints 5