add utf8-compatible functions to replace "capitalize', "capitalizeWords", "toLowerCase", "toUpperCase",

add a "truncate" function that adds "..." at the end of the string

Author: clemzarch

src/Capitalize.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Kiboko\Component\StringExpressionLanguage;
+
+use Symfony\Component\ExpressionLanguage\ExpressionFunction;
+
+final class Capitalize extends ExpressionFunction
+{
+    public function __construct($name)
+    {
+        parent::__construct(
+            $name,
+            \Closure::fromCallable($this->compile(...))->bindTo($this),
+            \Closure::fromCallable($this->evaluate(...))->bindTo($this)
+        );
+    }
+
+    private function compile(string $input): string
+    {
+        return <<<PHP
+            (
+                !\\is_string({$input}) ?
+                null :
+                (
+                    mb_convert_case(mb_substr({$input}, 0, 1), \\MB_CASE_UPPER) . mb_substr({$input}, 1, -1)
+                )
+            )
+            PHP;
+    }
+
+    private function evaluate(array $context, string $input)
+    {
+        return !\is_string($input) ?
+            null :
+            (
+                mb_convert_case(mb_substr($input, 0, 1), \MB_CASE_UPPER).mb_substr($input, 1, -1)
+            );
+    }
+}

src/CapitalizeWords.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Kiboko\Component\StringExpressionLanguage;
+
+use Symfony\Component\ExpressionLanguage\ExpressionFunction;
+
+final class CapitalizeWords extends ExpressionFunction
+{
+    public function __construct($name)
+    {
+        parent::__construct(
+            $name,
+            \Closure::fromCallable($this->compile(...))->bindTo($this),
+            \Closure::fromCallable($this->evaluate(...))->bindTo($this)
+        );
+    }
+
+    private function compile(string $input): string
+    {
+        return <<<PHP
+            (
+                !\\is_string({$input}) ?
+                null :
+                (
+                    mb_convert_case({$input}, \\MB_CASE_TITLE)
+                )
+            )
+            PHP;
+    }
+
+    private function evaluate(array $context, string $input)
+    {
+        return !\is_string($input) ?
+            null :
+            (
+                mb_convert_case($input, \MB_CASE_TITLE)
+            );
+    }
+}

src/StringExpressionLanguageProvider.php

@@ -14,19 +14,20 @@ public function getFunctions(): array
         return [
             ExpressionFunction::fromPhp('sprintf', 'format'),
             ExpressionFunction::fromPhp('trim', 'trim'),
-            ExpressionFunction::fromPhp('ucfirst', 'capitalize'),
-            ExpressionFunction::fromPhp('strtolower', 'toLowerCase'),
+            new Capitalize('capitalize'),
+            new ToLowerCase('toLowerCase'),
             ExpressionFunction::fromPhp('mb_substr', 'search'),
-            ExpressionFunction::fromPhp('strtoupper', 'toUpperCase'),
+            new ToUpperCase('toUpperCase'),
             ExpressionFunction::fromPhp('number_format', 'formatNumber'),
             ExpressionFunction::fromPhp('strpos', 'indexOf'),
             ExpressionFunction::fromPhp('str_replace', 'replace'),
             ExpressionFunction::fromPhp('strip_tags', 'stripHtml'),
             ExpressionFunction::fromPhp('json_decode', 'decode'),
             ExpressionFunction::fromPhp('preg_replace', 'replaceByExpression'),
-            ExpressionFunction::fromPhp('ucwords', 'capitalizeWords'),
+            new CapitalizeWords('capitalizeWords'),
             ExpressionFunction::fromPhp('rtrim', 'removeWhitespaces'),
             ExpressionFunction::fromPhp('explode', 'splitIntoArray'),
+            new Truncate('truncate'),
             new FileName('fileName'),
             new DateTime('dateTime'),
             new FormatDate('formatDate'),

src/ToLowerCase.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Kiboko\Component\StringExpressionLanguage;
+
+use Symfony\Component\ExpressionLanguage\ExpressionFunction;
+
+final class ToLowerCase extends ExpressionFunction
+{
+    public function __construct($name)
+    {
+        parent::__construct(
+            $name,
+            \Closure::fromCallable($this->compile(...))->bindTo($this),
+            \Closure::fromCallable($this->evaluate(...))->bindTo($this)
+        );
+    }
+
+    private function compile(string $input): string
+    {
+        return <<<PHP
+            (
+                !\\is_string({$input}) ?
+                null :
+                (
+                    mb_convert_case({$input}, \\MB_CASE_LOWER)
+                )
+            )
+            PHP;
+    }
+
+    private function evaluate(array $context, string $input)
+    {
+        return !\is_string($input) ?
+            null :
+            (
+                mb_convert_case($input, \MB_CASE_LOWER)
+            );
+    }
+}

src/ToUpperCase.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Kiboko\Component\StringExpressionLanguage;
+
+use Symfony\Component\ExpressionLanguage\ExpressionFunction;
+
+final class ToUpperCase extends ExpressionFunction
+{
+    public function __construct($name)
+    {
+        parent::__construct(
+            $name,
+            \Closure::fromCallable($this->compile(...))->bindTo($this),
+            \Closure::fromCallable($this->evaluate(...))->bindTo($this)
+        );
+    }
+
+    private function compile(string $input): string
+    {
+        return <<<PHP
+            (
+                !\\is_string({$input}) ?
+                null :
+                (
+                    mb_convert_case({$input}, \\MB_CASE_UPPER)
+                )
+            )
+            PHP;
+    }
+
+    private function evaluate(array $context, string $input)
+    {
+        return !\is_string($input) ?
+            null :
+            (
+                mb_convert_case($input, \MB_CASE_UPPER)
+            );
+    }
+}

src/Truncate.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Kiboko\Component\StringExpressionLanguage;
+
+use Symfony\Component\ExpressionLanguage\ExpressionFunction;
+
+final class Truncate extends ExpressionFunction
+{
+    public function __construct($name)
+    {
+        parent::__construct(
+            $name,
+            \Closure::fromCallable($this->compile(...))->bindTo($this),
+            \Closure::fromCallable($this->evaluate(...))->bindTo($this)
+        );
+    }
+
+    private function compile(string $input, string $limit): string
+    {
+        return <<<PHP
+            (
+                !\\is_string({$input}) || !\\is_int({$limit}) ?
+                null :
+                (
+                    rtrim(mb_substr({$input}, 0, {$limit} - 1)) . '…'
+                )
+            )
+            PHP;
+    }
+
+    private function evaluate(array $context, string $input, string $limit)
+    {
+        return !\is_string($input) || !\is_int($limit) ?
+            null :
+            (
+                rtrim(mb_substr($input, 0, $limit - 1)).'…'
+            );
+    }
+}