Start · Sprachen · PHP · Referenz · snmp_get_quick_print

snmp_get_quick_print

Funktion

Gibt den aktuellen Wert der <code>quick_print</code>-Einstellung der NET-SNMP-Bibliothek zurück.

seit PHP 4.0.0 Kategorie: http

Signatur

snmp_get_quick_print(): bool

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

Typ
bool
Beschreibung
Gibt 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.";
}
?>
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';
?>
Ergebnis mit quick_print: Linux-Router 4.15.0 quick_print wurde auf den ursprünglichen Zustand zurückgesetzt: 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.