Функция cot_randomstring в Cotonti

Функция cot_randomstring генерирует случайную строку заданной длины, используя символы из указанного набора ($charlist). Если набор символов не предоставлен, используется стандартный набор, включающий алфавит (буквы) и цифры.

Подробное объяснение работы функции:

function cot_randomstring($length = 8, $charlist = null)
{
    if (!is_string($charlist)) $charlist = 'ABCDEFGHIJKLMNOPRSTUVYZabcdefghijklmnoprstuvyz0123456789';
    $max = strlen($charlist) - 1;
    $string = '';
    for ($i = 0; $i < $length; $i++)
    {
        $string .= $charlist[mt_rand(0, $max)];
    }
    return $string;
}

 

Параметры:
$length (int) — длина строки, которую необходимо сгенерировать. По умолчанию значение равно 8.

Это количество символов в результирующей строке.

$charlist (string) — строка, содержащая допустимые символы для генерации случайной строки.
Если этот параметр не передан или передан неверный (не строковый) параметр, то используется стандартный набор символов, состоящий из:

'ABCDEFGHIJKLMNOPRSTUVYZabcdefghijklmnoprstuvyz0123456789'

Это включает все заглавные и строчные буквы латинского алфавита (кроме некоторых букв, таких как Q, W, X, и другие) и цифры.

Алгоритм работы функции:

Проверка и установка набора символов:

if (!is_string($charlist)) $charlist = 'ABCDEFGHIJKLMNOPRSTUVYZabcdefghijklmnoprstuvyz0123456789';

Если параметр $charlist не является строкой, то используется стандартный набор символов, который содержит заглавные и строчные буквы латинского алфавита и цифры.

Получение максимального индекса символа:

$max = strlen($charlist) - 1;

strlen($charlist) вычисляет длину строки символов. Поскольку индексы в строках начинаются с 0, максимальный индекс символа будет на 1 меньше длины строки.

Генерация случайной строки:

$string = '';
for ($i = 0; $i < $length; $i++)
{
    $string .= $charlist[mt_rand(0, $max)];
}

 

Цикл выполняется $length раз.

В каждой итерации выбирается случайный символ из набора $charlist с помощью функции mt_rand(0, $max), которая генерирует случайное число в пределах от 0 до $max (индекса последнего символа в $charlist).
С помощью этого случайного числа выбирается символ из строки $charlist и добавляется в строку $string.

Возврат сгенерированной строки:

return $string;

После завершения цикла функция возвращает сгенерированную строку заданной длины.
Примеры использования:
Пример с длиной 8 символов (по умолчанию):

echo cot_randomstring();  // Пример вывода: '4kZm2pQs'

Пример с длиной 12 символов:

echo cot_randomstring(12);  // Пример вывода: 'Wyz6NmoS7Yt0'

 

Пример с пользовательским набором символов (например, только буквы):

echo cot_randomstring(8, 'ABCDEabcde');  // Пример вывода: 'BaCbcAeD'

 

Пример с пользовательским набором символов (например, только цифры):

 

echo cot_randomstring(6, '0123456789');  // Пример вывода: '842356'

 

Пример с паролем

(empty($ruser['user_password'])) && $ruser['user_password'] = cot_randomstring();

Примечания:

Использование mt_rand():

Функция mt_rand() используется для генерации случайных чисел. Это достаточно эффективный генератор случайных чисел, который работает быстрее, чем обычный rand(), особенно при генерации большого количества случайных чисел.
Тем не менее, для криптографических целей следует использовать более безопасные методы генерации случайных чисел, такие как random_int() или random_bytes(), так как mt_rand() не является криптографически стойким.

Универсальность:

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

Заключение:
Функция cot_randomstring предоставляет простой и эффективный способ генерации случайных строк с заданной длиной и набором символов. Она может быть полезна для создания случайных паролей, одноразовых токенов и других случайных значений.