https://github.com/uuf6429/expression-language-tplstring
🪡 Template Strings support for Symfony Expression Language
https://github.com/uuf6429/expression-language-tplstring
expression-language php symfony syntax template-strings uuf6429
Last synced: about 2 months ago
JSON representation
🪡 Template Strings support for Symfony Expression Language
- Host: GitHub
- URL: https://github.com/uuf6429/expression-language-tplstring
- Owner: uuf6429
- License: mit
- Created: 2022-07-15T19:51:07.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-12-24T04:57:58.000Z (over 2 years ago)
- Last Synced: 2025-04-03T11:57:31.118Z (2 months ago)
- Topics: expression-language, php, symfony, syntax, template-strings, uuf6429
- Language: PHP
- Homepage:
- Size: 9.77 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🪡 Template Strings
for Symfony Expression Language (4-6)
[](https://github.com/uuf6429/expression-language-tplstring/actions/workflows/ci.yml)
[](https://codecov.io/gh/uuf6429/expression-language-tplstring)
[](https://php.net/)
[](https://github.com/uuf6429/expression-language-tplstring/blob/main/LICENSE)
[](https://packagist.org/packages/uuf6429/expression-language-tplstring)
[](https://packagist.org/packages/uuf6429/expression-language-tplstring)
> **What looks like a dot, a cross and a wave, and does the same thing?**
>
> It's the concatenation operator, of course!
>
> PHP uses a dot/period (`.`), many languages including javascript use `+`,
> whereas [Symfony Expression Language](https://github.com/symfony/expression-language) uses the tilde (`~`).
This library provides a translation layer on top of Expression Language that converts template strings in ES6 format* to
valid expression.
While an updated Expression Language subclass is provided for convenience, you don't have to use it, and you can use the
provided trait instead.
*\* only ES6 string interpolation (with any expressions and nesting) is supported; f.e. tagged templates are not.*
## 🔌 Installation
As always, the recommended and easiest way to install this library is through [Composer](https://getcomposer.org/):
```bash
composer require "uuf6429/expression-language-tplstring"
```
## 🚀 Usage
If you do not plan on extending Symfony Expression Language class, you can use the provided drop-in:
```php
$el = new \uuf6429\ExpressionLanguage\ExpressionLanguageWithTplStr();
$el->evaluate('`hello ${name}!`', ['name'=>'mars']); // => hello mars!
```
Otherwise, you can subclass the desired Expression Language class and `use` the provided trait:
```php
class MyEL extends \uuf6429\ExpressionLanguage\ExpressionLanguageWithArrowFunc
{
use \uuf6429\ExpressionLanguage\TemplateStringTranslatorTrait;
public function compile($expression, array $names = [])
{
if (!$expression instanceof \Symfony\Component\ExpressionLanguage\ParsedExpression) {
$expression = $this->translateTplToEl($expression);
}
return parent::compile($expression, $names);
}
public function evaluate($expression, array $values = [])
{
if (!$expression instanceof \Symfony\Component\ExpressionLanguage\ParsedExpression) {
$expression = $this->translateTplToEl($expression);
}
return parent::evaluate($expression, $values);
}
}
$el = new MyEL();
$el->evaluate(
'users.map((user) -> { `hello ${user.name}!` }).join(` `)',
[
'users' => new \Illuminate\Support\Collection([
(object)['name' => 'John', 'surname' => 'Doe'],
(object)['name' => 'Jane', 'surname' => 'Roe'],
])
]
); // => hello John! hello Jane!
```