Заменить недопустимые символы случайными буквами Path::randomizeInvalidFilename
Модуль: main — подключать отдельно не нужно
Метод Path::randomizeInvalidFilename заменяет каждый недопустимый символ имени файла случайной строчной латинской буквой от a до z. Метод вызывает replaceInvalidFilename с такой функцией замены.
Сигнатура метода в классе Bitrix\Main\IO\Path:
public static function randomizeInvalidFilename($filename)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| filename* | string |
Задает имя файла |
Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод возвращает имя той же длины в символах, где вместо каждого недопустимого символа стоит случайная буква. При повторных вызовах метод возвращает разные имена. Нулевой байт метод не заменяет, как и replaceInvalidFilename.
Примеры
Пример. Код исправляет имя и проверяет результат:
<?php
use Bitrix\Main\IO\Path;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$filename = Path::randomizeInvalidFilename('kg:g?.txt');
echo mb_strlen($filename) . ' ' . var_export(Path::validateFilename($filename), true);
Код выведет 9 true.
Смотрите также
Была ли статья полезна?
Следующая