Получить строку из заданных символов Random::getStringByCharsets

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

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

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

public static function getStringByCharsets($length, $charsetList)

Параметры

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

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

Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.

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

Метод возвращает строку string длиной length. Каждый символ метод выбирает по случайному байту из getBytes.

Примеры

Пример. Код генерирует код из шести символов без похожих друг на друга 0, O, 1 и I:

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

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

echo Random::getStringByCharsets(6, '23456789ABCDEFGHJKLMNPQRSTUVWXYZ');

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