Интеграционный шлюз на PHP с преобразованием данных между форматами JSON, XML и CSV

Интеграционный шлюз на PHP для преобразования и отправки данных в форматах JSON, XML и CSV с валидацией, логированием и обработкой ошибок.

Краткое введение

Интеграционный шлюз на PHP с преобразованием данных между форматами JSON, XML и CSV (php)
ОПИСАНИЕ:
Надежный шлюз, написанный на PHP, который позволяет принимать данные в формате JSON, XML или CSV, преобразовывать их в один из требуемых форматов и отправлять на удаленный эндпоинт. Включает валидацию, обработку ошибок, логирование и гибкую конфигурацию.

ДОПОЛНИТЕЛЬНЫЕ ЗАМЕЧАНИЯ:
Код готов к интеграции в корпоративные системы интеграции данных с акцентом на надежность и обработку ошибок. Использование внешних библиотек облегчает парсинг и преобразование. Arduino опционально и используется для случаев сбора данных с датчиков, отправляющих JSON через последовательный порт.

ПОЯСНЕНИЯ:
- Класс Gateway управляет всем процессом: прием данных, определение формата, парсинг, валидация, преобразование и отправка.
- Метод detectFormat() определяет формат входных данных на основе шаблонов и попыток парсинга.
- Для XML используется SimpleXML, для CSV библиотека league/csv, для JSON нативная функция json_decode.
- Преобразование между форматами осуществляется специализированными методами, конвертирующими ассоциативные массивы в целевой формат.
- Отправка данных осуществляется с помощью cURL с обработкой HTTP ошибок и настраиваемыми таймаутами.
- Логирование с помощью Monolog записывает события, ошибки и поток данных для отладки и аудита.
- Файл config.php позволяет легко изменять эндпоинты, поддерживаемые форматы и сетевые параметры.

Пример кода: php

<?php
/**
 * Шлюз интеграции данных на PHP
 * Поддерживает ввод/вывод в JSON, XML и CSV
 *
 * Зависимости:
 * - league/csv
 * - monolog/monolog
 *
 * Конфигурация в config.php
 *
 * @author Senior Software Engineer
 * @version 1.0
 */

require __DIR__ . '/vendor/autoload.php';
require __DIR__ . '/config.php';

use League\Csv\Reader;
use League\Csv\Writer;
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

class DataGateway {
    private Logger $logger;
    private array $config;

    public function __construct(array $config) {
        $this->config = $config;
        // Инициализация логгера Monolog
        $this->logger = new Logger('DataGatewayLogger');
        $this->logger->pushHandler(new StreamHandler($config['log_file'], Logger::DEBUG));
    }

    /**
     * Определяет формат входных данных
     * @param string $input
     * @return string 'json'|'xml'|'csv'|'unknown'
     */
    public function detectFormat(string $input): string {
        $inputTrim = trim($input);

        // Проверка JSON
        json_decode($inputTrim);
        if (json_last_error() === JSON_ERROR_NONE) {
            $this->logger->debug('Обнаружен формат: JSON');
            return 'json';
        }

        // Проверка XML
        libxml_use_internal_errors(true);
        $xml = simplexml_load_string($inputTrim);
        if ($xml !== false) {
            $this->logger->debug('Обнаружен формат: XML');
            return 'xml';
        }

        // Проверка CSV: проверка наличия хотя бы одной строки с разделителем
        $lines = explode("\n", $inputTrim);
        if (count($lines) > 1 && strpos($lines[0], ',') !== false) {
            $this->logger->debug('Обнаружен формат: CSV');
            return 'csv';
        }

        $this->logger->warning('Неизвестный формат данных');
        return 'unknown';
    }

    /**
     * Парсит данные в ассоциативный массив
     * @param string $input
     * @param string $format
     * @return array
     * @throws Exception
     */
    public function parseData(string $input, string $format): array {
        switch ($format) {
            case 'json':
                $data = json_decode($input, true);
                if (json_last_error() !== JSON_ERROR_NONE) {
                    throw new Exception('Ошибка парсинга JSON: ' . json_last_error_msg());
                }
                return $data;

            case 'xml':
                libxml_use_internal_errors(true);
                $xml = simplexml_load_string($input, 'SimpleXMLElement', LIBXML_NOCDATA);
                if ($xml === false) {
                    $errors = libxml_get_errors();
                    libxml_clear_errors();
                    throw new Exception('Ошибка парсинга XML: ' . print_r($errors, true));
                }
                // Конвертация XML в JSON, затем в массив
                $json = json_encode($xml);
                return json_decode($json, true);

            case 'csv':
                $reader = Reader::createFromString($input);
                $reader->setHeaderOffset(0); // Первая строка - заголовок
                $records = iterator_to_array($reader->getRecords());
                return $records;

            default:
                throw new Exception('Неподдерживаемый формат для парсинга: ' . $format);
        }
    }

