(PHP >= 5.2.0, PHP 7, PHP 8)
snmp2_set — 設定 SNMP 物件的值
$hostname,$community,$object_id,$type,$value,$timeout = -1,$retries = -1
snmp2_set() 用於設定由 object_id 指定的 SNMP 物件的值。
hostnameSNMP 代理程式（伺服器）的主機名稱。
community寫入共同體。
object_idSNMP 物件 ID。
typeMIB 定義每個物件 ID 的類型。它必須指定為以下列表中的一個單一字元。
| = | 類型取自 MIB |
| i | INTEGER (整數) |
| u | INTEGER (整數) |
| s | STRING (字串) |
| x | HEX STRING (十六進位字串) |
| d | DECIMAL STRING (十進位字串) |
| n | NULLOBJ (空物件) |
| o | OBJID (物件 ID) |
| t | TIMETICKS (時間刻度) |
| a | IPADDRESS (IP 位址) |
| b | BITS (位元) |
如果在編譯 SNMP 程式庫時定義了 OPAQUE_SPECIAL_TYPES，以下類型也適用
| U | unsigned int64 (無號 64 位元整數) |
| I | signed int64 (有號 64 位元整數) |
| F | float (浮點數) |
| D | double (雙精度浮點數) |
大多數類型會使用明顯對應的 ASN.1 類型。 's'、'x'、'd' 和 'b' 都是指定 OCTET STRING 值的不同方式，而 'u' 無號類型也用於處理 Gauge32 值。
如果 MIB 檔案已透過 "snmp_read_mib" 或在 libsnmp 設定中指定載入到 MIB 樹中，則所有物件 ID 都可以使用 '=' 作為 type 參數，因為此時可以從 MIB 自動讀取類型。
請注意，有兩種方法可以設定 BITS 類型的變數，例如 "SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}"
詳情請參閱範例章節。
value新值。
timeout第一次逾時的微秒數。
retries發生逾時時重試的次數。
如果 SNMP 主機拒絕資料類型，則會顯示 E_WARNING 訊息，例如「警告：封包錯誤。原因：(badValue) 給定的值類型或長度錯誤。」 如果指定了未知或無效的 OID，警告可能會顯示「無法新增變數」。
範例 #1 使用 snmp2_set()
<?php
snmp2_set("localhost", "public", "IF-MIB::ifAlias.3", "s", "foo");
?>範例 #2 使用 snmp2_set() 設定 BITS SNMP 物件 ID
<?php
snmp2_set("localhost", "public", 'FOO-MIB::bar.42', 'b', '0 1 2 3 4');
// 或
snmp2_set("localhost", "public", 'FOO-MIB::bar.42', 'x', 'F0');
?>「類型」參數必須是以下其中之一，取決於要在 SNMP 主機上設定的變數類型
i 整數 (INTEGER)
u 無正負號整數 (unsigned INTEGER)
t 時間刻度 (TIMETICKS)
a IP 位址 (IPADDRESS)
o 物件 ID (OBJID)
s 字串 (STRING)
x 十六進位字串 (HEX STRING)
d 十進位字串 (DECIMAL STRING)
如果在編譯 SNMP 函式庫時定義了 OPAQUE_SPECIAL_TYPES，則以下類型也屬有效
U 無正負號 int64 (unsigned int64)
I 有正負號 int64 (signed int64)
F 浮點數 (float)
D 雙精度浮點數 (double)