Signatur
Beschreibung
snmp_get_quick_print() liefert den aktuellen Status der quick_print-Option der NET-SNMP-Bibliothek. Ist quick_print aktiviert, gibt die SNMP-Bibliothek nur den rohen Wert eines SNMP-Objekts zurück, ohne die zusätzlichen Typinformationen (z. B. INTEGER:, STRING:), die normalerweise vorangestellt werden.
Die Funktion wird typischerweise zusammen mit snmp_set_quick_print() verwendet, um den aktuellen Zustand vor einer temporären Änderung zu speichern und später wiederherstellen zu können. So kann sichergestellt werden, dass der ursprüngliche Zustand der Bibliothek nach SNMP-Operationen erhalten bleibt.
Diese Funktion nimmt keine Parameter entgegen und gibt schlicht true zurück, wenn quick_print aktiviert ist, andernfalls false.
Rückgabewert
true zurück, wenn quick_print in der NET-SNMP-Bibliothek aktiviert ist, andernfalls false.Beispiele
Aktuellen quick_print-Status abfragen
<?php
// Aktuellen Status der quick_print-Einstellung abfragen
$status = snmp_get_quick_print();
if ($status) {
echo "quick_print ist aktiviert.";
} else {
echo "quick_print ist deaktiviert.";
}
?>
Status sichern, ändern und wiederherstellen
<?php
// Aktuellen Status sichern
$previousStatus = snmp_get_quick_print();
// quick_print temporär aktivieren
snmp_set_quick_print(true);
// SNMP-Abfrage durchführen (Beispiel)
$result = snmpget('192.168.1.1', 'public', 'sysDescr.0');
echo "Ergebnis mit quick_print: " . $result . PHP_EOL;
// Ursprünglichen Status wiederherstellen
snmp_set_quick_print($previousStatus);
echo "quick_print wurde auf den ursprünglichen Zustand zurückgesetzt: ";
echo snmp_get_quick_print() ? 'aktiviert' : 'deaktiviert';
?>
// Wichtig · Fallstricke
Voraussetzung: Die SNMP-Erweiterung muss in PHP aktiviert sein, und die NET-SNMP-Bibliothek muss installiert sein. Unter Linux ist dies häufig das Paket libsnmp-dev.
Die Funktion gehört zur Kategorie der globalen SNMP-Konfigurationsfunktionen und beeinflusst alle nachfolgenden SNMP-Abfragen innerhalb desselben PHP-Prozesses. In Mehrbenutzer- oder parallelen Umgebungen sollte die Einstellung daher mit Bedacht gesetzt und zurückgesetzt werden.