Собрать путь из частей Path::combine
Модуль: main — подключать отдельно не нужно
Метод Path::combine соединяет части пути через / и нормализует результат методом normalize. Метод убирает повторные косые черты на стыках частей.
Сигнатура метода в классе Bitrix\Main\IO\Path:
public static function combine(...$args)
Параметры
| Параметр | Тип | Описание |
|---|---|---|
| ...args | string или array |
Задают части пути. Каждая часть — отдельный аргумент. Массив метод разворачивает в части. Пустые строки и значения других типов, например числа и null, метод пропускает |
Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.
Возвращаемое значение
Метод возвращает нормализованный путь. Если непустых строк нет, метод возвращает пустую строку.
Исключения
| Исключение | Когда возникает |
|---|---|
Bitrix\Main\IO\InvalidPathException |
Собранный путь содержит нулевой байт или частей .. больше, чем частей перед ними |
Примеры
Пример. Код собирает путь к файлу из корня сайта, каталога и имени файла:
<?php
use Bitrix\Main\Application;
use Bitrix\Main\IO\Path;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$path = Path::combine(Application::getDocumentRoot(), '/upload/units/', 'kg.txt');
echo $path;
Код выведет путь вида /var/www/html/upload/units/kg.txt.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая