2.0 KiB
Diagnostics Service
DiagnosticsService provides operational diagnostics helpers:
- SSL certificate inspection
- codec compatibility checks
- panel log export/submission
- external API IP detection
Methods
getCertificateInfo(?string $certificate = null): ?array
Returns certificate details (serial, expiration, subject, path).
If $certificate is null, certificate path is auto-detected from nginx SSL config.
Returns null if file is missing or OpenSSL parsing fails.
checkCompatibility(array|string $data, bool $allowHEVC = false): bool
Checks whether media codecs are compatible with player constraints. Accepts FFProbe payload as array or JSON string.
Default accepted codecs include:
- video:
h264,vp8,vp9,ogg,av1 - audio:
aac,libfdk_aac,opus,vorbis,pcm_s16le,mp2,mp3,flac
With $allowHEVC=true, allows hevc/h265 and ac3.
downloadPanelLogs(object $db): array
Fetches up to 1000 recent rows from panel_logs (excluding epg), sanitizes output fields, and clears log rows after export.
Return shape:
[
'errors' => [...],
'version' => '...'
]
Throws Exception on DB query failure.
submitPanelLogs(object $db): array
Submits panel logs to remote diagnostics endpoint and clears submitted logs. Used for support/telemetry workflows.
getApiIP(): ?string
Attempts to resolve external/public IP via remote API request.
Returns null on network failure.
panel_logs Shape (used fields)
| Column | Type | Meaning |
|---|---|---|
type |
string | event type |
log_message |
string | main message |
log_extra |
string | extra context |
line |
int | source line |
date |
int | UNIX timestamp |
Related Files
| File | Purpose |
|---|---|
src/core/Diagnostics/DiagnosticsService.php |
diagnostics methods |
src/core/Logging/Logger.php |
writes logs |
src/core/Config/AppConfig.php |
version metadata |