CFile::GetPath в Битрикс — как получить URL и путь к файлу по ID

CFile::GetPath() — простой и часто используемый метод API 1С-Битрикс, который позволяет получить путь к файлу по его идентификатору.

Метод особенно удобен, когда от файла требуется только его URL или путь. В отличие от CFile::GetFileArray() и CFile::GetByID(), он не возвращает информацию о размере, MIME-типе, имени и других параметрах файла.

В статье разберём, как получить URL изображения или документа, использовать CFile::GetPath() с инфоблоками, свойствами типа «Файл», PREVIEW_PICTURE, DETAIL_PICTURE, а также рассмотрим частые ошибки.

Коротко: если у вас есть ID файла и нужен только его путь, используйте CFile::GetPath($fileId).

Что делает CFile::GetPath()

Метод получает путь к файлу по его ID.

Синтаксис:

$path = CFile::GetPath($fileId);

Где:

$fileId — ID файла в Битрикс.
$path — путь к файлу.

Например:

$fileId = 123;

$path = CFile::GetPath($fileId);

echo $path;

Результат:

/upload/iblock/abc/photo.jpg

Как получить URL файла по ID

Самый простой вариант:

$fileId = 123;

echo CFile::GetPath($fileId);

Если файл существует, Битрикс вернёт путь, начинающийся от корня сайта:

/upload/iblock/abc/photo.jpg

Этот путь можно непосредственно использовать в HTML.

<img src="<?= CFile::GetPath($fileId); ?>" alt="">

Нужна помощь с Битрикс?

Как получить URL изображения в Битрикс

Одна из наиболее распространённых задач — получить URL изображения по его ID.

$imageId = 123;

$imageUrl = CFile::GetPath($imageId);

echo $imageUrl;

В результате:

/upload/iblock/abc/image.jpg

Вывод изображения:

<img
    src="<?= htmlspecialchars($imageUrl) ?>"
    alt="Изображение"
>

Получение DETAIL_PICTURE элемента инфоблока

Если нужно получить детальную картинку элемента инфоблока, можно передать ID поля DETAIL_PICTURE.

$element = CIBlockElement::GetByID($elementId)->GetNext();

if ($element && !empty($element['DETAIL_PICTURE']))
{
    $imageUrl = CFile::GetPath($element['DETAIL_PICTURE']);

    echo $imageUrl;
}

Вывод изображения:

if ($element && !empty($element['DETAIL_PICTURE']))
{
    $imageUrl = CFile::GetPath($element['DETAIL_PICTURE']);
    ?>
    <img
        src="<?= htmlspecialchars($imageUrl) ?>"
        alt="<?= htmlspecialchars($element['NAME']) ?>"
    >
    <?php
}

Получение PREVIEW_PICTURE

Аналогично можно получить картинку анонса:

$element = CIBlockElement::GetByID($elementId)->GetNext();

if ($element && !empty($element['PREVIEW_PICTURE']))
{
    $imageUrl = CFile::GetPath($element['PREVIEW_PICTURE']);

    echo $imageUrl;
}

Получение файла из свойства инфоблока

Если у элемента есть свойство типа «Файл», его значение обычно содержит ID файла.

Например, есть свойство с кодом DOCUMENT:

$fileId = $arResult['PROPERTIES']['DOCUMENT']['VALUE'];

if ($fileId)
{
    echo CFile::GetPath($fileId);
}

Таким способом можно получить путь к:

PDF;
DOC;
DOCX;
ZIP;
JPG;
PNG;
WEBP;
другим загруженным файлам.

Получить ссылку на скачивание файла

Поскольку CFile::GetPath() возвращает URL, его можно использовать в ссылке.

$fileId = $arResult['PROPERTIES']['DOCUMENT']['VALUE'];

if ($fileId)
{
    $fileUrl = CFile::GetPath($fileId);

    ?>
    <a href="<?= htmlspecialchars($fileUrl) ?>" download>
        Скачать файл
    </a>
    <?php
}

Получить полный URL файла

CFile::GetPath() обычно возвращает относительный путь:

/upload/iblock/abc/file.pdf

Если необходимо сформировать полный URL с протоколом и доменом, можно использовать адрес сайта.

$path = CFile::GetPath($fileId);

$url = 'https://' . $_SERVER['HTTP_HOST'] . $path;

echo $url;

Например:

https://example.ru/upload/iblock/abc/file.pdf

Однако для обычного вывода на странице полный URL чаще всего не требуется. Относительного пути вполне достаточно.

Как получить физический путь к файлу

Необходимо различать URL файла и физический путь на сервере.

