Парсинг данных с шаблонов
Процесс обработки шаблонов происходит при AJAX запросе. В данном случае за этот процесс отвечает файл: upload/engine/ajax/maharder/dle_faker/parse_content.php.
Документация для parse_content.php
Глобальные переменные
$fakerConfig: Конфигурация для генерации данных.$faker: Объект генератора данных Faker.
Константы
DEFAULT_NEWS_FORMAT:'Y-m-d H:m:s'.
Пространства имен
use Faker\Factoryuse JetBrains\PhpStorm\ExpectedValues
Функции
Функция: extractNumsAndStrict
Описание:
Извлекает и заменяет шаблоны формата {{ randomNumber nums=X strict=Y }} на случайные числа, используя глобальную зависимость $faker.
Краткое описание:
Шаблоны имеют следующий формат: - nums=X - задаёт количество цифр в числе. - strict=Y - указывает, строго ли соблюдать количество цифр. (необязательный)
Параметры: - $text (string): Текст, содержащий шаблоны для замены.
Возвращаемый тип: string
Теги: - @global \Faker\Generator $faker - @see \Faker\Generator::randomNumber() - @see \Faker\Extension\Extension::numberBetween()
Функция: extractRandomDigit
Описание:
Заменяет шаблоны вида {{ randomDigit not=X }} случайными числами, не равными указанному X.
Параметры: - $text (string): Входной текст с шаблонами.
Возвращаемый тип: string
Теги: - @global \Faker\Generator $faker - @see \Faker\Generator::randomDigitNot() - @throws \RuntimeException
Функция: extractRandomFloatParams
Описание:
Обрабатывает шаблоны вида {{ randomFloat ... }} и заменяет их случайными числами с плавающей запятой.
Параметры: - $text (string): Текст, содержащий шаблоны.
Возвращаемый тип: string
Теги: - @global \Faker\Generator $faker - @see \Faker\Generator::randomFloat()
Функция: extractNubmerBetween
Описание:
Заменяет шаблоны вида {{ numberBetween min=X max=Y }} случайными числами из диапазона.
Регулярное выражение ищет шаблон вида {{ numberBetween min=X max=Y }}, где параметры min и max являются необязательными. Если параметр min не указан, используется значение PHP_INT_MIN, если max не указан - используется значение 2147483647.
При каждом совпадении выполняется генерация случайного числа с использованием функции numberBetween глобального объекта $faker.
Параметры: - $text (string): Текст с шаблонами.
Возвращаемый тип: string
Теги: - @global object $faker
Функция: extractRandomElementsParams
Описание:
Извлекает параметры шаблона {{ randomElements }} и заменяет их случайными элементами.
Следующие параметры могут быть переданы этому тегу: - items=[] - Обязательный параметр с перечислением элементов через запятую (,) - count=X - Необязательный параметр, устанавливает сколько элементов выводить. По умолчанию: 1. Если указано большее кол-во, нежели кол-во элементов, то возвращает всё - connector=_ - Необязательный параметр соединения элементов. По умолчанию: _.
Параметры: - $text (string): Текст с шаблонами.
Возвращаемый тип: string
Теги: - @global \Faker\Generator $faker - @see randomElements()
Функция: createWords
Описание:
Заменяет шаблоны вида {{ words max=N }} на случайные слова. Выводятся через запятую - max=X - Параметр устанавливающий кол-во выводимых слов. По умолчанию: 3
Параметры: - $text (string): Текст с шаблонами.
Возвращаемый тип: string
Теги: - @global \Faker\Generator $faker - @see \Faker\Provider\Base::words()
Функция: generateSentences
Описание:
Генерирует текст с заменой всех вхождений шаблона {{ sentences max=N }} на сгенерированные предложения с использованием глобальной переменной $faker.
Ищет совпадения с шаблоном {{ sentences max=N }}, где N указывает максимальное количество предложений, затем заменяет их сгенерированными предложениями с помощью метода sentences из $faker. Если параметр max отсутствует или указан некорректно, используется значение по умолчанию — 3.
Параметры: - $text (string): Текст с шаблонами.
Возвращаемый тип: string
Теги: - @global \Faker\Generator $faker - @see \Faker\Generator::sentences()
Функция: generateParagraph
Описание:
Генерирует текст с заменой шаблонов в виде {{ paragraph max=N }} на случайные абзацы текста.
Шаблоны в тексте, которые соответствуют указанному формату, будут заменены на случайно сгенерированные абзацы текста, где количество абзацев указывается через параметр max. По умолчанию используется 3 абзаца.
Параметры: - $text (string): Текст с шаблонами.
Возвращаемый тип: string
Теги: - @global \Faker\Generator $faker - @see \Faker\Generator::paragraphs()
Функция: generateText
Описание:
Генерирует текст, заменяя шаблонные маркеры {{ text max=X }} случайным текстом.
Маркеры в тексте имеют формат {{ text max=X }}. Если параметр max указан, он задаёт максимальную длину сгенерированного текста. Если max не указан, используется значение по умолчанию - 200 символов.
Параметры: - $text (string): Текст с шаблонами.
Возвращаемый тип: string
Теги: - @global object $faker - @see text()
Функция: generateDateTime
Описание:
Генерирует строку с заменой шаблонов даты и времени на соответствующие значения.
Шаблоны даты и времени в строке задаются в виде: - {{ datetime format="формат" }}
Пример шаблона: - {{ datetime format="Y-m-d H:i:s" }}
Если формат даты не указан, используется значение константы DEFAULT_NEWS_FORMAT.
Параметры: - $text (string): Текст с шаблонами.
Возвращаемый тип: string
Теги: - @global \Faker\Generator $faker - @see dateTime() - @see getTimezone()
Функция: getRandomValue
Описание:
Возвращает случайное значение или значения из массива с возможностью исключения определённых элементов.
Параметры: - $array (array): Массив для выборки. - $count (int): Количество значений (по умолчанию 1). - $exclude (array|string|null): Элементы для исключения.
Возвращаемый тип: mixed
Теги: - @global \Faker\Generator $faker - @see \Faker\Generator::numberBetween()
Функция: getTimezone
Описание:
Возвращает временную зону как объект или строку.
Параметры: - $parse (bool): Если true, возвращает объект; иначе строку.
Возвращаемый тип: DateTimeZone|string
Теги: - @global array $config
Функция: getRandomDateBetween
Описание:
Генерирует случайную дату в пределах заданного диапазона.
Если начальная и конечная даты идентичны, возвращает форматированную дату начала. В случае, если конечная дата не указана, диапазон устанавливается от начальной даты до текущей. Если начальная дата позже конечной, параметры меняются местами.
Параметры: - $start (string|DateTime): Начальная дата. - $end (string|DateTime|null): Конечная дата.
Возвращаемый тип: string
Теги: - @see DateTime - @see getTimezone
Функция: parseBoolValue
Описание:
Преобразует строковое значение в логическое.
Значение 'on' будет преобразовано в true, 'off' — в false. Для всех остальных значений используется случайное логическое значение, сгенерированное объектом $faker.
Параметры: - $text (string): Значение 'on', 'off' или 'random'.
Возвращаемый тип: bool
Теги: - @global \Faker\Generator $faker - @see \Faker\Generator::boolean()
Функция: create_metatags
Описание:
Создает метатеги на основе текста и входящих параметров.
Функция анализирует переданный текст, а также параметры запроса для формирования тэгов meta title, description и keywords. Для обработки текста используются внутренние функции очистки, а также анализ ключевых слов.
Параметры: - $story (string): Текст для анализа. - $ajax (bool): Режим AJAX.
Возвращаемый тип: array
Теги: - @global object $db - @global array $config - @see create_metatags engine/inc/include/functions.inc.php
Функция: parseFaker
Описание:
Обрабатывает и заменяет указанный тег в зависимости от заданного типа.
Параметры: - $tag (string): Тег для обработки. - $type (string): Тип данных ('user' или 'post').
Возвращаемый тип: mixed
Теги: - @global object $faker - @global array $fakerConfig - @see extractNumsAndStrict() - @see extractRandomDigit() - @see extractRandomFloatParams() - @see extractRandomElementsParams() - @see extractNubmerBetween() - @see getRandomValue()
Функция: parseUserValues
Описание:
Обрабатывает шаблоны типа user.
Параметры: - $tag (string): Шаблон для обработки.
Возвращаемый тип: mixed
Теги: - @see parseFaker()
Функция: parseNewsValues
Описание:
Обрабатывает значения новостей.
Параметры: - $tag (string): Тег для обработки.
Возвращаемый тип: mixed
Теги: - @see parseFaker()