Прогресс загрузки динамического XML

Прогресс загрузки динамического XMLпочему bytesTotal равен нулю и что с этим делать

Полоса загрузки стоит на нуле, хотя XML грузится. Причина не в ActionScript, а в ответе сервера: без Content-Length полный размер узнать неоткуда.

Раздел
ActionScript 3
Стек
ActionScript 3PHPnginxFetch API
Уровень
Средний
Опубликовано
Обновлено
Чтение
8 мин
Коротко
  • bytesTotal берётся только из заголовка Content-Length.
  • Динамический вывод и gzip на лету убирают длину из ответа.
  • Нужна точная полоса: строка целиком, strlen и без сжатия.
  • В fetch та же проблема, а при gzip длина ещё и сжатая.
Как решаем
  1. Проверьте заголовки ответа через curl -sI
  2. Обработайте bytesTotal = 0 неопределённым индикатором
  3. В PHP соберите XML в строку и отправьте Content-Length
  4. Отключите сжатие для этого адреса или отдавайте статику
  5. В JS читайте поток и ограничивайте долю единицей

Симптом: полоса загрузки стоит на нуле#

Классическая ситуация во Flash-проекте: каталог товаров, галерея или уровни игры приходят XML-файлом, который собирает PHP-скрипт. Прелоадер подписан на ProgressEvent.PROGRESS, считает bytesLoaded / bytesTotal и рисует полосу. С локального файла всё работает, а на боевом сервере полоса стоит на нуле, пока XML внезапно не загрузится целиком. В отладчике видно, что bytesTotal равен 0.

Код загрузчика при этом обычно правильный. Дело в ответе сервера: Flash узнаёт полный размер ответа только из заголовка Content-Length. Нет заголовка, нет и bytesTotal. Для статического catalog.xml веб-сервер ставит длину сам, потому что знает размер файла. Для динамического ответа длина заранее неизвестна, и сервер отправляет данные без неё.

Ошибка коварна тем, что на машине разработчика её не видно. Локальный сервер часто работает без сжатия, а XML маленький и приходит одним куском, так что прелоадер просто мигает. На продакшене включены gzip, прокси и медленный канал у пользователя, и вместо полосы он несколько секунд смотрит на пустой экран. Поэтому проверять прогресс стоит на том же окружении, где сайт будет жить, и с искусственно замедленной сетью.

Загрузчик XML на ActionScript 3#

Начнём с загрузчика, который честно обрабатывает оба случая: известный и неизвестный размер.

ActionScript 3
import flash.events.Event;
import flash.events.IOErrorEvent;
import flash.events.ProgressEvent;
import flash.net.URLLoader;
import flash.net.URLRequest;

var loader:URLLoader = new URLLoader();
loader.addEventListener(ProgressEvent.PROGRESS, onProgress);
loader.addEventListener(Event.COMPLETE, onComplete);
loader.addEventListener(IOErrorEvent.IO_ERROR, onError);
loader.load(new URLRequest("catalog.php"));

function onProgress(e:ProgressEvent):void {
    if (e.bytesTotal > 0) {
        bar.indeterminate = false;
        bar.ratio = Math.min(1, e.bytesLoaded / e.bytesTotal);
    } else {
        // размер неизвестен: крутим анимацию и показываем килобайты
        bar.indeterminate = true;
        label.text = Math.round(e.bytesLoaded / 1024) + " КБ";
    }
}

function onComplete(e:Event):void {
    var xml:XML = new XML(loader.data);
    buildCatalog(xml);
}

function onError(e:IOErrorEvent):void {
    label.text = "Не удалось загрузить каталог";
}

Здесь bar и label это ваши собственные клипы прелоадера, свойства indeterminate и ratio условные. Важны две детали: деление выполняется только при bytesTotal > 0, а результат ограничен единицей. Без проверки вы получите Infinity или NaN в ширине полосы, и клип пропадёт со сцены.

Почему сервер не отдаёт Content-Length#

Мы встречали четыре причины, иногда сразу несколько:

