Download the PHP package alanablett/twig-faker without Composer
On this page you can find all versions of the php package alanablett/twig-faker. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download alanablett/twig-faker
More information about alanablett/twig-faker
Files in alanablett/twig-faker
Package twig-faker
Short Description Integration of PHP faker library with the twig templating system.
License MIT
Informations about the package twig-faker
TwigFaker
An extension to add the faker library into twig templates, providing a fast efficient way to create dummy data within your templates. Here's a quick example:
Configure your fake data type factories/person.php
Use in your templates
Usage
Step 1: Install
Pull this package in through Composer.
Step 2: Register the TwigFaker extension with twig
Step 3: Create a Factories File
TwigFaker isn't magic. You need to describe the type of data that should be generated.
Each factory file you create will automatically have access to a $faker
variable. This is just a normal factory that you would create by doing Faker\Factory::create
.
Within a factories
directory in the root of your project, you may create any number of PHP files that will automatically be loaded by TwigFaker. Why don't you start with a generic factories/person.php
file.
Step 4: Call your new factory in a twig template
With your new factory defined, you can now use it in your twig template.
The first parameter passed to the fake
method is the factory name to be used. The second parameter is the number of fake instances you want to loop through (default is 1 if no parameter is passed).
Note: You can organise your factories in folders such as factories/subfolder/another/example.php
Usage With Sculpin
Step 1: Install
Pull this package in through Composer by adding it to the sculpin.json
file.
Step 2: Register the TwigFaker extension with sculpin
To use the extension in sculpin we have to add it to the extensions that sculpin knows about. This is done by adding it to app/config/sculpin_kernel.yml
Follow the further steps above to create new factories and use them in your templates.
Other Features
Caching
As of version 1.1 you can now cache your fake data in order to use later on down the page. This can be particularly useful when your markup must exist in different areas, but must use the same data. For example I have a hero block factory defined as follows
Now in my markup I would like to use the same data for two different calls to the fake method, so I simply pass in a key as the third argument to ensure the data is the same, in this case main-heroes