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

 			#$result["output"],爲執行完二元碼後的輸出陣列.
 			#必填的參數
 			#$conf["command"],字串,要執行的指令與.
 			$conf["external::callShell"]["command"]="systemctl";
 			#$conf["fileArgu"],字串,變數__FILE__的內容.
 			$conf["external::callShell"]["fileArgu"]=$conf["fileArgu"];
 			#可省略參數:
 			#$conf["argu"],陣列字串,指令搭配的參數,預設為空陣列.
 			$conf["external::callShell"]["argu"]=array("restart","httpd");
 			#$conf["arguIsAddr"],陣列字串,指令搭配的哪些參數為路徑,為路徑的參數會進行轉換以便符合呼叫當前函數的位置,預設不指定,若有3個參數,其中第3個參數為路徑,則表示為array("false","false","true").
 			#$conf["arguIsAddr"]=array();
 	#$conf["listenIp"]="";
 	#$conf["listenPort"],字串,要接聽的port,預設為已使用port+1.
 	#$conf["listenPort"]="";
 	#$conf["wsMode"],字串,是否要用webSocket模式,預設為"false",不使用,若為"true"則要使用.
 	#$conf["wsMode"]="false";
-	#$conf["processFuncs"],陣列,針對收到的訊息要呼叫的函式,會帶入一個參數陣列,array("data"=>收到的資料,"serverSock"=>serverSock,"clientSock"=>clientSock,"clientInfo"=>用戶端的資訊,"clientIndex"=>用戶端的索引,"allConn"=>所有連線的用戶端的連線資訊),回傳的結果若為陣列$result,其$result["status"]為"true"時,會結束執行(等待下個訊息);為"false"時,會var_dump結果,然後交給下一個函式執行;為"continue"時,代表交給下一個函式執行.
+	#$conf["processFuncs"],陣列,針對收到的訊息要呼叫的函式,會帶入一個參數陣列,array("data"=>收到的資料,"serverSock"=>serverSock,"clientSock"=>clientSock,"clientInfo"=>用戶端的資訊,"clientIndex"=>用戶端的索引,"allConn"=>所有連線的用戶端的連線資訊),回傳的結果若為陣列$result,其$result["status"]為"true"時,會結束執行(等待下個訊息);為"false"時,會var_dump結果,然後交給下一個函式執行;為"continue"時,代表交給下一個函式執行;預設的數值為array("noAuth");
 	#$conf["processFuncs"]=array();
+	#$conf["idleFunc"],陣列,當沒有收到訊息時,要執行的函式順序,預設不指定.
+	#$conf["idleFunc"]=array();
 	#參考資料:
 	#http://php.net/manual/en/sockets.examples.php
 	#http://us3.php.net/manual/en/function.socket-select.php
 	#response should at least end with "\r"=>http://stackoverflow.com/questions/25739768/websocket-communication-between-chromeclient-and-hotspotserver-status-line
 	#response status code should be 101=>http://stackoverflow.com/questions/29829597/i-get-a-status-200-when-connecting-to-the-websocket-but-it-is-an-error
 	#webSocket實做=>http://srchea.com/build-a-real-time-application-using-html5-websockets
 	#webSocketServer實做=>http://www.cuelogic.com/blog/php-and-html5-websocket-server-and-client-communication/
 	#備註:
 	#僅能在命令列執行.
-	#收到用戶的"id?"訊息,會回傳用戶的id.
-	#收到用戶的"ids?"訊息,會回傳非自己的所有用戶id
-	#收到用戶的"talkTo?"訊息,會回傳目前在跟誰談話.
-	#收到用戶的"talkTo:client-id"訊息,會建立與id對應的用戶對話,此後傳遞的訊息均會給對方.
-	#收到用戶的"quit"訊息,會結束與用戶的連線.
-	#收到用戶的"shutdown"訊息,會重新啟動webSocket server.
 	*/
 	public static function nativeSocketTcpIpServer(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array();
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
-		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("listenIp","listenPort","wsMode","processFuncs");
+		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("listenIp","listenPort","wsMode","processFuncs","idleFunc");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
-		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","array");
+		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","array","array");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
-		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("127.0.0.1",null,"false",null);
+		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("127.0.0.1",null,"false",array("noAuth"),null);
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		#建議:
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果 $conf["listenPort"] 不存在
 		if(!isset($conf["listenPort"])){
 			#用nmap掃port
 					#設為4000
 					$conf["listenPort"]="4000";
 					}#if end
 				}#if end
 			}#if end
 		#反之
 		else{
 			socket_set_nonblock($sock);
 			#SOL_SOCKET => socket level
 			#SO_REUSEADDR => Reports whether local addresses can be reused.
 			socket_set_option($sock, SOL_SOCKET, SO_REUSEADDR, 1);
 			#如果 Binds a name to a socket 失敗
 			if (@socket_bind($sock, $address, $port) === false){
 				#儲存錯誤訊息
 				$error=socket_strerror(socket_last_error($sock));
 				}#if end
 			#初始化儲存已經連線到 socket service 的服務
 			$connections=array();
+			#初始化 idle 時要呼叫的函式名稱陣列
+			$idleFunc=array();
 			#提示 listen 的 ip 與 port
 			echo "Listen to:".$address.":".$port.PHP_EOL;
 			#重複做,等待別人連線.
 			do{
 						#設置執行失敗
 						$result["status"]="false";
 						#設置執行錯誤訊息
 						$result["error"]=$encode;
 						#回傳結果
 						return $result;
 						}#if end
 						if(isset($client["lastPongTime"])){
 							#如果小於5秒沒有收到pong
 							if(time()-$client["lastPongTime"]<5){
-								#看下一個連線
+								#看下一個連線,亦即視為用戶已經斷線.
 								continue;
 								}#if end
 							}#if end
 						#debug
 						#var_dump(__LINE__,"send ping",$socket_write,socket_strerror(socket_last_error($clientSock)));
 						}#foreach end
