Инструкция по установке и использованию модуля dZENcode: FakerPHP
Инструкция по установке и использованию модуля dZENcode: FakerPHP
Общее

Модуль может быть установлен исключительно на сайты работающие на системе управления контентом «1С-Битрикс: Управление сайтом».

Административный раздел сайта доступен по адресу https://адрес-сайта/bitrix/admin

Документация по работе с административным разделом (админкой) сайта «1С-Битрикс: Управление сайтом»

Для работы с контентом сайта необходимо ознакомиться с системой управления сайтом. Вся необходимая и подробная информация содержится в курсе Контент-менеджер «1С-Битрикс».

Предназначение модуля dZENcode: FakerPHP

Чрезвычайно полезный при разработке инструмент FakerPHP в Bitrix-окружении! Поставляется "как есть", без кастомизации оригинального компонента. Поддерживает любые решения на PHP 8.1. Для установки не нужен Composer, поэтому можно установить на сайте с любым хостингом.

FakerPHP — это PHP-библиотека, которая генерирует тестовые (фейковые) данные для искусственного наполнения данными приложения при его разработке и тестировании. Очень удобно использовать, если необходимо наполнить базу данных, создать красивые XML-документы, заполнить персистентные данные для стресс-теста или анонимизировать данные, взятые из продакшена и т.д.

Значительно облегчает работу разработчика, когда нужно создать множество фейковых данных, тем не менее похожих на настоящие.

Установка

Решение «dZENcode: FakerPHP» может быть установлено на CMS «1С-Битрикс, Управление сайтом» с активной лицензией следующих редакций: Стандарт, Малый бизнес, Эксперт, Бизнес и
«1С-Битрикс, Корпоративный портал»: «Битрикс24» в коробке - Корпоративный портал, «Битрикс24» в коробке - Энтерпрайз, 1С-Битрикс24: Интернет-магазин + CRM

Если 1С-Битрикс подходящей редакции уже установлен:

Модуль ZENcode: FakerPHP поддерживает стандартную установку средствами системы, а именно:

    • В административной части сайта выбрать раздел «Marketplace»
    • «Каталог решений», найти и установить готовое решение «Модуль dZENcode: Fakerphp»
    Найдите решение “Модуль dZENcode: Fakerphp (dzencode.fakerphp) Fakerphp от dZENcode: генерация тестовых (фейковых) данных”, в контекстном меню мастера выберите пункт «Установить».
    Установка модуля
  • Далее необходимо следовать указаниям мастера установки.
Услуга установки готового решения

В случае необходимости установки готового решения силами специалистов компании "dZENcode", мы предлагаем услугу установки и первичной настройки готового решения на хостинге.

Запрос на установку готового решения Вы можете отправить через виджет, через форму обратной связи на нашем сайте или отправив письмо нам на почту support@dzencode.com .

Использование
  1. После стандартной установки модуля, его необходимо подключить в скрипте, в котором Вы планируете использовать FakerPHP:
    Bitrix\Main\Loader::includeModule('dzencode.fakerphp');
  2. Создать экземпляр класса Faker\Generator:
    $faker = Faker\Factory::create();
  3. Теперь можно генерировать данные при помощи многочисленных методов класса, например:
    echo $faker->name(); // 'Vince Sporer'
Методы FakerPHP

Доступные методы можно посмотреть на офсайте расширения, но там описаны не все методы.

Если есть желание просмотреть все доступные методы:

  • создайте экземпляр класса:
    $faker = Faker\Factory::create();
  • и выведите его дамп в браузер при помощи var_dump() или нравящегося Вам дампера, например:
    var_dump($faker);
  • В свойствах (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/

Структура
static_numbers