twig-faker

KO | EN

gitlite — search

#react #typescript #llm #golang #go #android #machine-learning #deep-learning #linux #windows #cli #kubernetes #pytorch #security

(★ 17)

An extension to add the faker library into twig templates.

twig-faker Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Build Status](https://travis-ci.org/alanablett/twig-faker.svg?branch=master)](https://travis-ci.org/alanablett/twig-faker)
[![Code Coverage](https://scrutinizer-ci.com/g/alanablett/twig-faker/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/alanablett/twig-faker/?branch=master)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/alanablett/twig-faker/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/alanablett/twig-faker/?branch=master)

[![Latest Stable Version](https://poser.pugx.org/alanablett/twig-faker/v/stable)](https://packagist.org/packages/alanablett/twig-faker) [![Total Downloads](https://poser.pugx.org/alanablett/twig-faker/downloads)](https://packagist.org/packages/alanablett/twig-faker) [![Latest Unstable Version](https://poser.pugx.org/alanablett/twig-faker/v/unstable)](https://packagist.org/packages/alanablett/twig-faker) [![License](https://poser.pugx.org/alanablett/twig-faker/license)](https://packagist.org/packages/alanablett/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`

```php
<?php

return [
    'first_name' => $faker->firstName,
    'last_name' => $faker->lastName,
    'avatar' => $faker->imageUrl(300, 300)
];
```

Use in your templates

```twig
{% for person in fake('person', 20) %}
    <p>Hello {{ person.first_name }} {{ person.first_name }}</p>
    <img src="{{ person.avatar }}">
{% endfor %}
```

## Usage

### Step 1: Install

Pull this package in through Composer.

```json
"require": {
    "alanablett/twig-faker": "~1.1"
}
```

### Step 2: Register the TwigFaker extension with twig

```php
$twig->addExtension(new Ablett\TwigFaker\TwigFakerExtension);
```

### 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.

```php
<?php

return [
    'first_name' => $faker->firstName,
    'last_name' => $faker->lastName,
    'avatar' => $faker->imageUrl(300, 300)
];
```

### Step 4: Call your new factory in a twig template

With your new factory defined, you can now use it in your twig template.

```twig
{% for person in fake('person', 20) %}
    <p>Hello {{ person.first_name }} {{ person.first_name }}</p>
    <img src="{{ person.avatar }}">
{% endfor %}
```

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`

```twig
{% for example in fake('subfolder/another/example', 20) %}
    <p>{{ example.value }}</p>
{% endfor %}
```

## Usage With Sculpin

### Step 1: Install

Pull this package in through Composer by adding it to the `sculpin.json` file.

```json
"require": {
    "alanablett/twig-faker": "~1.1"
}
```

### 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`

```yml
services:
  twig.extension.faker:
    class: Ablett\TwigFaker\TwigFakerExtension
    tags:
      - { name: twig.extension }
```

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

```php
<?php

return [
    'title' => $faker->sentence(),
    'background' => $faker->imageUrl(1700, 600)
];
```

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`

```twig
{% for hero in fake('heroes', 4, 'main-heroes') %}
    <div class="hero__cell" data-background-url="{{ hero.background }}">
        <h2>{{ hero.title }}</h2>
    </div>
{% endfor %}
...
...
...
{% for hero in fake('heroes', 4, 'main-heroes') %}
    <div class="hero__button">
        <button>{{ hero.title }}</button>
    </div>
{% endfor %}
```

[faker]: https://github.com/fzaninotto/Faker

twig-faker

twig-faker Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

twig-faker

twig-faker Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README