+					#如果有idle時要做的事情
+					if(count($conf["idleFunc"])>0){
+						#取得idleFunc設定
+						$idleFunc=$conf["idleFunc"];
+						#移除初始的idelFunc設定
+						unset($conf["idleFunc"]);
+						}#if end
+					#如果有idle時要做的事情
+					if(count($idleFunc)>0){
+						#針對每個要執行的函式
+						foreach($idleFunc as $if){
+							#設置要給予函式的參數陣列
+							$param=array("idleFunc"=>&$idleFunc,"serverSock"=>&$sock,"allConn"=>&$connections);
+							#初始化給予 call_user_func_array 的第2個參數
+							$params=array();
+							#設置呼叫函式 $if 時要傳遞的參數為一個 $param
+							$params[]=&$param;
+							#呼叫函式 $if 與要傳遞的參數.
+							$result=call_user_func_array($if,$params);
+							}#foreach end
+						}#if end
+					#如果有php程式要於idle時執行
+					while(count($php2runWhenIdle)>0){
+						#取得要執行的 php code
+						$phpCode=array_shift($php2runWhenIdle);
+						#...
+						}#while end
 					#下一輪
 					continue;
 					}#if end
 				#有事情發生
 				echo "something happen".PHP_EOL;
 				#如果有socket要處理
 				if(in_array($sock,$read)){
 					#如果有接收到 socket 連線
 					if (($msgsock = socket_accept($sock)) !== false) {
 						#初始化不是既有的 sock
 						$existSock=false;
 						#尋找是哪個 socket
 						for($i=0;$i<count($connections);$i++){
 							#如果是既有的 sock
 							if($connections[$i]["connect"]===$msgsock){
 						#如果該 socket 是新的
 						if(!$existSock){
 							#重複做
 							do{
 								#亂數產生連線id
 								#涵式說明：
 								#建立以圖片(PNG格式)呈現的驗證碼.
 								#回傳的解果：
 								#$result["status"],執行是否正常,"true"代表執行成功,"false"代表執行失敗.
 								}#do end
 							#檢查id有無重複
 							while(in_array($validationCode["randNumberWord"],$idArray));
 							#如果不是 ws 模式
 							if($conf["wsMode"]==="false"){
 								#儲存連線到陣列裡面
 								$connections[]=array("connect"=>$msgsock,"buf"=>"","id"=>$validationCode["randNumberWord"],"talkTo"=>array());
 								}#if end
 							#如果是 ws 模式
 							if($conf["wsMode"]==="true"){
 								#儲存連線到陣列裡面
 								$connections[]=array("connect"=>$msgsock,"buf"=>"","id"=>$validationCode["randNumberWord"],"talkTo"=>array(),"handshaked"=>"false","unmask"=>"false","userAgent"=>"false","3rn"=>0,"receivedMsgFromServer"=>array());
 								}#if end
 							#debug,提示 Server 給予的新 Id
 							echo "new connection:".PHP_EOL;
 							#初始化連線後要回傳的訊息
 							$msg="";
 							#如果不是 ws 模式
 							if($conf["wsMode"]!=="true"){
 								#提示client連上線後得到的訊息
 								$msg = $msg.PHP_EOL."Welcome to the PHP Test Server.".PHP_EOL;
 							}#if end
 						#如果有 handshaked
 						if($con["handshaked"]==="true"){
 							#讀取內容
 							$buf = @socket_read($con["connect"], 2048, PHP_BINARY_READ);
 							#設置要 unmask
 							$connections[$conIndex]["unmask"]="true";
+							#設置尚未 auth
+							$connections[$conIndex]["auth"]="false";
 							}#if end
 						#反之
 						else{
 							#讀取內容
 							$buf = @socket_read($con["connect"], 2048, PHP_NORMAL_READ);
 						#印出接受的非換行符號內容
 						if($buf!==PHP_EOL){
 							#debug
 							echo "received:".$buf.PHP_EOL;
 							}#if end
 						#如果無 handshaked
 						if($con["handshaked"]!=="true"){
 						#web socket mode
 						if($conf["wsMode"]==="true"){
 							#如果不需要 unmask
 							if($connections[$conIndex]["unmask"]==="false"){
 								#提示還不用 unmask
 								echo "don't need unmask now".PHP_EOL;
 								#重新計數 \r\n
 								$connections[$conIndex]["3rn"]=0;
 								}#if end
 							}#if end
 						#如果有內容(不是換行符號)
 						$st=trim($buf);
 						#如果是 ws 模式
 						if($conf["wsMode"]==="true"){
 							#如果尚未 handshake
 							if($connections[$conIndex]["handshaked"]==="false"){
 								#提示 server 在檢查 handshake 用的 key 是否存在.
 								echo "check Sec-WebSocket-Key ..".PHP_EOL;
 								#handshake
 								#如果收到的內容$buf含有 Sec-WebSocket-Key: 字串開頭,擷取後面的內容存到$matchs裡面.
 								if(preg_match("/Sec-WebSocket-Key: (.*)/",$buf,$matchs)){
 									#提示serve在handshake
 									echo "do handshake...".PHP_EOL.PHP_EOL;
 									#handshake
 									$key = $matchs[1].'258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
 									$key =  base64_encode(sha1($key, true));
 									#設置 handshake 的 header
 									$headers =
 									"HTTP/1.1 101 Switching Protocols".PHP_EOL.
 									"Upgrade: websocket".PHP_EOL.
 									"Connection: Upgrade".PHP_EOL.
 									"Sec-WebSocket-Accept: ".$key.PHP_EOL.
 									"X-Powered-By: qbpwcf".PHP_EOL.
 									PHP_EOL;
 									#傳送header給client
 									socket_write($con["connect"], $headers);
 									#儲存server傳送給client的訊息
 									#$connections[$conIndex]["receivedMsgFromServer"][]=$headers;
 									#提示serve handshake 完畢
 									echo "handshak done...".PHP_EOL;
 									#設置已經 handshake
 									$connections[$conIndex]["handshaked"]="true";
 									}#if end
 								}#if end
 							}#if end
 						#如果是 ws 模式
 						if($conf["wsMode"]==="true"){
 							#如果尚未 handshake 過
 							if($connections[$conIndex]["handshaked"]==="false"){
 								#跳過
 								continue;
 								}#if end
 							#如果還不用要 unmask
 							if($connections[$conIndex]["unmask"]==="false"){
 								#跳過
 								continue;
 							}#if end
 						#如果是 ws 模式
 						if($conf["wsMode"]==="true"){
 							#debug
 							#var_dump(__LINE__,$connections[$conIndex]);
 							#如果已經 handshake 過
 							if($connections[$conIndex]["handshaked"]==="true"){
 								#如果要 unmask
 								if($connections[$conIndex]["unmask"]==="true"){
 									#如果收到的訊息不為空
 									if(!empty($buf)){
 										echo "start unmask...".PHP_EOL;
 										#debug
 										#var_dump(__LINE__,$buf);
 										$buf=webSock::unmask($conf["self::unmask"]);
 										unset($conf["self::unmask"]);
 										#如果執行失敗
 										if($buf["status"]==="false"){
 											#印出結果
 											var_dump($buf);
 											#結束執行
 											exit;
 											}#if end
 										#如果是 ping 的回應 pong
 										if($buf["type"]==="pong"){
 											#提示收到 pong
 											echo "got pong".PHP_EOL;
 											#更新的連線的 last pong time
 											$connections[$conIndex]["lastPongTime"]=time();
 											#換處理下一則訊息
 											continue;
 											}#if end
 										#如果不是 web socket frame
 										if($buf["type"]==="invalid"){
 									}#if end
 								}#if end
 							}#if end
+						/*
 						#如果收到的是 id?
 						if($buf === 'id?'){
+							#如果尚未認證
+							if($connections[$conIndex]["auth"]==="false"){
-							#設置要回傳的訊息
+								#設置要回傳的訊息
+								$talkback="permission denied";
+								}#if end
+							else{
+								#設置要回傳的訊息
-							$talkback=$connections[$conIndex]["id"];
+								$talkback=$connections[$conIndex]["id"];
+								}#else end
 							#debug
 							#var_dump(__LINE__,$talkback);
 							#json encode 要回傳的訊息
 							#跳到下一輪
 							continue;
 							}#if end
+						*/
+						/*
 						#如果收到的是 ids?
 						if($buf === 'ids?'){
-							#設置要回傳的訊息
+							#如果尚未認證
-							$talkback=array();
+							if($connections[$conIndex]["auth"]==="false"){
-							#針對每個連線
+								#設置要回傳的訊息
-							foreach($connections as $conIndex_ids => $con_ids){
+								$talkback=json_encode("permission denied");
-								#如果不是自己
-								if($con_ids["connect"]!==$connections[$conIndex]["connect"]){
-									#記錄其他人的id
+								}#if end
-									$talkback[]=$con_ids["id"];
-									}#if end
+							#反之
+							else{
+								#設置要回傳的訊息
-								}#foreach end
+								$talkback=array();
+								#針對每個連線
+								foreach($connections as $conIndex_ids => $con_ids){
+									#如果不是自己
+									if($con_ids["connect"]!==$connections[$conIndex]["connect"]){
+										#記錄其他人的id
+										$talkback[]=$con_ids["id"];
+										}#if end
+									}#foreach end
-							#json encode要回傳的id陣列
+								#json encode要回傳的id陣列
-							$talkback=json_encode($talkback);
+								$talkback=json_encode($talkback);
+								}#else end
 							#如果是 ws 模式
 							if($conf["wsMode"]==="true"){
 								#如果已經 handshake 過
 								if($connections[$conIndex]["handshaked"]==="true"){
 									#如果要 unmask
 									if($connections[$conIndex]["unmask"]==="true"){
 										#函式說明:
 										#加密 handshake 後要傳送的訊息
 										#回傳結果:
 							}#if end
 						#如果收到 "talkTo?"
 						if($buf==="talkTo?"){
-							#初始化要講話的id陣列
+							#如果尚未認證
-							$talkback=array();
+							if($connections[$conIndex]["auth"]==="false"){
-							#有幾個要講話的人就執行幾次
+								#設置要回傳的訊息
-							foreach($connections[$conIndex]["talkTo"] as $to){
+								$talkback=json_encode("permission denied");
+								}#if end
+							#反之
+							else{
+								#初始化要講話的id陣列
+								$talkback=array();
+								#有幾個要講話的人就執行幾次
+								foreach($connections[$conIndex]["talkTo"] as $to){
-								#串街要講話的人
+									#串街要講話的人
-								$talkback[]=$to;
+									$talkback[]=$to;
+									}#foreach end
-								}#foreach end
+								#設置要回傳的訊息
+								$talkback=json_encode($talkback).PHP_EOL;
-							#設置要回傳的訊息
+								}#else end
-							$talkback=json_encode($talkback).PHP_EOL;
 							#如果是 ws 模式
 							if($conf["wsMode"]==="true"){
 								#如果已經 handshake 過
 								}#if end
 							#如果存在 "talkTo:" 前置字串
 							if($getMeetConditionsString["founded"]==="true"){
+								#如果尚未認證
+								if($connections[$conIndex]["auth"]==="false"){
+									#設置要回傳的訊息
+									$talkback=json_encode("permission denied");
+									#如果是 ws 模式
+									if($conf["wsMode"]==="true"){
+										#如果已經 handshake 過
+										if($connections[$conIndex]["handshaked"]==="true"){
+											#如果要 unmask
+											if($connections[$conIndex]["unmask"]==="true"){
+												#函式說明:
+												#加密 handshake 後要傳送的訊息
+												#回傳結果:
+												#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+												#$result["error"],執行不正常結束的錯訊息陣列.
+												#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+												#$result["argu"],陣列,使用的參數.
+												#必填參數:
+												#$conf["text"],字串,要加密的訊息.
+												$conf["webSock::encode"]["text"]=$talkback;
+												#可省略參數:
+												#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+												#$conf["payloadIsBin"]="false";
+												#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+												#$conf["ping"]="false";
+												#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+												#$conf["pong"]="false";
+												#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+												#$conf["frames"]=array();
+												#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+												#$conf["mask"]="false";
+												#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+												#$conf["debug"]="false";
+												#參考資料:
+												#無.
+												#備註:
+												#目前$conf["text"]長度超過125會出錯.
+												$talkback=webSock::encode($conf["webSock::encode"]);
+												unset($conf["webSock::encode"]);
+												#如果執行失敗
+												if($talkback["status"]==="false"){
+													#印出結果
+													var_dump($talkback);
+													#結束執行
+													exit;
+													}#if end
+												#debug
+												#var_dump(__LINE__,$talkback);
+												}#if end
+											}#if end
+										}#if end
+									#反之不為 web socket 訊息
+									else{
+										#儲存成只有一個訊息
+										$talkback["content"][]=$talkback;
+										}#else
+									#針對每個訊息的分段
+									foreach($talkback["content"] as $msg){
+										#回傳訊息
+										$socket_write=socket_write($connections[$conIndex]["connect"], $msg, strlen($msg));
+										#debug
+										#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+										}#foreach end
+									#跳到下一輪
+									continue;
+									}#if end
 								#用 "talkTo:" 分割 $buf
 								#涵式說明：
 								#將固定格式的字串分開，並回傳分開的結果。
 								#回傳結果:
 								#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 													#debug
 													#var_dump(__LINE__,$talkback);
 													}#if end
 												}#if end
 											}#if end
 										#反之不為 web socket 訊息
 											#回傳訊息
 											$socket_write=socket_write($connections[$conIndex]["connect"], $msg, strlen($msg));
 											#debug
 											#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
 											}#foreach end
 										#讓對方可以跟自己對話
 										$connections[$targetKey]["talkTo"][]=$myId;
 													#debug
 													#var_dump(__LINE__,$talkback);
 													}#if end
 												}#if end
 											}#if end
 										#反之不為 web socket 訊息
 									}#if end
 								}#if end
 							}#if end
+						*/
+						#如果收到的訊息是 runPhpWhenIdle: 開頭
+						if(strpos($buf,"runPhpWhenIdle:")===0){
+							#如果尚未認證
+							if($connections[$conIndex]["auth"]==="false"){
+								#設置要回傳的訊息
+								$talkback=json_encode("permission denied");
+								#如果是 ws 模式
+								if($conf["wsMode"]==="true"){
+									#如果已經 handshake 過
+									if($connections[$conIndex]["handshaked"]==="true"){
+										#如果要 unmask
+										if($connections[$conIndex]["unmask"]==="true"){
+											#函式說明:
+											#加密 handshake 後要傳送的訊息
+											#回傳結果:
+											#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+											#$result["error"],執行不正常結束的錯訊息陣列.
+											#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+											#$result["argu"],陣列,使用的參數.
+											#必填參數:
+											#$conf["text"],字串,要加密的訊息.
+											$conf["webSock::encode"]["text"]=$talkback;
+											#可省略參數:
+											#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+											#$conf["payloadIsBin"]="false";
+											#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+											#$conf["ping"]="false";
+											#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+											#$conf["pong"]="false";
+											#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+											#$conf["frames"]=array();
+											#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+											#$conf["mask"]="false";
+											#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+											#$conf["debug"]="false";
+											#參考資料:
+											#無.
+											#備註:
+											#目前$conf["text"]長度超過125會出錯.
+											$talkback=webSock::encode($conf["webSock::encode"]);
+											unset($conf["webSock::encode"]);
+											#如果執行失敗
+											if($talkback["status"]==="false"){
+												#印出結果
+												var_dump($talkback);
+												#結束執行
+												exit;
+												}#if end
+											#debug
+											#var_dump(__LINE__,$talkback);
+											}#if end
+										}#if end
+									}#if end
+								#反之不為 web socket 訊息
+								else{
+									#儲存成只有一個訊息
+									$talkback["content"][]=$talkback;
+									}#else
+								#針對每個訊息的分段
+								foreach($talkback["content"] as $msg){
+									#回傳訊息
+									$socket_write=socket_write($connections[$conIndex]["connect"], $msg, strlen($msg));
+									#debug
+									#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+									}#foreach end
+								#跳到下一輪
+								continue;
+								}#if end
+							#剔除開頭的 "runPhpWhenIdle:"
+							#函式說明:
+							#將字串特定關鍵字與其前面的內容剔除
+							#回傳結果:
+							#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+							#$result["error"],錯誤訊息陣列.
+							#$result["warning"],警告訊息鎮列.
+							#$result["founded"],有無找到定字串"true"代表有,"false"代表沒有.
+							#$result["function"],當前執行的函數名稱.
+							#$result["argu"],使用的參數.
+							#$result["oriStr"],要處理的原始字串內容.
+							#$result["content"],處理好的的字串內容.
+							#$result["deleted"],被移除的內容.
+							#必填參數:
+							#$conf["stringIn"],字串,要處理的字串.
+							$conf["stringProcess::delStrBeforeKeyWord"]["stringIn"]=$buf;
+							#$conf["keyWord"],字串,特定字串.
+							$conf["stringProcess::delStrBeforeKeyWord"]["keyWord"]="runPhpWhenIdle:";
+							#可省略參數:
+							#$conf["recursive"],字串,預設為"false"代表找到一個關鍵字就會停止;"true"代表會即重複執行,知道沒有關鍵字為止.
+							#$conf["recursive"]="true";
+							#$conf["lastResult"],陣列,本函式前次執行的結果,若沒有找到關鍵字，則會改回傳該內容.
+							#$conf["lastResult"]=$delStrBeforeKeyWord;
+							#參考資料:
+							#無.
+							#備註:
+							#無.
+							$delStrBeforeKeyWord=stringProcess::delStrBeforeKeyWord($conf["stringProcess::delStrBeforeKeyWord"]);
+							unset($conf["stringProcess::delStrBeforeKeyWord"]);
+							#如果執行失敗
+							if($delStrBeforeKeyWord["status"]==="false"){
+								#印出結果
+								var_dump($delStrBeforeKeyWord);
+								#結束執行
+								exit;
+								}#if end
+							#設置要執行的php程式
+							$php2runWhenIdle[]=$delStrBeforeKeyWord["content"];
+							#跳到下一輪
+							continue;
+							}#if end
+						/* 舊的寫法
 						#如果收到的是 quit
 						if ($buf === 'quit' ) {
 							#設置要回傳的訊息
 							$talkback="結束與 server 的連線";
 							#跳到下一輪
 							continue;
 							}#if end
+						*/
+						/* 舊的寫法
 						#如果收到的是 shutdown
 						if ($buf === 'shutdown') {
+							#如果尚未認證
+							if($connections[$conIndex]["auth"]==="false"){
+								#設置要回傳的訊息
+								$talkback=json_encode("permission denied");
+								#如果是 ws 模式
+								if($conf["wsMode"]==="true"){
+									#如果已經 handshake 過
+									if($connections[$conIndex]["handshaked"]==="true"){
+										#如果要 unmask
+										if($connections[$conIndex]["unmask"]==="true"){
+											#函式說明:
+											#加密 handshake 後要傳送的訊息
+											#回傳結果:
+											#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+											#$result["error"],執行不正常結束的錯訊息陣列.
+											#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+											#$result["argu"],陣列,使用的參數.
+											#必填參數:
+											#$conf["text"],字串,要加密的訊息.
+											$conf["webSock::encode"]["text"]=$talkback;
+											#可省略參數:
+											#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+											#$conf["payloadIsBin"]="false";
+											#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+											#$conf["ping"]="false";
+											#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+											#$conf["pong"]="false";
+											#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+											#$conf["frames"]=array();
+											#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+											#$conf["mask"]="false";
+											#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+											#$conf["debug"]="false";
+											#參考資料:
+											#無.
+											#備註:
+											#目前$conf["text"]長度超過125會出錯.
+											$talkback=webSock::encode($conf["webSock::encode"]);
+											unset($conf["webSock::encode"]);
+											#如果執行失敗
+											if($talkback["status"]==="false"){
+												#印出結果
+												var_dump($talkback);
+												#結束執行
+												exit;
+												}#if end
+											#debug
+											#var_dump(__LINE__,$talkback);
+											}#if end
+										}#if end
+									}#if end
+								#反之不為 web socket 訊息
+								else{
+									#儲存成只有一個訊息
+									$talkback["content"][]=$talkback;
+									}#else
+								#針對每個訊息的分段
+								foreach($talkback["content"] as $msg){
+									#回傳訊息
+									$socket_write=socket_write($connections[$conIndex]["connect"], $msg, strlen($msg));
+									#debug
+									#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+									}#foreach end
+								#跳到下一輪
+								continue;
+								}#if end
 							#設置要回傳的訊息
 							$talkback="Server 即將關閉";
 							#json encode 要回傳的訊息
 							$talkback=json_encode($talkback);
 							#跳到最外層,結束webSocket server
 							break 2;
 							}#if end
+						*/
+						/* 舊的寫法
+						#如果收到的訊息為"auth:"開頭
+						if(strpos($buf,"auth:")){
+							#剔除 "auth:" 前面的內容
+							#函式說明:
+							#將字串特定關鍵字與其前面的內容剔除
+							#回傳結果:
+							#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+							#$result["error"],錯誤訊息陣列.
+							#$result["warning"],警告訊息鎮列.
+							#$result["founded"],有無找到定字串"true"代表有,"false"代表沒有.
+							#$result["function"],當前執行的函數名稱.
+							#$result["argu"],使用的參數.
+							#$result["oriStr"],要處理的原始字串內容.
+							#$result["content"],處理好的的字串內容.
+							#$result["deleted"],被移除的內容.
+							#必填參數:
+							#$conf["stringIn"],字串,要處理的字串.
+							$conf["stringProcess::delStrBeforeKeyWord"]["stringIn"]=$buf;
+							#$conf["keyWord"],字串,特定字串.
+							$conf["stringProcess::delStrBeforeKeyWord"]["keyWord"]="auth:";
+							#可省略參數:
+							#$conf["recursive"],字串,預設為"false"代表找到一個關鍵字就會停止;"true"代表會即重複執行,知道沒有關鍵字為止.
+							#$conf["recursive"]="true";
+							#$conf["lastResult"],陣列,本函式前次執行的結果,若沒有找到關鍵字，則會改回傳該內容.
+							#$conf["lastResult"]=$delStrBeforeKeyWord;
+							#參考資料:
+							#無.
+							#備註:
+							#無.
+							$delStrBeforeKeyWord=stringProcess::delStrBeforeKeyWord($conf["stringProcess::delStrBeforeKeyWord"]);
+							unset($conf["stringProcess::delStrBeforeKeyWord"]);
+							#如果執行失敗
+							if($delStrBeforeKeyWord["status"]==="false"){
+								#印出結果
+								var_dump($delStrBeforeKeyWord);
+								#結束執行
+								exit;
+								}#if end
+							#還原編碼
+							#$delStrBeforeKeyWord["content"];
+							#gpg解密
+							#...
+							#檢查賬號密碼
+							#...
+							}#if end
+						*/
+						#以下為其他收到的訊息內容
+						/* 舊的寫法
+						#如果尚未認證
+						if($connections[$conIndex]["auth"]==="false"){
+							#設置要回傳的訊息
+							$talkback=json_encode("permission denied");
+							#如果是 ws 模式
+							if($conf["wsMode"]==="true"){
+								#如果已經 handshake 過
+								if($connections[$conIndex]["handshaked"]==="true"){
+									#如果要 unmask
+									if($connections[$conIndex]["unmask"]==="true"){
+										#函式說明:
+										#加密 handshake 後要傳送的訊息
+										#回傳結果:
+										#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+										#$result["error"],執行不正常結束的錯訊息陣列.
+										#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+										#$result["argu"],陣列,使用的參數.
+										#必填參數:
+										#$conf["text"],字串,要加密的訊息.
+										$conf["webSock::encode"]["text"]=$talkback;
+										#可省略參數:
+										#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+										#$conf["payloadIsBin"]="false";
+										#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+										#$conf["ping"]="false";
+										#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+										#$conf["pong"]="false";
+										#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+										#$conf["frames"]=array();
+										#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+										#$conf["mask"]="false";
+										#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+										#$conf["debug"]="false";
+										#參考資料:
+										#無.
+										#備註:
+										#目前$conf["text"]長度超過125會出錯.
+										$talkback=webSock::encode($conf["webSock::encode"]);
+										unset($conf["webSock::encode"]);
+										#如果執行失敗
+										if($talkback["status"]==="false"){
+											#印出結果
+											var_dump($talkback);
+											#結束執行
+											exit;
+											}#if end
+										#debug
+										#var_dump(__LINE__,$talkback);
+										}#if end
+									}#if end
+								}#if end
+							#反之不為 web socket 訊息
+							else{
+								#儲存成只有一個訊息
+								$talkback["content"][]=$talkback;
+								}#else
+							#針對每個訊息的分段
+							foreach($talkback["content"] as $msg){
+								#回傳訊息
+								$socket_write=socket_write($connections[$conIndex]["connect"], $msg, strlen($msg));
+								#debug
+								#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+								}#foreach end
+							#跳到下一輪
+							continue;
+							}#if end
+						*/
 						#如果有指定的外掛函式
 						if(isset($conf["processFuncs"])){
 							#針對每個用來處理輸入字串的函式
 							foreach($conf["processFuncs"] as $proFunc){
 								#debug
 								#var_dump(__LINE__,$proFunc);
+								#函式說明:
+								#提供webSock::nativeSocketTcpIpServer用於接受檢查權限的功能.
+								#回傳結果:
+								#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+								#$result["error"],執行不正常結束的錯訊息陣列.
+								#$result["argu"],陣列,使用的參數.
+								#必填參數:
+								#$conf["data"],字串,收到的bin2hex編碼後果gpg加密過後的json格式資料,必填的key有"randomStr","username","password".
+								$conf["webSocket::checkAuth"]["data"]=&$buf;
+								#$conf["serverSock"],resource,web socket server socket
+								$conf["webSocket::checkAuth"]["serverSock"]=&$sock;
+								#$conf["clientSock"],$resource,web socket client socket
+								$conf["webSocket::checkAuth"]["clientSock"]=&$con["connect"];
+								#$conf["clientInfo"],陣列,web socket client info.
+								$conf["webSocket::checkAuth"]["clientInfo"]=&$connections[$conIndex];
+								#$conf["clientIndex"],整數.web socket client index.
+								$conf["webSocket::checkAuth"]["clientIndex"]=&$conIndex;
+								#$conf["allConn"],陣列,all web socket client info.
+								$conf["webSocket::checkAuth"]["allConn"]=&$connections;
+								#$conf["func"],字串,要檢查的是否具備權限的函式.
+								$conf["webSocket::checkAuth"]["func"]=$proFunc;
+								#可省略參數:
+								#$conf["wsMode"],字串,是否要按照rfc6555,預設為"true"為是;"false"為否.
+								#$conf["wsMode"]="true";
+								#$conf["gpgId"],字串,用於加解密的gpg id,預設為gnupgId.
+								#$conf["gpgId"]=gnupgId;
+								#$conf["falseAllowFuncPlus"],陣列,額外的未認證時可以執行的函式清單.
+								#$conf["falseAllowFuncPlus"]=array();
+								#$conf["publicAllowFuncPlus"],陣列,額外的認證為public時可以執行的函式清單.
+								#$conf["publicAllowFuncPlus"]=array();
+								#參考資料:
+								#https://www.rfc-editor.org/rfc/rfc6455#page-28, Web Socket Base Framing Protocol.
+								#備註:
+								#無.
+								$checkAuth=webSocket::checkAuth($conf["webSocket::checkAuth"]);
+								unset($conf["webSocket::checkAuth"]);
+								#如果沒有權限
+								if($checkAuth["status"]==="false"){
+									#換看下個 $proFunc
+									continue;
+									}#if end
 								#呼叫函式,參數為輸入的字串data跟client socket, server socket, 每個 socket
 								#https://www.php.net/manual/en/function.call-user-func.php
 								$param=array("data"=>&$buf,"serverSock"=>&$sock,"clientSock"=>&$con["connect"],"clientInfo"=>&$connections[$conIndex],"clientIndex"=>&$conIndex,"allConn"=>&$connections);
 								$params=array();
 								$params[]=&$param;
 								$result=call_user_func_array($proFunc,$params);
 								#debug
 								#var_dump(__LINE__,$result);
 								#如果有回傳結果
 			#設置執行錯誤
 			$result["error"]="no matched ServerName";
 			#debug
 			var_dump(__FUNCTION__,__LINE__,$result);
 			#回傳結果
 			return $result;
 			}#if end
 		#回傳結果
 		return $result;
 		}#function getFileContent end
+	/*
+	#函式說明:
+	#提供webSock::nativeSocketTcpIpServer用於接受檢查權限的功能.
+	#回傳結果:
+	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+	#$result["error"],執行不正常結束的錯訊息陣列.
+	#$result["argu"],陣列,使用的參數.
+	#必填參數:
+	#$conf["data"],字串,收到的bin2hex編碼後果gpg加密過後的json格式資料,必填的key有"randomStr","username","password".
+	$conf["data"]="";
+	#$conf["serverSock"],resource,web socket server socket
+	$conf["serverSock"]=$resource;
+	#$conf["clientSock"],$resource,web socket client socket
+	$conf["clientSock"]=$resource;
+	#$conf["clientInfo"],陣列,web socket client info.
+	$conf["clientInfo"]=array();
+	#$conf["clientIndex"],整數.web socket client index.
+	$conf["clientIndex"];
+	#$conf["allConn"],陣列,all web socket client info.
+	$conf["allConn"]=array();
+	#$conf["func"],字串,要檢查的是否具備權限的函式.
+	$conf["func"]="";
+	#可省略參數:
+	#$conf["wsMode"],字串,是否要按照rfc6555,預設為"true"為是;"false"為否.
+	#$conf["wsMode"]="true";
+	#$conf["gpgId"],字串,用於加解密的gpg id,預設為gnupgId.
+	#$conf["gpgId"]=gnupgId;
+	#$conf["falseAllowFuncPlus"],陣列,額外的未認證時可以執行的函式清單.
+	#$conf["falseAllowFuncPlus"]=array();
+	#$conf["publicAllowFuncPlus"],陣列,額外的認證為public時可以執行的函式清單.
+	#$conf["publicAllowFuncPlus"]=array();
+	#參考資料:
+	#https://www.rfc-editor.org/rfc/rfc6455#page-28, Web Socket Base Framing Protocol.
+	#備註:
+	#無.
+	*/
+	public static function checkAuth(&$conf){
+		#初始化要回傳的結果
+		$result=array();
+		#取得當前執行的函數名稱
+		$result["function"]=__FUNCTION__;
+		#涵式說明：
+		#判斷當前環境為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["function"],當前執行的函式名稱.
+		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
+		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
+		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
+		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
+		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
+		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
+		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
+		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
+		#必填寫的參數：
+		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
+		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
+		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("data","serverSock","clientInfo","clientIndex","allConn","func");
+		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","resource","array","string","array","string");
+		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
+		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
+		#可以省略的參數：
+		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
+		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
+		#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
+		#$conf["canNotBeEmpty"]=array();
+		#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
+		#$conf["canBeEmpty"]=array();
+		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
+		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("wsMode");
+		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("wsMode","gpgId","falseAllowFuncPlus","publicAllowFuncPlus");
+		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
+		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","array","array");
+		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
+		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true",gnupgId,array(),array());
+		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
+		#$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
+		#取得收到的訊息
+		$receivedData=$conf["data"];
+		#取得 server 的 socket
+		$serverSocket=$conf["serverSock"];
+		#取得 client 的 socket
+		$clientSocket=$conf["clientSock"];
+		#取得 client 的資訊
+		$clientInfo=$conf["clientInfo"];
+		#取得 client 的索引
+		$clientIndex=$conf["clientIndex"];
+		#取得 all clients 的資訊
+		$allConn=&$conf["allConn"];
+		/* 檢查權限不用看收到的訊息
+		#hex2bin
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$receivedData;
+		#$conf["enCodeType"],"字串",加密的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin",7種,"sha1"較耗時,"md5"較快,"p_hash"適用於密碼加密,"aes256"是對稱式加解密,"qbpwcf"是透過urlencode、json_encode、base64_encode的結果,"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin".
+		$conf["authenticate::enCodeStr"]["enCodeType"]="hex2bin";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["gpgDecrypt"]="false";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		#$conf["gpgId"]="";
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#設置執行異常
+			$result["status"]="false";
+			#設置執行錯誤
+			$result["error"]=$enCodeStr;
+			#回傳結果
+			return $result;
+			}#if end
+		#取得hex2bin後的字串
+		$receivedData=$enCodeStr["content"];
+		#gpg decrypt
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$receivedData;
+		#$conf["enCodeType"],"字串",加密的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin",7種,"sha1"較耗時,"md5"較快,"p_hash"適用於密碼加密,"aes256"是對稱式加解密,"qbpwcf"是透過urlencode、json_encode、base64_encode的結果,"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin".
+		$conf["authenticate::enCodeStr"]["enCodeType"]="gpg";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		$conf["authenticate::enCodeStr"]["gpgDecrypt"]="true";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		$conf["authenticate::enCodeStr"]["gpgId"]=$conf["gpgId"];
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#設置執行異常
+			$result["status"]="false";
+			#設置執行錯誤
+			$result["error"]=$enCodeStr;
+			#回傳結果
+			return $result;
+			}#if end
+		#取得解密後的字串
+		$receivedData=$enCodeStr["content"];
+		#json_decode
+		$receivedData=json_decode($receivedData);
+		*/
+		#取得認證狀態
+		$authStatus=$conf["clientInfo"][$conf["clientIndex"]]["auth"];
+		#判斷 authStatus
+		switch($authStatus){
+			#如果未經過認證
+			case "false":
+				#預設可以使用的功能只有"auth"跟"checkAuth"
+				$authFunc=array("auth","checkAuth");
+				#如果有 $conf["falseAllowFuncPlus"]
+				if(count($conf["falseAllowFuncPlus"])>0){
+					#合併 array
+					#函式說明:
+					#將多個一維陣列串聯起來,key從0開始排序.
+					#回傳的結果：
+					#$result["status"],"true"表執行正常,"false"代表執行不正常.
+					#$result["error"],錯誤訊息陣列.
+					#$result["function"],當前執行的函數.
+					#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
+					#$result["content"],合併好的一維陣列.
+					#必填參數
+					#$conf["inputArray"],陣列,要合併的一維陣列變數，例如：=array($array1,$array2);
+					$conf["arrays::mergeArray"]["inputArray"]=array($authFunc,$conf["falseAllowFuncPlus"]);
+					#可省略參數:
+					#$conf["allowRepeat"],字串,預設為"true",允許重複的結果;若為"false"則不會出現重複的元素內容.
+					$conf["arrays::mergeArray"]["allowRepeat"]="false";
+					#$conf["looseDiff"],字串,預設為"false",代表要嚴謹判斷為有相異,例如陣列中元素的key順序不同(整數)就代表有相異;反之為"true",例如陣列中元素的key順序不同(非整數),但value有相同,則視為無相異.
+					$conf["arrays::mergeArray"]["looseDiff"]="true";
+					#參考資料:
+					#無.
+					#備註:
+					#無.
+					$mergeArray=arrays::mergeArray($conf["arrays::mergeArray"]);
+					unset($conf["arrays::mergeArray"]);
+					#如果執行失敗
+					if($mergeArray["status"]==="false"){
+						#設置執行異常
+						$result["status"]="false";
+						#設置執行錯誤
+						$result["error"]=$mergeArray;
+						#回傳結果
+						return $result;
+						}#if end
+					#取得合併好允許使用的清單
+					$authFunc=$mergeArray["content"];
+					}#if end
+				#如果沒有權限使用
+				if(!in_array($conf["func"],$authFunc)){
+					#設置執行異常
+					$result["status"]="false";
+					#設置執行錯誤
+					$result["error"][]="no ".$conf["func"]." permission";
+					#回傳結果
+					return $result;
+					}#if end
+				#結束 switch
+				break;
+			#如果是"root"賬戶,代表系統管理者,擁有所有權限.
+			case "root":
+				#預設可以使用的功能只有"*",代表所有功能都能用.
+				$authFunc=array("*");
+				/*	允許使用所有函式
+				#如果沒有權限使用
+				if(!in_array($conf["func"],$authFunc)){
+					#設置執行異常
+					$result["status"]="false";
+					#設置執行錯誤
+					$result["error"][]="no ".$conf["func"]." permission";
+					#回傳結果
+					return $result;
+					}#if end
+				*/
+				#結束 switch
+				break;
+			#如果是"public"賬戶,代表具備一般使用權限的公用使用者.
+			case "public":
+				#預設可以使用的功能只有"*",代表所有功能都能用.
+				$authFunc=array("auth","checkAuth","basic");
+				#如果有 publicAllowFuncPlus
+				if(count($conf["publicAllowFuncPlus"])>0){
+					#合併 array
+					#函式說明:
+					#將多個一維陣列串聯起來,key從0開始排序.
+					#回傳的結果：
+					#$result["status"],"true"表執行正常,"false"代表執行不正常.
+					#$result["error"],錯誤訊息陣列.
+					#$result["function"],當前執行的函數.
+					#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
+					#$result["content"],合併好的一維陣列.
+					#必填參數
+					#$conf["inputArray"],陣列,要合併的一維陣列變數，例如：=array($array1,$array2);
+					$conf["arrays::mergeArray"]["inputArray"]=array($authFunc,$conf["publicAllowFuncPlus"]);
+					#可省略參數:
+					#$conf["allowRepeat"],字串,預設為"true",允許重複的結果;若為"false"則不會出現重複的元素內容.
+					$conf["arrays::mergeArray"]["allowRepeat"]="false";
+					#$conf["looseDiff"],字串,預設為"false",代表要嚴謹判斷為有相異,例如陣列中元素的key順序不同(整數)就代表有相異;反之為"true",例如陣列中元素的key順序不同(非整數),但value有相同,則視為無相異.
+					$conf["arrays::mergeArray"]["looseDiff"]="true";
+					#參考資料:
+					#無.
+					#備註:
+					#無.
+					$mergeArray=arrays::mergeArray($conf["arrays::mergeArray"]);
+					unset($conf["arrays::mergeArray"]);
+					#如果執行失敗
+					if($mergeArray["status"]==="false"){
+						#設置執行異常
+						$result["status"]="false";
+						#設置執行錯誤
+						$result["error"]=$mergeArray;
+						#回傳結果
+						return $result;
+						}#if end
+					#取得合併好允許使用的清單
+					$authFunc=$mergeArray["content"];
+					}#if end
+				#如果沒有權限使用
+				if(!in_array($conf["func"],$authFunc)){
+					#設置執行異常
+					$result["status"]="false";
+					#設置執行錯誤
+					$result["error"][]="no ".$conf["func"]." permission";
+					#回傳結果
+					return $result;
+					}#if end
+				break;
+			#其他結果
+			default:
+				#依照指定的資料來源進行權限與可用功能的檢查
+				#...
+				#設置執行異常
+				$result["status"]="false";
+				#設置執行錯誤
+				$result["error"][]="not supported authStatus(".$authStatus.")";
+				#回傳結果
+				return $result;
+			}#switch end
+			#設置執行正常
+			$result["status"]="true";
+			#回傳結果
+			return $result;
+		}#function checkAuth end
+	/*
+	#函式說明:
+	#提供webSock::nativeSocketTcpIpServer用於接受"auth:"開頭的訊息進行認證使用者的功能.
+	#回傳結果:
+	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常,"continue"代表不適用.
+	#$result["error"],執行不正常結束的錯訊息陣列.
+	#$result["argu"],陣列,使用的參數.
+	#必填參數:
+	#$conf["data"],字串,收到的bin2hex編碼後果gpg加密過後的json格式資料,必填的key有"randomStr","username","password".
+	$conf["data"]="";
+	#$conf["serverSock"],resource,web socket server socket
+	$conf["serverSock"]=$resource;
+	#$conf["clientSock"],$resource,web socket client socket
+	$conf["clientSock"]=$resource;
+	#$conf["clientInfo"],陣列,web socket client info.
+	$conf["clientInfo"]=array();
+	#$conf["clientIndex"],整數.web socket client index.
+	$conf["clientIndex"];
+	#$conf["allConn"],陣列,all web socket client info.
+	$conf["allConn"]=array();
+	#可省略參數:
+	#$conf["wsMode"],字串,是否要按照rfc6555,預設為"true"為是;"false"為否.
+	#$conf["wsMode"]="true";
+	#$conf["gpgId"],字串,用於加解密的gpg id,預設為gnupgId.
+	#$conf["gpgId"]=gnupgId;
+	#參考資料:
+	#https://www.rfc-editor.org/rfc/rfc6455#page-28, Web Socket Base Framing Protocol.
+	#備註:
+	#無.
+	*/
+	public static function auth(&$conf){
+		#初始化要回傳的結果
+		$result=array();
+		#取得當前執行的函數名稱
+		$result["function"]=__FUNCTION__;
+		#涵式說明：
+		#判斷當前環境為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["function"],當前執行的函式名稱.
+		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
+		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
+		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
+		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
+		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
+		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
+		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
+		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
+		#必填寫的參數：
+		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
+		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
+		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("data","serverSock","clientInfo","clientIndex","allConn");
+		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","resource","array","string","array");
+		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
+		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
+		#可以省略的參數：
+		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
+		#$conf["canBeEmptyString"]="false";
+		#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
+		#$conf["canNotBeEmpty"]=array();
+		#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
+		#$conf["canBeEmpty"]=array();
+		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
+		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("wsMode");
+		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("wsMode","gpgId");
+		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
+		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string");
+		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
+		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true",gnupgId);
+		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
+		#$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
+		#取得收到的訊息
+		$receivedData=$conf["data"];
+		#取得 server 的 socket
+		$serverSocket=$conf["serverSock"];
+		#取得 client 的 socket
+		$clientSocket=$conf["clientSock"];
+		#取得 client 的資訊
+		$clientInfo=$conf["clientInfo"];
+		#取得 client 的索引
+		$clientIndex=$conf["clientIndex"];
+		#取得認證狀態
+		$authStatus=&$conf["clientInfo"][$conf["clientIndex"]]["auth"];
+		#取得 all clients 的資訊
+		$allConn=&$conf["allConn"];
+		#hex2bin
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$receivedData;
+		#$conf["enCodeType"],"字串",加密的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin",7種,"sha1"較耗時,"md5"較快,"p_hash"適用於密碼加密,"aes256"是對稱式加解密,"qbpwcf"是透過urlencode、json_encode、base64_encode的結果,"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin".
+		$conf["authenticate::enCodeStr"]["enCodeType"]="hex2bin";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["gpgDecrypt"]="false";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		#$conf["gpgId"]="";
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#設置執行異常
+			$result["status"]="false";
+			#設置執行錯誤
+			$result["error"]=$enCodeStr;
+			#回傳結果
+			return $result;
+			}#if end
+		#取得hex2bin後的字串
+		$receivedData=$enCodeStr["content"];
+		#gpg decrypt
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$receivedData;
+		#$conf["enCodeType"],"字串",加密的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin",7種,"sha1"較耗時,"md5"較快,"p_hash"適用於密碼加密,"aes256"是對稱式加解密,"qbpwcf"是透過urlencode、json_encode、base64_encode的結果,"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin".
+		$conf["authenticate::enCodeStr"]["enCodeType"]="gpg";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		$conf["authenticate::enCodeStr"]["gpgDecrypt"]="true";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		$conf["authenticate::enCodeStr"]["gpgId"]=$conf["gpgId"];
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#設置執行異常
+			$result["status"]="false";
+			#設置執行錯誤
+			$result["error"]=$enCodeStr;
+			#回傳結果
+			return $result;
+			}#if end
+		#取得解密後的字串
+		$receivedData=$enCodeStr["content"];
+		#json_decode
+		$receivedData=json_decode($receivedData);
+		#如果decode後的內容不為物件
+		if(gettype($receivedData)!=="Object"){
+			#設置不適用
+			$result["status"]="continue";
+			#回傳結果
+			return $result;
+			}#if end
+		#檢查物件是否符合格式
+		#函式說明:
+		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["error"],執行不正常結束的錯訊息陣列.
+		#$result["simpleError"],簡單表示的錯誤訊息.
+		#$result["function"],當前執行的函式名稱.
+		#$result["argu"],設置給予的參數.
+		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
+		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
+		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
+		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
+		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
+		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
+		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
+		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
+		#必填參數:
+		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
+		$conf["variableCheck::checkArguments"]["varInput"]=&$receivedData;
+		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
+		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
+		#可省略參數:
+		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("user","type","secrect");
+		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null、any代表不指定變數形態.其中 resource也包含"resource (closed)".
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string");
+		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
+		#$conf["canBeEmptyString"]="false";
+		#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
+		#$conf["canNotBeEmpty"]=array();
+		#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
+		#$conf["canBeEmpty"]=array();
+		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
+		#$conf["skipableVariableCanNotBeEmpty"]=array();
+		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
+		#$conf["skipableVariableName"]=array();
+		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
+		#$conf["skipableVariableType"]=array();
+		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
+		#$conf["skipableVarDefaultValue"]=array("");
+		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
+		#$conf["disallowAllSkipableVarIsEmpty"]="";
+		#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".
+		#$conf["disallowAllSkipableVarIsEmptyArray"]="";
+		#$conf["disallowAllSkipableVarNotExist"],字串,是否不允許每個可省略參數都不存在,預設為"false"代表允許,反之為"true".
+		#$conf["disallowAllSkipableVarNotExist"]="";
+		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
+		#$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"]="continue";
+			#回傳結果
+			return $result;
+			}#if end
+		#取得使用者名稱
+		$user=$receivedData->user;
+		#取得密碼或金鑰內容
+		$secrect=$receivedData->secrect;
+		#依照驗證方式
+		switch($receivedData->type){
+			#若是密碼認證
+			case "password":
+				#測試 $user 與 password 的組合是否能夠認證.
+				#函式說明:
+				#驗證Linux使用者的密碼是否正確.
+				#回傳結果:
+				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+				#$result["function"],當前執行的函數名稱.
+				#$result["error"],錯誤訊息陣列.
+				#$result["warninig"],警告訊息陣列.
+				#$result["valid"],是否為存在的使用者且密碼正確.
+				#必填參數:
+				#$conf["username"],字串,要驗證的使用者名稱.
+				$conf["authenticate::validUser"]["username"]=$user;
+				#$conf["password"],字串,用於驗證使用者的密碼.
+				$conf["authenticate::validUser"]["password"]=$secrect;
+				#$conf["fileArgu"],字串,變數__FILE__的內容.
+				$conf["authenticate::validUser"]["fileArgu"]=__FILE__;
+				#可省略參數:
+				#無.
+				#參考資料:
+				#無.
+				#備註:
+				#僅能在命令列環境下運行.
+				$validUser=authenticate::validUser($conf["authenticate::validUser"]);
+				unset($conf["authenticate::validUser"]);
+				#如果執行異常
+				if($validUser["status"]==="false"){
+					#設置異常
+					$result["status"]="false";
+					#設置錯誤訊息
+					$result["error"]=$validUser;
+					#回傳結果
+					return $result;
+					}#if end
+				#如果認證失敗
+				if($validUser["valid"]==="false"){
+					#記錄該 client 認證失敗的事件
+					$allConn[$clientIndex]["authFailed"][]=array("time"=>time(),"user"=>$user);
+					#針對每次認證失敗的記錄
+					for($i=0;$i<count($allConn[$clientIndex]["authFailed"]);$i++){
+						#如果有下一個事件
+						if(isset($allConn[$clientIndex]["authFailed"][$i+1])){
+							#如果本次跟下次事件的時間間隔小於60秒
+							if($allConn[$clientIndex]["authFailed"][$i+1]["time"] - $allConn[$clientIndex]["authFailed"][$i]["time"] > 60){
+								#移除本次記錄
+								array_shift($allConn[$clientIndex]["authFailed"]);
+								#新記錄的索引減少了1，因此更新$i
+								$i--;
+								}#if end
+							}#if end
+						}#foreach end
+					#如果總事件次數大於3
+					if(count($allConn[$clientIndex]["authFailed"])>3){
+						#設置異常
+						$result["status"]="false";
+						#設置錯誤訊息
+						$result["error"]=$allConn[$clientIndex]["authFailed"];
+						#回傳結果
+						return $result;
+						}#if end
+					#設置正常
+					$result["status"]="true";
+					#回傳結果
+					return $result;
+					}#if end
+				#執行到這邊代表使用者認證通過
+				#依照 user 取得其所屬 group
+				#函式說明:
+				#id指令來取得目標賬號的群組資訊
+				#回傳結果:
+				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+				#$reuslt["error"],執行不正常結束的錯訊息陣列.
+				#$result["function"],當前執行的函式名稱.
+				#$result["content"],呼叫完WebService所得回傳結果.
+				#$result["content"]["groupId"],群組的id.
+				#$result["content"]["belongGroupName"],陣列,隸屬的群組名稱陣列.
+				#$result["content"]["belongGroupId"],陣列,隸屬的群組id.
+				#必填參數:
+				#$conf["user"],字串,要取得群組資訊的目標使用者名稱.
+				$conf["authenticate::getUserGroup"]["user"]=$user;
+				#可省略參數:
+				#無.
+				#參考資料:
+				#無.
+				#備註:
+				#無.
+				$getUserGroup=authenticate::getUserGroup($conf["authenticate::getUserGroup"]);
+				unset($conf["authenticate::getUserGroup"]);
+				#如果執行異常
+				if($getUserGroup["status"]==="false"){
+					#設置異常
+					$result["status"]="false";
+					#設置錯誤訊息
+					$result["error"]=$getUserGroup;
+					#回傳結果
+					return $result;
+					}#if end
+				#設置預設的權限為 "false"
+				$authStatus="false";
+				#針對每個取得的群組名稱
+				foreach($getUserGroup["content"]["belongGroupName"] as $groupName){
+					#如果是 root
+					if($groupName==="root"){
+						#設置得到的權限
+						$authStatus=$groupName;
+						#結束 foreach
+						break;
+						}#if end
+					#反之如果是公開的使用者
+					else if($groupName==="public"){
+						#設置得到的權限
+						$authStatus=$groupName;
+						}#if end
+					#其他群組名稱
+					else{
+						#跳過
+						continue;
+						}#else end
+					}#foreach end
+				#設置正常
+				$result["status"]="true";
+				#回傳結果
+				return $result;
+				#跳出 switch
+				break;
+			#若是金鑰認證
+			case "key":
+				#測試 $user 與 key 的組合是否能夠認證.
+				#函式說明:
+				#驗證Linux使用者的密碼或ssh private key是否正確.
+				#回傳結果:
+				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+				#$result["function"],當前執行的函數名稱.
+				#$result["error"],錯誤訊息陣列.
+				#$result["warninig"],警告訊息陣列.
+				#$result["valid"],是否為存在的使用者且密碼正確.
+				#必填參數:
+				#$conf["username"],字串,要驗證的使用者名稱.
+				$conf["authenticate::validUser"]["username"]=$user;
+				#$conf["password"],字串,用於驗證使用者的密碼.
+				$conf["authenticate::validUser"]["password"]=$secrect;
+				#$conf["fileArgu"],字串,變數__FILE__的內容.
+				$conf["authenticate::validUser"]["fileArgu"]=__FILE__;
+				#可省略參數:
+				#$conf["sshPrivateKey"],字串,"true"代表password為ssh private key的內容;反之預設為密碼,設置為"false".
+				$conf["authenticate::validUser"]["sshPrivateKey"]="true";
+				#參考資料:
+				#無.
+				#備註:
+				#僅能在命令列環境下運.
+				#目前僅支援驗證執行php端的使用者.
+				$validUser=authenticate::validUser($conf["authenticate::validUser"]);
+				unset($conf["authenticate::validUser"]);
+				#如果執行異常
+				if($validUser["status"]==="false"){
+					#設置異常
+					$result["status"]="false";
+					#設置錯誤訊息
+					$result["error"]=$validUser;
+					#回傳結果
+					return $result;
+					}#if end
+				#如果認證失敗
+				if($validUser["valid"]==="false"){
+					#記錄該 client 認證失敗的事件
+					$allConn[$clientIndex]["authFailed"][]=array("time"=>time(),"user"=>$user);
+					#針對每次認證失敗的記錄
+					for($i=0;$i<count($allConn[$clientIndex]["authFailed"]);$i++){
+						#如果有下一個事件
+						if(isset($allConn[$clientIndex]["authFailed"][$i+1])){
+							#如果本次跟下次事件的時間間隔小於60秒
+							if($allConn[$clientIndex]["authFailed"][$i+1]["time"] - $allConn[$clientIndex]["authFailed"][$i]["time"] > 60){
+								#移除本次記錄
+								array_shift($allConn[$clientIndex]["authFailed"]);
+								#新記錄的索引減少了1，因此更新$i
+								$i--;
+								}#if end
+							}#if end
+						}#foreach end
+					#如果總事件次數大於3
+					if(count($allConn[$clientIndex]["authFailed"])>3){
+						#設置異常
+						$result["status"]="false";
+						#設置錯誤訊息
+						$result["error"]=$allConn[$clientIndex]["authFailed"];
+						#回傳結果
+						return $result;
+						}#if end
+					#設置正常
+					$result["status"]="true";
+					#回傳結果
+					return $result;
+					}#if end
+				#執行到這邊代表使用者認證通過
+				#依照 user 取得其所屬 group
+				#函式說明:
+				#id指令來取得目標賬號的群組資訊
+				#回傳結果:
+				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+				#$reuslt["error"],執行不正常結束的錯訊息陣列.
+				#$result["function"],當前執行的函式名稱.
+				#$result["content"],呼叫完WebService所得回傳結果.
+				#$result["content"]["groupId"],群組的id.
+				#$result["content"]["belongGroupName"],陣列,隸屬的群組名稱陣列.
+				#$result["content"]["belongGroupId"],陣列,隸屬的群組id.
+				#必填參數:
+				#$conf["user"],字串,要取得群組資訊的目標使用者名稱.
+				$conf["authenticate::getUserGroup"]["user"]=$user;
+				#可省略參數:
+				#無.
+				#參考資料:
+				#無.
+				#備註:
+				#無.
+				$getUserGroup=authenticate::getUserGroup($conf["authenticate::getUserGroup"]);
+				unset($conf["authenticate::getUserGroup"]);
+				#如果執行異常
+				if($getUserGroup["status"]==="false"){
+					#設置異常
+					$result["status"]="false";
+					#設置錯誤訊息
+					$result["error"]=$getUserGroup;
+					#回傳結果
+					return $result;
+					}#if end
+				#設置預設的權限為 "false"
+				$authStatus="false";
+				#針對每個取得的群組名稱
+				foreach($getUserGroup["content"]["belongGroupName"] as $groupName){
+					#如果是 root
+					if($groupName==="root"){
+						#設置得到的權限
+						$authStatus=$groupName;
+						#結束 foreach
+						break;
+						}#if end
+					#反之如果是公開的使用者
+					else if($groupName==="public"){
+						#設置得到的權限
+						$authStatus=$groupName;
+						}#if end
+					#其他群組名稱
+					else{
+						#跳過
+						continue;
+						}#else end
+					}#foreach end
+				#設置正常
+				$result["status"]="true";
+				#回傳結果
+				return $result;
+				#跳出 switch
+				break;
+			#其他類型
+			default:
+				#設置不適用
+				$result["status"]="continue";
+				#回傳結果
+				return $result;
+			}#switch end
+		#執行到這邊代表異常
+		#設置異常
+		$result["status"]="false";
+		#回傳結果
+		return $result;
+		}#function auth end
+	/*
+	#函式說明:
+	#提供webSock::nativeSocketTcpIpServer使用基本功能(basic).
+	#回傳結果:
+	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常,"continue"代表不適用.
+	#$result["error"],執行不正常結束的錯訊息陣列.
+	#$result["argu"],陣列,使用的參數.
+	#必填參數:
+	#$conf["data"],字串,收到的bin2hex編碼後再gpg加密過後的json格式資料.
+	$conf["data"]="";
+	#$conf["serverSock"],resource,web socket server socket
+	$conf["serverSock"]=$resource;
+	#$conf["clientSock"],$resource,web socket client socket
+	$conf["clientSock"]=$resource;
+	#$conf["clientInfo"],陣列,web socket client info.
+	$conf["clientInfo"]=array();
+	#$conf["clientIndex"],整數.web socket client index.
+	$conf["clientIndex"];
+	#$conf["allConn"],陣列,all web socket client info.
+	$conf["allConn"]=array();
+	#可省略參數:
+	#$conf["wsMode"],字串,是否要按照rfc6555,預設為"true"為是;"false"為否.
+	#$conf["wsMode"]="true";
+	#$conf["gpgId"],字串,用於加解密的gpg id,預設為gnupgId.
+	#$conf["gpgId"]=gnupgId;
+	#參考資料:
+	#https://www.rfc-editor.org/rfc/rfc6455#page-28, Web Socket Base Framing Protocol.
+	#備註:
+	#收到用戶的"id?"訊息,會回傳用戶的id.
+	#收到用戶的"ids?"訊息,會回傳非自己的所有用戶id.
+	#收到用戶的"talkTo?"訊息,會回傳目前在跟誰談話.
+	#收到用戶的"talkTo:client-id"訊息,會建立與id對應的用戶對話,此後傳遞的訊息均會給對方.
+	#結束連線的訊息"quit".
+	*/
+	public static function basic(&$conf){
+		#初始化要回傳的結果
+		$result=array();
+		#取得當前執行的函數名稱
+		$result["function"]=__FUNCTION__;
+		#涵式說明：
+		#判斷當前環境為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["function"],當前執行的函式名稱.
+		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
+		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
+		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
+		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
+		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
+		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
+		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
+		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
+		#必填寫的參數：
+		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
+		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
+		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("data","serverSock","clientInfo","clientIndex","allConn");
+		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","resource","array","string","array");
+		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
+		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
+		#可以省略的參數：
+		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
+		#$conf["canBeEmptyString"]="false";
+		#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
+		#$conf["canNotBeEmpty"]=array();
+		#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
+		#$conf["canBeEmpty"]=array();
+		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
+		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("wsMode");
+		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("wsMode","gpgId");
+		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
+		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string");
+		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
+		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true",gnupgId);
+		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
+		#$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
+		#取得收到的訊息
+		$receivedData=$conf["data"];
+		#取得 server 的 socket
+		$serverSocket=$conf["serverSock"];
+		#取得 client 的 socket
+		$clientSocket=$conf["clientSock"];
+		#取得 client 的資訊
+		$clientInfo=$conf["clientInfo"];
+		#取得 client 的索引
+		$clientIndex=$conf["clientIndex"];
+		#取得 all clients 的資訊
+		$allConn=&$conf["allConn"];
+		#hex2bin
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$receivedData;
+		#$conf["enCodeType"],"字串",加密的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin",7種,"sha1"較耗時,"md5"較快,"p_hash"適用於密碼加密,"aes256"是對稱式加解密,"qbpwcf"是透過urlencode、json_encode、base64_encode的結果,"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin".
+		$conf["authenticate::enCodeStr"]["enCodeType"]="hex2bin";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["gpgDecrypt"]="false";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		#$conf["gpgId"]="";
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#設置執行異常
+			$result["status"]="false";
+			#設置執行錯誤
+			$result["error"]=$enCodeStr;
+			#回傳結果
+			return $result;
+			}#if end
+		#取得hex2bin後的字串
+		$receivedData=$enCodeStr["content"];
+		#gpg decrypt
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$receivedData;
+		#$conf["enCodeType"],"字串",加密的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin",7種,"sha1"較耗時,"md5"較快,"p_hash"適用於密碼加密,"aes256"是對稱式加解密,"qbpwcf"是透過urlencode、json_encode、base64_encode的結果,"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin".
+		$conf["authenticate::enCodeStr"]["enCodeType"]="gpg";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		$conf["authenticate::enCodeStr"]["gpgDecrypt"]="true";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		$conf["authenticate::enCodeStr"]["gpgId"]=$conf["gpgId"];
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#設置執行異常
+			$result["status"]="false";
+			#設置執行錯誤
+			$result["error"]=$enCodeStr;
+			#回傳結果
+			return $result;
+			}#if end
+		#取得解密後的字串
+		$receivedData=$enCodeStr["content"];
+		#json_decode
+		$receivedData=json_decode($receivedData);
+		#如果收到的是 id?
+		if($receivedData==="id?"){
+			#如果尚未認證
+			if($connections[$conIndex]["auth"]==="false"){
+				#設置要回傳的訊息
+				$talkback="permission denied";
+				}#if end
+			else{
+				#設置要回傳的訊息
+				$talkback=$connections[$conIndex]["id"];
+				}#else end
+			#debug
+			#var_dump(__LINE__,$talkback);
+			#json encode 要回傳的訊息
+			$talkback=json_encode($talkback);
+			#debug
+			#var_dump(__LINE__,$talkback);
+			#如果是 ws 模式
+			if($conf["wsMode"]==="true"){
+				#如果已經 handshake 過
+				if($connections[$conIndex]["handshaked"]==="true"){
+					#如果要 unmask
+					if($connections[$conIndex]["unmask"]==="true"){
+						#函式說明:
+						#加密 handshake 後要傳送的訊息
+						#回傳結果:
+						#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+						#$result["error"],執行不正常結束的錯訊息陣列.
+						#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+						#$result["argu"],陣列,使用的參數.
+						#必填參數:
+						#$conf["text"],字串,要加密的訊息.
+						$conf["webSock::encode"]["text"]=$talkback;
+						#可省略參數:
+						#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+						#$conf["payloadIsBin"]="false";
+						#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+						#$conf["ping"]="false";
+						#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+						#$conf["pong"]="false";
+						#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+						#$conf["frames"]=array();
+						#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+						#$conf["mask"]="false";
+						#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+						#$conf["debug"]="false";
+						#參考資料:
+						#無.
+						#備註:
+						#目前$conf["text"]長度超過125會出錯.
+						$talkback=webSock::encode($conf["webSock::encode"]);
+						unset($conf["webSock::encode"]);
+						#如果執行失敗
+						if($talkback["status"]==="false"){
+							#印出結果
+							var_dump($talkback);
+							#結束執行
+							exit;
+							}#if end
+						#debug
+						#var_dump(__LINE__,$talkback);
+						}#if end
+					}#if end
+				}#if end
+			#反之不為 web socket 訊息
+			else{
+				#儲存成只有一個訊息
+				$talkback["content"][]=$talkback;
+				}#else
+			#針對每個訊息的分段
+			foreach($talkback["content"] as $msg){
+				#debug
+				var_dump(__LINE__,$msg);
+				#回傳訊息
+				$socket_write=socket_write($connections[$conIndex]["connect"], $msg, strlen($msg));
+				#debug
+				var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+				}#foreach end
+			#設置執行正常
+			$result["status"]="true";
+			#回傳結果
+			return $result;
+			}#if end
+		#反之如果收到的是 "quit"
+		else if($receivedData==="quit"){
+			#設置要回傳的訊息
+			$talkback="結束與 server 的連線";
+			#json encode 要回傳的訊息
+			$talkback=json_encode($talkback).PHP_EOL;
+			#如果是 ws 模式
+			if($conf["wsMode"]==="true"){
+				#如果已經 handshake 過
+				if($connections[$conIndex]["handshaked"]==="true"){
+					#如果要 unmask
+					if($connections[$conIndex]["unmask"]==="true"){
+						#函式說明:
+						#加密 handshake 後要傳送的訊息
+						#回傳結果:
+						#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+						#$result["error"],執行不正常結束的錯訊息陣列.
+						#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+						#$result["argu"],陣列,使用的參數.
+						#必填參數:
+						#$conf["text"],字串,要加密的訊息.
+						$conf["webSock::encode"]["text"]=$talkback;
+						#可省略參數:
+						#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+						#$conf["payloadIsBin"]="false";
+						#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+						#$conf["ping"]="false";
+						#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+						#$conf["pong"]="false";
+						#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+						#$conf["frames"]=array();
+						#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+						#$conf["mask"]="false";
+						#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+						#$conf["debug"]="false";
+						#參考資料:
+						#無.
+						#備註:
+						#目前$conf["text"]長度超過125會出錯.
+						$talkback=webSock::encode($conf["webSock::encode"]);
+						unset($conf["webSock::encode"]);
+						#如果執行失敗
+						if($talkback["status"]==="false"){
+							#印出結果
+							var_dump($talkback);
+							#結束執行
+							exit;
+							}#if end
+						#debug
+						#var_dump(__LINE__,$talkback);
+						}#if end
+					}#if end
+				}#if end
+			#反之不為 web socket 訊息
+			else{
+				#儲存成只有一個訊息
+				$talkback["content"][]=$talkback;
+				}#else
+			#針對每個訊息的分段
+			foreach($talkback["content"] as $msg){
+				#回傳訊息
+				$socket_write=socket_write($con["connect"], $msg, strlen($msg));
+				#debug
+				#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+				}#foreach end
+			#關閉被 client 的連線
+			socket_close($con["connect"]);
+			#清理連線的陣列
+			unset($connections[$conIndex]);
+			#設置執行正常
+			$result["status"]="true";
+			#回傳結果
+			return $result;
+			}#if end
+		#反之是如果收到的是 ids?
+		else if($receivedData === 'ids?'){
+			#如果尚未認證
+			if($connections[$conIndex]["auth"]==="false"){
+				#設置要回傳的訊息
+				$talkback=json_encode("permission denied");
+				}#if end
+			#反之
+			else{
+				#設置要回傳的訊息
+				$talkback=array();
+				#針對每個連線
+				foreach($connections as $conIndex_ids => $con_ids){
+					#如果不是自己
+					if($con_ids["connect"]!==$connections[$conIndex]["connect"]){
+						#記錄其他人的id
+						$talkback[]=$con_ids["id"];
+						}#if end
+					}#foreach end
+				#json encode要回傳的id陣列
+				$talkback=json_encode($talkback);
+				}#else end
+			#如果是 ws 模式
+			if($conf["wsMode"]==="true"){
+				#如果已經 handshake 過
+				if($connections[$conIndex]["handshaked"]==="true"){
+					#如果要 unmask
+					if($connections[$conIndex]["unmask"]==="true"){
+						#函式說明:
+						#加密 handshake 後要傳送的訊息
+						#回傳結果:
+						#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+						#$result["error"],執行不正常結束的錯訊息陣列.
+						#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+						#$result["argu"],陣列,使用的參數.
+						#必填參數:
+						#$conf["text"],字串,要加密的訊息.
+						$conf["webSock::encode"]["text"]=$talkback;
+						#可省略參數:
+						#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+						#$conf["payloadIsBin"]="false";
+						#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+						#$conf["ping"]="false";
+						#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+						#$conf["pong"]="false";
+						#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+						#$conf["frames"]=array();
+						#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+						#$conf["mask"]="false";
+						#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+						#$conf["debug"]="false";
+						#參考資料:
+						#無.
+						#備註:
+						#目前$conf["text"]長度超過125會出錯.
+						$talkback=webSock::encode($conf["webSock::encode"]);
+						unset($conf["webSock::encode"]);
+						#如果執行失敗
+						if($talkback["status"]==="false"){
+							#印出結果
+							var_dump($talkback);
+							#結束執行
+							exit;
+							}#if end
+						#debug
+						#var_dump(__LINE__,$talkback);
+						}#if end
+					}#if end
+				}#if end
+			#反之不為 web socket 訊息
+			else{
+				#儲存成只有一個訊息
+				$talkback["content"][]=$talkback;
+				}#else
+			#針對每個訊息的分段
+			foreach($talkback["content"] as $msg){
+				#回傳訊息
+				$socket_write=socket_write($connections[$conIndex]["connect"], $msg, strlen($msg));
+				#debug
+				var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+				}#foreach end
+			#設置執行正常
+			$result["status"]="true";
+			#回傳結果
+			return $result;
+			}#if end
+		#反之如果收到 "talkTo?"
+		else if($receivedData==="talkTo?"){
+			#如果尚未認證
+			if($connections[$conIndex]["auth"]==="false"){
+				#設置要回傳的訊息
+				$talkback=json_encode("permission denied");
+				}#if end
+			#反之
+			else{
+				#初始化要講話的id陣列
+				$talkback=array();
+				#有幾個要講話的人就執行幾次
+				foreach($connections[$conIndex]["talkTo"] as $to){
+					#串街要講話的人
+					$talkback[]=$to;
+					}#foreach end
+				#設置要回傳的訊息
+				$talkback=json_encode($talkback).PHP_EOL;
+				}#else end
+			#如果是 ws 模式
+			if($conf["wsMode"]==="true"){
+				#如果已經 handshake 過
+				if($connections[$conIndex]["handshaked"]==="true"){
+					#如果要 unmask
+					if($connections[$conIndex]["unmask"]==="true"){
+						#函式說明:
+						#加密 handshake 後要傳送的訊息
+						#回傳結果:
+						#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+						#$result["error"],執行不正常結束的錯訊息陣列.
+						#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+						#$result["argu"],陣列,使用的參數.
+						#必填參數:
+						#$conf["text"],字串,要加密的訊息.
+						$conf["webSock::encode"]["text"]=$talkback;
+						#可省略參數:
+						#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+						#$conf["payloadIsBin"]="false";
+						#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+						#$conf["ping"]="false";
+						#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+						#$conf["pong"]="false";
+						#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+						#$conf["frames"]=array();
+						#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+						#$conf["mask"]="false";
+						#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+						#$conf["debug"]="false";
+						#參考資料:
+						#無.
+						#備註:
+						#目前$conf["text"]長度超過125會出錯.
+						$talkback=webSock::encode($conf["webSock::encode"]);
+						unset($conf["webSock::encode"]);
+						#如果執行失敗
+						if($talkback["status"]==="false"){
+							#印出結果
+							var_dump($talkback);
+							#結束執行
+							exit;
+							}#if end
+						#debug
+						#var_dump(__LINE__,$talkback);
+						}#if end
+					}#if end
+				}#if end
+			#反之不為 web socket 訊息
+			else{
+				#儲存成只有一個訊息
+				$talkback["content"][]=$talkback;
+				}#else
+			#針對每個訊息的分段
+			foreach($talkback["content"] as $msg){
+				#回傳訊息
+				$socket_write=socket_write($connections[$conIndex]["connect"], $msg, strlen($msg));
+				#debug
+				#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+				}#foreach end
+			#設置執行正常
+			$result["status"]="true";
+			#回傳結果
+			return $result;
+			}#if end
+		#如果收到的訊息長度大於 "talkTo:"
+		if(strlen($receivedData)>strlen("talkTo:")){
+			#如果收到開頭為 "talkTo:"
+			#涵式說明：
+			#取得符合特定字首與字尾的字串
+			#回傳的結果：
+			#$result["status"]，若爲"true"則代表執行正常；若爲"false"則代表執行失敗。
+			#$result["function"],當前執行的函數名稱.
+			#$result["error"],錯誤訊息陣列.
+			#$result["founded"],若為"true"則代表有找到符合字首條件的結果；若爲"false"則代表沒有找到。
+			#$result["returnString"]，爲符合字首條件的字串內容。
+			#必填參數:
+			#$conf["checkString"],字串,要檢查的字串.
+			$conf["search::getMeetConditionsString"]["checkString"]=$receivedData;
+			#可省略參數:
+			#$conf["frontWord"],字串,用來檢查字首應該要有什麼字串,預設不指定.
+			$conf["search::getMeetConditionsString"]["frontWord"]="talkTo:";
+			#$conf["tailWord"],字串,用來檢查字尾應該要有什麼字串,預設不指定.
+			#$conf["tailWord"]="";
+			#參考資料:
+			#str_spilt(),可以將字串依照字母分割成一個個陣列字串。
+			$getMeetConditionsString=search::getMeetConditionsString($conf["search::getMeetConditionsString"]);
+			unset($conf["search::getMeetConditionsString"]);
+			#如果選找前置字串 "talkTo:" 失敗
+			if($getMeetConditionsString["status"]==="false"){
+				#設置執行失敗
+				$result["status"]="false";
+				#設置執行錯誤訊息
+				$result["error"]=$getMeetConditionsString;
+				#回傳結果
+				return $result;
+				}#if end
+			#如果存在 "talkTo:" 前置字串
+			if($getMeetConditionsString["founded"]==="true"){
+				#如果尚未認證
+				if($connections[$conIndex]["auth"]==="false"){
+					#設置要回傳的訊息
+					$talkback=json_encode("permission denied");
+					#如果是 ws 模式
+					if($conf["wsMode"]==="true"){
+						#如果已經 handshake 過
+						if($connections[$conIndex]["handshaked"]==="true"){
+							#如果要 unmask
+							if($connections[$conIndex]["unmask"]==="true"){
+								#函式說明:
+								#加密 handshake 後要傳送的訊息
+								#回傳結果:
+								#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+								#$result["error"],執行不正常結束的錯訊息陣列.
+								#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+								#$result["argu"],陣列,使用的參數.
+								#必填參數:
+								#$conf["text"],字串,要加密的訊息.
+								$conf["webSock::encode"]["text"]=$talkback;
+								#可省略參數:
+								#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+								#$conf["payloadIsBin"]="false";
+								#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+								#$conf["ping"]="false";
+								#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+								#$conf["pong"]="false";
+								#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+								#$conf["frames"]=array();
+								#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+								#$conf["mask"]="false";
+								#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+								#$conf["debug"]="false";
+								#參考資料:
+								#無.
+								#備註:
+								#目前$conf["text"]長度超過125會出錯.
+								$talkback=webSock::encode($conf["webSock::encode"]);
+								unset($conf["webSock::encode"]);
+								#如果執行失敗
+								if($talkback["status"]==="false"){
+									#印出結果
+									var_dump($talkback);
+									#結束執行
+									exit;
+									}#if end
+								#debug
+								#var_dump(__LINE__,$talkback);
+								}#if end
+							}#if end
+						}#if end
+					#反之不為 web socket 訊息
+					else{
+						#儲存成只有一個訊息
+						$talkback["content"][]=$talkback;
+						}#else
+					#針對每個訊息的分段
+					foreach($talkback["content"] as $msg){
+						#回傳訊息
+						$socket_write=socket_write($connections[$conIndex]["connect"], $msg, strlen($msg));
+						#debug
+						#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+						}#foreach end
+					#設置執行正常
+					$result["status"]="true";
+					#回傳結果
+					return $result;
+					}#if end
+				#用 "talkTo:" 分割收到的訊息
+				#涵式說明：
+				#將固定格式的字串分開，並回傳分開的結果。
+				#回傳結果:
+				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+				#$result["error"],錯誤訊息陣列
+				#$result["function"],當前執行的函數名稱.
+				#$result["oriStr"],要分割的原始字串內容
+				#$result["dataArray"],爲分割好字串的陣列內容,$result["dataArray"][$i]爲第($i+1)段的內容。
+				#$result["dataCounts"],爲總共分成幾段
+				#$result["found"],是否有在$conf["stringIn"]找到$conf["spiltSymbol"],"true"代表有找到,"false"代表沒有找到.
+				#必填的參數:
+				$conf["stringProcess::spiltString"]["stringIn"]=$receivedData;#要處理的字串。
+				$conf["stringProcess::spiltString"]["spiltSymbol"]="talkTo:";#爲以哪個符號作爲分割
+				#可省略參數:
+				#$conf["allowEmptyStr"],是否允許分割出來空字串,預設為"false"不允許;"true"代表允許.
+				$conf["stringProcess::spiltString"]["allowEmptyStr"]="false";
+				$spiltString=stringProcess::spiltString($conf["stringProcess::spiltString"]);
+				unset($conf["stringProcess::spiltString"]);
+				#如果分割字串失敗
+				if($spiltString["status"]==="false"){
+					#設置執行失敗
+					$result["status"]="false";
+					#設置執行錯誤訊息
+					$result["error"]=$spiltString;
+					#回傳結果
+					return $result;
+					}#if end
+				#如果剛好分割出一筆資料
+				if($spiltString["dataCounts"]===1){
+					#取得自己的id
+					$myId=$connections[$conIndex]["id"];
+					#取得講話對象的id
+					$toId=$spiltString["dataArray"][0];
+					#設置對象不存在的識別
+					$targetExist=false;
+					#設置通話對象的key
+					$targetKey="";
+					#取得除了自己的id以外的所有連線
+					foreach($connections as $index=>$talkInfo){
+						#除了自己的id
+						if($talkInfo["id"]!==$myId){
+							#如果存在要對話的對象
+							if($talkInfo["id"]===$toId){
+								#設置對象存在的識別
+								$targetExist=true;
+								#通話對象的key
+								$targetKey=$index;
+								}#if end
+							}#if end
+						}#for each end
+					#如果通話對象存在
+					if($targetExist){
+						#保存自己的通話對象
+						$connections[$conIndex]["talkTo"][]=$toId;
+						#設置要給自己看的訊息
+						$talkback="您與 ".$toId." 展開對話";
+						#json encode 要給自己看的訊息
+						$talkback=json_encode($talkback).PHP_EOL;
+						#如果是 ws 模式
+						if($conf["wsMode"]==="true"){
+							#如果已經 handshake 過
+							if($connections[$conIndex]["handshaked"]==="true"){
+								#如果要 unmask
+								if($connections[$conIndex]["unmask"]==="true"){
+									#函式說明:
+									#加密 handshake 後要傳送的訊息
+									#回傳結果:
+									#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+									#$result["error"],執行不正常結束的錯訊息陣列.
+									#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+									#$result["argu"],陣列,使用的參數.
+									#必填參數:
+									#$conf["text"],字串,要加密的訊息.
+									$conf["webSock::encode"]["text"]=$talkback;
+									#可省略參數:
+									#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+									#$conf["payloadIsBin"]="false";
+									#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+									#$conf["ping"]="false";
+									#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+									#$conf["pong"]="false";
+									#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+									#$conf["frames"]=array();
+									#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+									#$conf["mask"]="false";
+									#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+									#$conf["debug"]="false";
+									#參考資料:
+									#無.
+									#備註:
+									#目前$conf["text"]長度超過125會出錯.
+									$talkback=webSock::encode($conf["webSock::encode"]);
+									unset($conf["webSock::encode"]);
+									#如果執行失敗
+									if($talkback["status"]==="false"){
+										#印出結果
+										var_dump($talkback);
+										#結束執行
+										exit;
+										}#if end
+									#debug
+									#var_dump(__LINE__,$talkback);
+									}#if end
+								}#if end
+							}#if end
+						#反之不為 web socket 訊息
+						else{
+							#儲存成只有一個訊息
+							$talkback["content"][]=$talkback;
+							}#else
+						#針對每個訊息的分段
+						foreach($talkback["content"] as $msg){
+							#回傳訊息
+							$socket_write=socket_write($connections[$conIndex]["connect"], $msg, strlen($msg));
+							#debug
+							#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+							}#foreach end
+						#讓對方可以跟自己對話
+						$connections[$targetKey]["talkTo"][]=$myId;
+						#設置要給對方看的訊息
+						$talkback=$connections[$conIndex]["id"]." 與您展開對話";
+						#json encode 設置要給對方看的訊息
+						$talkback=json_encode($talkback);
+						#如果是 ws 模式
+						if($conf["wsMode"]==="true"){
+							#如果已經 handshake 過
+							if($connections[$conIndex]["handshaked"]==="true"){
+								#如果要 unmask
+								if($connections[$conIndex]["unmask"]==="true"){
+									#函式說明:
+									#加密 handshake 後要傳送的訊息
+									#回傳結果:
+									#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+									#$result["error"],執行不正常結束的錯訊息陣列.
+									#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+									#$result["argu"],陣列,使用的參數.
+									#必填參數:
+									#$conf["text"],字串,要加密的訊息.
+									$conf["webSock::encode"]["text"]=$talkback;
+									#可省略參數:
+									#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+									#$conf["payloadIsBin"]="false";
+									#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+									#$conf["ping"]="false";
+									#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+									#$conf["pong"]="false";
+									#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+									#$conf["frames"]=array();
+									#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+									#$conf["mask"]="false";
+									#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+									#$conf["debug"]="false";
+									#參考資料:
+									#無.
+									#備註:
+									#目前$conf["text"]長度超過125會出錯.
+									$talkback=webSock::encode($conf["webSock::encode"]);
+									unset($conf["webSock::encode"]);
+									#如果執行失敗
+									if($talkback["status"]==="false"){
+										#印出結果
+										var_dump($talkback);
+										#結束執行
+										exit;
+										}#if end
+									#debug
+									#var_dump(__LINE__,$talkback);
+									}#if end
+								}#if end
+							}#if end
+						#反之不為 web socket 訊息
+						else{
+							#儲存成只有一個訊息
+							$talkback["content"][]=$talkback;
+							}#else
+						#針對每個訊息的分段
+						foreach($talkback["content"] as $msg){
+							#給對方看的訊息
+							$socket_write=socket_write($connections[$targetKey]["connect"], $msg, strlen($msg));
+							#debug
+							#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+							}#foreach end
+						#設置執行正常
+						$result["status"]="true";
+						#回傳結果
+						return $result;
+						}#if end
+					}#if end
+				}#if end
+			}#if end
+		#不是支援的訊息
+		$result["status"]="continue";
+		#回傳結果
+		return $result;
+		}#function basic end
+	/*
+	#函式說明:
+	#提供webSock::nativeSocketTcpIpServer使用系統功能(system).
+	#回傳結果:
+	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常,"continue"代表不適用.
+	#$result["error"],執行不正常結束的錯訊息陣列.
+	#$result["argu"],陣列,使用的參數.
+	#必填參數:
+	#$conf["data"],字串,收到的bin2hex編碼後再gpg加密過後的json格式資料,必填的key有"randomStr","username","password".
+	$conf["data"]="";
+	#$conf["serverSock"],resource,web socket server socket
+	$conf["serverSock"]=$resource;
+	#$conf["clientSock"],$resource,web socket client socket
+	$conf["clientSock"]=$resource;
+	#$conf["clientInfo"],陣列,web socket client info.
+	$conf["clientInfo"]=array();
+	#$conf["clientIndex"],整數.web socket client index.
+	$conf["clientIndex"];
+	#$conf["allConn"],陣列,all web socket client info.
+	$conf["allConn"]=array();
+	#可省略參數:
+	#$conf["wsMode"],字串,是否要按照rfc6555,預設為"true"為是;"false"為否.
+	#$conf["wsMode"]="true";
+	#$conf["gpgId"],字串,用於加解密的gpg id,預設為gnupgId.
+	#$conf["gpgId"]=gnupgId;
+	#參考資料:
+	#https://www.rfc-editor.org/rfc/rfc6455#page-28, Web Socket Base Framing Protocol.
+	#備註:
+	#收到用戶的"shutdown"訊息,會重新啟動webSocket server.
+	#無.
+	*/
+	public static function system(&$conf){
+		#初始化要回傳的結果
+		$result=array();
+		#取得當前執行的函數名稱
+		$result["function"]=__FUNCTION__;
+		#涵式說明：
+		#判斷當前環境為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["function"],當前執行的函式名稱.
+		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
+		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
+		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
+		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
+		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
+		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
+		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
+		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
+		#必填寫的參數：
+		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
+		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
+		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("data","serverSock","clientInfo","clientIndex","allConn");
+		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","resource","array","string","array");
+		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
+		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
+		#可以省略的參數：
+		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
+		#$conf["canBeEmptyString"]="false";
+		#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
+		#$conf["canNotBeEmpty"]=array();
+		#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
+		#$conf["canBeEmpty"]=array();
+		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
+		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("wsMode");
+		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("wsMode","gpgId");
+		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
+		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string");
+		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
+		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true",gnupgId);
+		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
+		#$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
+		#取得收到的訊息
+		$receivedData=$conf["data"];
+		#取得 server 的 socket
+		$serverSocket=$conf["serverSock"];
+		#取得 client 的 socket
+		$clientSocket=$conf["clientSock"];
+		#取得 client 的資訊
+		$clientInfo=$conf["clientInfo"];
+		#取得 client 的索引
+		$clientIndex=$conf["clientIndex"];
+		#取得 all clients 的資訊
+		$allConn=&$conf["allConn"];
+		#hex2bin
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$receivedData;
+		#$conf["enCodeType"],"字串",加密的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin",7種,"sha1"較耗時,"md5"較快,"p_hash"適用於密碼加密,"aes256"是對稱式加解密,"qbpwcf"是透過urlencode、json_encode、base64_encode的結果,"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin".
+		$conf["authenticate::enCodeStr"]["enCodeType"]="hex2bin";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["gpgDecrypt"]="false";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		#$conf["gpgId"]="";
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#設置執行異常
+			$result["status"]="false";
+			#設置執行錯誤
+			$result["error"]=$enCodeStr;
+			#回傳結果
+			return $result;
+			}#if end
+		#取得hex2bin後的字串
+		$receivedData=$enCodeStr["content"];
+		#gpg decrypt
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$receivedData;
+		#$conf["enCodeType"],"字串",加密的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin",7種,"sha1"較耗時,"md5"較快,"p_hash"適用於密碼加密,"aes256"是對稱式加解密,"qbpwcf"是透過urlencode、json_encode、base64_encode的結果,"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin".
+		$conf["authenticate::enCodeStr"]["enCodeType"]="gpg";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		$conf["authenticate::enCodeStr"]["gpgDecrypt"]="true";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		$conf["authenticate::enCodeStr"]["gpgId"]=$conf["gpgId"];
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#設置執行異常
+			$result["status"]="false";
+			#設置執行錯誤
+			$result["error"]=$enCodeStr;
+			#回傳結果
+			return $result;
+			}#if end
+		#取得解密後的字串
+		$receivedData=$enCodeStr["content"];
+		#json_decode
+		$receivedData=json_decode($receivedData);
+		#如果收到 "shutdown"
+		if($receivedData==="shutdown"){
+			#設置要回傳的訊息
+			$talkback="Server 即將關閉";
+			#json encode 要回傳的訊息
+			$talkback=json_encode($talkback);
+			#如果是 ws 模式
+			if($conf["wsMode"]==="true"){
+				#如果已經 handshake 過
+				if($connections[$conIndex]["handshaked"]==="true"){
+					#如果要 unmask
+					if($connections[$conIndex]["unmask"]==="true"){
+						#函式說明:
+						#加密 handshake 後要傳送的訊息
+						#回傳結果:
+						#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+						#$result["error"],執行不正常結束的錯訊息陣列.
+						#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+						#$result["argu"],陣列,使用的參數.
+						#必填參數:
+						#$conf["text"],字串,要加密的訊息.
+						$conf["webSock::encode"]["text"]=$talkback;
+						#可省略參數:
+						#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+						#$conf["payloadIsBin"]="false";
+						#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+						#$conf["ping"]="false";
+						#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+						#$conf["pong"]="false";
+						#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+						#$conf["frames"]=array();
+						#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+						#$conf["mask"]="false";
+						#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+						#$conf["debug"]="false";
+						#參考資料:
+						#無.
+						#備註:
+						#無.
+						$talkback=webSock::encode($conf["webSock::encode"]);
+						unset($conf["webSock::encode"]);
+						#如果執行失敗
+						if($talkback["status"]==="false"){
+							#印出結果
+							var_dump($talkback);
+							#結束執行
+							exit;
+							}#if end
+						#debug
+						#var_dump(__LINE__,$talkback);
+						}#if end
+					}#if end
+				}#if end
+			#反之不為 web socket 訊息
+			else{
+				#儲存成只有一個訊息
+				$talkback["content"][]=$talkback;
+				}#else
+			#針對每個訊息的分段
+			foreach($talkback["content"] as $msg){
+				#回傳訊息
+				$socket_write=socket_write($con["connect"], $msg, strlen($msg));
+				#debug
+				#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+				}#foreach end
+			#關閉用戶的連線
+			socket_close($con["connect"]);
+			}#if end
+		#關閉 server socket
+		socket_close($serverSocket);
+		#設置執行正常
+		$result["status"]="true";
+		#回傳結果
+		return $result;
+		}#function system end
+	/*
+	#函式說明:
+	#提供webSock::nativeSocketTcpIpServer使用系統功能(system).
+	#回傳結果:
+	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常,"continue"代表不適用.
+	#$result["error"],執行不正常結束的錯訊息陣列.
+	#$result["argu"],陣列,使用的參數.
+	#必填參數:
+	#$conf["data"],字串,收到的bin2hex編碼後再gpg加密過後的json格式資料.
+	$conf["data"]="";
+	#$conf["serverSock"],resource,web socket server socket
+	$conf["serverSock"]=$resource;
+	#$conf["clientSock"],$resource,web socket client socket
+	$conf["clientSock"]=$resource;
+	#$conf["clientInfo"],陣列,web socket client info.
+	$conf["clientInfo"]=array();
+	#$conf["clientIndex"],整數.web socket client index.
+	$conf["clientIndex"];
+	#$conf["allConn"],陣列,all web socket client info.
+	$conf["allConn"]=array();
+	#可省略參數:
+	#$conf["wsMode"],字串,是否要按照rfc6555,預設為"true"為是;"false"為否.
+	#$conf["wsMode"]="true";
+	#$conf["gpgId"],字串,用於加解密的gpg id,預設為gnupgId.
+	#$conf["gpgId"]=gnupgId;
+	#參考資料:
+	#https://www.rfc-editor.org/rfc/rfc6455#page-28, Web Socket Base Framing Protocol.
+	#備註:
+	#收到用戶的"quit"訊息,會結束與用戶的連線.
+	*/
+	public static function noAuth(&$conf){
+		#初始化要回傳的結果
+		$result=array();
+		#取得當前執行的函數名稱
+		$result["function"]=__FUNCTION__;
+		#涵式說明：
+		#判斷當前環境為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["function"],當前執行的函式名稱.
+		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
+		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
+		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
+		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
+		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
+		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
+		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
+		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
+		#必填寫的參數：
+		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
+		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
+		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("data","serverSock","clientInfo","clientIndex","allConn");
+		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","resource","array","string","array");
+		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
+		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
+		#可以省略的參數：
+		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
+		#$conf["canBeEmptyString"]="false";
+		#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
+		#$conf["canNotBeEmpty"]=array();
+		#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
+		#$conf["canBeEmpty"]=array();
+		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
+		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("wsMode");
+		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("wsMode","gpgId");
+		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
+		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string");
+		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
+		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true",gnupgId);
+		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
+		#$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
+		#取得收到的訊息
+		$receivedData=$conf["data"];
+		#取得 server 的 socket
+		$serverSocket=$conf["serverSock"];
+		#取得 client 的 socket
+		$clientSocket=$conf["clientSock"];
+		#取得 client 的資訊
+		$clientInfo=$conf["clientInfo"];
+		#取得 client 的索引
+		$clientIndex=$conf["clientIndex"];
+		#取得 all clients 的資訊
+		$allConn=&$conf["allConn"];
+		#hex2bin
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$receivedData;
+		#$conf["enCodeType"],"字串",加密的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin",7種,"sha1"較耗時,"md5"較快,"p_hash"適用於密碼加密,"aes256"是對稱式加解密,"qbpwcf"是透過urlencode、json_encode、base64_encode的結果,"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin".
+		$conf["authenticate::enCodeStr"]["enCodeType"]="hex2bin";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["gpgDecrypt"]="false";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		#$conf["gpgId"]="";
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#設置執行異常
+			$result["status"]="false";
+			#設置執行錯誤
+			$result["error"]=$enCodeStr;
+			#回傳結果
+			return $result;
+			}#if end
+		#取得hex2bin後的字串
+		$receivedData=$enCodeStr["content"];
+		#gpg decrypt
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$receivedData;
+		#$conf["enCodeType"],"字串",加密的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin",7種,"sha1"較耗時,"md5"較快,"p_hash"適用於密碼加密,"aes256"是對稱式加解密,"qbpwcf"是透過urlencode、json_encode、base64_encode的結果,"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin".
+		$conf["authenticate::enCodeStr"]["enCodeType"]="gpg";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		$conf["authenticate::enCodeStr"]["gpgDecrypt"]="true";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		$conf["authenticate::enCodeStr"]["gpgId"]=$conf["gpgId"];
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#設置執行異常
+			$result["status"]="false";
+			#設置執行錯誤
+			$result["error"]=$enCodeStr;
+			#回傳結果
+			return $result;
+			}#if end
+		#取得解密後的字串
+		$receivedData=$enCodeStr["content"];
+		#json_decode
+		$receivedData=json_decode($receivedData);
+		#如果訊息內容為 "quit"
+		if($receivedData==="quit"){
+			#設置要回傳的訊息
+			$talkback="結束與 server 的連線";
+			#json encode 要回傳的訊息
+			$talkback=json_encode($talkback).PHP_EOL;
+			#如果是 ws 模式
+			if($conf["wsMode"]==="true"){
+				#如果已經 handshake 過
+				if($connections[$conIndex]["handshaked"]==="true"){
+					#如果要 unmask
+					if($connections[$conIndex]["unmask"]==="true"){
+						#函式說明:
+						#加密 handshake 後要傳送的訊息
+						#回傳結果:
+						#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+						#$result["error"],執行不正常結束的錯訊息陣列.
+						#$result["content"],陣列,加密 handshake 後要傳送給 client 的訊息,若有多個代表要分為多個 Fragmentation 來依序傳送.
+						#$result["argu"],陣列,使用的參數.
+						#必填參數:
+						#$conf["text"],字串,要加密的訊息.
+						$conf["webSock::encode"]["text"]=$talkback;
+						#可省略參數:
+						#$conf["payloadIsBin"],字串,"true"定義Payload data是為2元碼;預設為"false"代表為文字.
+						#$conf["payloadIsBin"]="false";
+						#$conf["ping"],字串,"true"代表為ping訊息;反之為"false",預設為"false".
+						#$conf["ping"]="false";
+						#$conf["pong"],字串,"true"代表為pong訊息;反之為"false",預設為"false".
+						#$conf["pong"]="false";
+						#$conf["frames"],陣列,目前既有的訊息frame,預設為空陣列,代表沒有.
+						#$conf["frames"]=array();
+						#$conf["mask"],字串,代表是否要將內容進行mask,預設為"false",代表不要,適用於server to client;反之為"true"代表要,適用於client to server.
+						#$conf["mask"]="false";
+						#$conf["debug"],字串,"true"代表要show debug訊息;反之為預設"false".
+						#$conf["debug"]="false";
+						#參考資料:
+						#無.
+						#備註:
+						#目前$conf["text"]長度超過125會出錯.
+						$talkback=webSock::encode($conf["webSock::encode"]);
+						unset($conf["webSock::encode"]);
+						#如果執行失敗
+						if($talkback["status"]==="false"){
+							#印出結果
+							var_dump($talkback);
+							#結束執行
+							exit;
+							}#if end
+						#debug
+						#var_dump(__LINE__,$talkback);
+						}#if end
+					}#if end
+				}#if end
+			#反之不為 web socket 訊息
+			else{
+				#儲存成只有一個訊息
+				$talkback["content"][]=$talkback;
+				}#else
+			#針對每個訊息的分段
+			foreach($talkback["content"] as $msg){
+				#回傳訊息
+				$socket_write=socket_write($con["connect"], $msg, strlen($msg));
+				#debug
+				#var_dump(__LINE__,$socket_write,socket_strerror(socket_last_error($con["connect"])));
+				}#foreach end
+			#關閉被 client 的連線
+			socket_close($con["connect"]);
+			#清理連線的陣列
+			unset($connections[$conIndex]);
+			#設置執行正常
+			$result["status"]="true";
+			#回傳結果
+			return $result;
+			}#if end
+		}#function noAuth end
+	/*
+	#函式說明:
+	#依照參數來執行對應的函式.
+	#回傳結果:
+	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+	#$result["function"],當前執行的函數名稱.
+	#$result["content"],加密後的結果.
+	#$result["error"],錯誤訊息陣列.
+	#$result["argu"],使用的參數.
+	#必填參數:
+	#$conf["data"],字串,收到bin2hex編碼後再gpg加密後的資料.
+	$conf["data"]="";
+	#$conf["serverSock"],socket,代表web socket server的socket.
+	$conf["serverSock"]=;
+	#$conf["clientSock"],socket,代表web socket client的socket.
+	#$conf["clientInfo"],陣列,用戶端的資訊.
+	$conf["clientInfo"]=array();
+	#$conf["clientIndex"],字串,代表client於allConn中的索引.
+	$conf["clientIndex"]="";
+	#$conf["allConn"],陣列,所有連線的用戶端的連線資訊.
+	$conf["allConn"]=array();
+	#可省略參數:
+	#無.
+	#參考資料:
+	#無.
+	#備註:
+	#無.
+	*/
+	public static function callFunc(&$conf){
+		#初始化要回傳的結果
+		$result=array();
+		#取得當前執行的函數名稱
+		$result["function"]=__FUNCTION__;
+		#涵式說明：
+		#判斷當前環境為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["function"],當前執行的函式名稱.
+		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
+		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
+		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
+		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
+		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
+		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
+		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
+		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
+		#必填寫的參數：
+		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
+		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
+		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("data","serverSock","clientInfo","clientIndex","allConn");
+		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
+		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","resource","array","string","array");
+		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
+		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
+		#可以省略的參數：
+		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
+		#$conf["canBeEmptyString"]="false";
+		#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
+		#$conf["canNotBeEmpty"]=array();
+		#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
+		#$conf["canBeEmpty"]=array();
+		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
+		#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array();
+		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
+		#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("listenIp","listenPort","wsMode","processFuncs");
+		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
+		#$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","array");
+		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
+		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("127.0.0.1",null,"false",null);
+		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
+		#$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
+		#取得收到的訊息
+		$receivedData=$conf["data"];
+		#取得 server 的 socket
+		$serverSocket=$conf["serverSock"];
+		#取得 client 的 socket
+		$clientSocket=$conf["clientSock"];
+		#取得 client 的資訊
+		$clientInfo=$conf["clientInfo"];
+		#取得 client 的索引
+		$clientIndex=$conf["clientIndex"];
+		#取得 all clients 的資訊
+		$allConn=$conf["allConn"];
+		#hex2bin
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,gpg,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$receivedData;
+		#$conf["enCodeType"],"字串",加密或編碼的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin"與"gpg"與"hex2bin&gpg",9種,"sha1"較耗時;"md5"較快;"p_hash"適用於密碼加密;"aes256"是對稱式加解密;"qbpwcf"是透過urlencode、json_encode、base64_encode的結果;"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin";"gpg"是應用gpg進行加解密,需要先有ID對應的key;"hex2bin&gpg"為先hex2bin在進行gpg加解密.
+		$conf["authenticate::enCodeStr"]["enCodeType"]="hex2bin";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["gpgDecrypt"]="false";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		$conf["authenticate::enCodeStr"]["gpgId"]=gnupgId;
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#印出結果
+			return $enCodeStr;
+			}#if end
+		#用GnuPG解密
+		#函式說明:
+		#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,gpg,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.
+		#回傳結果:
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["function"],當前執行的函數名稱.
+		#$result["content"],加密後的結果.
+		#$result["error"],錯誤訊息陣列.
+		#$result["argu"],使用的參數.
+		#必填參數:
+		#$conf["enCodeStr"],any,要加密的字串,陣列,物件.
+		$conf["authenticate::enCodeStr"]["enCodeStr"]=$$enCodeStr["content"];
+		#$conf["enCodeType"],"字串",加密或編碼的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin"與"gpg"與"hex2bin&gpg",9種,"sha1"較耗時;"md5"較快;"p_hash"適用於密碼加密;"aes256"是對稱式加解密;"qbpwcf"是透過urlencode、json_encode、base64_encode的結果;"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin";"gpg"是應用gpg進行加解密,需要先有ID對應的key;"hex2bin&gpg"為先hex2bin在進行gpg加解密.
+		$conf["authenticate::enCodeStr"]["enCodeType"]="gpg";
+		#可省略參數:
+		#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".
+		#$conf["sha1Raw"]="false";
+		#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.
+		#$conf["p_hash"]="";
+		#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.
+		#$conf["keyForAes256"]="";
+		#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.
+		#$conf["aes256Encode"]="";
+		#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["qbpwcfDecode"]="false";
+		#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.
+		#$conf["gpgDecrypt"]="false";
+		#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,該參數必填.
+		$conf["authenticate::enCodeStr"]["gpgId"]=gnupgId;
+		#參考資料:
+		#sha1=>http://php.net/manual/en/function.sha1.php
+		#md5=>http://php.net/manual/en/function.md5.php
+		#password_hash=>http://php.net/manual/en/function.password-hash.php
+		#password_verify=>http://php.net/manual/en/function.password-verify.php
+		#json_decode=>https://www.php.net/manual/en/function.json-decode.php
+		#備註:
+		#無.
+		$enCodeStr=authenticate::enCodeStr($conf["authenticate::enCodeStr"]);
+		unset($conf["authenticate::enCodeStr"]);
+		#如果執行失敗
+		if($enCodeStr["status"]==="false"){
+			#印出結果
+			return $enCodeStr;
+			}#if end
+		#解碼取得的內容
+		$receivedData=json_decode($enCodeStr["content"]);
+		#如果有設置 callFunc
+		if(isset($receivedData->callFunc)){
+			#取得要呼叫的函式
+			$func=$receivedData->callFunc;
+			#檢查是否有權限執行該函式
+			#函式說明:
+			#提供webSock::nativeSocketTcpIpServer用於接受檢查權限的功能.
+			#回傳結果:
+			#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+			#$result["error"],執行不正常結束的錯訊息陣列.
+			#$result["argu"],陣列,使用的參數.
+			#必填參數:
+			#$conf["data"],字串,收到的bin2hex編碼後果gpg加密過後的json格式資料,必填的key有"randomStr","username","password".
+			$conf["self::checkAuth"]["data"]=$conf["data"];
+			#$conf["serverSock"],resource,web socket server socket
+			$conf["self::checkAuth"]["serverSock"]=$conf["serverSock"];
+			#$conf["clientSock"],$resource,web socket client socket
+			$conf["self::checkAuth"]["clientSock"]=$conf["clientSock"];
+			#$conf["clientInfo"],陣列,web socket client info.
+			$conf["self::checkAuth"]["clientInfo"]=$conf["clientInfo"];
+			#$conf["clientIndex"],整數.web socket client index.
+			$conf["self::checkAuth"]["clientIndex"]=$conf["clientIndex"];
+			#$conf["allConn"],陣列,all web socket client info.
+			$conf["self::checkAuth"]["allConn"]=$conf["allConn"];
+			#$conf["func"],字串,要檢查的是否具備權限的函式.
+			$conf["self::checkAuth"]["func"]=$func;
+			#可省略參數:
+			#$conf["wsMode"],字串,是否要按照rfc6555,預設為"true"為是;"false"為否.
+			#$conf["wsMode"]="true";
+			#$conf["gpgId"],字串,用於加解密的gpg id,預設為gnupgId.
+			#$conf["gpgId"]=gnupgId;
+			#$conf["falseAllowFuncPlus"],陣列,額外的未認證時可以執行的函式清單.
+			#$conf["falseAllowFuncPlus"]=array();
+			#$conf["publicAllowFuncPlus"],陣列,額外的認證為public時可以執行的函式清單.
+			#$conf["publicAllowFuncPlus"]=array();
+			#參考資料:
+			#https://www.rfc-editor.org/rfc/rfc6455#page-28, Web Socket Base Framing Protocol.
+			#備註:
+			#無.
+			$checkAuth=self::checkAuth($conf["self::checkAuth"]);
+			unset($conf["self::checkAuth"]);
+			#如果異常
+			if($checkAuth["status"]==="false"){
+				#回傳結果
+				return $checkAuth;
+				}#if end
+			#移除使用好的元素
+			unset($receivedData["callFunc"]);
+			#置換data為未加密的內容
+			$conf["data"]=json_encode($receivedData);
+			#呼叫對應的函式
+			return eval($func."(&\$conf);");
+			}#if end
+		#設置執行失敗
+		$result["ststus"]="false";
+		#回傳結果
+		return $result;
+		}#function callFunc end
 	}#class webSock end
 ?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/webSock.php – Rev 3 → 66