NIS 函數庫
nis 的全名為 network information system，另外一個說法就是 yp (yellow pages)。nis 或 yp 可以讓許多不同的 unix 機器擁有相同的系統信息，例如相同的用戶帳號密碼，使系統管理人員及用戶都容易在不同的機器間穿梭，不可避免的，會有安全上的缺點，不過安全就不是這兒所討論的了。而關于 nis 方面的中英文書籍在市面上都可以找到，或者也可以參考 http://www.desy.de/~sieversm/ypdoku/ypdoku/ypdoku.html 。
欲使用 nis 函數庫，記得要在編譯 php 時將 yp 的選項打開，即加上 --with-yp 選項。
yp_get_default_domain: 取得機器的 domain。
yp_order: 返回 map 的序數。
yp_master: 取得 nis 的 master。
yp_match: 取得指定資料。
yp_first: 返回 map 上第一筆符合的資料。
yp_next: 指定 map 的下筆資料。
yp_errno: 取得先前 yp 操作的錯誤碼。
yp_err_string: 取得先前 yp 操作的錯誤字符串。
yp_get_default_domain
取得機器的 domain。
語法: string yp_get_default_domain(void);
返回值: 字符串
函數種類: 網絡系統
內容說明: 本函數用來尋找服務器本身所處的 domain。執行成功則返回 domain 字符串，失敗則返回 false。本函數執行時不需要加參數。
使用范例
參考: yp_errno() yp_err_string()
yp_order
返回 map 的序數。
語法: int yp_order(string domain, string map);
返回值: 整數
函數種類: 網絡系統
內容說明: 本函數用來取得 map 的序數，在取得 domain 及 map 之后使用。返回值為 map 序數，若失敗則返回 false。
使用范例
參考: yp_get_default_domain() yp_errno() yp_err_string()
yp_master
取得 nis 的 master。
語法: string yp_master(string domain, string map);
返回值: 字符串
函數種類: 網絡系統
內容說明: 本函數用來獲取目前所在 domain 上的 master 機器，在取得 domain 及 map 之后使用。
參考: yp_get_default_domain() yp_errno() yp_err_string()
yp_match
取得指定資料。
語法: string yp_match(string domain, string map, string key);
返回值: 字符串
函數種類: 網絡系統
內容說明: 本函數用來獲取指定 domain 中 map 中的指定資料。參數 key 可指定用戶名稱等。
使用范例
下例用來取得 wilson 的信息
返回字符串類似下面的字符串
wilson:##wilson:12345:380:wilson peng:/home/wilson:/bin/bash
參考: yp_get_default_domain() yp_errno() yp_err_string()
yp_first
返回 map 上第一筆符合的資料。
語法: array yp_first(string domain, string map);
返回值: 數組
函數種類: 網絡系統
內容說明: 本函數用來取得指定 map 上第一筆返回資料的索引和其值。返回資料為數組，若失敗則返回 false。
使用范例
參考: yp_get_default_domain() yp_errno() yp_err_string()
yp_next
指定 map 的下筆資料。
語法: array yp_next(string domain, string map, string key);
返回值: 數組
函數種類: 網絡系統
內容說明: 本函數用來取得 map 上指定資料的下筆返回資料的索引和其值。返回資料為數組，若失敗則返回 false。
使用范例
參考: yp_get_default_domain() yp_errno() yp_err_string()
yp_errno
取得先前 yp 操作的錯誤碼。
語法: int yp_errno(void);
返回值: 整數
函數種類: 網絡系統
內容說明: 本函數用來取得最后一次 yp 操作時的錯誤
[url=javascript:;]代碼[/url]
，代碼值及意義見下粗體部分
代碼 意義
1 函數的參數有錯
2 rpc 錯誤 - 不再系著 domain
3 在 domain 上無法系住服務器
4 domain 上找不到指定的 map
5 map 上找不到指定的索引鍵
6 yp 內部有錯
7 資源取得錯誤
8 指定 map
[url=javascript:;]數據庫[/url]
中已無資料
9 無法與 portmapper 通訊
10 無法與 ypbind 通訊
11 無法與 ypserv 通訊
12 未配置本地的 domain
13 yp 數據庫有錯
14 yp 版本不合
15 暴力存取
16 資料忙線中
yp_err_string
取得先前 yp 操作的錯誤字符串。
語法: string yp_err_string(void);
返回值: 字符串
函數種類: 網絡系統
內容說明: 本函數用來取得最后一次 yp 操作時的錯誤字符串。本函數不需參數。
【編輯推薦】