CFile::GetPath() возвращает URL-путь:

/upload/iblock/abc/photo.jpg

Если необходимо получить физический путь на сервере, можно добавить DOCUMENT_ROOT:

$path = CFile::GetPath($fileId);

$fullPath = $_SERVER['DOCUMENT_ROOT'] . $path;

echo $fullPath;

Результат будет примерно таким:

/home/bitrix/www/upload/iblock/abc/photo.jpg

Физический путь используется для работы с файлом средствами PHP.

Проверка существования файла

Если ID файла может быть пустым или неправильным, результат метода необходимо проверить.

$path = CFile::GetPath($fileId);

if ($path)
{
    echo $path;
}
else
{
    echo 'Файл не найден';
}

Также можно проверить физическое существование файла:

$path = CFile::GetPath($fileId);

if ($path)
{
    $fullPath = $_SERVER['DOCUMENT_ROOT'] . $path;

    if (file_exists($fullPath))
    {
        echo $path;
    }
}

CFile::GetPath для картинки товара

Например, в компоненте каталога необходимо вывести изображение товара.

$imageId = $arResult['DETAIL_PICTURE'];

if ($imageId)
{
    $imageUrl = CFile::GetPath($imageId);

    ?>
    <img
        src="<?= htmlspecialchars($imageUrl) ?>"
        alt="<?= htmlspecialchars($arResult['NAME']) ?>"
    >
    <?php
}

CFile::GetPath и свойство типа «Файл»

Если свойство содержит один файл:

$fileId = $arResult['PROPERTIES']['FILE']['VALUE'];

if ($fileId)
{
    $fileUrl = CFile::GetPath($fileId);

    echo $fileUrl;
}

Для ссылки:

$fileId = $arResult['PROPERTIES']['FILE']['VALUE'];

if ($fileId)
{
    $fileUrl = CFile::GetPath($fileId);
    ?>
    <a href="<?= htmlspecialchars($fileUrl) ?>" target="_blank">
        Открыть файл
    </a>
    <?php
}

Множественное файловое свойство

Если свойство является множественным, значение может содержать несколько ID файлов.

Например:

$files = $arResult['PROPERTIES']['FILES']['VALUE'];

if (!empty($files) && is_array($files))
{
    foreach ($files as $fileId)
    {
        $fileUrl = CFile::GetPath($fileId);

        if ($fileUrl)
        {
            echo '<a href="' . htmlspecialchars($fileUrl) . '">';
            echo 'Открыть файл';
            echo '</a><br>';
        }
    }
}

Получение нескольких URL файлов

Если есть массив ID файлов, можно получить пути в цикле:

$fileIds = [10, 20, 30];

foreach ($fileIds as $fileId)
{
    $path = CFile::GetPath($fileId);

    if ($path)
    {
        echo $path . '<br>';
    }
}

CFile::GetPath или CFile::GetFileArray?

Выбор метода зависит от того, какие данные необходимы.

Метод	Что возвращает	Когда использовать
CFile::GetPath()	Путь к файлу	Когда нужен только URL
CFile::GetFileArray()	Массив данных	Когда нужны параметры файла
CFile::GetByID()	Результат выборки	Когда нужен результат CDBResult

Например, если нужно только вывести картинку:

$src = CFile::GetPath($fileId);

echo '<img src="' . htmlspecialchars($src) . '" alt="">';

Если дополнительно нужны размеры изображения:

$file = CFile::GetFileArray($fileId);

if ($file)
{
    echo $file['SRC'];
    echo $file['WIDTH'];
    echo $file['HEIGHT'];
}

Можно ли получить имя файла через GetPath?

Нет. CFile::GetPath() возвращает только путь к файлу.

Если необходимо получить имя файла, нужно использовать CFile::GetFileArray():

$file = CFile::GetFileArray($fileId);

if ($file)
{
    echo $file['FILE_NAME'];
}

Для оригинального названия:

echo $file['ORIGINAL_NAME'];

Можно ли получить размер файла через GetPath?

Нет. Метод не возвращает размер файла.

Используйте:

$file = CFile::GetFileArray($fileId);

if ($file)
{
    echo $file['FILE_SIZE'];
}

Можно ли получить размеры изображения через GetPath?

Нет. Для получения ширины и высоты используйте CFile::GetFileArray():

$file = CFile::GetFileArray($fileId);

if ($file)
{
    echo $file['WIDTH'];
    echo $file['HEIGHT'];
}

Частые ошибки

Передаётся URL вместо ID

CFile::GetPath() принимает ID файла, а не его URL.

Неправильно:

$path = CFile::GetPath('/upload/photo.jpg');

