Интеграционный шлюз на PHP для преобразования и отправки данных в форматах JSON, XML и CSV с валидацией, логированием и обработкой ошибок.
<?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'];
}
?>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 с еженедельной ротацией