Прогресс загрузки динамического XMLпочему bytesTotal равен нулю и что с этим делать
Полоса загрузки стоит на нуле, хотя XML грузится. Причина не в ActionScript, а в ответе сервера: без Content-Length полный размер узнать неоткуда.
- Раздел
- ActionScript 3
- Стек
- ActionScript 3PHPnginxFetch API
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 8 мин
- bytesTotal берётся только из заголовка Content-Length.
- Динамический вывод и gzip на лету убирают длину из ответа.
- Нужна точная полоса: строка целиком, strlen и без сжатия.
- В fetch та же проблема, а при gzip длина ещё и сжатая.
- Проверьте заголовки ответа через curl -sI
- Обработайте bytesTotal = 0 неопределённым индикатором
- В PHP соберите XML в строку и отправьте Content-Length
- Отключите сжатие для этого адреса или отдавайте статику
- В JS читайте поток и ограничивайте долю единицей
Симптом: полоса загрузки стоит на нуле#
Классическая ситуация во Flash-проекте: каталог товаров, галерея или уровни игры приходят XML-файлом, который собирает PHP-скрипт. Прелоадер подписан на ProgressEvent.PROGRESS, считает bytesLoaded / bytesTotal и рисует полосу. С локального файла всё работает, а на боевом сервере полоса стоит на нуле, пока XML внезапно не загрузится целиком. В отладчике видно, что bytesTotal равен 0.
Код загрузчика при этом обычно правильный. Дело в ответе сервера: Flash узнаёт полный размер ответа только из заголовка Content-Length. Нет заголовка, нет и bytesTotal. Для статического catalog.xml веб-сервер ставит длину сам, потому что знает размер файла. Для динамического ответа длина заранее неизвестна, и сервер отправляет данные без неё.
Ошибка коварна тем, что на машине разработчика её не видно. Локальный сервер часто работает без сжатия, а XML маленький и приходит одним куском, так что прелоадер просто мигает. На продакшене включены gzip, прокси и медленный канал у пользователя, и вместо полосы он несколько секунд смотрит на пустой экран. Поэтому проверять прогресс стоит на том же окружении, где сайт будет жить, и с искусственно замедленной сетью.
Загрузчик XML на 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
// до любого вывода
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:
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 осталась ровно та же, а со сжатием стала даже заметнее.
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.
Короткий чек-лист#
- Проверьте заголовки ответа через
curl -sIсAccept-Encoding: gzip. - Если длины нет, решите, нужна ли точная полоса. Для небольших ответов достаточно неопределённого индикатора.
- Нужна точная полоса: соберите ответ в строку, отправьте
Content-Lengthи отключите сжатие для этого адреса или отдавайте заранее сгенерированный статический файл. - В клиенте никогда не делите на
bytesTotalбез проверки и ограничивайте результат единицей.
Если прелоадер анимирован, не забывайте, что прогресс приходит рывками, порциями по несколько килобайт. Плавность дают твины к целевому значению, а не прямое присваивание ширины; подходящие кривые разобраны в статье про easing, а обновлять полосу удобнее из общего цикла кадра.
«Нет заголовка Content-Length, нет и bytesTotal: прогресс ломает не клиент, а ответ сервера.»
Главный вывод заметки


