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