Download the PHP package youniwemi/string-template without Composer
On this page you can find all versions of the php package youniwemi/string-template. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download youniwemi/string-template
More information about youniwemi/string-template
Files in youniwemi/string-template
Package string-template
Short Description StringTemplate is a very simple but powefull string template engine for php. It allows named and nested substutions as well as conditionnals et custom filters (originaly a fork of nicmart/StringTemplate)
License MIT
Informations about the package string-template
StringTemplate
StringTemplate is a very simple string template engine for php (and a fork of nicmart/StringTemplate).
It allows named and nested substutions as well as conditionnals et custom filters.
For installing instructions, go to the end of this README.
Why
I have often struggled against sprintf's lack of a named placeholders feature, so I have decided to write once and for all a simple component that allows you to render a template string in which placeholders are named.
Furthermore, its placeholders can be nested as much as you want (multidimensional arrays allowed).
Usage
Simply create an instance of Youniwemi\StringTemplate\Engine
, and use its render
method.
Placeholders are delimited by default by {
and }
, but you can specify others through
the class constructor.
You can also provide an array value:
Nested array values are allowed too! Example:
Object values will be converted to strings:
You can change the delimiters as you want:
You can use a simple condition:
You can use a simple condition with else:
You can use a simple filters ( lower|upper|esc_html ):
You can add you own filters:
You can use closures a values
You can use closures can use the variables
And lastly, you can use sprintf formats:
NestedKeyArray
In addition to iteration with nested keys, the library offers a class that allows you to access
a multidimensional array with flatten nested keys as the ones seen above. It's called NestedKeyArray
.
Example:
Where is it used
I use StringTemplate in Instareza, a booking system for activities, as well as in Mail Control for its newsletter upcoming feature.
Install
The best way to install StringTemplate is through composer.
Just create a composer.json file for your project:
Then you can run these two commands to install it:
$ curl -s http://getcomposer.org/installer | php
$ php composer.phar install
or simply run composer install
if you have have already installed the composer globally.
Then you can include the autoloader, and you will have access to the library classes: