WebSVN – php-qbpwcf – Diff – /trunk/usr/lib64/qbpwcf/sock.php

 <?php
 /*
 	QBPWCF, Quick Build PHP website Component base on Fedora Linux.
-    Copyright (C) 2015~2024 Min-Jhin,Chen
+    Copyright (C) 2014~2025 MIN ZHI, CHEN
     This file is part of QBPWCF.
     QBPWCF is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
     You should have received a copy of the GNU General Public License
     along with QBPWCF.  If not, see <http://www.gnu.org/licenses/>.
 */
 namespace qbpwcf;
 /*
 類別說明:
 跟socket應用相關的類別.
 備註:
 無.
 	#__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
 	#備註:
 	#無.
 	*/
 	public function __call($method,$arguments){
 		#取得當前執行的函式
 		$result["function"]=__FUNCTION__;
 		#設置執行不正常
 		$result["status"]="false";
 		#設置執行錯誤
 		$result["error"][]=__NAMESPACE__ ."/".$method."() 不存在!";
 		#設置所丟入的參數
 		$result["error"][]=$arguments;
 		#回傳結果
 		return $result;
 		}#function __call end
 	/*
 	#函式說明:
 	#當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#__callStatic=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
 	#備註:
 	#無.
 	*/
 	public static function __callStatic($method,$arguments){
 		#取得當前執行的函式
 		$result["function"]=__FUNCTION__;
 		#設置執行不正常
 		$result["status"]="false";
 		#設置執行錯誤
 		$result["error"][]="欲呼叫的". __NAMESPACE__ ."/".$method."() 不存在!";
 		#設置所丟入的參數
 		$result["error"][]=$arguments;
 		#回傳結果
 		return $result;
 		}#function __callStatic end
 	/*
 	#函式說明:
 	#建立 unix domain socket server, 僅提供具備檔案存取權限的用戶使用,預設提供可以下達任何指令的功能.
 	#回傳結果:
 	#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 	#http://php.net/manual/en/function.stream-socket-server.php
 	#備註:
 	#無.
 	*/
 	public static function unixDomainSockServer(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#涵式說明：
 		#判斷當前環境為web還是cmd
 		#回傳結果：
 		#$result,"web"或"cmd"
 		if(csInformation::getEnv()==="web"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="函數 ".$result["function"]." 僅能在命令列環境下運行!";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sock","fileArgu");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("changeOwner","changePermission","sessionTimeout","addOnProcessFunc","funcToRunWhenIdle","infoToFunction","shutdownStrAddr");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("changeOwner","changePermission","sessionTimeout","addOnProcessFunc","funcToRunWhenIdle","infoToFunction","paramsForFuncToRunWhenIdle","shutdownStrAddr");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","array","array","array","array","array");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf[\"mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("root.".webUser,null,"300",null,null,null,array(),null);
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#縮減 socket 的路徑,避免出錯.
 		#函式說明:
 		#將檔案目錄的絕對位置中的 "../" 剔除變成直觀的路徑.
 		#回傳結果:
 		#$result["status"],執行是否成功,"true"代表執行成功,"false"代表執行失敗.
 		#無.
 		#備註:
 		#考慮用realpath取代
 		$changeDirByDotDotSolidus=stringProcess::changeDirByDotDotSolidus($conf["stringProcess::changeDirByDotDotSolidus"]);
 		unset($conf["stringProcess::changeDirByDotDotSolidus"]);
 		#如果執行異常
 		if($changeDirByDotDotSolidus["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$changeDirByDotDotSolidus;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得整理過後的直觀路徑
 		$conf["sock"]=$changeDirByDotDotSolidus["changedPath"];
 		#取得 socket 的路徑
 		#函式說明:
 		#將字串特定關鍵字與其後面的內容剔除
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#無.
 		#備註:
 		#無.
 		$delStrAfterKeyWord=stringProcess::delStrAfterKeyWord($conf["stringProcess::delStrAfterKeyWord"]);
 		unset($conf["stringProcess::delStrAfterKeyWord"]);
 		#如果執行失敗
 		if($delStrAfterKeyWord["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]=$delStrAfterKeyWord;
 			#設置錯誤訊息
 			$result["error"][]="建立 unix domain socket(".$conf["sock"].") 失敗";
 			#印出錯誤訊息
 			echo print_r($result,true);
 			#回傳結果
 			return $result;
 			}#if end
 		#如果有 "/"
 		if($delStrAfterKeyWord["founded"]==="true"){
 			#確保建立socket的路徑有存在
 			#函式說明:
 			#確保路徑存在.
 			#回傳結果:
 			#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
 			#無.
 			#備註:
 			#無.
 			$validatePath=fileAccess::validatePath($conf["fileAccess::validatePath"]);
 			unset($conf["fileAccess::validatePath"]);
 			#如果執行失敗
 			if($validatePath["status"]==="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"][]=$validatePath;
 				#設置錯誤訊息
 				$result["error"][]="建立 unix domain socket(".$conf["sock"].") 失敗";
 				#印出錯誤訊息
 				echo print_r($result,true);
 				#回傳結果
 				return $result;
 				}#if end
 			}#if end
 		#如果同名 unix domain socket file 存在
 		if(file_exists($conf["sock"])){
 			#則移除之.
 			unlink($conf["sock"]);
 			}#if end
 		#預設的 unix socket addr
 		$unixAddr="unix://".$conf["sock"];
 		#建立 unix domain socket
 		$socket=stream_socket_server($unixAddr, $errno, $errstr);
 		#如果建立 unix domain socket 失敗
 		if(!$socket){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]=$errstr." (".$errno.")";
 			#設置錯誤訊息
 			$result["error"][]="建立 unix domain socket(".$conf["sock"].") 失敗";
 			#印出錯誤訊息
 			echo print_r($result,true);
 			#回傳結果
 			return $result;
 			}#if end
 		#如果建立 unix domain socket 成功
 		else{
 			#產生用於代表結束本函式的字串
 			#函式說明:
 			#使用 linux 的 uuid 指令來產生 uuid 字串
 			#回傳結果:
 			#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 			#參考資料:
 			#無.
 			#備註:
 			#無.
 			$uuid=cmd::uuid();
 			#如果執行失敗
 			if($uuid["status"]==="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$uuid;
 				#回傳結果
 				return $result;
 				}#if end
 			#設置代表結束本服務的uuid字串
 			$shutdownStr=$uuid["content"];
 			#如果沒有設置
 			if(!isset($conf["shutdownStrAddr"])){
 				#初始化存放 shutdownStr 的檔案
 				$conf["shutdownStrAddr"]=$conf["sock"].".shutdownStr";
 				}#if end
 			#如果檔案位置名稱跟socket一樣
 			else if($conf["sock"]===$conf["shutdownStrAddr"]){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"][]="參數shutdownStrAddr跟sock不可一樣";
 				#設置錯誤訊息
 				$result["error"][]=$checkArguments;
 				#回傳結果
 				return $result;
 				}#else end
 			#建立裡面儲存若要結束本程式需要接收到什麼樣的字串
 			#函式說明:
 			#將字串寫入到檔案
 			#回傳結果:
 			#$result["status"],"true"表示檔案寫入成功,"false"表示檔案寫入失敗.
 			#無.
 			#備註:
 			#無.
 			$writeTextIntoFile=fileAccess::writeTextIntoFile($conf["fileAccess::writeTextIntoFile"]);
 			unset($conf["fileAccess::writeTextIntoFile"]);
 			#如果執行失敗
 			if($writeTextIntoFile["status"]==="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$writeTextIntoFile;
 				#回傳結果
 				return $result;
 				}#if end
 			#debug
 			#var_dump(__LINE__,$writeTextIntoFile);exit;
 			#初始化 client 陣列
 			$client=array();
 			#如果有設置$conf["changeOwner"]
 			if(isset($conf["changeOwner"])){
 				#如果裡面的"."不是一個
 				if(substr_count($conf["changeOwner"],".")!==1){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置錯誤訊息
 					$result["error"][]="參數 changeOwner 應為 username.groupname";
 					#印出錯誤訊息
 					echo print_r($result,true);
 					#回傳結果
 					return $result;
 					}#if end
 				#改變檔案的擁有者
 				#函式說明:
 				#使用 linux 的 chown 指令來修改目標檔案或目錄的擁有者跟群組擁有者資訊.
 				#回傳結果:
 				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 				#無.
 				#備註:
 				#無.
 				$chown=cmd::chown($conf["cmd::chown"]);
 				unset($conf["cmd::chown"]);
 				#如果改變檔案擁有者限失敗
 				if($chown===false){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置錯誤訊息
 					$result["error"][]="改變 ".$conf["sock"]." 檔案的擁有資訊為 ".explode(".",$conf["changeOwner"])[0]." 失敗,通常只有系統帳戶才能變更之.";
 					#印出錯誤訊息
 					echo print_r($result,true);
 					#回傳結果
 					return $result;
 					}#if end
 				}#if end
 			#如果有設置 $conf["changePermission"]
 			if(isset($conf["changePermission"])){
 				#函式說明:
 				#使用 linux 的 chmod 指令來修改目標檔案或目錄的權限.
 				#回傳結果:
 				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 				#$result["error"],錯誤訊息.
 				#無.
 				#備註:
 				#無.
 				$chmod=cmd::chmod($conf["cmd::chmod"]);
 				unset($conf["cmd::chmod"]);
 				#如果變更檔案權限失敗
 				if($chmod["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置錯誤訊息
 					$result["error"]=$chmod;
 					#印出錯誤訊息
 					echo print_r($result,true);
 					#回傳結果
 					return $result;
 					}#if end
 				}#if end
 			#初始化儲存 server 資訊的變數,預設數值為 $result 自己
 			$result["serverCache"]=&$result;
 			#初始化方便識別 server 資訊的變數
 			$serverCache=&$result["serverCache"];
 			#初始化 server site cache
 			$serverCache["serverSide"]=array();
 			#初始化 儲存 透過 proc 執行的子程序
 			$serverCache["serverSide"]["procs"]=array();
 			#初始化 client site cache
 			$serverCache["clientSide"]=array();
 			#初始化方便識別 client site cache 資訊的變數
 			$clientCache=&$serverCache["clientSide"];
 			#將建立的 listen sock 放到 $master 陣列
 			$master[] = $socket;
 			#永久監聽, 不 timeout
 			while(true){
 				#debug
 				#var_dump(__LINE__,gmdate("Y-m-d H:i:s",time()));
 				#設置給 stream_select 監控的sock變數
 				$read = $write = $except = $master;
 				#等待5秒，看有沒有連線進來讀寫資料
 				$mod_fd = stream_select($read, $write, $except, 5);
 				#如果執行失敗
 				if($mod_fd===FALSE){
 					#提示錯誤訊息
 					echo "Stream_select failed at ".gmdate("Y-m-d H:i:s",time());
 					#結束監聽
 					exit(1);
 					}#if end
 				#如果沒有訊息,代表閒置時可以做的事情
 				else if($mod_fd===0){
 					#提示idle
 					echo ".";
 					#清除 session timeout 的連線 - start
 					#初始化要給 server 的回應
 					$res=array();
 					#初始化計數移除幾個用戶
 					$res["delIdleConCount"]=0;
 					#針對每個 $client
 					foreach($client as $index=>$uncheckClient){
 						#如果上次的要求時間為300秒前.
 						if(time()-(int)$uncheckClient["last_req_time"]>$conf["sessionTimeout"]){
 							#移除該用戶變數
 							unset($client["$index"]);
 							#計數移除了幾個用戶
 							$res["delIdleConCount"]++;
 							}#if end
 						}#foreach end
 					#設置執行正常
 					$res["status"]="true";
 					#如果有移除閒置的連線
 					if($res["delIdleConCount"]>0){
 						#印出給 server 的訊息
 						echo PHP_EOL."response:".PHP_EOL.print_r($res,true);
 						}#if end
 					#清除 session timeout 的連線 - end
 					#清除 太久沒有 被查詢的 proc(子程序) - start
 					#初始化要給 server 的回應
 					$res=array();
 					#初始化計數移除幾個沒被關注的子程序
 					$res["delIdleProcCount"]=0;
 					#針對每個 子程序
 					foreach($serverCache["serverSide"]["procs"] as $procIndex=>$procInfo){
 						#debug
 						#var_dump(__FUNCTION__,__LINE__,$procInfo);
 						#如果上次的要求時間為300秒前.
 						if(time()-(int)$procInfo["latestAccessTime"]>$conf["sessionTimeout"]){
 							#若運行中
 							if($procInfo["content"][0]["statusCode"]==="?"){
 								#更新資訊
 								#函式說明:
 								#更新透過proc執行的多程序資訊.
 								#回傳結果:
 								#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 								#無.
 								#備註:
 								#無.
 								$proc_update=threads::proc_update($conf["threads::proc_update"]);
 								unset($conf["threads::proc_update"]);
 								#若執行不正常
 								if($proc_update["status"]==="false"){
 									#設置執行失敗
 									$result["status"]="false";
 									#設置錯誤訊息
 									$result["error"]=$proc_update;
 									#印出錯誤訊息
 									echo print_r($result,true);
 									#回傳結果
 									return $result;
 									}#if end
 								#更新程序狀態
 								$procInfo["content"]=$proc_update["content"][0];
 								#更新會後存取時間
 								#若已經執行結束
 								if($procInfo["content"]["statusCode"]!=="?"){
 									#換下一個
 									continue;
 									}#if end
 								#執行到這代表一樣再運行中
 								#終止程序
 								proc_close($procInfo["content"]["process"]);
 								#移除該用戶變數
 								unset($serverCache["serverSide"]["procs"][$procIndex]);
 								#換下一個
 								continue;
 								}#if end
 							#反之為已運行結束
 							#移除該用戶變數
 							unset($serverCache["serverSide"]["procs"][$procIndex]);
 							#計數移除幾個沒被關注的子程序
 							$res["delIdleProcCount"]++;
 							}#if end
 						}#foreach end
 					#設置執行正常
 					$res["status"]="true";
 					#如果有移除沒被關注的子程序
 					if($res["delIdleProcCount"]>0){
 						#印出給 server 的訊息
 						echo PHP_EOL."response:".PHP_EOL.print_r($res,true);
 						}#if end
 					#清除 太久沒有 被查詢的 proc(子程序) - end
 					#如果有設置 idle 要執行的函式
 					if(isset($conf["funcToRunWhenIdle"])){
 						#提示有idle要執行的函式
 						echo "response:".PHP_EOL."There is funcToRunWhenIdle param set.".PHP_EOL;
 						#針對每個 funcToRunWhenIdle
 						foreach($conf["funcToRunWhenIdle"] as $index => $funcToRunWhenIdle){
 							#提示正要執行的函式
 							echo "response:".PHP_EOL."Executeing ".$funcToRunWhenIdle."...".PHP_EOL;
 							#初始化要給 funcToRunWhenIdle 函式的參數
 							$parasmForFuncToRunWhenIdle=array();
 							#取得所有用戶
 							$parasmForFuncToRunWhenIdle["client"]=&$client;
 							#如果有設置 infoToFunction
 							if(isset($conf["infoToFunction"])){
 								#設置info
 								$parasmForFuncToRunWhenIdle["info"]=&$conf["infoToFunction"];
 								}#if end
 							#debug
 							#var_dump(__FILE__,__LINE__,$serverCache["serverSide"]);
 							#如果屬於該 $funcToRunWhenIdle 的 server side cache 不存在
 							if(!isset($serverCache["serverSide"]["funcToRunWhenIdle"][$funcToRunWhenIdle])){
 								#初始化為空陣列
 								$serverCache["serverSide"]["funcToRunWhenIdle"][$funcToRunWhenIdle]=array();
 								}#if end
 							#設置給予 $funcToRunWhenIdle 函式的 serverCache 參數
 							$parasmForFuncToRunWhenIdle["serverCache"]=&$serverCache;
 							#儲存 $funcToRunWhenIdle 函式 的運行結束的時間點到 server side 的 cache
 							$serverCache["serverSide"]["funcToRunWhenIdle"][$funcToRunWhenIdle]["lastRunTime"]=time::unix()["content"];
 							#如果有要指定給 $funcToRunWhenIdle 的參數
 							if(isset($conf["paramsForFuncToRunWhenIdle"][$index])){
 								#針對每個 要給予 funcToRunWhenIdle 的參數
 								foreach($conf["paramsForFuncToRunWhenIdle"][$index] as $arguKeyForFuncToRunWhenIdle => $arguValueForFuncToRunWhenIdle){
 									#設置給予 funcToRunWhenIdle 的參數
 									$parasmForFuncToRunWhenIdle[$arguKeyForFuncToRunWhenIdle]=$arguValueForFuncToRunWhenIdle;
 									#debug
 									#var_dump(__LINE__,$parasmForFuncToRunWhenIdle);
 									}#foreach end
 								}#if end
 							/* debug
 							#函式說明:
 							#撰寫log
 							#回傳結果:
 							#$result["status"],狀態,"true"或"false".
 							#$result["error"],錯誤訊息陣列.
 							#無.
 							#備註:
 							#無.
 							$record=logs::record($conf["logs::record"]);
 							unset($conf["logs::record"]);
 							#如果執行失敗
 							if($record["status"]==="false"){
 								#設置執行錯誤識別
 								$result["status"]="false";
 								#設置執行錯誤
 								$result["error"]=$record;
 								#回傳結果
 								return $result;
 								}#if end
 							*/
 							#debug
 							#var_dump(__LINE__,$parasmForFuncToRunWhenIdle);
 							#debug
 							#var_dump(__LINE__,"\$call_user_func=".$funcToRunWhenIdle."(\$parasmForFuncToRunWhenIdle);");
 							#呼叫 $funcToRunWhenIdle 函式,參數用 $client[$request->id]， 取得執行後的回應.
 							eval("\$call_user_func=".$funcToRunWhenIdle."(\$parasmForFuncToRunWhenIdle);");
 							/* debug
 							#函式說明:
 							#撰寫log
 							#回傳結果:
 							#$result["status"],狀態,"true"或"false".
 							#$result["error"],錯誤訊息陣列.
 							#無.
 							#備註:
 							#無.
 							$record=logs::record($conf["logs::record"]);
 							unset($conf["logs::record"]);
 							#如果執行失敗
 							if($record["status"]==="false"){
 								#設置執行錯誤識別
 								$result["status"]="false";
 								#設置執行錯誤
 								$result["error"]=$record;
 								#回傳結果
 								return $result;
 								}#if end
 							*/
 							#儲存 $funcToRunWhenIdle 函式 的運行結果資訊到 server side 的 cache
 							$serverCache["serverSide"]["funcToRunWhenIdle"][$funcToRunWhenIdle]["result"]=&$call_user_func;
 							#儲存 $funcToRunWhenIdle 函式 的運行結束的時間點到 server side 的 cache
 							$serverCache["serverSide"]["funcToRunWhenIdle"][$funcToRunWhenIdle]["lastEndTime"]=time::unix()["content"];
 							#debug
 							#var_dump(__FILE__,__LINE__,$serverCache);
 							#如果 運行 $funcToRunWhenIdle 後回傳的內容含有 key 為 status 的元素
 							if(isset($call_user_func["status"])){
 								#如果其數值為 "false"
 								if($call_user_func["status"]==="false"){
 									#印出訊息,結束執行
 									var_dump(__FILE__,__LINE__,$call_user_func);exit;
 									}#if end
 								}#if end
 							#如果有訊息要提示
 							if(isset($call_user_func["content"])){
 								#印出提示訊息
 								var_dump($call_user_func["content"]);
 								}#if end
 							#如果 運行 $funcToRunWhenIdle 後回傳的內容含有 key 為 cache 的元素
 							if(isset($call_user_func["cache"])){
 								#debug
 								#var_dump(__FILE__,__LINE__,$call_user_func["cache"]);
 								#儲存到 server side 的 cache
 								$serverCache["serverSide"]["funcToRunWhenIdle"][$funcToRunWhenIdle]["cache"]=&$call_user_func["cache"];
 								/*
 								#debug
 								#函式說明:
 								#撰寫log
 								#回傳結果:
 								#無.
 								#備註:
 								#無.
 								$record=logs::record($conf["logs::record"]);
 								unset($conf["logs::record"]);
 								#如果執行失敗
 								if($record["status"]==="false"){
 									#設置執行錯誤識別
 									$result["status"]="false";
 									#設置執行錯誤
 									$result["error"]=$record;
 									#回傳結果
 									return $result;
 									}#if end
 								*/
 								}#if end
 							#如果回傳結果含有 exit 元素
 							if(isset($call_user_func["exit"])){
 								/*
 								#debug
 								#函式說明:
 								#撰寫log
 								#回傳結果:
 								#無.
 								#備註:
 								#無.
 								$record=logs::record($conf["logs::record"]);
 								unset($conf["logs::record"]);
 								#如果執行失敗
 								if($record["status"]==="false"){
 									#設置執行錯誤識別
 									$result["status"]="false";
 									#設置執行錯誤
 									$result["error"]=$record;
 									#回傳結果
 									return $result;
 									}#if end
 								*/
 								#如果是要結束daemon執行
 								if($call_user_func["exit"]==="true"){
 									#設置daemon結束的原因
 									$call_user_func["exit"]="exit by funcToRunWhenIdle(".$funcToRunWhenIdle.")";
 									#設置執行正常
 									$result["status"]="true";
 									#結束執行
 									return $result;
 									}#if end
 								}#if end
 							#提示正要執行的函式
 							echo "response:".PHP_EOL.$funcToRunWhenIdle." Executed.".PHP_EOL;
 							}#foreach end
 						}#if end
 					#等待下個要求
 					continue;
 					}#if end
 				#有偵測到讀寫的動作
 				else{
 					#針對每個 sock 陣列
 					foreach($read as $readStream){
 						#如果元素是 listen 的 socket
 						if($readStream === $socket){
 							#當等待別人連線時,若有人連線進來.
 							$conn = stream_socket_accept($socket);
 							#取得 meta data
 							#$stream_meta_data=stream_get_meta_data($conn);
 							#debug
 							#var_dump(__LINE__,$stream_meta_data);
 							#印出有連線進來的訊息
 							echo "received a connection".PHP_EOL;
 							#初始化取得的內容
 							$request="";
 							#初始化要回應的內容
 							$res=array();
 							#取得 request 的時間
 							$last_req_time=time();
 							#當有要求時
 							while(!feof($conn)){
 								#讀取要求
 								$tmp=fgets($conn, 1024);
 								#如果讀到 PHP_EOL
 								if($tmp===PHP_EOL){
 									#結束讀取要求
 									break;
 									}#if end
 								#串接回應
 								$request=$request.$tmp;
 								}#while end
 							#印出有連線進來的訊息
 							echo "received content:".PHP_EOL.$request.PHP_EOL;
 							#parse request json
 							$request=json_decode($request);
 							#如果 parse json 失敗
 							if($request===false){
 								#設置錯誤訊息
 								$res["error"]="要求格式必須為json";
 								#設置執行失敗
 								$res["status"]="false";
 								#印出回的訊息
 								echo "res:".print_r($res,true);
 								#寫入回應的內容
 								fwrite($conn,json_encode($res).PHP_EOL);
 								#結束回應
 								fwrite($conn,PHP_EOL.PHP_EOL);
 								#關閉socket連線,將回應輸出.
 								fclose($conn);
 								#等待下個要求
 								continue;
 								}#if end
 							#若無ID資訊
 							if(!isset($request->id)){
 								#無窮迴圈
 								while(true){
 									#set client id 設置要回應的訊息
 									#函式說明:
 									#呼叫shell執行系統命令,並取得回傳的內容.
 									#回傳結果:
 									#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 									#備註:
 									#不是所有指令都能用apache的身份執行,目前已知java,javac指令無法執行,使用root身份可能會被selinux阻擋.
 									#若使用的 command、argu 參數，含有 ~ 則會被視為字串，若有需要其於 shell 中代表的家目錄位置，可用 fileAccess::tildeToPath 來進行轉換.
 									$callShell=external::callShell($conf["external::callShell"]);
 									unset($conf["external::callShell"]);
 									#如果執行失敗
 									if($callShell["status"]==="false"){
 										#設置執行失敗
 										$result["status"]="false";
 										#設置錯誤訊息
 										$result["error"]=$callShell;
 										#回傳結果
 										return $result;
 										}#if end
 									#如果沒有預期的 uuid 回應
 									if(!isset($callShell["output"][0])){
 										#設置執行失敗
 										$result["status"]="false";
 										#設置錯誤訊息
 										$result["error"][]="get uuid failed!";
 										#設置錯誤訊息
 										$result["error"][]=$callShell;
 										#回傳結果
 										return $result;
 										}#if end
 									#檢查 client id 是否已經存在
 									if(isset($client[$callShell["output"][0]])){
 										#休息一微秒
 										usleep(1);
 										#再次建立id試試
 										continue;
 										}#if end
 									#設置回應的id
 									$res["id"]=$callShell["output"][0];
 									#建立id完畢
 									break;
 									}#while end
 								#儲存使用者id與最後一次來request的時間
 								$client[$res["id"]]=array("last_req_time"=>$last_req_time);
 								#印出用戶端列表
 								echo "clients:".print_r($client,true);
 								#設置執行正常
 								$res["status"]="true";
 								#印出回的訊息
 								echo "response:".PHP_EOL.print_r($res,true);
 								#寫入回應的內容
 								fwrite($conn,json_encode($res).PHP_EOL);
 								#結束回應
 								fwrite($conn,PHP_EOL.PHP_EOL);
 								#關閉socket連線,將回應輸出.
 								fclose($conn);
 								#等待下個要求
 								continue;
 								}#if end
 							#若ID資訊不存在
 							if(!isset($client[$request->id])){
 								#設置執行失敗
 								$res["status"]="false";
 								#設置ID不存在的訊息
 								$res["error"]="ID:".$request->id." 不存在,請再要一次ID.";
 								#印出回的訊息
 								echo "response:".PHP_EOL.print_r($res,true);
 								#寫入回應的內容
 								fwrite($conn,json_encode($res).PHP_EOL);
 								#結束回應
 								fwrite($conn,PHP_EOL.PHP_EOL);
 								#關閉socket連線,將回應輸出.
 								fclose($conn);
 								#等待下個要求
 								continue;
 								}#if end
 							#如果有客製化訊息
 							if(isset($request->custom)){
 								#取代之
 								$request=$request->custom;
 								}#if end
 							#若有要執行的指令 cmd,且非客製化.
 							if(isset($request->cmd)){
 								#如果是要結束連線
 								if($request->cmd==="quit"){
 									#設置執行正常
 									$res["status"]="true";
 									#設置訊息
 									$res["content"]="將關閉與您的連線";
 									#寫入回應的內容
 									fwrite($conn,json_encode($res).PHP_EOL);
 									#結束回應
 									fwrite($conn,PHP_EOL.PHP_EOL);
 									#關閉socket連線,將回應輸出.
 									fclose($conn);
 									#移除該用戶變數
 									unset($client[$index]);
 									#計數移除了幾個用戶
 									$res["delCount"]++;
 									#設置執行正常
 									$res["status"]="true";
 									#印出回的訊息
 									echo "response:".PHP_EOL.print_r($res,true);
 									#等待下個要求
 									continue;
 									}#if end
 								#如果是要結束server
 								if($request->cmd===$shutdownStr){
 									#設置執行正常
 									$res["status"]="true";
 									#設置訊息
 									$res["content"]="本服務將結束";
 									#寫入回應的內容
 									fwrite($conn,json_encode($res).PHP_EOL);
 									#結束回應
 									fwrite($conn,PHP_EOL.PHP_EOL);
 									#關閉socket連線,將回應輸出.
 									fclose($conn);
 									#設置執行正常
 									$result["status"]="true";
 									#結束本程式
 									return $result;
 									}#if end
 								#涵式說明:
 								#呼叫shell執行系統命令,並取得回傳的內容.
 								#回傳的結果:
 								#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 								#$result["error"],錯誤訊息陣列.
 								#$conf["command"],字串,要執行的指令與.
 								$conf["external::callShell"]["command"]=$request->cmd;
 								#$conf["fileArgu"],字串,變數__FILE__的內容.
 								$conf["external::callShell"]["fileArgu"]=$conf["fileArgu"];
 								#可省略參數:
 								#如果有指定參數
 								if(isset($request->param)){
 									#$conf["argu"],陣列字串,指令搭配的參數,預設為空陣列.
 									$conf["external::callShell"]["argu"]=$request->param;
 									}#if end
 								#$conf["arguIsAddr"],陣列字串,指令搭配的哪些參數為路徑,為路徑的參數會進行轉換以便符合呼叫當前函數的位置,預設不指定,若有3個參數,其中第3個參數為路徑,則表示為array("false","false","true").
 								#$conf["arguIsAddr"]=array();
 								#$conf["pre"],陣列,要在本指令前執行的每個指令與參數.
 								#$conf["pre"][$i]["cmd"],字串,要在本指令前執行的第$i+1個指令.
 								#$conf["pre"][$i]["param"],陣列字串,要在本指令前執行的第$i+1個指令的參數.
 								#$conf["enablePrintDescription"],字串,是否要印出$conf["printDescription"]的內容,"true"代表要,"false"代表不要,預設為"false".
 								#$conf["enablePrintDescription"]="true";
 								#$conf["printDescription"],字串,執行該外部程式前要印出來的的文字,預設為$conf["command"]的內容.
 								#$conf["printDescription"]="";
 								#如果有參數
 								if(isset($request->param)){
 									#如果有識別是否已經 escaped 參數
 									if(isset($request->escaped)){
 										#設置預設要 escape
 										$needEscaped="true";
 										#如果已經 ecaped
 										if($request->escaped){
 											#設置不用 escape
 											$needEscaped="false";
 											}#if end
 										#$conf["escapeshellarg"],字串,是否要啟用過濾參數,用了比較安全,但可能會出錯,"true"為啟用,"false"為不啟用,預設為"false".
 										$conf["external::callShell"]["escapeshellarg"]=$needEscaped;
 										}#if end
 									}#if end
 								#如果有設置要用特定的使用者身份執行
 								if(isset($request->user) && isset($request->password)){
 									#$conf["username"],字串,要用什麼使用者來執行,預設為執行php的使用者,該參數不適用於apache環境.
 									$conf["external::callShell"]["username"]=$request->user;
 									#$conf["password"],字串,與$conf["username"]搭配的使用者密碼,預設不使用密碼,該參數不適用於apache環境.
 									$conf["external::callShell"]["password"]=$request->password;
 									}#if end
 								#$conf["useScript"],字串,是否要啟用Linux的script指令來記錄輸出,"true"代表要,Fedora的selinux會擋住該操作;"false"代表不要,預設為"false".
 								#$conf["useScript"]="";
 								#$conf["logFilePath"],字串,當 $conf["useScript"] 為 "true" 時,輸出的內容要暫存到哪裡,預設為 "/tmp/.qbpwcf_tmp/external/callShell/".
 								#$conf["logFilePath"]=".qbpwcf_tmp/external/callShell/";
 								#$conf["inBackGround"],字串,是否要在背景執行,且不會等待程式執行結束再執行下一個指令,"true"代表是,"false"代表不要,預設為"false",如果$conf["command"]有用「;」區隔的多個指令將會出錯.
 								#exec=>http://php.net/manual/en/function.exec.php
 								#escapeshellcmd=>http://php.net/manual/en/function.escapeshellcmd.php
 								#escapeshellarg=>http://php.net/manual/en/function.escapeshellarg.php
 								$callShell=external::callShell($conf["external::callShell"]);
 								unset($conf["external::callShell"]);
 								#設置要回覆的內容
 								$res=$callShell;
 								#印出回的訊息
 								echo "response:".PHP_EOL.print_r($res,true);
 								#寫入回應的內容
 								fwrite($conn,json_encode($res).PHP_EOL);
 								#結束回應
 								fwrite($conn,PHP_EOL.PHP_EOL);
 								#關閉socket連線,將回應輸出.
 								fclose($conn);
 								#更新使用者id與最後一次來request的時間
 								$client[$request->id]["last_req_time"]=$last_req_time;
 								#等待下個要求
 								continue;
 								}#if end
 							#設置接收到json字串資訊
 							$client[$request->id]["request"]=(array)($request);
 							#設置用戶端的socket
 							$client[$request->id]["socket"]=$conn;
 							#如果有要求在背景中執行指令的訊息
 							if(isset($request->cmdInBg)){
 								#debug
 								#var_dump(__FUNCTION__,__LINE__,$request);
 								#如果有參數
 								if(isset($request->param)){
 									#函式說明:
 									#將一維陣列轉換為用特定符號間隔的字串,ex:array("1","2","3") to "a;b;c;".
 									#回傳的結果:
 									#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 									#$result["function"],當前執行的function名稱
 									#無.
 									#備註:
 									#無.
 									$arrayToString=arrays::arrayToString($conf["arrays::arrayToString"]);
 									unset($conf["arrays::arrayToString"]);
 									#如果執行失敗
 									if($arrayToString["status"]==="false"){
 										#設置執行失敗
 										$result["status"]="false";
 										#設置錯誤訊息
 										$result["error"]=$arrayToString;
 										#回傳結果
 										return $result;
 										}#if end
 									#串接參數
 									$request->cmdInBg=$request->cmdInBg.$arrayToString["content"];
 									}#if end
 								#函式說明:
 								#透過proc來多執行序運作.
 								#回傳結果:
 								#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 								#$reuslt["error"],執行不正常結束的錯訊息陣列.
 								#https://www.php.net/manual/en/function.proc-get-status.php
 								#備註:
 								#若需要取得當下的執行狀況,請使用 self::proc_update 來更新.
 								$proc=threads::proc($conf["threads::proc"]);
 								unset($conf["threads::proc"]);
 								#如果執行失敗
 								if($proc["status"]==="false"){
 									#設置執行失敗
 									$result["status"]="false";
 									#設置錯誤訊息
 									$result["error"]=$proc;
 									#回傳結果
 									return $result;
 									}#if end
 								#函式說明:
 								#使用 linux 的 uuid 指令來產生 uuid 字串
 								#回傳結果:
 								#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 								#$result["error"],錯誤訊息.
 								#參考資料:
 								#無.
 								#備註:
 								#無.
 								$uuid=cmd::uuid();
 								#如果執行失敗
 								if($uuid["status"]==="false"){
 									#設置執行失敗
 									$result["status"]="false";
 									#設置錯誤訊息
 									$result["error"]=$uuid;
 									#回傳結果
 									return $result;
 									}#if end
 								#取得 uuid
 								$uuid=$uuid["content"];
 								#儲存到 server side 的 procs
 								$result["serverCache"]["serverSide"]["procs"][$uuid]=$proc;
 								#設置最後的檢查時間為當下
 								$result["serverCache"]["serverSide"]["procs"][$uuid]["latestAccessTime"]=time();
 								#設置要回覆的內容
 								$res=array("status"=>"true","content"=>$uuid);
 								#印出回的訊息
 								echo "response:".PHP_EOL.print_r($res,true);
 								#寫入回應的內容
 								fwrite($conn,json_encode($res).PHP_EOL);
 								#結束回應
 								fwrite($conn,PHP_EOL.PHP_EOL);
 								#關閉socket連線,將回應輸出.
 								fclose($conn);
 								#更新使用者id與最後一次來request的時間
 								$client[$request->id]["last_req_time"]=$last_req_time;
 								#等待下個要求
 								continue;
 								}#if end
 							#如果要查詢程序執行的狀況
 							if(isset($request->QueryProcByUUID)){
 								#如果沒有 proc 資訊
 								if(!isset($result["serverCache"]["serverSide"]["procs"])){
 									#設置要回覆的內容
 									$res=array("status"=>"true","content"=>"");
 									#印出回的訊息
 									echo "response:".PHP_EOL.print_r($res,true);
 									#寫入回應的內容
 									fwrite($conn,json_encode($res).PHP_EOL);
 									#結束回應
 									fwrite($conn,PHP_EOL.PHP_EOL);
 									#關閉socket連線,將回應輸出.
 									fclose($conn);
 									#更新使用者id與最後一次來request的時間
 									$client[$request->id]["last_req_time"]=$last_req_time;
 									#等待下個要求
 									continue;
 									}#if end
 								#函式說明:
 								#更新透過proc執行的多程序資訊.
 								#回傳結果:
 								#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 								#$reuslt["error"],執行不正常結束的錯訊息陣列.
 								#無.
 								#備註:
 								#無.
 								$proc_update=threads::proc_update($conf["threads::proc_update"]);
 								unset($conf["threads::proc_update"]);
 								#如果執行失敗
 								if($proc_update["status"]==="false"){
 									#設置執行失敗
 									$result["status"]="false";
 									#設置錯誤訊息
 									$result["error"]=$proc_update;
 									#回傳結果
 									return $result;
 									}#if end
 								#更新 serverSide 的 proc cache
 								$result["serverCache"]["serverSide"]["procs"][$request->QueryProcByUUID]["content"]=$proc_update["content"];
 								#設置最後檢查的時間
 								$result["serverCache"]["serverSide"]["procs"][$request->QueryProcByUUID]["latestAccessTime"]=time();
 								#印出子程序的資訊
 								echo "proc info:".PHP_EOL.print_r($proc_update["content"][0],true);
 								#初始化要回傳的內容
 								$res=array();
 								#設置 pid
 								$res["pid"]=$proc_update["content"][0]["proc_get_status"]["pid"];
 								#設置輸入的內容
 								$res["input"]=$proc_update["content"][0]["input"];
 								#預設設置已經結束執行
 								$res["running"]="false";
 								#如果尚在執行
 								if($proc_update["content"][0]["statusCode"]==="?"){
 									#設置正在執行
 									$res["running"]="true";
 									}#if end
 								#如果已經結束執行
 								if($res["running"]==="false"){
 									#設置執行後得到的標準輸出
 									$res["output"]=$proc_update["content"][0]["content"];
 									#設置執行後得到的錯誤輸出
 									$res["error"]=$proc_update["content"][0]["error"];
 									}#if end
 								#設置回應正常
 								$res["status"]="true";
 								#印出回的訊息
 								echo "response:".PHP_EOL.print_r($res,true);
 								#寫入回應的內容
 								fwrite($conn,json_encode($res).PHP_EOL);
 								#結束回應
 								fwrite($conn,PHP_EOL.PHP_EOL);
 								#關閉socket連線,將回應輸出.
 								fclose($conn);
 								#更新使用者id與最後一次來request的時間
 								$client[$request->id]["last_req_time"]=$last_req_time;
 								#等待下個要求
 								continue;
 								}#if end
 							#debug
 							#var_dump(__LINE__,$conn,$client[$request->id]);
 							#如果存在 addOnProcessFunc
 							if(isset($conf["addOnProcessFunc"])){
 								#針對每個 addOnProcessFunc
 								foreach($conf["addOnProcessFunc"] as $addOnProcessFunc){
 									#如果有設置 infoToFunction
 									if(isset($conf["infoToFunction"])){
 										#設置info
 										$client[$request->id]["info"]=&$conf["infoToFunction"];
 										}#if end
 									#設置client cache
 									$client[$request->id]["clientCache"]=&$clientCache;
 									#呼叫 $addOnProcessFunc 函式,參數用 $client[$request->id]， 取得執行後的回應.
 									eval("\$call_user_func=".$addOnProcessFunc."(\$client[\$request->id]);");
 									/* debug
 									#函式說明:
 									#撰寫log
 									#回傳結果:
 									#$result["status"],狀態,"true"或"false".
 									#$result["error"],錯誤訊息陣列.
 									#無.
 									#備註:
 									#無.
 									$record=logs::record($conf["logs::record"]);
 									unset($conf["logs::record"]);
 									#如果執行失敗
 									if($record["status"]==="false"){
 										#設置執行錯誤識別
 										$result["status"]="false";
 										#設置執行錯誤
 										$result["error"]=$record;
 										#回傳結果
 										return $result;
 										}#if end
 									*/
 									#如果回應不是 array
 									if(gettype($call_user_func)!=="array"){
 										#設置執行失敗
 										$result["status"]="false";
 										#設置錯誤訊息
 										$result["error"][]=$call_user_func;
 										#設置錯誤訊息
 										$result["error"][]=$conf;
 										#印出error資訊
 										echo "error:".print_r($result,true);
 										#回應錯誤訊息給用戶
 										fwrite($conn,json_encode($result).PHP_EOL);
 										#結束回應
 										fwrite($conn,PHP_EOL.PHP_EOL);
 										#關閉socket連線,將回應輸出.
 										fclose($conn);
 										#回傳結果
 										return $result;
 										}#if end
 									#檢查回應的格式
 									#函式說明:
 									#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 									#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 									#$reuslt["error"],執行不正常結束的錯訊息陣列.
 									#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 									#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 									#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 									#必填寫的參數:
 									#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 									$conf["variableCheck::checkArguments"]["varInput"]=&$call_user_func;
 									#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 									$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 									#可以省略的參數:
 									#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 									$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("status");
 									#$conf["canBeEmpty"]=array();
 									#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 									#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("function","continue");
 									#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 									$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("function","continue","content","cache","argu","error");
 									#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 									$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string",null,"array","array","array");
 									#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 									$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array($addOnProcessFunc,"true",null,null,null,null);
 									#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 									#$conf["disallowAllSkipableVarIsEmpty"]="";
 									#$conf["arrayCountEqualCheck"][]=array();
 									#參考資料來源:
 									#array_keys=>http://php.net/manual/en/function.array-keys.php
 									$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 									unset($conf["variableCheck::checkArguments"]);
 									#如果檢查參數失敗
 									if($checkArguments["status"]==="false"){
 										#設置執行失敗
 										$result["status"]="false";
 										#設置錯誤訊息
 										$result["error"]=$checkArguments;
 										#印出error資訊
 										echo "error:".print_r($result,true);
 										#回應錯誤訊息給用戶
 										fwrite($conn,json_encode($result).PHP_EOL);
 										#結束回應
 										fwrite($conn,PHP_EOL.PHP_EOL);
 										#關閉socket連線,將回應輸出.
 										fclose($conn);
 										#回傳結果
 										return $result;
 										}#if end
 									#如果檢查參數不通過
 									if($checkArguments["passed"]==="false"){
 										#設置執行失敗
 										$result["status"]="false";
 										#設置錯誤訊息
 										$result["error"]=$checkArguments;
 										#印出error資訊
 										echo "error:".print_r($result,true);
 										#回應錯誤訊息給用戶
 										fwrite($conn,json_encode($result).PHP_EOL);
 										#結束回應
 										fwrite($conn,PHP_EOL.PHP_EOL);
 										#關閉socket連線,將回應輸出.
 										fclose($conn);
 										#回傳結果
 										return $result;
 										}#if end
 									#如果回應不正常
 									if($call_user_func["status"]==="false"){
 										#設置執行失敗
 										$result["status"]="false";
 										#設置錯誤訊息
 										$result["error"][]=$call_user_func;
 										#設置錯誤訊息
 										$result["error"][]=$conf;
 										#印出error資訊
 										echo "error:".print_r($result,true);
 										#回應錯誤訊息給用戶
 										fwrite($conn,json_encode($result).PHP_EOL);
 										#結束回應
 										fwrite($conn,PHP_EOL.PHP_EOL);
 										#關閉socket連線,將回應輸出.
 										fclose($conn);
 										#回傳結果
 										return $result;
 										}#if end
 									#如果回應有 content 元素
 									if(isset($call_user_func["content"])){
 										#用收到 content 元素內容來更新 $client[id]["request"]
 										$client[$request->id]["request"]=$call_user_func["content"];
 										}#if end
 									#如果回傳 cache 元素
 									if(isset($call_user_func["cache"])){
 										#用收到 cache 元素內容來更新 server side 的 cache
 										$result["serverCache"]["clientSide"]["addOnProcessFunc"][$addOnProcessFunc]=&$call_user_func["cache"];
 										}#if end
 									#如果回應不要往後面執行
 									if($call_user_func["continue"]==="false"){
 										#結束 foreach
 										break;
 										}#if end
 									}#foreach end
 								}#if end
 							#執行到這代表是要保持連線
 							#設置執行正常
 							$res["status"]="true";
 							#印出回的訊息
 							echo "response:".PHP_EOL.print_r($res,true);
 							#debug
 							#var_dump(__LINE__,$conn,get_resource_type($conn));
 							#如果資源形態沒有異常(用戶關閉連線後,會有resource type變成"Unknown"的結果)
 							if(get_resource_type($conn)!=="Unknown"){
 								#函式說明:
 								#用fwrite寫入到resource,可以指定每個寫入字串的結尾方式.
 								#回傳結果:
 								#$result["status"],執行是否正常,"true"為正常,"false"為不正常.
 								#$result["error"],錯誤訊息陣列.
 								#https://www.php.net/manual/en/function.socket-get-status.php
 								#備註:
 								#無.
 								$fwrite=sock::fwrite($conf["sock::fwrite"]);
 								unset($conf["sock::fwrite"]);
 								#如果執行失敗
 								if($fwrite["status"]==="false"){
 									#如果有 is_writable
 									if(isset($fwrite["is_writable"])){
 										#如果有 is_writable
 										if($fwrite["is_writable"]==="true"){
 											#設置執行失敗
 											$result["status"]="false";
 											#設置錯誤訊息
 											$result["error"]=$fwrite;
 											#印出error資訊
 											echo "error:".print_r($result,true);
 											#結束並回傳1給shell
 											exit(1);
 											}#if end
 										}#if end
 									#反之
 									else{
 										#設置執行失敗
 										$result["status"]="false";
 										#設置錯誤訊息
 										$result["error"]=$fwrite;
 										#印出error資訊
 										echo "error:".print_r($result,true);
 										#結束並回傳1給shell
 										exit(1);
 										}#else end
 									}#if end
 								}#if end
 							#更新使用者id與最後一次來request的時間
 							$client[$request->id]["last_req_time"]=$last_req_time;
 							#印出用戶端列表
 							echo "clients:".print_r($client,true);
 							#等待下個要求
 							continue;
 							}#if end
 						#socket 陣列不是我們建立的 socket
 						else{
 							#顯示 socket 的狀態
 							var_dump("socket_get_status".socket_get_status($conn));
 							}#else end
 						}#foreach end
 					}#else end
 				}#while end
 			#關閉 unix domain socket
 			fclose($socket);
 			}#else end
 		}#function unixDomainSockServer end
 	/*
 	#函式說明:
 	#連線到 unixDomainSockServer 提供的 unix domain socket.
 	#回傳結果:
 	#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 	#http://php.net/manual/en/function.stream-get-contents.php
 	#備註:
 	#無.
 	*/
 	public static function unixDomainSockClient(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sock");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("id","cmd","param","escaped","custom");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("id","cmd","param","escaped","custom","raw");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","array","string","array","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,null,null,"false",null,null);
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查 unix socket 檔案 $conf["sock"] 是否存在.
 		#函式說明:
 		#檢查多個檔案與資料夾是否存在.
 		#回傳的結果:
 		#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
 		#備註:
 		#函數file_exists檢查的路徑為檔案系統的路徑
 		#$result["varName"][$i]結果未實作
 		$checkMultiFileExist=fileAccess::checkMultiFileExist($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查失敗
 		if($checkMultiFileExist["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkMultiFileExist;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查失敗
 		if($checkMultiFileExist["allExist"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkMultiFileExist;
 			#回傳結果
 			return $result;
 			}#if end
 		#初始化取得的回應
 		$result["content"]="";
 		#debug
 		#var_dump(__LINE__,"before connect");
 		#嘗試30秒內連線到 unix domain socket
 		$fp=@stream_socket_client("unix://".$conf["sock"], $errno, $errstr, 30, STREAM_CLIENT_ASYNC_CONNECT );
 		#如果開啟 unix domain socket 失敗
 		if(!$fp){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$errstr." (".$errno.")";
 			#回傳結果
 			return $result;
 			}#if end
 		#反之開啟 unix domain socket 成功,且沒有raw參數存在
 		else if(!isset($conf["raw"])){
 			#初始化要傳送的要求
 			$req=array();
 			#如果有設置 $conf["id"]
 			if(isset($conf["id"])){
 				#設置識別自己的id
 				$req["id"]=$conf["id"];
 				}#if end
 			#如果有設置 $conf["cmd"]
 			if(isset($conf["cmd"])){
 				#設置要執行的指令
 				$req["cmd"]=$conf["cmd"];
 				}#if end
 			#如果有設置 $conf["param"]
 			if(isset($conf["param"])){
 				#設置要執行的指令參數
 				$req["param"]=$conf["param"];
 				#設置參數是否已經escaped
 				$req["escaped"]=$conf["escaped"];
 				}#if end
 			#如果有設置 $conf["custom"]
 			if(isset($conf["custom"])){
 				#用 $conf["custom"] 來取代 $req
 				$req=$conf["custom"];
 				#如果有設置 $conf["id"]
 				if(isset($conf["id"])){
 					#設置識別自己的id
 					$req["id"]=$conf["id"];
 					}#if end
 				}#if end
 			#debug
 			#var_dump(__LINE__,"before write ".json_encode($req));
 			#傳送要求
 			fwrite($fp,json_encode($req).PHP_EOL);
 			#結束要求
 			fwrite($fp,PHP_EOL.PHP_EOL);
 			#如果回應為空
 			while(strlen($result["content"])<2){
 				#當有回應時
 				while(!feof($fp)){
 					#讀取回應
 					$tmp=fgets($fp, 1024);
 					#debug
 					#var_dump($tmp);
 					#debug
 					#var_dump(__LINE__,"got ".$tmp);
 					#如果讀到 PHP_EOL
 					if($tmp===PHP_EOL){
 						#結束讀取回應
 						break 2;
 						}#if end
 					#串接回應
 					$result["content"]=$result["content"].$tmp;
 					}#while end
 				}#while end
 			#關閉 socket
 			fclose($fp);
 			}#else end
 		#反之有有raw參數存在
 		else{
 			#傳送要求
 			fwrite($fp,trim($conf["raw"]).PHP_EOL);
 			#當有回應時
 			while(!feof($fp)){
 				#讀取回應
 				$tmp=fgets($fp, 1024);
 				#debug
 				#var_dump($tmp);
 				#debug
 				#var_dump(__LINE__,"got ".$tmp);
 				#如果讀到 PHP_EOL
 				if($tmp===PHP_EOL){
 					#結束讀取回應
 					break;
 					}#if end
 				#串接回應
 				$result["content"]=$result["content"].$tmp;
 				}#while end
 			#關閉 socket
 			fclose($fp);
 			}#else end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function unixDomainSockClient end
 	/*
 	#函式說明:
 	#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 	#回傳結果:
 	#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function execAnyCmdByQBPWCFunixSocket(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("fileArgu","command");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("sock");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("sock","argu","commandIncludeArgu","commandInBg");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","array","string","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(qbpwcf_usock_path,array(),"false","false");
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果指令已經包含參數了
 		if($conf["commandIncludeArgu"]==="true"){
 			#函式說明:
 			#將指令字串解析成陣列,方便給予 external::callShell 使用
 			#回傳結果:
 			#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 			#$reuslt["error"],執行不正常結束的錯訊息陣列.
 			#$result["function"],當前執行的函式名稱.
 			#$result["content"],解析好的指令陣列.
 			#無.
 			#備註:
 			#無.
 			$parseCmdString=cmd::parseCmdString($conf["cmd::parseCmdString"]);
 			unset($conf["cmd::parseCmdString"]);
 			#debug
 			#var_dump(__FUNCTION__,__LINE__,$parseCmdString);exit;
 			#如果執行失敗
 			if($parseCmdString["status"]==="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$parseCmdString;
 				#回傳結果
 				return $result;
 				}#if end
 			#取得解析好的指令名稱
 			$conf["command"]=$parseCmdString["cmd"];
 			#取得解析好的參數陣列
 			$conf["argu"]=$parseCmdString["argus"];
 			#debug
 			#var_dump(__LINE__,$parseCmdString);
 			}#if end
 		#函式說明:
 		#呼叫shell執行系統命令,並取得回傳的內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#備註:
 		#不是所有指令都能用apache的身份執行,目前已知java,javac指令無法執行,使用root身份可能會被selinux阻擋.
 		#若使用的 command、argu 參數，含有 ~ 則會被視為字串，若有需要其於 shell 中代表的家目錄位置，可用 fileAccess::tildeToPath 來進行轉換.
 		$callShell=external::callShell($conf["external::callShell"]);
 		unset($conf["external::callShell"]);
 		#debug
 		#var_dump(__LINE__,$callShell);
 		#如果檢查參數作業出錯
 		if($callShell["status"]=="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$callShell;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#連線到 unixDomainSockServer 提供的 unix domain socket.
 		#回傳結果:
 		#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 		#$result["error"],錯誤訊息陣列.
 		#$conf["param"],參數陣列.
 		$conf["sock::unixDomainSockClient"]["param"]=$callShell["escape"]["argu"];
 		#$conf["escaped"],字串,param參數是否已經escaped了,預設為"false",反之為"true".
 		$conf["sock::unixDomainSockClient"]["escaped"]="true";
 		#$conf["custom"],陣列,要客制化傳輸的內容,會覆蓋以上除了$conf["id"]以外的可省略參數.
 		#如果要在背景執行指令
 		if($conf["commandInBg"]==="true" && isset($conf["sock::unixDomainSockClient"]["cmd"]) ){
 			#設定要在背景執行的指令
 			$conf["sock::unixDomainSockClient"]["custom"]["cmdInBg"]=$conf["sock::unixDomainSockClient"]["cmd"];
 			#設定要在背景執行的指令
 			$conf["sock::unixDomainSockClient"]["custom"]["param"]=$conf["sock::unixDomainSockClient"]["param"];
 			#移除不要的參數
 			unset($conf["sock::unixDomainSockClient"]["cmd"]);
 			#移除不要的參數
 			unset($conf["sock::unixDomainSockClient"]["param"]);
 			#保存 custom 參數
 			$custom=$conf["sock::unixDomainSockClient"]["custom"];
 			#debug
 			#var_dump(__LINE__,$custom);
 			}#if end
 		#$conf["raw"],字串,要直接傳送的字串內容,會忽略其他可省略參數.
 		#$conf["raw"]="";
 		#參考資料:
 		#http://php.net/manual/en/function.stream-socket-client.php
 		#http://php.net/manual/en/function.stream-get-contents.php
 		#備註:
 		#無.
 		$paramsOfUnixDomainSockClient=$conf["sock::unixDomainSockClient"];
 		$unixDomainSockClient=sock::unixDomainSockClient($paramsOfUnixDomainSockClient);
 		unset($paramsOfUnixDomainSockClient);
 		#如果執行失敗
 		if($unixDomainSockClient["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#debug
 		#var_dump(__LINE__,$unixDomainSockClient);
 		#如果不是 json 字串
 		if(json_validate(trim($unixDomainSockClient["content"]))==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]=trim($unixDomainSockClient["content"])." is not json string!";
 			#設置錯誤訊息
 			$result["error"][]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得json回應
 		$jsonRes=json_decode(trim($unixDomainSockClient["content"]));
 		#debug
 		#var_dump(__LINE__,$jsonRes);
 		#如果執行失敗
 		if($jsonRes===null){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果沒有產生新id
 		if(!isset($jsonRes->id)){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#用新的id再傳送一次要求給 qbpwcf_usock_path
 		$paramsOfUnixDomainSockClient=$conf["sock::unixDomainSockClient"];
 		$paramsOfUnixDomainSockClient["id"]=$jsonRes->id;
 		#var_dump(__LINE__,$paramsOfUnixDomainSockClient);
 		$unixDomainSockClient=sock::unixDomainSockClient($paramsOfUnixDomainSockClient);
 		unset($paramsOfUnixDomainSockClient);
 		#如果執行失敗
 		if($unixDomainSockClient["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#debug
 		#var_dump(__LINE__,$unixDomainSockClient["content"]);
 		#如果輸出非 json
 		if(json_validate(trim($unixDomainSockClient["content"]))===false){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]="got not json output";
 			#設置錯誤訊息
 			$result["error"][]=json_last_error().":".json_last_error_msg();
 			#回傳結果
 			return $result;
 			}#if end
 		#取得json回應
 		$jsonRes=(array)json_decode($unixDomainSockClient["content"]);
 		#如果執行失敗
 		if($jsonRes===null){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果執行指令失敗
 		if($jsonRes["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$jsonRes["error"];
 			#回傳結果
 			return $result;
 			}#if end
 		#執行正常
 		$result["status"]="true";
 		#設置執行的結果
 		$result["content"]=$jsonRes;
 		#回傳結果
 		return $result;
 		}#public function execAnyCmdByQBPWCFunixSocket end
 	/*
 	#函式說明:
 	#詢問透過 sock::unixDomainSockServer 執行的程序狀況
 	#回傳結果:
 	#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function getProcInfo(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("uuid");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("sock");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("sock");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(qbpwcf_usock_path);
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		函式說明:
 		#連線到 unixDomainSockServer 提供的 unix domain socket.
 		#回傳結果:
 		#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 		#$result["error"],錯誤訊息陣列.
 		#備註:
 		#無.
 		$paramsOfUnixDomainSockClient=$conf["sock::unixDomainSockClient"];
 		$unixDomainSockClient=sock::unixDomainSockClient($paramsOfUnixDomainSockClient);
 		unset($paramsOfUnixDomainSockClient);
 		#如果執行失敗
 		if($unixDomainSockClient["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#debug
 		#var_dump(__LINE__,$unixDomainSockClient);
 		#如果不是 json 字串
 		if(json_validate(trim($unixDomainSockClient["content"]))==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]=trim($unixDomainSockClient["content"])." is not json string!";
 			#設置錯誤訊息
 			$result["error"][]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得json回應
 		$jsonRes=json_decode(trim($unixDomainSockClient["content"]));
 		#debug
 		#var_dump(__LINE__,$jsonRes);
 		#如果執行失敗
 		if($jsonRes===null){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果沒有產生新id
 		if(!isset($jsonRes->id)){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#用新的id再傳送一次要求給 qbpwcf_usock_path
 		$paramsOfUnixDomainSockClient=$conf["sock::unixDomainSockClient"];
 		$paramsOfUnixDomainSockClient["id"]=$jsonRes->id;
 		$unixDomainSockClient=sock::unixDomainSockClient($paramsOfUnixDomainSockClient);
 		unset($paramsOfUnixDomainSockClient);
 		#如果執行失敗
 		if($unixDomainSockClient["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#debug
 		#var_dump(__LINE__,$unixDomainSockClient["content"]);
 		#如果輸出非 json
 		if(json_validate(trim($unixDomainSockClient["content"]))===false){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]="got not json output";
 			#設置錯誤訊息
 			$result["error"][]=json_last_error().":".json_last_error_msg();
 			#設置原始訊息
 			$result["error"][]="ori res:".$unixDomainSockClient["content"];
 			#回傳結果
 			return $result;
 			}#if end
 		#取得json回應
 		$jsonRes=(array)json_decode($unixDomainSockClient["content"]);
 		#如果執行失敗
 		if($jsonRes===null){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果執行指令失敗
 		if($jsonRes["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$jsonRes["error"];
 			#回傳結果
 			return $result;
 			}#if end
 		#移除不需要的元素
 		unset($jsonRes["status"]);
 		#執行正常
 		$result["status"]="true";
 		#$result["content"],陣列,程序的資訊.
 		#$result["content"]["pid"],字串,程序的pid.
 		#$result["content"]["running"],字串,是否正常執行中.
 		#$result["content"]["statusCode"],字串,回傳給 shell 的代碼.
 		#$result["content"]["input"],字串,輸入的內容.
 		#$result["content"]["output"],字串,標準輸出的內容.
 		#$result["content"]["error"],字串,錯誤輸出的內容.
 		#初始執行的結果
 		$result["content"]=$jsonRes;
 		#回傳結果
 		return $result;
 		}#function getProcInfo end
 	/*
 	#函式說明:
 	#傳送 raw 訊息到  unix domain socket.
 	#回傳結果:
 	#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function sendRawMsgUnixSocket(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],執行不正常結束的錯訊息陣列.
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		#備註:
 		#無.
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果執行失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments["error"];
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkArguments["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments["error"];
 			#回傳結果
 			return $result;
 			}#if end
 		#讓存放unix domain socket的路徑存在
 		#函式說明:
 		#確保路徑存在.
 		#回傳結果:
 		#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
 		#無.
 		#備註:
 		#無.
 		$validatePath=fileAccess::validatePath($conf["fileAccess::validatePath"]);
 		unset($conf["fileAccess::validatePath"]);
 		#如果執行失敗
 		if($validatePath["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$validatePath;
 			#回傳結果
 			return $result;
 			}#if end
 		#變更 working dir
 		$chdir=chdir($validatePath["path"]);
 		#嘗試30秒內連線到 unix domain socket
 		$fp=stream_socket_client("unix://".$validatePath["fileName"], $errno, $errstr, 30, STREAM_CLIENT_ASYNC_CONNECT );
 		#如果開啟 unix domain socket 失敗
 		if(!$fp){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$errstr." (".$errno.")";
 			#回傳結果
 			return $result;
 			}#if end
 		#傳遞訊息
 		$fwrite=fwrite($fp,$conf["msg"]);
 		#如果傳遞失敗
 		if($fwrite===false){
 			#關閉unix domain socket
 			@fclose($fp);
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="傳遞訊息(".$conf["msg"].")失敗";
 			#回傳結果
 			return $result;
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function sendRawMsgUnixSocket
 	/*
 	#連線到 sock::unixDomainSocketServer 產生的  unix domain socket,傳送指定的訊息.
 	#回傳結果:
 	#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 	#$result["error"],錯誤訊息陣列.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function sendAnyMsgToQBPWCFunixSocket(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],執行不正常結束的錯訊息陣列.
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		#備註:
 		#無.
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果執行失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments["error"];
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkArguments["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments["error"];
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#連線到 unixDomainSockServer 提供的 unix domain socket.
 		#回傳結果:
 		#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 		#$result["error"],錯誤訊息陣列.
 		#備註:
 		#無.
 		$paramsOfUnixDomainSockClient=$conf["sock::unixDomainSockClient"];
 		$unixDomainSockClient=sock::unixDomainSockClient($conf["sock::unixDomainSockClient"]);
 		unset($conf["sock::unixDomainSockClient"]);
 		#如果執行失敗
 		if($unixDomainSockClient["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得json回應
 		$jsonRes=json_decode($unixDomainSockClient["content"]);
 		#如果執行失敗
 		if($jsonRes===null){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果沒有產生新id
 		if(!isset($jsonRes->id)){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#用新的id再傳送一次要求給 qbpwcf_usock_path
 		$paramsOfUnixDomainSockClient["id"]=$jsonRes->id;
 		$unixDomainSockClient=sock::unixDomainSockClient($paramsOfUnixDomainSockClient);
 		unset($paramsOfUnixDomainSockClient);
 		#如果執行失敗
 		if($unixDomainSockClient["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得回應
 		$result["content"]=$unixDomainSockClient["content"];
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function sendAnyMsgToQBPWCFunixSocket end
 	/*
 	#函式說明:
 	#重複連線到 unixDomainSockServer 提供的 unix domain socket, 避免其 listen timeout, 並清除逾時的連線.
 	#回傳結果:
 	#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function keepAliveUnixDomainSockConnection(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#涵式說明：
 		#判斷當前環境為web還是cmd
 		#回傳結果：
 		#$result,"web"或"cmd"
 		if(csInformation::getEnv()==="web"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="函數 ".$result["function"]." 僅能在命令列環境下運行!";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sock");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("id","cmd","param","clear");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("id","cmd","param","clear");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","array","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array();
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#連線到 unixDomainSockServer 提供的 unix domain socket.
 		#回傳結果:
 		#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 		#$result["error"],錯誤訊息陣列.
 		#參考資料:
 		#http://php.net/manual/en/function.stream-socket-client.php
 		#http://php.net/manual/en/function.stream-get-contents.php
 		$unixDomainSockClient=sock::unixDomainSockClient($conf["sock::unixDomainSockClient"]);
 		unset($conf["sock::unixDomainSockClient"]);
 		#建立連線失敗
 		if($unixDomainSockClient["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得回應
 		$res=$unixDomainSockClient["content"];
 		#解析回應
 		$res=json_decode(trim($res));
 		#如果解析失敗
 		if($res===false){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="解析回應失敗";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得id
 		$id=$res->id;
 		#無窮迴圈
 		while(true){
 			#函式說明:
 			#連線到 unixDomainSockServer 提供的 unix domain socket.
 			#回傳結果:
 			#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 			#$result["error"],錯誤訊息陣列.
 			#參考資料:
 			#http://php.net/manual/en/function.stream-socket-client.php
 			#http://php.net/manual/en/function.stream-get-contents.php
 			$unixDomainSockClient=sock::unixDomainSockClient($conf["sock::unixDomainSockClient"]);
 			unset($conf["sock::unixDomainSockClient"]);
 			#建立連線失敗
 			if($unixDomainSockClient["status"]==="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置執行錯誤訊息
 				$result["error"]=$unixDomainSockClient;
 				#回傳結果
 				return $result;
 				}#if end
 			#取得回應
 			$res=$unixDomainSockClient["content"];
 			#解析回應
 			$res=json_decode($res);
 			#如果解析失敗
 			if($res===false){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置執行錯誤訊息
 				$result["error"][]="解析回應失敗";
 				#回傳結果
 				return $result;
 				}#if end
 			#show res
 			var_dump($res);
 			#停止執行
 			sleep(60);
 			}#while end
 		#設置執行不正常
 		$result["status"]="false";
 		#設置錯誤訊息
 		$result["error"][]="程式不應該中斷";
 		#回傳結果
 		return $reuslt;
 		}#function keepAliveUnixDomainSockConnection end
 	/*
 	#函式說明:
 	#tcp client
 	#https://www.php.net/manual/en/function.socket-get-option.php
 	#備註:
 	#無.
 	*/
 	public static function tcpClient(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#涵式說明：
 		#判斷當前環境為web還是cmd
 		#回傳結果：
 		#$result,"web"或"cmd"
 		if(csInformation::getEnv()==="web"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="函數 ".$result["function"]." 僅能在命令列環境下運行!";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#初始化取得的回應
 		$result["content"]="";
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("port","dataToSend");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("ip");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("ip","sec","microSec");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","integer","integer");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("127.0.0.1",5,0);
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#建立 tcp socket client
 		$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
 		#設置接收資料的最長等待時間
 		socket_set_option($socket, SOL_SOCKET, SO_RCVTIMEO, array("sec"=>$conf["sec"],"usec"=>$conf["microSec"]));
 		#如果建立 socket 失敗
 		if ($socket === false) {
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]="socket_create() failed: reason: " . socket_strerror(socket_last_error());
 			#回傳結果
 			return $result;
 			}#if end
 		#連線到 tcp socket server
 		$socket_connect = socket_connect($socket, $conf["ip"], $conf["port"]);
 		#如果連線到 tcp socket server 失敗
 		if ($socket_connect === false) {
 			#設置執行失敗
 			$result["status"]="false";
 	    		#設置錯誤訊息
 			$result["error"][]="socket_connect() failed. Reason: ($result) " . socket_strerror(socket_last_error($socket));
 			#回傳結果
 			return $result;
 			}#if end
 		#傳送訊息到 tcp server
 		socket_write($socket, $conf["dataToSend"].PHP_EOL, strlen($conf["dataToSend"].PHP_EOL));
 		#取得回應
 		while ($out = socket_read($socket, 2048)) {
 			#設置取得的回應
 			$result["content"]=$result["content"].$out;
 			#debug
 			#echo $result["content"];
 			}#while end
 		#關閉socket
 		socket_close($socket);
 		#設置處理正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function tcpClient end
 	/*
 	#函式說明:
 	#udp client
 	#https://www.php.net/manual/en/sockets.examples.php
 	#備註:
 	#無.
 	*/
 	public static function udpClient(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#涵式說明：
 		#判斷當前環境為web還是cmd
 		#回傳結果：
 		#$result,"web"或"cmd"
 		if(csInformation::getEnv()==="web"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="函數 ".$result["function"]." 僅能在命令列環境下運行!";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#初始化取得的回應
 		$result["content"]="";
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("port","dataToSend");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("ip","secSleepAfterSend","closeAtEnd","timeout");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("ip","secSleepAfterSend","closeAtEnd","sock","timeout");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","integer","string","object","integer");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("127.0.0.1",1,"false",null,10);
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果沒有指定要用既有的 socket
 		if(!isset($conf["sock"])){
 			#建立 udp socket client
 			$socket = socket_create(AF_INET, SOCK_DGRAM, SOL_UDP);
 			#設置 timeout 為 $conf["timeout"] 秒
 			$timeout = array('sec'=>$conf["timeout"],'usec'=>0);
  			socket_set_option($socket,SOL_SOCKET,SO_RCVTIMEO,$timeout);
  			#如果建立 socket 失敗
 			if ($socket === false) {
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"][]="socket_create() failed: reason: " . socket_strerror(socket_last_error());
 				#回傳結果
 				return $result;
 				}#if end
 			#連線到 udp socket server
 			$socket_connect = socket_connect($socket, $conf["ip"], $conf["port"]);
 			#如果連線到 udp socket server 失敗
 			if ($socket_connect === false) {
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"][]="socket_connect() failed. Reason: ($result) " . socket_strerror(socket_last_error($socket));
 				#回傳結果
 				return $result;
 				}#if end
 			}#if end
 		#反之
 		else{
 			#取得要重複使用的socket
 			$socket=&$conf["sock"];
 			}#else end
 		#有幾個訊息就跑幾次
 		for($i=0;$i<count($conf["dataToSend"]);$i++){
 			#傳送訊息到 tcp server
 			socket_write($socket, $conf["dataToSend"][$i], strlen($conf["dataToSend"][$i]));
 			#取得回應
 			while ($out = socket_read($socket, 2048)) {
 				#設置取得的回應,儲存到陣列裡面.
 				$result["contentArray"][]=$out;
 				#設置取得的回應,儲存成字串,串接在一塊.
 				$result["content"]=$result["content"].$out;
 				}#while end
 			#如果有多個訊息要傳遞,且不是最後一個訊息
 			if(count($conf["dataToSend"])>1 && $i!==count($conf["dataToSend"])-1){
 				#休息一下
 				sleep($conf["secSleepAfterSend"]);
 				}#if end
 			}#for end
 		#如果要關閉連線
 		if($conf["closeAtEnd"]==="true"){
 			#關閉socket
 			socket_close($socket);
 			}#if end
 		#取得使用的socket
 		$result["sock"]=$socket;
 		#設置處理正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function udpClient end
 	/*
 	#函式說明:
 	#建立tcp server
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#涵式說明：
 		#判斷當前環境為web還是cmd
 		#回傳結果：
 		#$result,"web"或"cmd"
 		if(csInformation::getEnv()==="web"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="函數 ".$result["function"]." 僅能在命令列環境下運行!";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("port");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("ip","welcomeMsg");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("ip","processFuncs","welcomeMsg","socketSelectTimeountSec","socketSelectTimeountUsec","serverFuncs");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","array","string","integer","integer","array");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("0.0.0.0",array(),"true",0,null,null);
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#程式不會 timeout
 		set_time_limit(0);
 		#Turn on implicit output flushing so we see what we're getting as it comes in.
 		ob_implicit_flush();
 		#無窮迴圈
 		do {
 			#each resource
 			foreach($clients as $rk=>$csock){
 				#if not socket resource
 				if(get_resource_type($csock)!=="Socket"){
 					#delete
 					unset($clients[$rk]);
 					}#if end
 				}#foreach end
 			#found server sock
 			$serverSock=false;
 			#each resource
 			foreach($clients as $rk=>$csock){
 				#if not socket resource
 				if($rk==="serverSock"){
 					#found server sock
 					$serverSock=true;
 					}#if end
 				}#if end
 			#not found server sock
 			if(!$serverSock){
 				#end
 				exit;
 				}#if end
 			#for socket select
 			$read   = $clients;
 			$write  = NULL;
 			$except = NULL;
 			#如果沒設定微妙
 			if(!isset($conf["socketSelectTimeountUsec"])){
 				#get interesting socket
 				$num_changed_sockets = socket_select($read, $write, $except, $conf["socketSelectTimeountSec"]);
 				}#if end
 			#反之有設定微妙
 				}#else end
 			#socket_select failed
 			if ($num_changed_sockets === false) {
 				#NOTICE to server
 				echo "socket_select failed".PHP_EOL;
 				}
 			#At least at one of the sockets something interesting happened
 			else if ($num_changed_sockets > 0) {
 				/* debug
 				echo "At least at one of the sockets something interesting happened".PHP_EOL;
 				echo "\$read:".PHP_EOL;var_dump($read);
 				echo "\$write:".PHP_EOL;var_dump($write);
 				echo "\$except:".PHP_EOL;var_dump($except);
 				*/
 				// check if there is a client trying to connect
 				if (in_array($sock, $read)) {
 					#accept the client, and add him to the $clients array
 				   	$clients[] = $newsock = socket_accept($sock);
 				   	#如果要顯示歡迎訊息
 					if($conf["welcomeMsg"]==="true"){
 				   		#send the client a welcome message
 				   		socket_write($newsock, "Welcome to QBPWCF tcpServer".PHP_EOL.
 				   		"There are ".(count($clients) - 1)." client(s) connected to the server".PHP_EOL);
 				   		}#if end
 					#嘗試取得遠端的ip與port
 					#參考資料:https://www.php.net/manual/en/function.socket-getpeername.php
 				 	@socket_getpeername($newsock, $ip);
 					#如果有抓到 $ip
 					if(isset($ip)){
 						#提示有新的使用者
 						echo "New client connected: ".$ip.PHP_EOL;
 						}#if end
 					// remove the listening socket from the clients-with-data array
 					$key = array_search($sock, $read);
 					unset($read[$key]);
+					}
 				#message received
 				else{
 					// loop through all the clients that have data to read from
 					foreach ($read as $read_sock) {
 						// read until newline or 1024 bytes
 						// socket_read while show errors when the client is disconnected, so silence the error messages
 						$data = @socket_read($read_sock, 1024, PHP_NORMAL_READ);
 						// check if the client is disconnected
 						if ($data === false)
+						{
 							// remove client for $clients array
 							$key = array_search($read_sock, $clients);
 							unset($clients[$key]);
 							echo "client disconnected.".PHP_EOL;
 							// continue to the next client to read from, if any
 							continue;
+						}
 						// trim off the trailing/beginning white spaces
 						$data = trim($data);
 						// check if there is any data after trimming off the spaces
 						if(!empty($data)){
 							// send this to all the clients in the $clients array (except the first one, which is a listening socket)
 							foreach ($clients as $send_sock) {
 								// if its the listening sock or the client that we got the message from, go to the next one in the list
 								#如果是Server Socket
 								if ($send_sock === $sock){
 									#server debug
 									echo "reveiced:".$data.PHP_EOL;
 									#針對每個用來處理輸入字串的函式
 									foreach($conf["processFuncs"] as $proFunc){
 										#呼叫函式,參數為輸入的字串data跟client socket, server socket, 每個 socket
 										#https://www.php.net/manual/en/function.call-user-func.php
 										$param=array("data"=>$data,"serverSock"=>$sock,"clientSock"=>$read_sock,"allSockArray"=>$clients);
 										$params=array();
 										$params[]=&$param;
 										$result=call_user_func_array($proFunc,$params);
 										#如果有回傳結果
 										if($result!==NULL){
 											#如果執行出錯
 											if($result["status"]==="false"){
+									}
 								/*
 								#如果是Sender Socket
 								else if ($send_sock === $read_sock){
 									continue;
+									}
 								*/
 								/*
 								#msg to others/broadcast
 								else{
 						    			// write the message to the client -- add a newline character to the end of the message
 						    			socket_write($send_sock, $data.PHP_EOL);
 									}//end of broadcast
 								*/
 								} //foreach end
 							}#if end
 						} // end of reading foreach
 					}#msg received end
 				}#something happen end
 			#反之沒有用戶插手
 			else{
 				#提示idle
 				#echo "idle:".time().PHP_EOL;
 				#如果沒有設置 $conf["serverFuncs"]
 				if(!isset($conf["serverFuncs"])){
 					#設置為空陣列
 					$conf["serverFuncs"]=array();
 					}#if end
 				#針對每個用來處理輸入字串的函式
 				foreach($conf["serverFuncs"] as $proFunc){
 					#呼叫函式,參數為輸入的字串data跟client socket, server socket, 每個 socket
 					#https://www.php.net/manual/en/function.call-user-func.php
 					$result=call_user_func_array($proFunc,array());
 					#如果有回傳結果
 					if($result!==NULL){
 						#如果執行出錯
 							}//if end
 						}//if end
 					}//foreach end
 				}#else end
 			} while (true);
 		#關閉listen的socket
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#涵式說明：
 		#判斷當前環境為web還是cmd
 		#回傳結果：
 		#$result,"web"或"cmd"
 		if(csInformation::getEnv()==="web"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="函數 ".$result["function"]." 僅能在命令列環境下運行!";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("port");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("ip","welcomeMsg","socketSelectTimeountUsec");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("ip","processFuncs","welcomeMsg","socketSelectTimeountSec","socketSelectTimeountUsec");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","array","string","integer","integer");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("0.0.0.0",array(),"true",0,null);
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#Allow the script to hang around waiting for connections.
 		set_time_limit(0);
 		#Turn on implicit output flushing so we see what we're getting as it comes in.
 		ob_implicit_flush();
 		#無窮迴圈
 		do {
 			#each resource
 			foreach($clients as $rk=>$csock){
 				#if not socket resource
 				if(gettype($csock)==="boolean"){
 					#delete
 					unset($clients[$rk]);
 				else if(get_resource_type($csock)!=="Socket"){
 					#delete
 					unset($clients[$rk]);
 					}
+				}
 			#found server sock
 			$serverSock=false;
 			#each resource
 			foreach($clients as $rk=>$csock){
 				#if not socket resource
 				if($rk==="serverSock"){
 					#found server sock
 					$serverSock=true;
 					}
+				}
 			#not found server sock
 			if(!$serverSock){
 				#end
 				exit;
+				}
 			#for socket select
 			$read   = $clients;
 			$write  = NULL;
 			$except = NULL;
 			#如果未設置 $conf["socketSelectTimeountUsec"]
 			if(!isset($conf["socketSelectTimeountUsec"])){
 				#get interesting socket
 				$num_changed_sockets = socket_select($read, $write, $except, $conf["socketSelectTimeountSec"]);
 				}#if end
 			#反之有設置 $conf["socketSelectTimeountUsec"]
 			else{
 				}#else end
 			#socket_select failed
 			if ($num_changed_sockets === false) {
 				#NOTICE to server
 				echo "socket_select failed".PHP_EOL;
 				}#if end
 			#At least at one of the sockets something interesting happened
 			else if ($num_changed_sockets > 0) {
 				// check if there is a client trying to connect
 				if (in_array($sock, $read)) {
 					#accept the client, and add him to the $clients array
 				   	$receivedBytes=socket_recvfrom($sock,$data,1024,0,$remote_ip,$remote_port);
 					$key=$remote_ip.":".$remote_port;
 					$clients[$key] = $newsock = $sock;
 					#如果要顯示歡迎訊息
 					if($conf["welcomeMsg"]==="true"){
 					#debug
 					echo "client connected:".$key.PHP_EOL;
 					echo "client sended:".$data;
 					echo "all client:".PHP_EOL;
 					var_dump($clients);
 					#針對每個用來處理輸入字串的函式
 					foreach($conf["processFuncs"] as $proFunc){
 						#呼叫函式,參數為輸入的字串data跟client socket, server socket, 每個 socket
 						#https://www.php.net/manual/en/function.call-user-func.php
 						$param=array("data"=>trim($data),"serverSock"=>$sock,"clientKey"=>$key,"allSockArray"=>&$clients);
 						$params=array();
 						$params[]=&$param;
 						$result=call_user_func_array($proFunc,$params);
 						#如果有回傳結果
 						if($result!==NULL){
 							#如果執行出錯
+						}
 					#debug
 					echo "last all client:".PHP_EOL;
 					var_dump($clients);
 					# remove the listening socket from the clients-with-data array
 					$key = array_search($sock, $read);
 					unset($read[$key]);
 					}#if end
 				}#something happen end
 			} while (true);
 	#無.
 	#備註:
 	#無.
 	*/
 	public function echoService(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#涵式說明：
 		#判斷當前環境為web還是cmd
 		#回傳結果：
 		#$result,"web"或"cmd"
 		if(csInformation::getEnv()==="web"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="函數 ".$result["function"]." 僅能在命令列環境下運行!";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("data","clientSock","serverSock","allSockArray");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("ip");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("ip","processFuncs");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","array");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("0.0.0.0",array());
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#將內容原封不動還給 client
 		@socket_write($conf["clientSock"], $conf["data"].PHP_EOL);
 	#無.
 	#備註:
 	#無.
 	*/
 	public function echoServiceU(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#涵式說明：
 		#判斷當前環境為web還是cmd
 		#回傳結果：
 		#$result,"web"或"cmd"
 		if(csInformation::getEnv()==="web"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="函數 ".$result["function"]." 僅能在命令列環境下運行!";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("data","clientKey","serverSock","allSockArray");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("ip");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("ip","processFuncs");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","array");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("0.0.0.0",array());
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#將內容原封不動還給 client
 		$strArray=explode(":",$conf["clientKey"]);
 		$remote_ip=$strArray[0];
 	#無.
 	#備註:
 	#無.
 	*/
 	public function endService(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#涵式說明：
 		#判斷當前環境為web還是cmd
 		#回傳結果：
 		#$result,"web"或"cmd"
 		if(csInformation::getEnv()==="web"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="函數 ".$result["function"]." 僅能在命令列環境下運行!";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("data","clientSock","serverSock","allSockArray");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("ip");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("ip","processFuncs");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","array");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("0.0.0.0",array());
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#針對輸入的內容
 		switch($conf["data"]){
 	#無.
 	#備註:
 	#無.
 	*/
 	public function endServiceU(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#涵式說明：
 		#判斷當前環境為web還是cmd
 		#回傳結果：
 		#$result,"web"或"cmd"
 		if(csInformation::getEnv()==="web"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="函數 ".$result["function"]." 僅能在命令列環境下運行!";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("data","clientKey","serverSock","allSockArray");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("ip");
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("ip","processFuncs");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","array");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("0.0.0.0",array());
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#針對輸入的內容
 		switch($conf["data"]){
 			default:
 			}#switch end
 		}#function endServiceU end
 	/*
 	#函式說明:
 	#給予unixDomainSockServer函式的addOnProcessFunc參數用的函式,在背景執行指令.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"為正常,"false"為不正常.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function addOnProcessFuncForUnixDomainSockServerInRunWithAutoAddMemoryDaemon(&$conf=array()){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#取得參數
 		$result["argu"]=$conf;
 		#允許後面的函式繼續執行
 		$result["continue"]="true";
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],執行不正常結束的錯訊息陣列.
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		#備註:
 		#無.
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#debug
 		#var_dump(__LINE__,$checkArguments);
 		#如果執行失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#將需求變成陣列
 		$request=(array)json_decode($conf["request"]);
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],執行不正常結束的錯訊息陣列.
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		#備註:
 		#無.
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#debug
 		#var_dump(__LINE__,$checkArguments);
 		#如果執行失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#呼叫shell執行系統命令,並取得回傳的內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#備註:
 		#不是所有指令都能用apache的身份執行,目前已知java,javac指令無法執行,使用root身份可能會被selinux阻擋.
 		#若使用的 command、argu 參數，含有 ~ 則會被視為字串，若有需要其於 shell 中代表的家目錄位置，可用 fileAccess::tildeToPath 來進行轉換.
 		$callShell=external::callShell($conf["external::callShell"]);
 		unset($conf["external::callShell"]);
 		#如果執行失敗
 		if($callShell["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$callShell;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#將一維陣列轉換為用特定符號間隔的字串,ex:array("1","2","3") to "a;b;c;".
 		#回傳的結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["function"],當前執行的function名稱
 		#無.
 		#備註:
 		#無.
 		$arrayToString=arrays::arrayToString($conf["arrays::arrayToString"]);
 		unset($conf["arrays::arrayToString"]);
 		#如果執行失敗
 		if($arrayToString["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$arrayToString;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#透過proc來多執行序運作.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#https://www.php.net/manual/en/function.proc-get-status.php
 		#備註:
 		#無.
 		$proc=threads::proc($conf["threads::proc"]);
 		unset($conf["threads::proc"]);
 		/* debug
 		#函式說明:
 		#撰寫log
 		#回傳結果:
 		#$result["status"],狀態,"true"或"false".
 		#$result["error"],錯誤訊息陣列.
 		#無.
 		#備註:
 		#無.
 		$record=logs::record($conf["logs::record"]);
 		unset($conf["logs::record"]);
 		#如果執行失敗
 		if($record["status"]==="false"){
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置執行錯誤
 			$result["error"]=$record;
 			#回傳結果
 			return $result;
 			}#if end
 		*/
 		#設置要暫存在server端的內容
 		$result["cache"]=&$proc;
 		#如果執行失敗
 		if($proc["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$proc;
 			#回傳結果
 			return $result;
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 		#後面的程式不要執行
 		$result["continue"]="false";
 		#回傳結果
 		return $result;
 		}#function addOnProcessFuncForUnixDomainSockServerInRunWithAutoAddMemoryDaemon end
 	/*
 	#函式說明:
 	#執行程式時，依照需要增加記憶體的上限.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"為正常,"false"為不正常.
 	#https://www.php.net/manual/en/function.stream-get-meta-data.php
 	#備註:
 	#無.
 	*/
 	public static function runWithAutoAddMemoryDaemon(&$conf=array()){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		#備註:
 		#無.
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果執行失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤資訊
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤資訊
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		/*
 		#函式說明:
 		#於 ./tmp 底下建立暫存目錄與回傳暫存檔案名稱路徑
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息.
 		#$result["function"],當前執行的函數名稱.
 		#$result["content"],暫存檔案的路徑與名稱.
 		#無.
 		*/
 		$conf["fileAccess::createTempFile"]=array();
 		$createTempFile=fileAccess::createTempFile($conf["fileAccess::createTempFile"]);
 		unset($conf["fileAccess::createTempFile"]);
 		#如果執行失敗
 		if($createTempFile["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$createTempFile;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得暫存的 unix domain socket 檔案
 		$tmpUnixDomainSock=$createTempFile["content"];
 		#初始化用來運行  unixDomainSockServer.php 的參數
 		$argu=array();
 		#設置參數
 		$argu[]="--sock";
 		#設置參數
 		$argu[]=$tmpUnixDomainSock;
 		#設置參數
 		$argu[]="--addOnProcessFunc";
 		#設置參數
 		$argu[]="\qbpwcf\sock::addOnProcessFuncForUnixDomainSockServerInRunWithAutoAddMemoryDaemon";
 		#設置參數
 		$argu[]="--funcToRunWhenIdle";
 		#設置參數
 		$argu[]="\qbpwcf\config::autoAddMemory";
 		#設置參數
 		$argu[]="--onlyOutputCache";
 		#設置參數
 		$argu[]="true";
 		#設置參數
 		$argu[]="--cacheLayer";
 		#設置參數
 		$argu[]="serverCache";
 		#設置參數
 		$argu[]="--cacheLayer";
 		#設置參數
 		$argu[]="serverSide";
 		#設置參數
 		$argu[]="--cacheLayer";
 		#設置參數
 		$argu[]="funcToRunWhenIdle";
 		#設置參數
 		$argu[]="--cacheLayer";
 		#設置參數
 		$argu[]="\qbpwcf\config::autoAddMemory";
 		#設置參數
 		$argu[]="--cacheLayer";
 		#設置參數
 		$argu[]="cache";
 		#設置參數
 		$argu[]="--cacheLayer";
 		#設置參數
 		$argu[]="stdout";
 		#函式說明:
 		#呼叫shell執行系統命令,並取得回傳的內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#備註:
 		#不是所有指令都能用apache的身份執行,目前已知java,javac指令無法執行,使用root身份可能會被selinux阻擋.
 		#若使用的 command、argu 參數，含有 ~ 則會被視為字串，若有需要其於 shell 中代表的家目錄位置，可用 fileAccess::tildeToPath 來進行轉換.
 		$callShell=external::callShell($conf["external::callShell"]);
 		unset($conf["external::callShell"]);
 		#debug
 		#var_dump(__LINE__,$callShell);exit;
 		#如果執行失敗
 		if($callShell["status"]==="false"){
 			#如果socket存在
 			if(file_exists($tmpUnixDomainSock)){
 				#移除之
 				unlink($tmpUnixDomainSock);
 				}#if end
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$callShell;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#將一維陣列轉換為用特定符號間隔的字串,ex:array("1","2","3") to "a;b;c;".
 		#回傳的結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["function"],當前執行的function名稱
 		#無.
 		#備註:
 		#無.
 		$arrayToString=arrays::arrayToString($conf["arrays::arrayToString"]);
 		unset($conf["arrays::arrayToString"]);
 		#如果執行失敗
 		if($arrayToString["status"]==="false"){
 			#如果socket存在
 			if(file_exists($tmpUnixDomainSock)){
 				#移除之
 				unlink($tmpUnixDomainSock);
 				}#if end
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$arrayToString;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#透過proc來多執行序運作.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#參考資料:
 		#https://www.php.net/manual/en/function.proc-open.php
 		#https://www.php.net/manual/en/function.proc-get-status.php
 		#備註:
 		#無.
 		$procForUnixDoaminSocket=threads::proc($conf["threads::proc"]);
 		unset($conf["threads::proc"]);
 		#如果執行失敗
 		if($procForUnixDoaminSocket["status"]==="false"){
 			#如果socket存在
 			if(file_exists($tmpUnixDomainSock)){
 				#移除之
 				unlink($tmpUnixDomainSock);
 				}#if end
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$procForUnixDoaminSocket;
 			#回傳結果
 			return $result;
 			}#if end
 		#var_dump($procForUnixDoaminSocket);exit;
 		#如果 unix doamin socket server 沒有在運行
 		if($procForUnixDoaminSocket["content"][0]["proc_get_status"]["running"]===false){
 			#如果socket存在
 			if(file_exists($tmpUnixDomainSock)){
 				#移除之
 				unlink($tmpUnixDomainSock);
 				}#if end
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$procForUnixDoaminSocket;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果當下 unix doamin socket server 沒有在運行
 		if(proc_get_status($procForUnixDoaminSocket["content"][0]["process"])["running"]===false){
 			#如果socket存在
 			if(file_exists($tmpUnixDomainSock)){
 				#移除之
 				unlink($tmpUnixDomainSock);
 				}#if end
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$procForUnixDoaminSocket;
 			#回傳結果
 			return $result;
 			}#if end
 		#debug
 		#var_dump(__LINE__,"before send msg");
 		#初始化要求執行程式的訊息
 		$msg=array();
 		#設置執行的指令
 		$msg["cmd2run"]=$conf["cmd"];
 		#如果有參數
 		if(isset($conf["params"])){
 			#設置參數
 			$msg["params"]=$conf["params"];
 			}#if end
 		#初始化儲存等待了幾秒
 		$waitSec=0;
 		#無窮迴圈
 		while(true){
 			#函式說明:
 			#連線到 unixDomainSockServer 提供的 unix domain socket.
 			#回傳結果:
 			#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 			#$result["error"],錯誤訊息陣列.
 			#備註:
 			#無.
 			$paramsOfUnixDomainSockClient=$conf["sock::unixDomainSockClient"];
 			$unixDomainSockClient=sock::unixDomainSockClient($paramsOfUnixDomainSockClient);
 			unset($paramsOfUnixDomainSockClient);
 			#如果執行成功
 			if($unixDomainSockClient["status"]==="true"){
 				#debug
 				#var_dump(__LINE__,"before parse id");
 				#跳出while
 				break;
 				}#if end
 			#提示錯誤
 			else{
 				#debug
 				#var_dump(__LINE__,$unixDomainSockClient);
 				}#else end
 			#如果當下 unix doamin socket server 沒有在運行
 			if(proc_get_status($procForUnixDoaminSocket["content"][0]["process"])["running"]===false){
 				#如果socket存在
 				if(file_exists($tmpUnixDomainSock)){
 					#移除之
 					unlink($tmpUnixDomainSock);
 					}#if end
 				#設置執行失敗
 				$result["status"]="false";
 				#設置執行錯誤訊息
 				$result["error"][]="client取得回應前server就意外結束了";
 				#設置執行錯誤訊息
 				$result["error"][]=$procForUnixDoaminSocket;
 				#回傳結果
 				return $result;
 				}#if end
 			#等後1秒，擔心unix domain socket server 尚未跑起來.
 			sleep(1);
 			#已等待時間加1秒
 			$waitSec=$waitSec+1;
 			}#while end
 		#debug
 		#var_dump(__LINE__,"json string got:".$unixDomainSockClient["content"]);
 		#取得json回應
 		$jsonRes=json_decode($unixDomainSockClient["content"]);
 		#如果執行失敗
 		if($jsonRes===null){
 			#如果socket存在
 			if(file_exists($tmpUnixDomainSock)){
 				#移除之
 				unlink($tmpUnixDomainSock);
 				}#if end
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果沒有產生新id
 		if(!isset($jsonRes->id)){
 			#如果socket存在
 			if(file_exists($tmpUnixDomainSock)){
 				#移除之
 				unlink($tmpUnixDomainSock);
 				}#if end
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#debug
 		#var_dump(__LINE__,"got id:".$jsonRes->id);
 		#debug
 		#while(true){};
 		#用新的id再傳送一次要求給 qbpwcf_usock_path
 		$paramsOfUnixDomainSockClient=array();
 		$paramsOfUnixDomainSockClient["sock"]=$tmpUnixDomainSock;
 		$paramsOfUnixDomainSockClient["id"]=$jsonRes->id;
 		$paramsOfUnixDomainSockClient["custom"]=$msg;
 		$unixDomainSockClient=sock::unixDomainSockClient($paramsOfUnixDomainSockClient);
 		unset($paramsOfUnixDomainSockClient);
 		#debug
 		#var_dump(__LINE__,$unixDomainSockClient);
 		#如果執行失敗
 		if($unixDomainSockClient["status"]==="false"){
 			#如果socket存在
 			if(file_exists($tmpUnixDomainSock)){
 				#移除之
 				unlink($tmpUnixDomainSock);
 				}#if end
 			#設置執行錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$unixDomainSockClient;
 			#回傳結果
 			return $result;
 			}#if end
 		#debug
 		#var_dump(__LINE__,$unixDomainSockClient);
 		#如果有回應的內容
 		if(!empty($unixDomainSockClient["content"])){
 			#取得json回應
 			$jsonRes=(array)json_decode($unixDomainSockClient["content"]);
 			#如果執行失敗
 			if($jsonRes===null){
 				#如果socket存在
 				if(file_exists($tmpUnixDomainSock)){
 					#移除之
 					unlink($tmpUnixDomainSock);
 					}#if end
 				#設置執行錯誤識別
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$unixDomainSockClient;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果執行指令失敗
 			if($jsonRes["status"]==="false"){
 				#如果socket存在
 				if(file_exists($tmpUnixDomainSock)){
 					#移除之
 					unlink($tmpUnixDomainSock);
 					}#if end
 				#設置執行錯誤識別
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$jsonRes["error"];
 				#回傳結果
 				return $result;
 				}#if end
 			#印出client收到的結果
 			#var_dump($jsonRes);
 			}#if end
 		#debug
 		#var_dump(__LINE__,$procForUnixDoaminSocket);
 		#初始化儲存標準輸出
 		$result["content"]["stdout"]="";
 		#初始化儲存非標準輸出
 		$result["content"]["stderr"]="";
 		#等待 unixDomainSockServer 結束執行
 		while(true){
 			#取得程序狀態
 			$proc_get_status=proc_get_status($procForUnixDoaminSocket["content"][0]["process"]);
 			/* debug
 			#函式說明:
 			#撰寫log
 			#回傳結果:
 			#$result["status"],狀態,"true"或"false".
 			#$result["error"],錯誤訊息陣列.
 			#無.
 			#備註:
 			#無.
 			$record=logs::record($conf["logs::record"]);
 			unset($conf["logs::record"]);
 			#如果執行失敗
 			if($record["status"]==="false"){
 				#設置執行錯誤識別
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$record;
 				#回傳結果
 				return $result;
 				}#if end
 			*/
 			#確認process是否存在
 			#ps auxwf | grep sshd | grep -v 'grep' | wc -l
 			#函式說明:
 			#呼叫shell執行系統命令,並取得回傳的內容.
 			#回傳結果:
 			#備註:
 			#不是所有指令都能用apache的身份執行,目前已知java,javac指令無法執行,使用root身份可能會被selinux阻擋.
 			#若使用的 command、argu 參數，含有 ~ 則會被視為字串，若有需要其於 shell 中代表的家目錄位置，可用 fileAccess::tildeToPath 來進行轉換.
 			$callShell=external::callShell($conf["external::callShell"]);
 			unset($conf["external::callShell"]);
 			#如果執行失敗
 			if($callShell["status"]==="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置執行錯誤訊息
 				$result["error"]=$callShell;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果沒有輸出結果
 			if(!isset($callShell["output"][0])){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置執行錯誤訊息
 				$result["error"]=$callShell;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果執行結束了
 			if( $proc_get_status["running"]===false || $callShell["output"][0]==="0" ){
 				#取得程式執行過程產生的標準輸出
 				$result["content"]["stdout"]=$procForUnixDoaminSocket["content"][0]["content"];
 				#如果是resource
 				if(gettype($result["content"]["stdout"])==="resource"){
 					#讀取內容
 					$result["content"]["stdout"]=stream_get_contents($result["content"]["stdout"]);
 					}#if end
 				#取得程式執行過程產生的非標準輸出
 				$result["content"]["stderr"]=$procForUnixDoaminSocket["content"][0]["error"];
 				#如果是resource
 				if(gettype($result["content"]["stderr"])==="resource"){
 					#讀取內容
 					$result["content"]["stderr"]=stream_get_contents($result["content"]["stderr"]);
 					}#if end
 				#跳出 while
 				break;
 				}#if end
 			#休息1秒
 			sleep(1);
 			}#while end
 		#如果socket存在
 		if(file_exists($tmpUnixDomainSock)){
 			#移除之
 			unlink($tmpUnixDomainSock);
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function runWithAutoAddMemoryDaemon end
 	/*
 	#函式說明:
 	#用fwrite寫入到resource,可以指定每個寫入字串的結尾方式.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"為正常,"false"為不正常.
 	#https://www.php.net/manual/en/function.fopen.php
 	#備註:
 	#無.
 	*/
 	public static function fwrite(&$conf=array()){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		#備註:
 		#無.
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果執行失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤資訊
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤資訊
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#debug
 		#var_dump(__LINE__,$conf["stream"]);
 		/*
 		#函式說明:
 		#處理各種錯誤與例外.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["passed"],檢查是否通過,"true"代表通過,"false"代表不通過.
 		#無.
 		#備註:
 		#無.
 		$setErrorHandler=variableCheck::setErrorHandler($conf["variableCheck::setErrorHandler"]);
 		unset($conf["variableCheck::setErrorHandler"]);
 		#如果有回傳內容
 		if($setErrorHandler!==null){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤資訊
 			$result["error"]=$setErrorHandler;
 			#回傳結果
 			return $result;
 			}#if end
 		*/
 		#取得 stream 狀態
 		$stream_get_meta_data=stream_get_meta_data($conf["stream"]);
 		#debug
 		#var_dump(__LINE__,$stream_get_meta_data);
 		#如果存在 uri
 		if(isset($stream_get_meta_data["uri"])){
 			#取得能否寫入
 			$is_writable=is_writable($stream_get_meta_data["uri"]);
 			}#if end
 		#反之用 mode 來判斷
 		else if(isset($stream_get_meta_data["mode"])){
 			#函式說明:
 			#檢查一個字串裡面是否有多個關鍵字
 			#回傳結果:
 			#$result["status"],"true"代表執行成功，"false"代表執行失敗.
 			#$result["error"],錯誤訊息.
 			#無.
 			#備註:
 			#無.
 			$findManyKeyWords=search::findManyKeyWords($conf["search::findManyKeyWords"]);
 			unset($conf["search::findManyKeyWords"]);
 			#如果執行失敗
 			if($findManyKeyWords["status"]==="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤資訊
 				$result["error"]=$findManyKeyWords;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果模式含有寫入的屬性
 			if($findManyKeyWords["founded"]==="true"){
 				#設置可以寫入
 				$is_writable=true;
 				}#if end
 			}#else
 		#反之需要其他判斷方式
 		else{
 			#設置警示訊息
 			$result["warning"][]="無法判別 resource 能否寫入";
 			#設置警示訊息
 			$result["warning"][]=$stream_get_meta_data;
 			#直接放行
 			$is_writable=true;
 			}#else end
 		#如果不可寫入
 		if($is_writable!==true){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤資訊
 			$result["error"][]="resource 無法寫入";
 			#設置錯誤資訊
 			$result["error"][]=$stream_get_meta_data;
 			#設置resource不可寫入
 			$result["is_writable"]="false";
 			#回傳結果
 			return $result;
 			}#if end
 		#設置resource可寫入
 		$result["is_writable"]="true";
 		#判斷訊息結尾的格式
 		switch($conf["msgEndType"]){
 			#如果是 "none"
 			case "none":
 				#要寫入的每個字串
 				foreach($conf["data"] as $msg){
 					#寫入內容
 					fwrite($conf["stream"],$msg);
 					}#foreach end
 				break;
 			#如果是 "EOL"
 			case "EOL":
 				#要寫入的每個字串
 				foreach($conf["data"] as $msg){
 					#寫入內容,用PHP_EOL結尾.
 					fwrite($conf["stream"],$msg.PHP_EOL);
 					}#foreach end
 				break;
 			#如果是 "HTTP/1.1"
 			case "HTTP/1.1":
 				#如果要寫入的字串大於2段
 				if(count($conf["data"])>2){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置錯誤資訊
 					$result["error"][]="當參數 msgEndType 為 ".$conf["msgEndType"]." 時,參數 data 的數量不得超過2個.";
 					#設置resource不可寫入
 					$result["is_writable"]="false";
 					#回傳結果
 					return $result;
 					}#if end
 				#要寫入的每個字串
 				foreach($conf["data"] as $msg){
 					#寫入 header/body
 					fwrite($conf["stream"],$msg.PHP_EOL.PHP_EOL);
 					}#foreach end
 				#跳出switch
 				break;
 			#非預期的類型
 			default:
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤資訊
 				$result["error"][]="unsupported msgEndType ".$conf["msgEndType"];
 				#回傳結果
 				return $result;
 			}#switch end
 		#若要關閉resource
 		if($conf["autoClose"]==="true"){
 			#關閉resouce.
 			fclose($conf["stream"]);
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function fwrite end
 	}#class sock end
 ?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/sock.php – Rev 220 → 226