1. После стандартной установки модуля, его необходимо подключить в скрипте, в котором Вы планируете использовать FakerPHP:
Bitrix\Main\Loader::includeModule('dzencode.fakerphp'); |
2. Создать экземпляр класса Faker\Generator:
$faker = Faker\Factory::create(); |
3. Теперь можно генерировать данные при помощи многочисленных методов класса, например:
echo $faker->name(); // 'Vince Sporer' |
Доступные методы можно посмотреть на
офсайте расширения,
но там описаны не все методы.
Если есть желание просмотреть все доступные методы:
- создайте экземпляр класса:
$faker = Faker\Factory::create(); |
- и выведите его дамп в браузер при помощи var_dump() или нравящегося Вам дампера:
- В свойствах (Properties) будут защищенное свойство-провайдеры (protected providers) в которых в виде массива будут доступные провайдеры и доступные методы к каждому. Например, для провайдера Faker\Provider\en_US\Person доступны публичные методы name(), firstName() и т.д.
Локализация
Очень важна в данной библиотеке.
В пакете присутствует более 60 локализаций.
С полным списком можно ознакомиться в структуре модуля:
dzencode.fakerphp/lib/fakerphp/Faker/Provider
По умолчанию используется английская американская en_US, т.е. ее указывать в параметрах статического метода create() не нужно.
Чтобы установить, например, французскую локаль (fr_FR), нужно при создании объекта указать ее в параметрах соответствующего метода:
$faker = Faker\Factory::create('fr_FR');
❗ Обратите, пожалуйста, внимание, что при вызове методов имеет значение, какая локаль установлена. Например, с русской локалью метод email() не работает и его вызов вернет ошибку.
Кстати, локали занимают довольно много места на диске, т.к. содержат в себе огромные тексты, используемые при генерации данных. Например, в русской хранится полный текст Мертвых душ Гоголя. Общий вес модуля составляет около 10 Mб (львиная доля которых приходится именно на локали) и если свободное место критично, просто удалите не используемые языки из директории dzencode.fakerphp/lib/fakerphp/Faker/Provider/