Правильно:

$path = CFile::GetPath(123);

Передаётся пустое значение

Перед вызовом метода лучше проверить ID:

if (!empty($fileId))
{
    $path = CFile::GetPath($fileId);
}

Путается URL и физический путь

Результат:

/upload/iblock/abc/photo.jpg

является URL-путём, а не абсолютным путём файловой системы.

Для работы с PHP-функциями вроде file_exists() необходимо сформировать физический путь:

$fullPath = $_SERVER['DOCUMENT_ROOT'] . CFile::GetPath($fileId);

Практический пример: вывести список документов

<?php

$files = $arResult['PROPERTIES']['DOCUMENTS']['VALUE'];

if (!empty($files) && is_array($files))
{
    foreach ($files as $fileId)
    {
        $fileUrl = CFile::GetPath($fileId);

        if (!$fileUrl)
        {
            continue;
        }

        ?>
        <a
            href="<?= htmlspecialchars($fileUrl) ?>"
            target="_blank"
        >
            Скачать документ
        </a>
        <?php
    }
}

?>

Практический пример: вывести изображения

<?php

$images = $arResult['PROPERTIES']['PHOTOS']['VALUE'];

if (!empty($images) && is_array($images))
{
    foreach ($images as $imageId)
    {
        $imageUrl = CFile::GetPath($imageId);

        if (!$imageUrl)
        {
            continue;
        }

        ?>
        <img
            src="<?= htmlspecialchars($imageUrl) ?>"
            alt=""
        >
        <?php
    }
}

?>

Когда CFile::GetPath() — лучший вариант

Используйте CFile::GetPath(), когда задача сводится к получению URL файла.

Например:

получить URL картинки;
вывести изображение;
получить ссылку на PDF;
получить ссылку на документ;
получить путь к файлу свойства инфоблока;
получить путь к PREVIEW_PICTURE;
получить путь к DETAIL_PICTURE;
сформировать ссылку на скачивание.

Если кроме URL нужны параметры файла, лучше использовать CFile::GetFileArray().

FAQ

Что делает CFile::GetPath?

Метод возвращает путь к файлу по его ID.

Как получить URL картинки по ID в Битрикс?

$url = CFile::GetPath($fileId);

echo $url;

Что возвращает CFile::GetPath?

Метод возвращает строку с путём к файлу, например /upload/iblock/abc/photo.jpg.

Как получить физический путь к файлу?

$path = $_SERVER['DOCUMENT_ROOT'] . CFile::GetPath($fileId);

Как получить имя файла через CFile::GetPath?

Никак. Для имени файла необходимо использовать CFile::GetFileArray().

Как получить размеры картинки?

Используйте CFile::GetFileArray() и поля WIDTH и HEIGHT.

Можно ли использовать CFile::GetPath для PDF?

Да. Метод работает не только с изображениями, но и с другими файлами, зарегистрированными в файловой системе Битрикс.

Заключение

CFile::GetPath() — простой метод API Битрикс для получения пути к файлу по его ID. Его удобно использовать, когда от файла требуется только URL: для вывода изображения, формирования ссылки на документ или получения пути к файлу из свойства инфоблока.

Если необходимо получить дополнительные сведения — размер, имя, MIME-тип, ширину или высоту изображения — лучше использовать CFile::GetFileArray().

Что делает CFile::GetPath()

Как получить URL файла по ID

Нужна помощь с Битрикс?

Как получить URL изображения в Битрикс

Получение DETAIL_PICTURE элемента инфоблока

Получение PREVIEW_PICTURE

Получение файла из свойства инфоблока

Получить ссылку на скачивание файла

Получить полный URL файла

Как получить физический путь к файлу

Проверка существования файла

CFile::GetPath для картинки товара

CFile::GetPath и свойство типа «Файл»

Множественное файловое свойство

Получение нескольких URL файлов

CFile::GetPath или CFile::GetFileArray?

Можно ли получить имя файла через GetPath?

Можно ли получить размер файла через GetPath?

Можно ли получить размеры изображения через GetPath?

Частые ошибки

Передаётся URL вместо ID

Передаётся пустое значение

Путается URL и физический путь

Практический пример: вывести список документов

Практический пример: вывести изображения

Когда CFile::GetPath() — лучший вариант

FAQ

Что делает CFile::GetPath?

Как получить URL картинки по ID в Битрикс?

Что возвращает CFile::GetPath?

Как получить физический путь к файлу?

Как получить имя файла через CFile::GetPath?

Как получить размеры картинки?

Можно ли использовать CFile::GetPath для PDF?

Заключение

Похожие материалы