Как проверить существование файла по ссылке HTTP или HTTPS в 1С

← На главную

В процессе разработки часто возникает задача проверить, доступен ли определенный файл (картинка, документ, архив) по ссылке на внешнем веб-сервере. Стандартные средства работы с файловой системой, такие как Файл.Существует() или НайтиФайлы(), предназначены исключительно для локальных ресурсов или сетевых дисков и совершенно не подходят для работы с протоколами HTTP/HTTPS.

В этой статье мы подробно разберем, как правильно реализовать проверку существования удаленного файла, избежав при этом лишнего расхода трафика и зависания системы.

Метод 1: Использование метода ПолучитьЗаголовки() — самый эффективный способ

Многие начинающие разработчики совершают ошибку, пытаясь проверить файл методом Получить(). Проблема этого подхода в том, что если файл существует и весит несколько гигабайт, 1С начнет его скачивать целиком только для того, чтобы подтвердить его наличие. Это крайне неэффективно.

Для решения этой задачи в платформе 1С предусмотрен метод ПолучитьЗаголовки(). На уровне протокола HTTP он отправляет запрос HEAD. Сервер в ответ присылает только метаданные файла (размер, тип, дату изменения) и код состояния, не передавая само тело файла. Рассмотрим пример кода:


// Определим параметры подключения
Сервер = "www.myserver.ru";
ПутьКФайлу = "/files/document.pdf";

// Создаем соединение. Для HTTPS используем ЗащищенноеСоединениеOpenSSL
Соединение = Новый HTTPСоединение(Сервер, , , , , 5, Новый ЗащищенноеСоединениеOpenSSL());

// Создаем запрос
Запрос = Новый HTTPЗапрос(ПутьКФайлу);

Попытка
    // Получаем только заголовки (HEAD-запрос)
    Ответ = Соединение.ПолучитьЗаголовки(Запрос);
    
    // Код состояния 200 означает, что файл найден и доступен
    Если Ответ.КодСостояния = 200 Тогда
        Сообщить("Файл существует!");
    ИначеЕсли Ответ.КодСостояния = 404 Тогда
        Сообщить("Файл не найден (404).");
    Иначе
        Сообщить("Сервер вернул код: " + Ответ.КодСостояния);
    КонецЕсли;
Исключение
    Сообщить("Не удалось установить соединение с сервером.");
КонецПопытки;

Метод 2: Обработка перенаправлений (редиректов)

Иногда при запросе файла сервер возвращает коды 301 (Moved Permanently) или 302 (Found). Это означает, что файл перемещен на другой адрес. Платформа 1С не переходит по таким ссылкам автоматически. Чтобы проверка была корректной, нам нужно проанализировать заголовки ответа и выполнить повторный запрос по новому адресу.

Проанализируем алгоритм обработки редиректа:

Выполняем запрос к серверу.
Если КодСостояния равен 301 или 302, ищем в соответствии Ответ.Заголовки ключ "Location".
Если ключ найден, повторяем запрос по полученному адресу.

Для реализации такой логики удобно использовать рекурсивную функцию или цикл. Важно помнить, что в заголовке Location может быть как полный URL, так и относительный путь.

Важные технические нюансы при проверке файлов

При работе с веб-запросами необходимо учитывать несколько критических моментов, которые могут привести к ошибкам:

1. Кодирование URL. Если путь к файлу содержит пробелы, кириллицу или специальные символы, запрос может завершиться ошибкой "Неверный путь". Перед созданием объекта HTTPЗапрос обязательно используйте функцию кодирования:

ПутьКФайлу = КодироватьСтроку(ПутьКФайлу, СпособКодированияСтроки.URLКодирование);

2. Таймаут. Всегда устанавливайте таймаут в конструкторе HTTPСоединение (параметр Таймаут). По умолчанию он может быть очень большим. Для простой проверки существования достаточно 5–10 секунд. Это предотвратит "замирание" программы, если сервер недоступен.

3. Безопасное соединение. При обращении к ресурсам по протоколу HTTPS необходимо передавать объект ЗащищенноеСоединениеOpenSSL. Если на сервере используется самоподписанный сертификат, 1С может выдать ошибку. В этом случае проверку сертификата можно настроить или отключить через параметры объекта ЗащищенноеСоединениеOpenSSL.

Использование COM-объекта WinHTTP (Альтернатива)

В некоторых случаях (например, на старых версиях платформы или для специфической интеграции с настройками Windows) можно использовать системный объект WinHttpRequest. Этот метод работает через механизм COM и доступен только в среде Windows.


WinHttp = Новый COMОбъект("WinHttp.WinHttpRequest.5.1");
Попытка
    WinHttp.Open("HEAD", "https://www.example.com/file.jpg", Ложь);
    WinHttp.Send();
    
    Статус = WinHttp.Status;
    Если Статус = 200 Тогда
        Сообщить("Файл на месте.");
    Иначе
        Сообщить("Статус ответа: " + Статус);
    КонецЕсли;
Исключение
    Сообщить("Ошибка при отправке запроса.");
КонецПопытки;

Разбор кодов состояния HTTP

Для качественной обработки результата проверки важно понимать, что именно сообщает сервер:

200 (OK): Все отлично, файл существует и доступен.
401 (Unauthorized) / 403 (Forbidden): Доступ к файлу ограничен. Скорее всего, файл есть, но сервер требует авторизации или специальных прав.
404 (Not Found): Файла точно нет по указанному адресу.
405 (Method Not Allowed): Сервер запрещает метод HEAD. В этом редком случае придется использовать метод Получить().
500+ (Server Error): Проблема на стороне самого сервера.

Подводя итог, можно сказать, что наиболее современным и правильным способом в 1С является использование HTTPСоединение с методом ПолучитьЗаголовки(). Это экономит ресурсы сервера и клиента, обеспечивая при этом высокую скорость проверки даже для очень больших файлов.