Проверить абсолютный путь Path::validate
Модуль: main — подключать отдельно не нужно
Метод Path::validate проверяет, что строка — абсолютный путь без недопустимых символов. Метод проверяет только строку и не обращается к файловой системе.
Сигнатура метода в классе Bitrix\Main\IO\Path:
public static function validate($path)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| path* | string |
Задает путь |
Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод возвращает true, если путь подходит под все условия:
- начинается с
/или с буквы диска и:/, напримерC:/upload, - не содержит повторных косых черт, например
/upload//units, - не содержит символов из константы
INVALID_FILENAME_CHARS, кроме/, - не содержит управляющих символов, нулевого байта и символа смены направления текста U+202E.
Иначе метод возвращает false. Для относительного пути, пустой строки и не строки метод возвращает false. Кириллица и пробелы в пути допустимы.
Примеры
Пример. Код проверяет три пути:
<?php
use Bitrix\Main\IO\Path;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
foreach (['/upload/units/kg.txt', 'upload/kg.txt', '/upload/k:g.txt'] as $path)
{
echo $path . ' ' . var_export(Path::validate($path), true) . PHP_EOL;
}
Код выведет:
/upload/units/kg.txt true
upload/kg.txt false
/upload/k:g.txt false