Медиабиблиотека в Битрикс: что проверить до загрузки файлов

За 20–30 минут вы проверите, куда в 1С-Битрикс загружаются файлы, какие ограничения действуют на сервере и как убедиться, что изображение появилось на сайте. Это важно до массовой загрузки: файл может успешно сохраниться в административной части, но не открываться посетителям или оказаться не в той папке.

Перед началом: что понадобится

Инструкция относится к CMS «1С-Битрикс: Управление сайтом», интерфейс и отдельные пункты меню могут отличаться между версиями. Для проверки подойдут версии 24.x и 25.x; если у вас другая версия, сверяйте названия разделов с документацией именно для неё.

• Учётная запись с правом загружать файлы и редактировать нужный раздел или элемент инфоблока. Администратор сайта не нужен, если вы можете проверить доступ у ответственного.
• Доступ к административной панели и адрес страницы, где файл должен отображаться.
• Один тестовый файл: изображение в распространённом формате или документ, который действительно будет использоваться на сайте.
• Возможность обратиться к администратору хостинга. Настройки PHP и лимиты диска могут быть недоступны из панели Битрикс.

Медиабиблиотека¹ в Битрикс — не обязательно отдельная универсальная папка. Файлы могут храниться в файловой системе сайта и связываться с конкретными страницами, элементами инфоблоков или разделами. Поэтому до загрузки выясните не только «куда нажать», но и где этот файл должен использоваться.

Первые шаги: проверьте путь от файла до страницы

1. Уточните место хранения. Спросите у владельца раздела, куда добавляют изображения и документы: в свойства элемента инфоблока, в текст страницы или в заранее согласованную папку. Не создавайте свою структуру каталогов, пока не проверили принятую на сайте схему. Проверка: вы знаете конкретную страницу или элемент, к которому привяжете тестовый файл.
2. Посмотрите ограничения загрузки. В административной панели откройте раздел настроек, доступный вашей роли, и проверьте, не указаны ли ограничения по формату или размеру в интерфейсе добавления файла. Если файла нет среди разрешённых типов или размер превышает лимит, уточните ограничения у администратора. На сервере могут действовать отдельные лимиты PHP и веб-сервера, которые панель Битрикс не отменяет. Проверка: тестовый файл укладывается в доступные ограничения, а нужный тип допускается.
3. Загрузите один файл в нужное поле. Откройте страницу или элемент, найдите предназначенное для изображения или документа поле и выберите тестовый файл. Не заменяйте файл в существующем элементе, если не знаете, используется ли он ещё где-то. Проверка: после сохранения в поле отображается имя файла или миниатюра.
4. Проверьте результат на опубликованной странице. Откройте сайт как обычный посетитель, обновите страницу и нажмите на изображение или ссылку на документ. В админке миниатюра может отображаться даже тогда, когда публичная страница не опубликована или ссылка ведёт не туда. Проверка: посетитель видит изображение или может открыть документ без входа в админку.
5. Проверьте мобильный вид и исходный файл. Убедитесь, что изображение не растягивается и не обрезается неожиданно, а документ открывается или скачивается согласно задаче. Если сайт создаёт уменьшенные копии, не удаляйте оригинал и не подменяйте его уменьшенной версией без согласования. Проверка: файл читаем на странице и в мобильном браузере.

Что проверить до массовой загрузки

Сначала протестируйте один файл каждого нужного типа. У Битрикс есть связь между загруженными файлами и объектами сайта: удаление или замена изображения в одном месте может затронуть повторное использование файла в другом. Не считайте медиабиблиотеку обычной папкой, в которой безопасно переименовывать и удалять всё подряд.

Загрузка файла в админку — только половина задачи. Проверяйте его там, где его увидит посетитель: на опубликованной странице и без прав администратора.

Если загрузка не сработала

Точный текст сообщения зависит от версии Битрикс и настроек сайта, поэтому не ищите одну универсальную ошибку. Сначала зафиксируйте, на каком шаге возникла проблема, и передайте администратору имя файла, его размер, формат и страницу, куда вы загружали.

• Файл не выбирается или тип запрещён. Проверьте расширение и уточните разрешённые типы. Не переименовывайте файл, чтобы обойти ограничение: расширение не меняет его реальный формат.
• Загрузка обрывается или превышен допустимый размер. Сверьте размер с ограничением поля. Если он проходит, но загрузка всё равно не завершается, попросите администратора проверить серверные лимиты и свободное место.
• После сохранения файла нет на странице. Проверьте, привязан ли он к нужному полю, сохранены ли изменения и опубликована ли страница. Затем откройте страницу без авторизации.
• Изображение заменилось не там, где ожидали. Не удаляйте другие копии. Уточните у администратора, где хранится исходник и где используется прежний файл.
• Документ открывается с ошибкой доступа. Проверьте настройки публичного доступа и ссылку на странице. Если файл предназначен только для сотрудников, открытый доступ может быть нежелателен.

Что делать дальше

После тестовой загрузки согласуйте с командой правила именования файлов, допустимые форматы и место хранения для каждого типа контента. Для фотографий договоритесь о размерах и подготовке изображений до загрузки: это уменьшает риск тяжёлых страниц. Перед пакетной заменой или удалением файлов попросите администратора проверить резервную копию и повторное использование этих файлов на сайте.

¹ Инфоблок — механизм Битрикс для хранения структурированного контента, например каталога товаров или списка новостей. Поля и правила загрузки могут задаваться отдельно для конкретного инфоблока.