- php-fints Bibliothek von 3.7.0 auf 4.0.0 aktualisiert - Parser-Fix: Ignoriert zusätzliche Bank-Felder statt Exception - HKEKA Segmente implementiert (HIEKASv5, HKEKAv5, HIEKAv5) - HKKAA Segmente implementiert (HIKAASv1, HKKAAv1) - GetStatementFromArchive und GetElectronicStatement Actions HINWEIS: HKKAA/HKEKA funktionieren noch nicht mit VR Bank (Fehler "unerwarteter Aufbau wrt DE 2" - Kontoverbindungsformat) Normale Funktionalität (Transaktionsimport) ist nicht betroffen. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
87 lines
3.1 KiB
PHP
87 lines
3.1 KiB
PHP
<?php
|
|
|
|
namespace Fhp;
|
|
|
|
/**
|
|
* Thin wrapper around curl that does base64 encoding/decoding and converts errors to {@link CurlException}s.
|
|
*/
|
|
class Connection
|
|
{
|
|
protected string $url;
|
|
protected ?\CurlHandle $curlHandle = null;
|
|
protected int $timeoutConnect = 15;
|
|
protected int $timeoutResponse = 30;
|
|
|
|
public function __construct(string $url, int $timeoutConnect = 15, int $timeoutResponse = 30)
|
|
{
|
|
$this->url = $url;
|
|
$this->timeoutConnect = $timeoutConnect;
|
|
$this->timeoutResponse = $timeoutResponse;
|
|
}
|
|
|
|
/**
|
|
* @throws CurlException When initializing cURL fails.
|
|
*/
|
|
private function connect(): void
|
|
{
|
|
$this->curlHandle = curl_init() ?: throw new CurlException('Failed initializing cURL.');
|
|
|
|
curl_setopt($this->curlHandle, CURLOPT_SSL_VERIFYPEER, true);
|
|
curl_setopt($this->curlHandle, CURLOPT_SSL_VERIFYHOST, 2);
|
|
curl_setopt($this->curlHandle, CURLOPT_USERAGENT, 'phpFinTS');
|
|
curl_setopt($this->curlHandle, CURLOPT_RETURNTRANSFER, true);
|
|
curl_setopt($this->curlHandle, CURLOPT_URL, $this->url);
|
|
curl_setopt($this->curlHandle, CURLOPT_CONNECTTIMEOUT, $this->timeoutConnect);
|
|
curl_setopt($this->curlHandle, CURLOPT_CUSTOMREQUEST, 'POST');
|
|
curl_setopt($this->curlHandle, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
|
|
curl_setopt($this->curlHandle, CURLOPT_ENCODING, '');
|
|
curl_setopt($this->curlHandle, CURLOPT_MAXREDIRS, 0);
|
|
curl_setopt($this->curlHandle, CURLOPT_TIMEOUT, $this->timeoutResponse);
|
|
curl_setopt($this->curlHandle, CURLOPT_HTTPHEADER, ['cache-control: no-cache', 'Content-Type: text/plain']);
|
|
}
|
|
|
|
public function disconnect(): void
|
|
{
|
|
if ($this->curlHandle !== null) {
|
|
curl_close($this->curlHandle);
|
|
$this->curlHandle = null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param string $message The message to be sent, in HBCI/FinTS wire format, ISO-8859-1 encoded.
|
|
* @return string The response from the server, in HBCI/FinTS wire format, ISO-8859-1 encoded.
|
|
* @throws CurlException When the request fails.
|
|
*/
|
|
public function send(string $message): string
|
|
{
|
|
if (!$this->curlHandle) {
|
|
$this->connect();
|
|
}
|
|
|
|
curl_setopt($this->curlHandle, CURLOPT_POSTFIELDS, base64_encode($message));
|
|
$response = curl_exec($this->curlHandle);
|
|
|
|
if (false === $response) {
|
|
throw new CurlException(
|
|
'Failed sending to ' . $this->url . ': ' . curl_error($this->curlHandle),
|
|
null,
|
|
curl_errno($this->curlHandle),
|
|
curl_getinfo($this->curlHandle),
|
|
curl_error($this->curlHandle)
|
|
);
|
|
}
|
|
|
|
$statusCode = curl_getinfo($this->curlHandle, CURLINFO_HTTP_CODE);
|
|
if ($statusCode < 200 || $statusCode > 299) {
|
|
throw new CurlException(
|
|
'Bad response with status code ' . $statusCode,
|
|
$response,
|
|
$statusCode,
|
|
curl_getinfo($this->curlHandle)
|
|
);
|
|
}
|
|
|
|
return base64_decode($response);
|
|
}
|
|
}
|