ПричинаЧто происходит
Вывод PHP по частямСкрипт печатает XML через echo в цикле. Сервер не знает, сколько ещё будет данных, и использует Transfer-Encoding: chunked без длины.
Сжатие gzip на летуzlib.output_compression в PHP, mod_deflate в Apache или gzip on в nginx сжимают ответ потоком, и итоговый размер заранее неизвестен.
Прокси и CDNПромежуточный сервер пересобирает ответ и может убрать длину или пересчитать её для сжатых данных.
Длина задана, но сжатие включеноЗаголовок описывает несжатый объём, а по сети идёт сжатый. Полоса не доходит до конца или ведёт себя странно.

Проверить ответ проще всего из консоли: curl -sI -H 'Accept-Encoding: gzip' https://example.test/catalog.php. Если в заголовках нет Content-Length или есть Transfer-Encoding: chunked, причина найдена.

Решение на стороне PHP#

Самый надёжный путь: собрать XML целиком в строку, выключить сжатие для этого ответа и отправить точную длину в байтах. Функция strlen() считает именно байты, поэтому для UTF-8 подходит она, а не mb_strlen().

PHP
<?php
// до любого вывода
ini_set('zlib.output_compression', '0');
if (function_exists('apache_setenv')) {
    apache_setenv('no-gzip', '1');   // mod_deflate пропустит этот ответ
}

$xml = buildCatalogXml();           // строка с готовым документом

header('Content-Type: application/xml; charset=utf-8');
header('Content-Length: ' . strlen($xml));
echo $xml;

Если XML генерируется старым кодом, который печатает документ через десятки echo, переписывать его не обязательно. Оберните вызов в буферизацию вывода: ob_start() перед генерацией, затем $xml = ob_get_clean(), и дальше те же заголовки и один echo. Главное, чтобы до вызова header() в ответ не ушло ни одного байта, включая пробел или BOM перед открывающим тегом <?php, иначе PHP выдаст предупреждение «headers already sent», и длина не уйдёт.

Ещё одна деталь: если в коде стоит Content-Length, а где-то ниже по цепочке ответ всё же сжимается, браузер получит противоречивые данные. Поэтому после правки всегда перепроверяйте заголовки через curl, а не только поведение прелоадера.

Если сайт работает за nginx, сжатие отключается в нужном location:

nginx
location = /catalog.php {
    gzip off;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root/catalog.php;
    fastcgi_pass unix:/run/php/php-fpm.sock;
}

Отключать сжатие стоит осознанно. Текстовый XML ужимается в разы, и на большом каталоге полоса прогресса может обойтись дороже, чем сама загрузка. Для файлов в десятки килобайт честнее показать неопределённый индикатор, а для мегабайтных выгрузок заранее сохранять готовый XML на диск: статический файл веб-сервер отдаст с длиной сам. О том, как аккуратно разложить такие обработчики по маршрутам, мы писали в заметке про простой роутер на PHP.

Большой XML: читать по мере прихода#

Иногда проблема не в полосе, а в том, что пользователь ждёт весь файл, хотя первые записи уже можно показать. Для этого во Flash был класс URLStream: он даёт доступ к сырым байтам по мере поступления через bytesAvailable и методы вроде readUTFBytes(). Класс XML не умеет разбирать неполный документ, поэтому такой подход работает, если сервер отдаёт данные удобными кусками, например по одной записи в строке, или если формат меняют на построчный.

Для типичного каталога на пару сотен позиций это лишнее усложнение. Мы применяли потоковое чтение только для журналов и выгрузок на несколько мегабайт, где разница в ожидании была заметна глазом. Во всех остальных случаях хватало честного прогресса и разбора документа целиком в обработчике Event.COMPLETE.

То же решение работает в браузере: поток из fetch можно пропустить через TextDecoderStream и разбирать построчно, если сервер отдаёт NDJSON или похожий формат с записью на строку.

Что изменилось к 2026 году#

Flash Player не поддерживается с 31 декабря 2020 года, но задача никуда не делась. В браузере тот же прогресс читается через fetch и ReadableStream, и проблема с Content-Length осталась ровно та же, а со сжатием стала даже заметнее.

