crm.clientright.ru/SEND2COURT_FIXES.md

Исправления Send2Court - 23 октября 2025

Проблемы, которые были исправлены

🔴 Проблема №1: HTTP 500 - Invalid Control Characters

Ошибка: Specified value has invalid Control characters. (Parameter 'value')

Причина: В адресах из базы данных присутствовали HTML entities (—,  , " и т.д.), которые попадали в JSON и отправлялись в API debex.ru. Сервер не мог обработать эти символы и возвращал ошибку 500.

Пример проблемного адреса:

362047, Республика Северная Осетия — Алания, Владикавказ...

Решение: Добавлено декодирование HTML entities с помощью функции html_entity_decode() для всех текстовых полей перед отправкой в API:

• courtNoticesAddress - адрес для судебных уведомлений
• legalAddress - юридический адрес
• actualResidenceAddress - фактический адрес
• name - название организации
• Адреса, используемые для поиска суда

Изменения в коде:

// Было:
$data['mySelfAdditionalData']['courtNoticesAddress'] = $adb->query_result($result, 0, 'addr_notice');

// Стало:
$data['mySelfAdditionalData']['courtNoticesAddress'] = html_entity_decode($adb->query_result($result, 0, 'addr_notice'), ENT_QUOTES | ENT_HTML5, 'UTF-8');

---

🔴 Проблема №2: HTTP 403 при скачивании файлов из S3

Ошибка: ошибка скачивания файла из S3, HTTP код: 403

Причина: В именах файлов на S3 присутствовали специальные символы:

• # (хештег) - интерпретируется как якорь URL
• Пробелы
• Кириллица в именах файлов
• Другие спецсимволы

Пример проблемного URL:

https://s3.twcstorage.ru/.../8_Договор_на_оказание_услуг_09-04-2025-13-52-43_Чужба_10_CTP#realfile.pdf

Решение: Переписана функция getTempFileFromS3() с правильным кодированием URL:

1. URL разбирается на части с помощью parse_url()
2. Путь разбивается на сегменты по /
3. Каждый сегмент кодируется с помощью rawurlencode()
4. URL собирается обратно

Теперь символы правильно кодируются:

• # → %23
• Пробел → %20
• Кириллица → правильные UTF-8 последовательности

Изменения в коде:

// Было:
$s3Url = str_replace('#', '%23', $s3Url);
$s3Url = str_replace(' ', '%20', $s3Url);

// Стало:
$urlParts = parse_url($s3Url);
$path = isset($urlParts['path']) ? $urlParts['path'] : '';
$pathSegments = explode('/', $path);
$encodedSegments = array_map(function($segment) {
    return rawurlencode($segment);
}, $pathSegments);
$encodedPath = implode('/', $encodedSegments);
$s3Url = $urlParts['scheme'] . '://' . $urlParts['host'] . $encodedPath;

---

Дополнительные улучшения

Улучшенное логирование

• Добавлен вывод размера скачанного файла
• Добавлен вывод CURL ошибок при проблемах со скачиванием
• Улучшены сообщения в логах для лучшей диагностики

Проверка валидности данных

• Добавлена проверка корректности URL перед попыткой скачивания
• Добавлена проверка, что файл не пустой перед сохранением

---

Файлы, которые были изменены

• /var/www/fastuser/data/www/crm.clientright.ru/include/utils/Debexpert-guzzle.php
  • Функция Send2Court() - добавлено декодирование HTML entities
  • Функция getCourt() - добавлено декодирование HTML entities в адресах
  • Функция getTempFileFromS3() - переписана с правильным кодированием URL

---

Тестирование

После внедрения исправлений необходимо протестировать отправку:

1. Искового с адресом, содержащим HTML entities (—,   и т.д.)
2. Проекта с файлами на S3, содержащими # или другие спецсимволы в имени
3. Проекта с кириллицей в именах файлов на S3

---

Мониторинг

Проверять логи после отправки на наличие:

• ❌ HTTP статус код: 500 + Invalid Control characters
• ❌ ошибка скачивания файла из S3, HTTP код: 403
• ✅ файл сохранен во временную папку + размер файла
• ✅ получили ответ на запрос + номер дела

---

Дата исправления: 23 октября 2025
Автор: AI Assistant (Claude)
Статус: ✅ Готово к тестированию