1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
namespace arc; |
4
|
|
|
|
5
|
|
|
class template |
6
|
|
|
{ |
7
|
|
|
/** |
8
|
|
|
* This method replaces {$key} entries in a string with the value of that key in an arguments list |
9
|
|
|
* If the key isn't in the arguments array, it will remain in the returned string as-is. |
10
|
|
|
* The arguments list may be an object or an array and the values may be basic types or callable. |
11
|
|
|
* In the latter case, the key will be substituted with the return value of the callable. The callable |
12
|
|
|
* is called with the key matched. |
13
|
|
|
* <code> |
14
|
|
|
* $parsedTemplate = \arc\template::substitute( 'Hello {$world} {$foo}', [ 'world' => 'World!' ] ); |
15
|
|
|
* // => 'Hello World! {$foo}' |
16
|
|
|
*</code> |
17
|
|
|
* @param string $template |
18
|
|
|
* @param array $arguments |
19
|
|
|
* @return string |
20
|
|
|
*/ |
21
|
4 |
|
public static function substitute($template, $arguments) |
22
|
|
|
{ |
23
|
4 |
|
if (is_object($arguments) && !($arguments instanceof \ArrayObject )) { |
24
|
|
|
$arguments = get_object_vars( $arguments ); |
25
|
|
|
} |
26
|
4 |
|
$regex = '\{\$(' . join( array_keys( (array) $arguments ), '|' ) . ')\}'; |
27
|
|
|
|
28
|
4 |
|
return preg_replace_callback( '/'.$regex.'/', function ($matches) use ($arguments) { |
29
|
4 |
|
$argument = $arguments[ $matches[1] ]; |
30
|
4 |
|
if (is_callable( $argument )) { |
31
|
1 |
|
$argument = call_user_func( $argument, $matches[1] ); |
32
|
|
|
} |
33
|
|
|
|
34
|
4 |
|
return $argument; |
35
|
4 |
|
}, $template ); |
36
|
|
|
} |
37
|
|
|
|
38
|
|
|
/** |
39
|
|
|
* This method is identical to \arc\template::substitute but it removes any keys left over. |
40
|
|
|
* <code> |
41
|
|
|
* $parsedTemplate = \arc\template::substituteAll( 'Hello {$world} {$foo}', [ 'world' => 'World!' ] ); |
42
|
|
|
* // => 'Hello World! ' |
43
|
|
|
*</code> |
44
|
|
|
* @param string $template |
45
|
|
|
* @param array $arguments |
46
|
|
|
* @return string |
47
|
|
|
*/ |
48
|
1 |
|
public static function substituteAll($template, $arguments) |
49
|
|
|
{ |
50
|
1 |
|
return preg_replace('/\{\$.*\}/', '', self::substitute( $template, $arguments ) ); |
51
|
|
|
} |
52
|
|
|
|
53
|
|
|
} |
54
|
|
|
|