Куда отправляются файлы
Форма отправляет multipart-запрос непосредственно вашему HTTPS-серверу. Telegram открывает Mini App и передаёт initData, но не становится хранилищем загруженного файла. В таком сценарии нет входящего message.document, file_id и вызова getFile. Если пользователь должен прислать документ обычным сообщением боту, нужен другой обработчик.
FormData умеет объединять текстовые поля и File в одном теле. Для fetch не задавайте Content-Type вручную: браузер добавит multipart boundary. Текст из textarea и выбранные файлы должны попасть в один снимок отправки. После нажатия блокируем поля, пока результат не подтверждён, чтобы повтор не содержал уже другие данные. Использование FormData.
Учебное ограничение — от одного до трёх файлов, каждый до 5 МиБ, только JPEG, PNG и PDF. Документом здесь считается PDF; DOCX, ZIP, HEIC и SVG намеренно не принимаются. Если клиент выбрал фотографию в неподдерживаемом формате, предложите экспортировать JPEG или приложить PDF, а не переименовывать расширение.
Подготовьте PHP и закрытое хранилище
Нужны PHP 8.3+, PDO SQLite, mbstring и fileinfo; Composer не требуется. Веб-сервер открывает только public. База и каталог вложений находятся вне публичного корня, доступны процессу PHP и не попадают в Git. Предпросмотр ниже выполняется в браузере; авторизация, проверка типов и сохранение — на PHP.
public/form.html public/api.php public/download.php common.php values.php auth.php uploads.php schema.sql init.php
APP_DB=/private/repair.sqlite UPLOAD_DIR=/private/repair-files BOT_TOKEN=TOKEN_FROM_BOTFATHER
Создайте каталог repair-files с правами только для пользователя приложения. На Linux код дополнительно задаёт сохранённым файлам режим 0600. Обычный PHP не загружает .env самостоятельно: значения должны быть доступны PHP-FPM и CLI. Для первого запуска достаточно отдельного тестового бота и небольшого приватного диска.
file_uploads = On upload_max_filesize = 6M post_max_size = 20M max_file_uploads = 10 max_execution_time = 90 display_errors = Off
Лимит приложения в 5 МиБ строже PHP-лимита в 6M, чтобы приложение могло вернуть понятную ошибку. post_max_size учитывает всё тело и служебные части multipart. На Nginx задайте подходящий client_max_body_size для этого виртуального хоста. Если запрос отсекается до PHP, ответом может быть HTML 413, а не JSON вашего API. Параметры PHP.
<?php
declare(strict_types=1);
/**
*
* @return array<string,mixed>
*/
function objectValue(mixed $value): array
{
if (!is_array($value)) {
throw new InvalidArgumentException('Expected object');
}
$result = [];
foreach ($value as $key => $item) {
if (!is_string($key)) {
throw new InvalidArgumentException('Expected object keys');
}
$result[$key] = $item;
}
return $result;
}
function stringValue(mixed $value): string
{
if (!is_string($value)) {
throw new InvalidArgumentException('Expected string');
}
return $value;
}
function intValue(mixed $value): int
{
if (!is_int($value) && !is_string($value)) {
throw new InvalidArgumentException('Expected integer');
}
$integer = filter_var($value, FILTER_VALIDATE_INT);
if ($integer === false) {
throw new InvalidArgumentException('Invalid integer');
}
return $integer;
}
<?php
declare(strict_types=1);
require_once __DIR__.'/values.php';
function envRequired(string $name): string
{
$value = getenv($name);
if ($value === false || $value === '') {
throw new RuntimeException('Missing environment: '.$name);
}
return $value;
}
function database(): PDO
{
$db = new PDO('sqlite:'.envRequired('APP_DB'), null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$db->exec('PRAGMA busy_timeout=5000');
return $db;
}
CREATE TABLE requests ( id INTEGER PRIMARY KEY AUTOINCREMENT, user_id INTEGER NOT NULL, operation_id TEXT NOT NULL, request_hash TEXT NOT NULL, description TEXT NOT NULL, created_at INTEGER NOT NULL, UNIQUE(user_id,operation_id) ); CREATE TABLE attachments ( id TEXT PRIMARY KEY, request_id INTEGER NOT NULL REFERENCES requests(id), storage_name TEXT NOT NULL UNIQUE, mime TEXT NOT NULL, bytes INTEGER NOT NULL, sha256 TEXT NOT NULL );
<?php declare(strict_types=1); require __DIR__.'/common.php'; database()->exec(stringValue(file_get_contents(__DIR__.'/schema.sql'))); echo "Database ready\n";
Проверьте пользователя до доступа к заявке
Сервер берёт user_id только из подписанного initData. Поле user_id из формы не принимается. Один и тот же идентификатор вложения не даёт права скачать его: запрос должен принадлежать владельцу связанной заявки. Поэтому даже случайный 32-символьный ID не заменяет проверку доступа.
<?php
declare(strict_types=1);
function telegramUser(string $raw, string $botToken, int $now): int
{
if ($raw === '' || strlen($raw) > 16384) {
throw new RuntimeException('Invalid initData');
}
$fields = [];
foreach (explode('&', $raw) as $pair) {
[$key,$value] = array_pad(explode('=', $pair, 2), 2, '');
$key = urldecode($key);
$value = urldecode($value);
if ($key === '' || array_key_exists($key, $fields)) {
throw new RuntimeException('Duplicate field');
}
$fields[$key] = $value;
}
$hash = $fields['hash'] ?? '';
unset($fields['hash']);
if (!preg_match('/^[a-f0-9]{64}$/D', $hash)) {
throw new RuntimeException('Invalid hash');
}
ksort($fields, SORT_STRING);
$lines = [];
foreach ($fields as $key => $value) {
$lines[] = $key.'='.$value;
}
$secret = hash_hmac('sha256', $botToken, 'WebAppData', true);
if (!hash_equals(hash_hmac('sha256', implode("\n", $lines), $secret), $hash)) {
throw new RuntimeException('Bad signature');
}
$date = filter_var($fields['auth_date'] ?? '', FILTER_VALIDATE_INT);
if ($date === false || $date > $now + 30 || $date < $now - 3600) {
throw new RuntimeException('Expired initData');
}
$user = json_decode($fields['user'] ?? '', true, 16, JSON_THROW_ON_ERROR);
if (!is_array($user) || !is_int($user['id'] ?? null) || $user['id'] <= 0) {
throw new RuntimeException('Missing user');
}
return $user['id'];
}
Здесь принимается initData не старше часа и отклоняются дублирующиеся query-поля. Клиент передаёт исходную строку в X-Telegram-Init-Data. Не помещайте её в URL, логи и базу. При 401 интерфейс предлагает заново открыть Mini App. Для долгой сессии можно после проверки выдавать собственную сессию — этот вариант разобран в статье об авторизации.
Алгоритм HMAC использует токен именно этого бота. Если одна форма работает с несколькими ботами, сначала выберите подтверждённую серверную конфигурацию и только затем проверяйте initData. Нельзя проверять подпись одним токеном, а сохранять владельца в пространстве другого бота. Проверка данных Mini App.
Проверьте содержимое, а не название файла
accept и File.type помогают интерфейсу, но клиент может изменить запрос. Сервер сначала проверяет UPLOAD_ERR_OK и происхождение временного файла, затем фактический размер и MIME через fileinfo. Для JPEG и PNG дополнительно проверяются размеры изображения. Ограничение в 20 мегапикселей не зависит от сжатого размера на диске.
Имя пользователя не становится путём хранения. Сервер назначает случайное имя и расширение по проверенному MIME. Файл с названием «акт.php» и настоящим PDF-содержимым будет храниться как случайный .pdf; наоборот, переименование исполняемого текста в .jpg не поможет пройти проверку. Исходные имена не нужны рабочей логике и в БД этого примера не сохраняются.
<?php
declare(strict_types=1);
final class UploadConflict extends RuntimeException
{
}
/**
* @param array<string,mixed> $file
*
* @return array{tmp:string,mime:string,extension:string,bytes:int,sha256:string}
*/
function inspectUpload(array $file): array
{
if (($file['error'] ?? null) !== UPLOAD_ERR_OK) {
throw new InvalidArgumentException('Файл не загружен целиком');
}
$tmp = stringValue($file['tmp_name'] ?? null);
if (!is_uploaded_file($tmp)) {
throw new InvalidArgumentException('Ожидается HTTP-загрузка');
}
$bytes = filesize($tmp);
if ($bytes === false || $bytes < 1 || $bytes > 5 * 1024 * 1024) {
throw new InvalidArgumentException('Файл должен быть от 1 байта до 5 МиБ');
}
$mime = (new finfo(FILEINFO_MIME_TYPE))->file($tmp);
$allowed = ['image/jpeg' => 'jpg','image/png' => 'png','application/pdf' => 'pdf'];
if (!is_string($mime) || !isset($allowed[$mime])) {
throw new InvalidArgumentException('Разрешены JPEG, PNG и PDF');
}
if (str_starts_with($mime, 'image/')) {
$size = getimagesize($tmp);
if ($size === false || $size[0] < 1 || $size[1] < 1 || $size[0] * $size[1] > 20000000) {
throw new InvalidArgumentException('Изображение повреждено или больше 20 мегапикселей');
}
}
return ['tmp' => $tmp,'mime' => $mime,'extension' => $allowed[$mime],'bytes' => $bytes,'sha256' => stringValue(hash_file('sha256', $tmp))];
}
/**
* @return array{id:int,attachments:list<array{id:string,mime:string,bytes:int}>}|null
*/
function requestStatus(PDO $db, int $userId, string $operation): ?array
{
$q = $db->prepare('SELECT id FROM requests WHERE user_id=? AND operation_id=?');
$q->execute([$userId,$operation]);
$id = $q->fetchColumn();
if ($id === false) {
return null;
}
$q = $db->prepare('SELECT id,mime,bytes FROM attachments WHERE request_id=? ORDER BY id');
$q->execute([$id]);
$files = [];
while ($row = $q->fetch(PDO::FETCH_ASSOC)) {
$r = objectValue($row);
$files[] = ['id' => stringValue($r['id']),'mime' => stringValue($r['mime']),'bytes' => intValue($r['bytes'])];
}
return ['id' => intValue($id),'attachments' => $files];
}
/**
* @param list<array{tmp:string,mime:string,extension:string,bytes:int,sha256:string}> $files
*
* @return array{id:int,attachments:list<array{id:string,mime:string,bytes:int}>}
*/
function saveRequest(PDO $db, int $userId, string $operation, string $description, array $files): array
{
if (!preg_match('/^[a-f0-9-]{36}$/D', $operation) || mb_strlen(trim($description)) < 10 || mb_strlen($description) > 2000
|| count($files) < 1 || count($files) > 3) {
throw new InvalidArgumentException('Проверьте описание и число файлов');
}
$manifest = array_map(static fn (array $f): array => [$f['mime'],$f['bytes'],$f['sha256']], $files);
$hash = hash('sha256', json_encode([$description,$manifest], JSON_THROW_ON_ERROR));
$directory = realpath(envRequired('UPLOAD_DIR'));
if ($directory === false || !is_writable($directory)) {
throw new RuntimeException('Private storage unavailable');
}
$paths = [];
$db->exec('BEGIN IMMEDIATE');
try {
$q = $db->prepare('SELECT request_hash FROM requests WHERE user_id=? AND operation_id=?');
$q->execute([$userId,$operation]);
$previous = $q->fetchColumn();
if ($previous !== false) {
if (!hash_equals(stringValue($previous), $hash)) {
throw new UploadConflict('Ключ использован с другим содержимым');
}
$result = requestStatus($db, $userId, $operation);
if ($result === null) {
throw new RuntimeException('Request missing');
}
$db->exec('COMMIT');
return $result;
}
$db->prepare('INSERT INTO requests(user_id,operation_id,request_hash,description,created_at) VALUES(?,?,?,?,?)')
->execute([$userId,$operation,$hash,$description,time()]);
$requestId = intValue($db->lastInsertId());
foreach ($files as $file) {
$id = bin2hex(random_bytes(16));
$name = $id.'.'.$file['extension'];
$path = $directory.DIRECTORY_SEPARATOR.$name;
if (!move_uploaded_file($file['tmp'], $path)) {
throw new RuntimeException('Cannot store upload');
}
$paths[] = $path;
if (!chmod($path, 0600)) {
throw new RuntimeException('Cannot restrict file permissions');
}
$db->prepare('INSERT INTO attachments(id,request_id,storage_name,mime,bytes,sha256) VALUES(?,?,?,?,?,?)')
->execute([$id,$requestId,$name,$file['mime'],$file['bytes'],$file['sha256']]);
}
$result = requestStatus($db, $userId, $operation);
if ($result === null) {
throw new RuntimeException('Request missing');
}
$db->exec('COMMIT');
return $result;
} catch (Throwable $e) {
$db->exec('ROLLBACK');
foreach ($paths as $path) {
if (is_file($path)) {
unlink($path);
}
}
throw $e;
}
}
inspectUpload использует is_uploaded_file, поэтому обычный путь к файлу на диске не подойдёт даже в локальной проверке: нужен настоящий multipart HTTP-запрос. Для переноса используется move_uploaded_file, а не произвольное копирование пути из JSON. Загрузка в PHP, move_uploaded_file.
Проверка MIME не доказывает безопасность любого PDF и не удаляет метаданные снимка. Для публичного сервиса добавьте карантин и проверку антивирусом до доступа сотрудников, а для изображений при необходимости — отдельное безопасное перекодирование и удаление EXIF. Не показывайте пользовательский PDF встроенным HTML и не выполняйте его обработку системной командой из имени файла.
Как заявка и вложения сохраняются вместе
saveRequest проверяет все выбранные файлы до записи. Затем создаёт заявку и метаданные вложений, перемещает файлы в закрытый каталог и фиксирует транзакцию. При обычном исключении транзакция откатывается, уже перемещённые файлы удаляются. Пользователь видит успех только после commit.
operation_id относится к одной отправке одного пользователя. request_hash включает описание и упорядоченный список MIME, размеров и SHA-256 файлов. Повтор с тем же содержимым возвращает прежний номер; тот же ключ с другой фотографией получает 409. Хеш содержимого здесь проверяет неизменность повторной отправки, а не даёт право доступа.
Файловая система и SQLite не имеют общей транзакции. При аварийном завершении процесса между move_uploaded_file и commit может остаться файл без строки attachments. Поэтому нужен периодический поиск сирот: под блокировкой, исключающей текущую загрузку, сравнивайте случайные имена со строками БД и удаляйте только достаточно старые неподтверждённые файлы. Не удаляйте весь каталог по времени изменения — там могут быть действующие заявки.
В примере SQLite удерживает блокировку записи во время нескольких локальных перемещений. Это приемлемо для небольшого теста на одном сервере. Для потока больших файлов используйте отдельную стадию загрузки, статусы проверки и финализацию заявки. Переход на объектное хранилище требует серверной проверки владельца ключа и фактического размера после загрузки.
Подключите API приёма и проверки результата
<?php
declare(strict_types=1);
require dirname(__DIR__).'/common.php';
require dirname(__DIR__).'/auth.php';
require dirname(__DIR__).'/uploads.php';
header('Content-Type: application/json; charset=utf-8');
header('Cache-Control: no-store');
/**
* @param array<string,mixed> $body
*/
function respond(int $status, array $body): never
{
http_response_code($status);
echo json_encode($body, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
exit;
}
try {
$userId = telegramUser(stringValue($_SERVER['HTTP_X_TELEGRAM_INIT_DATA'] ?? ''), envRequired('BOT_TOKEN'), time());
} catch (Throwable) {
respond(401, ['error' => 'Переоткройте Mini App в Telegram']);
}
try {
$db = database();
$method = $_SERVER['REQUEST_METHOD'] ?? '';
if ($method === 'GET') {
$key = stringValue($_GET['operation_id'] ?? '');
if (!preg_match('/^[a-f0-9-]{36}$/D', $key)) {
respond(422, ['error' => 'Некорректный ключ']);
}
$result = requestStatus($db, $userId, $key);
respond($result === null ? 404 : 200, $result ?? ['error' => 'Заявка не найдена']);
}
if ($method !== 'POST') {
respond(405, ['error' => 'Метод не поддерживается']);
}
if (intValue($_SERVER['CONTENT_LENGTH'] ?? 0) > 20 * 1024 * 1024) {
respond(413, ['error' => 'Запрос слишком большой']);
}
$upload = objectValue($_FILES['files'] ?? []);
$errors = $upload['error'] ?? null;
if (!is_array($errors) || !array_is_list($errors) || count($errors) < 1 || count($errors) > 3) {
respond(422, ['error' => 'Выберите от 1 до 3 файлов']);
}
$tmp = $upload['tmp_name'] ?? null;
if (!is_array($tmp)) {
respond(422, ['error' => 'Некорректные файлы']);
}
$files = [];
foreach ($errors as $i => $error) {
$files[] = inspectUpload(['error' => $error,'tmp_name' => $tmp[$i] ?? null]);
}
respond(200, saveRequest($db, $userId, stringValue($_POST['operation_id'] ?? ''), stringValue($_POST['description'] ?? ''), $files));
} catch (UploadConflict $e) {
respond(409, ['error' => $e->getMessage()]);
} catch (InvalidArgumentException $e) {
respond(422, ['error' => $e->getMessage()]);
} catch (Throwable) {
respond(503,['error' => 'Не удалось подтвердить сохранение. Проверьте статус заявки']);
}
POST принимает files[], description и operation_id. GET по operation_id только проверяет результат текущего пользователя. В JSON не возвращаются путь хранения, initData или токен бота. Некорректные поля получают 422, слишком большое тело — 413, несовместимый повтор — 409.
Ответ | Действие интерфейса |
|---|---|
200 | Показать номер заявки и ссылки на её вложения. |
401 | Переоткрыть Mini App; не менять user_id вручную. |
413 / 422 | Исправить объём или состав файлов и начать исправленную отправку. |
409 | Проверить результат прежней операции; не заменять содержимое под тем же ключом. |
Таймаут / 503 / не-JSON | Сохранить ключ, проверить GET и при необходимости повторить тот же снимок. |
Пустой GET-результат сразу после сетевого сбоя ещё не доказывает, что первый POST никогда не выполнится. Запрос мог находиться на другом процессе. Повтор с прежним ключом безопаснее создания новой операции: уникальность и хеш защищают запись заявки на сервере.
Сделайте выбор файлов и предпросмотр
Ниже полная HTML-страница без сборщика. Фото показывается через локальный blob URL; PDF выводится названием и размером. Имена вставляются через textContent, поэтому HTML в имени файла не превращается в разметку. При смене выбора старые object URL освобождаются.
<!doctype html><html lang="ru"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>Заявка на ремонт</title><script src="https://telegram.org/js/telegram-web-app.js"></script>
<style>*{box-sizing:border-box}body{margin:0;padding:22px;font:16px/1.5 system-ui;background:#f2f6fc;color:#17243a}main{max-width:560px;margin:auto}h1{font-size:26px}label{display:block;margin-top:18px}textarea,input,button{width:100%;font:inherit;padding:12px;border-radius:10px;border:1px solid #aab8cc}textarea{min-height:110px}button{margin-top:12px;background:#2869b0;color:white;border:0}button:disabled{opacity:.5}#status{padding:12px;background:#e0eafa;border-radius:10px}.file{margin:12px 0;padding:12px;background:white;border-radius:10px;overflow-wrap:anywhere}.file img{display:block;max-width:100%;max-height:150px;margin-top:8px}small{display:block;color:#52647d;margin:10px 0}</style>
<main><h1>Заявка на ремонт</h1><p id="status" role="status">Выберите файлы и опишите неисправность</p>
<form id="form"><label for="description">Что случилось?</label><textarea id="description" minlength="10" maxlength="2000" required></textarea>
<label for="files">Фотографии и документы</label><input id="files" type="file" accept="image/jpeg,image/png,application/pdf" multiple required>
<small>От 1 до 3 файлов, каждый до 5 МиБ. JPEG, PNG или PDF.</small><div id="preview"></div><button id="send">Отправить заявку</button></form>
<button id="check" hidden>Проверить результат отправки</button><button id="retry" hidden>Повторить ту же отправку</button><div id="downloads"></div></main>
<script type="module">
const tg=window.Telegram?.WebApp,el=id=>document.getElementById(id),status=t=>el('status').textContent=t;
let urls=[],pending=null,pendingBody=null,done=false,busy=false;
const storageKey='repair-upload-operation';
try{pending=sessionStorage.getItem(storageKey);}catch{}
function controls(){for(const id of ['description','files','send'])el(id).disabled=busy||done||!!pending;el('check').hidden=!pending||done;el('check').disabled=busy;el('retry').hidden=!pending||!pendingBody||done;el('retry').disabled=busy;}
async function call(url,body){
const r=await fetch(url,{method:body?'POST':'GET',headers:{'X-Telegram-Init-Data':tg.initData},body,signal:AbortSignal.timeout(60000)});
let data;try{data=await r.json();}catch{throw new Error('Сервер не подтвердил результат');}
if(!r.ok)throw Object.assign(new Error(data.error||'Ошибка запроса'),{status:r.status});return data;
}
function showResult(result){
done=true;pending=null;try{sessionStorage.removeItem(storageKey);}catch{}
status('Заявка №'+result.id+' принята. Вложения сохранены.');
for(const file of result.attachments){const b=document.createElement('button');b.textContent='Скачать вложение '+file.id.slice(0,6);b.type='button';
b.onclick=async()=>{try{const r=await fetch('./download.php?id='+file.id,{headers:{'X-Telegram-Init-Data':tg.initData}});if(!r.ok)throw new Error('Файл недоступен');const url=URL.createObjectURL(await r.blob());const a=document.createElement('a');a.href=url;a.download='attachment-'+file.id+(file.mime==='application/pdf'?'.pdf':file.mime==='image/png'?'.png':'.jpg');a.click();setTimeout(()=>URL.revokeObjectURL(url),30000);}catch(e){status(e.message);}};
el('downloads').append(b);}
}
el('files').onchange=()=>{
for(const u of urls)URL.revokeObjectURL(u);urls=[];el('preview').replaceChildren();
for(const f of el('files').files){const row=document.createElement('div');row.className='file';row.textContent=f.name+' · '+(f.size/1024/1024).toFixed(2)+' МиБ';
if(['image/jpeg','image/png'].includes(f.type)){const img=document.createElement('img');const u=URL.createObjectURL(f);urls.push(u);img.src=u;img.alt='Предпросмотр выбранной фотографии';row.append(img);}el('preview').append(row);}
};
el('form').onsubmit=async event=>{
event.preventDefault();if(busy||done||pending)return;
const files=[...el('files').files];
if(files.length<1||files.length>3||files.some(f=>f.size<1||f.size>5*1024*1024)){status('Выберите 1–3 файла размером до 5 МиБ');return;}
pending=crypto.randomUUID();try{sessionStorage.setItem(storageKey,pending);}catch{}
const body=new FormData();body.append('operation_id',pending);body.append('description',el('description').value);
for(const file of files)body.append('files[]',file,file.name);pendingBody=body;
busy=true;controls();status('Загружаем и сохраняем…');
try{showResult(await call('./api.php',body));}
catch(e){status(e.message);if([401,413,422].includes(e.status)){pending=null;try{sessionStorage.removeItem(storageKey);}catch{}}}
finally{busy=false;controls();}
};
el('check').onclick=async()=>{
if(!pending||busy)return;busy=true;controls();
try{showResult(await call('./api.php?operation_id='+encodeURIComponent(pending)));}
catch(e){status(e.status===404?'Запись пока не найдена. Повторите проверку через минуту; не создавайте новую заявку сразу.':e.message);}
finally{busy=false;controls();}
};
el('retry').onclick=async()=>{if(!pendingBody||!pending||busy)return;busy=true;controls();try{showResult(await call('./api.php',pendingBody));}catch(e){status(e.message);}finally{busy=false;controls();}};
if(tg?.initData){tg.ready();controls();if(pending){status('Проверим предыдущую отправку');el('check').click();}}
else{busy=true;controls();status('Откройте форму из меню Telegram-бота');}
</script></html>
После отправки описание и список файлов заблокированы. При неизвестном результате кнопка проверки делает GET, а повторная отправка использует сохранённый FormData с тем же ключом. Успех показывается после серверного ответа, а не после завершения чтения файла в браузере. Процент прогресса здесь не рисуется: обычный fetch в этом примере не сообщает загрузочный прогресс.
sessionStorage хранит только ключ операции. После перезагрузки браузер не восстановит File и произвольный доступ к файлам устройства; повторная отправка станет недоступна, но проверка результата останется. Если запрос точно не дошёл, сотрудник может проверить отсутствие заявки, после чего пользователь начнёт новую форму. Для устойчивого продолжения больших загрузок нужен отдельный протокол возобновления. Черновик формы решает сохранение полей, но сам по себе не сохраняет выбранные файлы.
Отдавайте файл только владельцу
<?php
declare(strict_types=1);
require dirname(__DIR__).'/common.php';
require dirname(__DIR__).'/auth.php';
header('Cache-Control: private, no-store');
header('X-Content-Type-Options: nosniff');
try {
$userId = telegramUser(stringValue($_SERVER['HTTP_X_TELEGRAM_INIT_DATA'] ?? ''), envRequired('BOT_TOKEN'), time());
} catch (Throwable) {
http_response_code(401);
exit;
}
$id = $_GET['id'] ?? '';
if (!is_string($id) || !preg_match('/^[a-f0-9]{32}$/D', $id)) {
http_response_code(404);
exit;
}
$q = database()->prepare('SELECT a.* FROM attachments a JOIN requests r ON r.id=a.request_id WHERE a.id=? AND r.user_id=?');
$q->execute([$id,$userId]);
$row = $q->fetch(PDO::FETCH_ASSOC);
if (!is_array($row)) {
http_response_code(404);
exit;
}
$name = stringValue($row['storage_name']);
if (!preg_match('/^[a-f0-9]{32}\.(jpg|png|pdf)$/D', $name)) {
http_response_code(500);
exit;
}
$path = rtrim(envRequired('UPLOAD_DIR'), '/\\').DIRECTORY_SEPARATOR.$name;
$file = fopen($path, 'rb');
if ($file === false) {
http_response_code(503);
exit;
}
header('Content-Type: '.stringValue($row['mime']));
header('Content-Disposition: attachment; filename="'.$name.'"');
header('Content-Length: '.intValue($row['bytes']));
fpassthru($file);
fclose($file);
Запрос соединяет attachments с requests и одновременно проверяет user_id. Чужой и отсутствующий ID получают одинаковый 404. Ответ запрещает MIME-sniffing и предлагает скачивание. Отправка бинарного тела идёт из файлового потока, без base64 внутри JSON.
В форме скачивание выполняется через fetch с initData, затем создаётся временный blob URL. Это не вечная публичная ссылка. Поведение сохранения файла проверьте в клиентах Telegram: Android, iOS и Desktop могут показывать разные диалоги. Не отключайте авторизацию ради удобства обычного тега a. Если понадобится передаваемая ссылка, проектируйте отдельный короткоживущий токен с проверяемой областью доступа.
Сотрудникам требуется отдельная авторизованная панель и разрешение на просмотр заявок. Этот download.php предназначен владельцу заявки, а не менеджеру с известным ID. Отдельно задайте сроки хранения, удаление после закрытия обращения и резервное копирование базы вместе с файлами.
Первый запуск и проверка результата
php init.php
Откройте public на HTTPS-домене и укажите form.html в меню Mini App тестового бота. Обычная браузерная вкладка без Telegram должна показать просьбу открыть приложение из бота. В Telegram заполните описание, приложите небольшой PNG и PDF и отправьте форму. Ожидается номер заявки и две кнопки скачивания.
SELECT id,user_id,operation_id,created_at FROM requests; SELECT request_id,id,mime,bytes FROM attachments;
Повтор той же отправки оставляет одну заявку и прежние ID вложений.
Подмена MIME, обрыв загрузки, нулевой файл и размер выше 5 МиБ отклоняются.
Четыре файла не создают частичную заявку из трёх.
Другой пользователь не получает файл и статус чужой операции.
Потерянный HTTP-ответ не вызывает автоматического создания новой заявки.
Выбранные файлы и их имена не попадают в публичный каталог, журнал запросов или аналитические события.
Нагрузка, лимиты на пользователя и проверка содержимого требуют отдельной настройки до публичного запуска. BotGate здесь может доставить менеджеру уведомление о принятой заявке. Сама загрузка и закрытое хранение проходят через ваш сервер и не зависят от Telegram-транспорта.