swoole提供的function · swoole手冊

# 函數列表 swoole除了網絡通信相關的函數外，還提供了一些獲取系統信息的函數供PHP程序使用。 [TOC=2,3] ## swoole_set_process_name 用于設置進程的名稱。修改進程名稱后，此函數接受一個字符串參數。此函數與PHP5.5提供的cli_set_process_title功能是相同的。但swoole_set_process_name可用于PHP5.2之上的任意版本。swoole_set_process_name兼容性比cli_set_process_title要差，如果存在cli_set_process_title函數則優先使用cli_set_process_title。 **功能描述**：設置進程的名稱 **函數原型**： ```php void swoole_set_process_name(string $name); ``` **返回**：無 **參數說明**： | 參數 | 說明 | | -------- | -------- | | string name | 進程名稱 | **說明**： 修改進程名稱后，通過ps命令看到的將不再是php your_file.php，而是設定的字符串 示例代碼： ``` swoole_set_process_name("swoole server"); var_dump($argv); sleep(1000); ``` >swoole_set_process_name在1.6.3版本提供 >在onStart回調中執行此函數，將修改主進程的名稱。在onWorkerStart中調用將修改worker子進程的名稱。如何為Swoole Server重命名各個進程名稱 * 在swoole_server_create之前修改為manager進程名稱 * onStart調用時修改為主進程名稱 * onWorkerStart修改為worker進程名稱 >1.6.12后增加了onManagerStart事件回調，可以在這里設置管理進程的名稱 >低版本Linux內核和Mac OSX不支持進程重命名 ## swoole_version **功能描述**：獲取swoole擴展的版本號 **函數原型**： ```php string swoole_version(); ``` **返回**：swoole擴展的版本號 **樣例**: ```php echo swoole_version(); ``` ## swoole_strerror **功能描述**：將標準的Unix Errno錯誤碼轉換成錯誤信息 **函數原型**： ```php string swoole_strerror(int $errno); ``` **返回**：轉化后的錯誤信息 **參數說明**： | 參數 | 說明 | | -------- | -------- | | int errno | errno錯誤碼 | **樣例**: ```php echo swoole_strerror( $errno ); ``` ## swoole_errno **功能描述**：獲取最近一次系統調用的錯誤碼 **函數原型**： ```php int swoole_errno(); ``` **返回**：最近一次系統調用的錯誤碼 **參數說明**：無 **說明**： 錯誤碼的值與操作系統有關。可是使用swoole_strerror將錯誤轉換為錯誤信息。 **樣例**: ```php echo swoole_strerror(swoole_errno()); ``` ## swoole_get_local_ip **功能描述**：此函數用于獲取本機所有網絡接口的IP地址 **函數原型**： ```php array swoole_get_local_ip(); $result = array("eth0" => "192.168.1.100"); ``` **返回**：以interface名稱為key的關聯數組 **參數說明**：無 **說明**： 目前只返回IPv4地址，返回結果會過濾掉本地loop地址127.0.0.1 返回結果樣例array("eth0" => "192.168.1.100")； **樣例**: ```php var_dump(swoole_get_local_ip()); ``` * 目前只返回IPv4地址，返回結果會過濾掉本地loop地址127.0.0.1。 * 結果數組是以interface名稱為key的關聯數組。比如 array("eth0" => "192.168.1.100") * 此函數會實時調用ioctl系統調用獲取接口信息，底層無緩存 ## swoole_clear_dns_cache 清除swoole內置的DNS緩存，對swoole_client和swoole_async_dns_lookup 有效。 ``` function swoole_clear_dns_cache(); ``` ## swoole_get_local_mac 獲取本機網卡Mac地址。 ``` function swoole_get_local_mac() : array; ``` 調用成功返回所有網卡的Mac地址 ``` array(4) { ["lo"]=> string(17) "00:00:00:00:00:00" ["eno1"]=> string(17) "64:00:6A:65:51:32" ["docker0"]=> string(17) "02:42:21:9B:12:05" ["vboxnet0"]=> string(17) "0A:00:27:00:00:00" } ``` >在1.9.18或更高版本可用