survos/faker-bundle

Makes fakerphp/faker methods available via twig

1.5.442 2024-12-15 14:27 UTC

Requires

• php: ^8.3
• fakerphp/faker: ^1.20
• survos/installer: ^1.5 || ^2.0
• symfony/config: ^6.4 || ^7.1
• symfony/dependency-injection: ^6.4 || ^7.1
• symfony/http-kernel: ^6.4 || ^7.1
• twig/twig: ^3.4

Requires (Dev)

• phpstan/phpstan: ^2.0

MIT

• Tac Tacelosky

README

Symfony Bundle for fakerphp/faker, exposes many of the formatters in twig.

composer req survos/faker-bundle

<ul>
{% for i in 1..10 %}
<li>{{ person_name() }}, {{ company_company() }}</li>
{% endfor %} 
</ul>

By default, the data will change with every page refresh. To keep it consistent, change the seed. If the twig function names interfere with another twig function, set a prefix, e.g. fake_name().

# config/packages/survos_faker.yaml
survos_faker:
  seed: 42
  prefix: fake_

You can also set the seed in a twig file, via the faker_set_seed() function.

Working example

Cut and paste the following to create a new Symfony project with a landing page that demonstrates the faker twig functions.

symfony new FakerDemo --webapp && cd FakerDemo
bin/console make:controller AppController
sed  -i "s|'/app'|'/'|" src/Controller/AppController.php # the landing page controller
composer config allow-plugins.survos/installer true
composer req survos/faker-bundle
echo "{% extends 'base.html.twig' %} {% block body %}<ul> {% for i in 0..10 %} <li>{{ person_name() }} <u>{{ internet_email() }}</u> <br />  <i>{{ company_jobTitle() }}</i>, {{ company_company() }}  </li>{% endfor %}</ul> {% endblock %}" > templates/app/index.html.twig
symfony server:start -d
symfony open:local

symfony new pwa-demo --webapp --php=8.2 && cd pwa-demo composer config extra.symfony.allow-contrib true composer req symfony/stimulus-bundle

bin/console make:controller AppController sed -i "s|Route('/app'|Route('/'|" src/Controller/AppController.php sed -i "s|'app_app'|'app_homepage'|" src/Controller/AppController.php cat > templates/app/index.html.twig <<END {% extends 'base.html.twig' %} {% block body %}

A simple CRUD

Listing {% endblock %} END

Now open the site. Each refresh generates different results. To make the results consistent, set a seed.

echo "survos_faker: {seed: 1}" > config/packages/survos_faker.yaml
bin/console cache:clear
symfony server:start