Получить строку с символами из каждого набора Random::getStringByArray

Модуль: main — подключать отдельно не нужно

Метод Random::getStringByArray возвращает случайную строку, в которой есть символы из каждого набора, например цифры, буквы и специальные символы. Аналог в классическом API — randString($length, $chars) с массивом наборов, он вызывает этот метод.

Сигнатура метода в классе Bitrix\Main\Security\Random:

public static function getStringByArray(int $length, array $charsetList): string

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
length* int Задает длину строки
charsetList* string[] Задает наборы символов, каждый строкой. Передавайте только символы ASCII. С пустым массивом метод зацикливается и не возвращает результат. Пустая строка в массиве вызывает ошибку PHP DivisionByZeroError

Возвращаемое значение

Метод возвращает строку string длиной length.

Метод делит строку на группы по числу наборов. В каждой группе по одному символу из каждого набора в случайном порядке. Если length меньше числа наборов, в строку попадут не все наборы.

Примеры

Пример. Код генерирует пароль из восьми символов, в котором есть цифры, строчные и прописные буквы:

<?php
use Bitrix\Main\Security\Random;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

echo Random::getStringByArray(8, ['0123456789', 'abcdefghijklmnopqrstuvwxyz', 'ABCDEFGHIJKLMNOPQRSTUVWXYZ']);

Смотрите также