    /**
     * Преобразует массив данных в целевой формат
     * @param array $data
     * @param string $targetFormat
     * @return string
     * @throws Exception
     */
    public function transformData(array $data, string $targetFormat): string {
        switch ($targetFormat) {
            case 'json':
                $json = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
                if ($json === false) {
                    throw new Exception('Ошибка кодирования JSON');
                }
                return $json;

            case 'xml':
                $xml = new SimpleXMLElement('<root/>');
                $this->arrayToXml($data, $xml);
                return $xml->asXML();

            case 'csv':
                if (!is_array($data) || empty($data)) {
                    throw new Exception('Неверные данные для CSV');
                }
                $output = Writer::createFromString('');

                // Если данные - массив массивов, используем ключи первой строки как заголовок
                if (isset($data[0]) && is_array($data[0])) {
                    $output->insertOne(array_keys($data[0]));
                    foreach ($data as $row) {
                        $output->insertOne($row);
                    }
                } else {
                    // Данные одного записи
                    $output->insertOne(array_keys($data));
                    $output->insertOne($data);
                }

                return $output->toString();

            default:
                throw new Exception('Неподдерживаемый формат для преобразования: ' . $targetFormat);
        }
    }

    /**
     * Рекурсивная функция для конвертации массива в XML
     * @param array $data
     * @param SimpleXMLElement $xml
     * @return void
     */
    private function arrayToXml(array $data, SimpleXMLElement &$xml): void {
        foreach ($data as $key => $value) {
            // Обработка числовых ключей
            if (is_numeric($key)) {
                $key = 'item';
            }
            if (is_array($value)) {
                $subnode = $xml->addChild($key);
                $this->arrayToXml($value, $subnode);
            } else {
                $xml->addChild($key, htmlspecialchars((string)$value));
            }
        }
    }