JavaScript
async function loadXml(url, onProgress) {
  const res = await fetch(url);
  if (!res.ok) throw new Error(`HTTP ${res.status}`);

  const header = res.headers.get('Content-Length');
  const total = header ? Number(header) : 0;
  const reader = res.body.getReader();
  const chunks = [];
  let loaded = 0;

  for (;;) {
    const { done, value } = await reader.read();
    if (done) break;
    chunks.push(value);
    loaded += value.byteLength;
    // при gzip total это сжатый размер, а loaded считает распакованные байты
    onProgress(total ? Math.min(1, loaded / total) : null, loaded);
  }

  const text = await new Blob(chunks).text();
  return new DOMParser().parseFromString(text, 'application/xml');
}

loadXml('/catalog.xml', (ratio, bytes) => {
  // progress это элемент <progress> с max="1"
  if (ratio === null) progress.removeAttribute('value');  // неопределённое состояние
  else progress.value = ratio;
});

Что важно знать сегодня:

  • Сжатие почти всегда включено. Если ответ идёт с Content-Encoding: gzip или br, Content-Length описывает сжатые байты, а поток отдаёт уже распакованные. Отношение loaded / total быстро превышает единицу, поэтому ограничивайте его.
  • По HTTP/2 и HTTP/3 длина часто не передаётся для динамических ответов, и total будет нулём, как во Flash.
  • Для запросов на другой домен нестандартные заголовки видны скрипту только после перечисления в Access-Control-Expose-Headers. Если сервер присылает несжатый размер своим заголовком, не забудьте его открыть.
  • Элемент <progress> без атрибута value сам рисует неопределённое состояние и доступен скринридерам. Подпись с килобайтами всё равно полезна.

Кроме того, XML в новых API встречается редко, и чаще грузят JSON. Механика прогресса от формата не зависит: читаете поток, считаете байты, разбираете целиком в конце. Ещё больше браузерных рецептов в разделе JavaScript.

Короткий чек-лист#

  1. Проверьте заголовки ответа через curl -sI с Accept-Encoding: gzip.
  2. Если длины нет, решите, нужна ли точная полоса. Для небольших ответов достаточно неопределённого индикатора.
  3. Нужна точная полоса: соберите ответ в строку, отправьте Content-Length и отключите сжатие для этого адреса или отдавайте заранее сгенерированный статический файл.
  4. В клиенте никогда не делите на bytesTotal без проверки и ограничивайте результат единицей.

Если прелоадер анимирован, не забывайте, что прогресс приходит рывками, порциями по несколько килобайт. Плавность дают твины к целевому значению, а не прямое присваивание ширины; подходящие кривые разобраны в статье про easing, а обновлять полосу удобнее из общего цикла кадра.

0bytesTotal без Content-Length
strlen()считает байты, а не символы
31.12.2020конец поддержки Flash Player

«Нет заголовка Content-Length, нет и bytesTotal: прогресс ломает не клиент, а ответ сервера.»

Главный вывод заметки

Вопросы и ответы

Вопросы и ответы

Почему локально прогресс работает, а на сервере нет?
Локальный файл или статический XML веб-сервер отдаёт с известной длиной. Боевой ответ собирает PHP, а сервер ещё и сжимает его на лету, поэтому заголовок Content-Length пропадает и bytesTotal остаётся нулём.
Можно ли оставить gzip и всё равно показать точный прогресс?
Только приблизительно. Можно передать несжатый размер своим заголовком и сравнивать его с распакованными байтами в fetch. Во Flash такого доступа к заголовкам ответа в браузере обычно не было, поэтому там выбирали между сжатием и точной полосой.
Почему strlen, а не mb_strlen?
Content-Length задаётся в байтах. Функция strlen возвращает число байтов строки, а mb_strlen считает символы. Для XML с кириллицей в UTF-8 mb_strlen даст меньшее число, и клиент решит, что ответ закончился раньше времени.
Что показывать пользователю, если размер неизвестен?
Неопределённый индикатор: бегущую полосу или спиннер, плюс счётчик загруженных килобайт. В браузере элемент progress без атрибута value рисует такое состояние сам и корректно озвучивается вспомогательными технологиями.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

Читайте также