Unifi-Voucher-Tool/includes/VoucherService.php
Friederich Loheide 4c1e58e68f
All checks were successful
CI / PHP Lint (push) Successful in 36s
CI / PHP Lint-1 (push) Successful in 38s
CI / Unit Tests & Static Analysis (push) Successful in 42s
CI / PHP Lint (pull_request) Successful in 36s
CI / PHP Lint-1 (pull_request) Successful in 41s
CI / Unit Tests & Static Analysis (pull_request) Successful in 42s
Zertifikatsprüfung als Opt-in: pro Site und für SMTP
Übernommen aus dem alten Review-Branch
claude/tool-review-optimization-q9nyv5, neu gebaut auf dem aktuellen
Stand. Der Rest jenes Branches ist durch das Redesign überholt.

Bisher galt CURLOPT_SSL_VERIFYPEER => false für jede Verbindung zum
Controller, ohne Möglichkeit, das zu ändern. Wer den Controller unter
seinem echten Namen mit gültigem Zertifikat betreibt, kann die Prüfung
jetzt pro Site einschalten; Standard bleibt aus, weil UniFi-Geräte ab
Werk ein selbst signiertes Zertifikat liefern.

- Migration 0008, Spalte sites.ssl_verify (Default 0)
- UniFiController: fünfter Konstruktor-Parameter, steuert VERIFYPEER und
  VERIFYHOST; testConnection() ebenso. Alle acht Aufrufer geben den Wert
  der Site weiter, tolerant über "?? 0" für Alt-Installationen
- Site-Verwaltung: Schalter in beiden Modalen, Abzeichen auf der Karte
- Mailer: dasselbe über die Einstellung smtp_verify_ssl, Schalter im
  SMTP-Tab
- Backup nimmt die Spalte mit, Readme erklärt, wann man sie einschaltet
- 3 Tests auf den Durchgriff bis cURL (75 Tests, 178 Assertions)

Nebenbei: der Aufruf von openEditModal() hat fehlende Spalten bisher als
leeres Argument gerendert - jetzt über (int)(... ?? 0) abgesichert.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-25 05:12:28 +00:00

64 lines
2.4 KiB
PHP

<?php
/**
* Erstellt Voucher im UniFi-Controller und schreibt sie in die Datenbank.
*
* Bis hierher lag diese Logik doppelt in index.php und der REST-API; mit der
* Kiosk-Seite waere sie ein drittes Mal noetig gewesen.
*/
require_once __DIR__ . '/UniFiController.php';
require_once __DIR__ . '/Crypto.php';
class VoucherService
{
/**
* @param array $site Zeile aus `sites`
* @param array $qos ['down' => kbit, 'up' => kbit, 'quota_mb' => MB]
* @param int|null $userId angemeldeter Benutzer, sonst null
* @param int|null $kioskId Herkunft, falls ueber eine Display-Seite geholt
*
* @return array{code:string,site_name:string,max_uses:int,expire_min:int,expiry_date:string,expiry_time:string}
* @throws Exception wenn der Controller keinen gueltigen Voucher liefert
*/
public static function create(
$db,
array $site,
string $voucherName,
int $maxUses,
int $expireMinutes,
?int $userId = null,
array $qos = [],
?int $kioskId = null
): array {
$fullName = date('Y-m-d') . '_' . $voucherName;
$controller = new UniFiController(
$site['unifi_controller_url'],
$site['unifi_username'],
Crypto::decrypt($site['unifi_password']),
$site['site_id'],
$site['ssl_verify'] ?? 0
);
$voucher = $controller->createVoucher($fullName, $maxUses, $expireMinutes, $qos);
if (!is_array($voucher) || empty($voucher['formatted_code'])) {
throw new Exception(function_exists('__') ? __('error_voucher_invalid') : 'Ungueltige Antwort des Controllers');
}
$db->execute(
"INSERT INTO vouchers (site_id, user_id, kiosk_id, voucher_code, voucher_name, max_uses, expire_minutes, unifi_voucher_id)
VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
[$site['id'], $userId, $kioskId, $voucher['code'], $fullName, $maxUses, $expireMinutes, $voucher['unifi_id'] ?? null]
);
$expiryTs = time() + ($expireMinutes * 60);
return [
'code' => $voucher['formatted_code'],
'site_name' => $site['name'],
'max_uses' => $maxUses,
'expire_min' => $expireMinutes,
'expiry_date' => date('d.m.Y', $expiryTs),
'expiry_time' => date('H:i', $expiryTs),
];
}
}