    /**
     * Отправляет преобразованные данные на удаленный эндпоинт через POST
     * @param string $data
     * @param string $format
     * @return array ['success' => bool, 'response' => string]
     */
    public function sendData(string $data, string $format): array {
        $url = $this->config['endpoint_url'];
        $headers = [];
        switch ($format) {
            case 'json':
                $headers[] = 'Content-Type: application/json';
                break;
            case 'xml':
                $headers[] = 'Content-Type: application/xml';
                break;
            case 'csv':
                $headers[] = 'Content-Type: text/csv';
                break;
            default:
                $this->logger->error('Неподдерживаемый формат для отправки: ' . $format);
                return ['success' => false, 'response' => 'Неподдерживаемый формат'];
        }

        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
        curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
        curl_setopt($ch, CURLOPT_TIMEOUT, $this->config['timeout_seconds']);

        $response = curl_exec($ch);
        $err = curl_error($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        if ($err) {
            $this->logger->error('Ошибка cURL: ' . $err);
            return ['success' => false, 'response' => $err];
        }

        if ($httpCode >= 200 && $httpCode < 300) {
            $this->logger->info('Данные успешно отправлены, HTTP код: ' . $httpCode);
            return ['success' => true, 'response' => $response];
        } else {
            $this->logger->warning('HTTP ответ не OK: ' . $httpCode . ', ответ: ' . $response);
            return ['success' => false, 'response' => $response];
        }
    }

    /**
     * Полный процесс: принимает вход, преобразует и отправляет
     * @param string $input
     * @param string $outputFormat
     * @return array
     */
    public function process(string $input, string $outputFormat): array {
        try {
            $inputFormat = $this->detectFormat($input);
            if ($inputFormat === 'unknown') {
                throw new Exception('Формат входных данных не распознан');
            }

            $data = $this->parseData($input, $inputFormat);

            $transformed = $this->transformData($data, $outputFormat);

            $result = $this->sendData($transformed, $outputFormat);

            return $result;

        } catch (Exception $ex) {
            $this->logger->error('Исключение в процессе: ' . $ex->getMessage());
            return ['success' => false, 'response' => $ex->getMessage()];
        }
    }
}

// Пример использования
$config = require __DIR__ . '/config.php';
$gateway = new DataGateway($config);

// Пример JSON входных данных
$inputJson = '{"nome":"Mario Rossi","eta":30,"email":"mario.rossi@example.com"}';
$outputFormat = 'xml';

$result = $gateway->process($inputJson, $outputFormat);

if ($result['success']) {
    echo "Данные успешно отправлены. Ответ сервера:\n" . $result['response'];
} else {
    echo "Ошибка при отправке данных: " . $result['response'];
}

?>
×
×
×
Хотите сгенерировать ответ заново?
×
Экспорт чата
Выберите формат экспорта
Generazione PDF in corso…
Allegati
×
Вы собираетесь закрыть чат и перейти к генератору изображений. Если вы не авторизованы, вы потеряете наш чат. Подтверждаете?
Вы просматриваете общий чат во временном режиме. Он не будет сохранён.
×
Сохранённые запросы
×
Личная заметка
×
Метка
×
Искать во всех чатах
×
Ваши инсайты
Анализ…
×
Настройки ИИ
Имя ассистента 30
Длина ответов
Модель ИИ
Структурированные ответы
Добавлять примеры
Использовать эмодзи
Веди меня, не решай Подсказки и вопросы вместо готового ответа
Больше настроек →
×
Поделиться этим чатом
Тот, кто откроет эту ссылку, сможет просмотреть чат или добавить его в свой профиль как собственный.
Внимание: вложения чата тоже будут переданы. Тот, кто добавит чат, получит копию файлов в свою папку.
Общий чат
С вами поделились чатом. Хотите просто посмотреть его или добавить к своим чатам?
Внимание: вложения чата тоже будут переданы. Тот, кто добавит чат, получит копию файлов в свою папку.
×

Сохранённые сообщения

Загрузка...

×

История чатов

primernye-programmy · ИСТОРИЯ ЧАТА

Загрузка...

Настройки ИИ

×
  • БазовыйБыстрые и простые ответы для обучения
  • СреднийВысокое качество для учёбы и программирования
  • ПродвинутыйСложная логика и детальный анализ
Объяснять шаги

Что нужно?

PHP 8+ с расширением libxml для XML и mbstring для кодировки

Зависимости Composer: league/csv для парсинга CSV, monolog/monolog для логирования

Конфигурация через файл config.php для эндпоинта, поддерживаемых форматов и логов

Класс Gateway с методами для парсинга, валидации, преобразования и отправки данных

Симулированный удаленный эндпоинт для тестирования (например, мок REST сервера)

Опционально Arduino, подключенное через последовательный порт для отправки JSON данных: проводка TX (пин 1) и RX (пин 0) с USB-сериал адаптером

Конфигурация PHP.ini: max_execution_time=30, memory_limit=128M, allow_url_fopen=On

Лог-файлы в /logs/gateway.log с еженедельной ротацией

Похожие темы

Первый PHP-скрипт: отображение сообщения на экране
Простой PHP-скрипт для начинающих, который отображает приветственное сообщение на экране, показывая базовые возможности языка PHP.
PHP-страница, отображающая текущие дату и время
Простой PHP-скрипт для отображения текущей даты и времени в формате день месяц год часы минуты секунды с настройкой часового пояса.
Очень простой калькулятор с двумя числами на PHP
Очень простой калькулятор на PHP для сложения двух чисел с HTML-формой. Идеально для изучения основ PHP и обработки данных POST.
PHP-форма, которая приветствует пользователя по имени
Простая PHP-форма с HTML, которая принимает имя пользователя и отображает персонализированное приветствие с использованием метода POST для безопасности.
PHP-страница, которая считает, сколько раз она была посещена
Простой PHP-скрипт для подсчета посещений страницы с использованием файла counter.txt для хранения и обновления счетчика при каждой загрузке.
Статический список продуктов, отображаемый с помощью PHP
Простой пример PHP-страницы с статическим списком продуктов, показывающий работу с массивами и вывод данных в HTML для начинающих.
PHP-страница, которая генерирует HTML-таблицу из массива
Пример PHP-страницы, которая динамически генерирует HTML-таблицу из многомерного массива с безопасной обработкой данных и простым кодом для начинающих.
Мини-адресная книга на PHP с массивом контактов
Мини-адресная книга на PHP с массивом контактов для отображения и поиска по имени без базы данных, простой и безопасный скрипт для веб-сервера.