Если веб-форма сохраняет файл правильно, а фоновая задача создаёт его в другой папке, сравните рабочие каталоги процессов. Относительный путь вроде uploads/result.jpg может разрешаться по-разному при разных способах запуска. Сначала зафиксируйте вычисленный полный путь в закрытом диагностическом журнале, затем задайте обоим процессам один корень данных.

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

На стенде сравниваем три каталога

ЗначениеЧто означаетЧем не является
getcwd()Текущий рабочий каталог PHPПостоянной папкой данных
__DIR__Каталог файла с этим выражениемАвтоматически корнем проекта
Корень хранения из конфигурацииСогласованное место данныхПубличным URL

PHP определяет __DIR__ относительно файла кода, а getcwd() возвращает текущий рабочий каталог или false при ошибке. Это разные величины. Включённый вспомогательный файл имеет свой __DIR__. Поэтому замена всех путей на __DIR__ без разбора структуры проекта способна перенести ошибку в другое место. Документация проверена 11 октября 2026 года.

<?php
// Только закрытая диагностика на стенде, не публичная страница
$diagnostic = [
    'cwd' => getcwd(),
    'code_directory' => __DIR__,
    'storage_root' => $configuredStorageRoot,
];
// Передайте массив в штатный закрытый журнал приложения.

configuredStorageRoot здесь должен быть получен из вашего конфигурационного слоя: фрагмент не объявляет переменную сам. Не выводите эти данные посетителям. Сопоставьте значения в web, worker и плановом запуске, а также итоговый путь назначения. Если корень одинаковый, проверьте, не дописывает ли один обработчик лишний сегмент или не использует ли старую настройку.

Корень данных получает каждый исполнитель

Храните согласованный абсолютный корень отдельно от названия пользовательского файла. В задачу передавайте внутренний ID, а путь стройте через общий слой хранения. Не принимайте готовый абсолютный путь из браузера. Валидируйте ID и сегменты, чтобы входные данные не могли выбрать соседний каталог. Символические ссылки и права процесса проверяют отдельно, в рамках принятой модели размещения.

После изменения конфигурации перезапустите только нужные долгоживущие исполнители по процедуре проекта. Старый worker может продолжить использовать прежнюю настройку. Убедитесь, что все процессы действительно получили одну версию, а не просто проверьте файл конфигурации на диске. Для отката сохраните предыдущие настройки и остановите выпуск новых задач, если появились несогласованные пути.

Возвращаем потерянные результаты по манифесту

  1. Составить список внутреннего ID, фактического и ожидаемого пути.
  2. Проверить владельца, размер и контрольную сумму содержимого.
  3. Выявить конфликты назначения до копирования.
  4. Скопировать согласованный малый набор с сохранением исходников.
  5. Проверить чтение через приложение и только потом согласовать очистку.

Совпадение имени не даёт права перезаписать существующий файл. При конфликте нужны запись задачи и связь с объектом приложения. Если часть результата уже опубликована, обновление ссылки должно соответствовать реально проверенному содержимому. Не переписывайте массово пути в базе по текстовому совпадению: сначала установите, какой формат ключа хранит конкретная запись.

Одинаковый вход должен дать одинаковое назначение

Отправьте одну тестовую задачу через веб-интерфейс и через очередь; затем повторите с другим рабочим каталогом на стенде. Назначение должно определяться конфигурацией и ID, а не местом запуска. Проверьте повтор задачи и отказ записи: приложение не должно сообщать готовность файла, который не появился в постоянном хранилище.

Для поиска расхождения нужны способы запуска процессов, обезличенные значения трёх каталогов и один внутренний тестовый ID с ожидаемым назначением. Этого достаточно, чтобы разделить неверный корень, старый worker и ошибочную сборку пути, не перемещая рабочие данные наугад.

Проверенные источники