* * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ /** * \file htdocs/custom/netdiag/lib/netdiag.lib.php * \ingroup netdiag * \brief Hilfsfunktionen für das Modul NetDiag */ /** * Tabs für die Admin-Seiten des Moduls vorbereiten * * @return array> Tab-Array */ function netdiagAdminPrepareHead() { global $langs, $conf; $langs->load("netdiag@netdiag"); $h = 0; $head = array(); $head[$h][0] = dol_buildpath("/netdiag/admin/setup.php", 1); $head[$h][1] = $langs->trans("Settings"); $head[$h][2] = 'settings'; $h++; $head[$h][0] = dol_buildpath("/netdiag/admin/about.php", 1); $head[$h][1] = $langs->trans("About"); $head[$h][2] = 'about'; $h++; complete_head_from_modules($conf, $langs, null, $head, $h, 'netdiag@netdiag'); complete_head_from_modules($conf, $langs, null, $head, $h, 'netdiag@netdiag', 'remove'); return $head; } /** * Tabs für die Detailansicht eines Diagnose-Protokolls vorbereiten * * @param NetDiagProtocol $object Protokoll-Objekt * @return array> Tab-Array */ function netdiagProtocolPrepareHead($object) { global $langs, $conf; $langs->load("netdiag@netdiag"); $h = 0; $head = array(); $head[$h][0] = dol_buildpath("/netdiag/netdiagprotocol_card.php", 1).'?id='.$object->id; $head[$h][1] = $langs->trans("NetDiagProtocol"); $head[$h][2] = 'card'; $h++; complete_head_from_modules($conf, $langs, $object, $head, $h, 'netdiagprotocol@netdiag'); complete_head_from_modules($conf, $langs, $object, $head, $h, 'netdiagprotocol@netdiag', 'remove'); return $head; } /** * Ausgabeverzeichnis des Moduls ermitteln (für PDF-Dokumente) * * @return string Absoluter Pfad zum Dokumentenverzeichnis */ function netdiagGetOutputDir() { global $conf; if (!empty($conf->netdiag->dir_output)) { return $conf->netdiag->dir_output; } return DOL_DATA_ROOT.'/netdiag'; } /** * Ein Mess-Ergebnis (JSON) lesbar als HTML aufbereiten. * * Generisch: rendert flache Schlüssel/Wert-Paare und einfache Listen, * damit auch künftige Tools ohne Code-Änderung dargestellt werden. Jeder Wert * wird auf 200 Zeichen gekürzt (`dol_trunc`) — für Skalare unschädlich, aber * ein Dauertest mit vielen Ausfällen/Minuten-Buckets würde dabei mitten im * Satz abgeschnitten. Für `$tool === 'stresstest'` deshalb eigener, nicht * gekürzter Zweig (siehe netdiagFormatStressTest) — dieselbe Notlösung wie * netdiagPdfStressTest() im PDF-Generator. * * @param string $json JSON-String des Ergebnisses * @param string $tool Werkzeug-ID der Messung (optional, für Sonderfälle) * @return string HTML-Schnipsel */ function netdiagFormatResult($json, $tool = '') { if (empty($json)) { return '-'; } $data = json_decode($json, true); if ($data === null) { return dol_escape_htmltag(dol_trunc($json, 120)); } if (!is_array($data)) { return dol_escape_htmltag((string) $data); } if ($tool === 'stresstest') { return netdiagFormatStressTest($data); } if ($tool === 'wifikanal') { return netdiagFormatWifiKanal($data); } $out = '

'; foreach ($data as $key => $val) { $label = dol_escape_htmltag(ucfirst((string) $key)); if (is_array($val)) { $flat = array(); foreach ($val as $item) { $flat[] = is_array($item) ? json_encode($item, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) : (string) $item; } $valstr = implode(', ', $flat); } elseif (is_bool($val)) { $valstr = $val ? 'ja' : 'nein'; } else { $valstr = (string) $val; } $out .= ''.$label.': '.dol_escape_htmltag(dol_trunc($valstr, 200)).' '; } $out .= '

'; return $out; } /** * Dauer-/Stresstest-Ergebnis strukturiert als HTML aufbereiten (Kennzahlen + * Ausfallliste, ungekürzt) statt es wie ein generisches Werkzeug zu * behandeln — sonst schneidet dol_trunc(...,200) die Ausfallliste eines * längeren Laufs mitten im Satz ab. * * @param array $data bereits dekodiertes result-JSON * @return string HTML-Schnipsel */ function netdiagFormatStressTest($data) { if (!empty($data['hinweis']) || !empty($data['fehler'])) { return ''.dol_escape_htmltag((string) ($data['hinweis'] ?? $data['fehler'])).''; } $sum = array(); if (isset($data['host'])) { $sum[] = 'Ziel: '.$data['host']; } if (isset($data['dauerSekunden'])) { $sum[] = 'Dauer: '.round($data['dauerSekunden'] / 60).' min'; } if (isset($data['intervallSek'])) { $sum[] = 'Takt: '.$data['intervallSek'].' s'; } if (isset($data['gesendet']) && isset($data['empfangen'])) { $sum[] = 'Proben: '.$data['empfangen'].'/'.$data['gesendet']; } if (isset($data['verlustProzent'])) { $sum[] = 'Verlust: '.$data['verlustProzent'].' %'; } if (isset($data['avgMs']) && $data['avgMs'] !== null) { $sum[] = 'Ø '.$data['avgMs'].' ms'; } if (isset($data['minMs']) && isset($data['maxMs']) && $data['minMs'] !== null) { $sum[] = 'Min/Max '.$data['minMs'].'/'.$data['maxMs'].' ms'; } if (isset($data['p95Ms']) && $data['p95Ms'] !== null) { $sum[] = 'p95 '.$data['p95Ms'].' ms'; } if (isset($data['laengsterAusfallSek']) && $data['laengsterAusfallSek'] !== null) { $sum[] = 'längster Ausfall '.$data['laengsterAusfallSek'].' s'; } $out = '

'.dol_escape_htmltag(implode(' | ', $sum)).'

'; $ausfaelle = (isset($data['ausfaelle']) && is_array($data['ausfaelle'])) ? $data['ausfaelle'] : array(); if (empty($ausfaelle)) { $out .= '

Kein Ausfall während des Laufs.

'; } else { $out .= '

Ausfälle ('.count($ausfaelle).'):

'.dol_escape_htmltag((string) $line).'

'; } $out .= '

'; return $out; } /** * WLAN-Kanal-Momentaufnahme strukturiert als HTML aufbereiten. * * Wie beim Dauertest ein eigener Zweig statt der generischen Darstellung: * `netze` ist eine Liste von Objekten und würde dort als JSON-Text mit * dol_trunc(…,200) mitten im Satz abgeschnitten. * * @param array $data bereits dekodiertes result-JSON * @return string HTML-Schnipsel */ function netdiagFormatWifiKanal($data) { $out = '

'; // Aus dem Demomodus der App: erfundene Netze zum Ansehen/Vorführen. Muss // deutlich sichtbar bleiben, sonst wird eine Demo später für eine echte // Messung am Kundenstandort gehalten. if (!empty($data['demodaten'])) { $out .= '

' .dol_escape_htmltag('DEMODATEN — keine echte Messung').'

'; } $sum = array(); if (isset($data['anzahlNetze'])) { $sum[] = $data['anzahlNetze'].' Netze sichtbar'; } if (!empty($data['eigenesNetz']) && is_array($data['eigenesNetz'])) { $e = $data['eigenesNetz']; $teil = 'Eigenes Netz: '.($e['ssid'] ?? '?').' — Kanal '.($e['kanal'] ?? '?'); if (!empty($e['band'])) { $teil .= ' ('.$e['band'].')'; } if (isset($e['rssi'])) { $teil .= ', '.$e['rssi'].' dBm'; } if (!empty($e['bewertung'])) { $teil .= ' — '.$e['bewertung']; } $sum[] = $teil; } if (!empty($data['empfehlung24GHz']) && is_array($data['empfehlung24GHz'])) { $best = reset($data['empfehlung24GHz']); if (is_array($best) && isset($best['kanal'])) { $sum[] = 'Störungsärmster 2,4-GHz-Kanal: '.$best['kanal']; } } if (!empty($sum)) { $out .= '

'.dol_escape_htmltag(implode(' | ', $sum)).'

'; } if (!empty($data['warnungen']) && is_array($data['warnungen'])) { $out .= '

Hinweise:

'.dol_escape_htmltag((string) $w).'

'; } $netze = (isset($data['netze']) && is_array($data['netze'])) ? $data['netze'] : array(); if (!empty($netze)) { $out .= ''; $out .= ''; $out .= ''; $out .= ''; foreach ($netze as $n) { if (!is_array($n)) { continue; } $out .= ''; $out .= ''; $out .= ''; $out .= ''; $out .= ''; $out .= ''; $out .= ''; $out .= ''; $out .= ''; } $out .= '

SSID	Kanal	Band	Breite	Standard	Sicherheit	Pegel
'.dol_escape_htmltag((string) ($n['ssid'] ?? '')).'	'.dol_escape_htmltag((string) ($n['kanal'] ?? '')).'	'.dol_escape_htmltag((string) ($n['band'] ?? '')).'	'.(isset($n['breiteMhz']) && $n['breiteMhz'] !== null ? dol_escape_htmltag($n['breiteMhz'].' MHz') : '-').'	'.dol_escape_htmltag((string) ($n['standard'] ?? '-')).'	'.dol_escape_htmltag((string) ($n['sicherheit'] ?? '-')).'	'.dol_escape_htmltag((string) ($n['rssi'] ?? '')).' dBm

'; } $out .= '

'; return $out; }