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

 <?php
 /*
 	QBPWCF, Quick Build PHP website Component base on Fedora Linux.
-    Copyright (C) 2014~2025 Min-Jhin,Chen
+    Copyright (C) 2014~2025 MIN ZHI, CHEN
     This file is part of QBPWCF.
     QBPWCF is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
 		#回傳結果
 		return $result;
 		}#function __callStatic end
 	/*
 	#函式說明:
 	#檢查陣列裡面的特定元素是否存在以及其變數型態是否正確，如果沒有設定則回傳提示訊息。
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 							#如果有設定$conf["variableType"]
 							if(isset($conf["variableType"])){
 								#如果正確 type 為 "resource"
 								if($conf["variableType"][$typeCount]==="resource"){
 									#如果是 resource 開頭的形態
 									if(strpos(gettype($varInputValue),$conf["variableType"][$typeCount])===0){
 										#則給予型態認證通過的識別
 										$result["content"][$shouldBtCheckedVarName]["varType"]="true";
 										}#if end
 									}#if end
 								#反之如果該變數的型態正確 或是要求的形態為null 或為 "any"
 								else if($conf["variableType"][$typeCount]===gettype($varInputValue) || $conf["variableType"][$typeCount]===null || $conf["variableType"][$typeCount]==="any"){
 						}#if end
 					}#foreach end
 				}#foreach end
 			}#if end
 		#如果 $result["passed"] 沒有設置
 		if(!isset($result["passed"])){
 			}#if end
 		#如果是 resource
 		if($conf["vType"]==="resource"){
 			#如果不是開頭為 "resource"  的形態
 			if(strpos(gettype($conf["vName"]),$conf["vType"])!==0){
 				#設置執行正常
 				$result["status"]="true";
 				#設置檢查不通過
 				$result["passed"]="false";
 				#設置錯誤訊息
 				$result["error"][]="變數\$conf[\"vName\"]的形態應為".$conf["vType"];
 				#回傳結果
 				return $result;
 				}#if end
 			}#if end
 		#反之若其變數形態不爲 $conf["vType"] 且期望的變數型態不為 "any"
 		else if(gettype($conf["vName"])!=$conf["vType"] && $conf["vType"]!=="any"){
 					#如果 $conf["checkedVar"][$conf["sikpableVarNameArray"][$i]] 的型態不等於 $conf["sikpableVarTypeArray"][$i] 且 $conf["skipableVarTypeArray"][$i] 不為 null
 					if(gettype($conf["checkedVar"][$conf["sikpableVarNameArray"][$i]])!=$conf["skipableVarTypeArray"][$i] && $conf["skipableVarTypeArray"][$i]!=null){
 						#type "any" 不用檢查
 						if($conf["skipableVarTypeArray"][$i]!=="any"){
 							#設置執行正常
 							$result["status"]="true";
 							#設置執行錯誤識別
 							$result["passed"]="false";
 							#設置錯誤訊息
 							$result["error"][]=$conf["sikpableVarNameArray"][$i]."須為".$conf["skipableVarTypeArray"][$i]."型態";
 							#回傳結果
 							return $result;
 							}#if end
 						}#if end
 					}#if end
 	#array_keys=>http://php.net/manual/en/function.array-keys.php
 	#備註:
 	#無.
 	*/
 	public static function checkArguments(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#設置當其函數名稱
 		$result["function"]=__FUNCTION__;
 			$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 			unset($conf["variableCheck::getSimpleError"]);
 			#如果執行失敗
 			if($getSimpleError["status"]==="false"){
 				#設置執行錯誤訊息
 				$result["error"][]=$getSimpleError;
 				#回傳結果
 				return $result;
 				}#if end
 			$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 			unset($conf["variableCheck::getSimpleError"]);
 			#如果執行失敗
 			if($getSimpleError["status"]==="false"){
 				#設置執行錯誤訊息
 				$result["error"][]=$getSimpleError;
 				#回傳結果
 				return $result;
 				}#if end
 		#如果檢查不通過
 		if($checkResult["passed"]==="false"){
 			#設置執正常
 			$result["status"]="true";
 			#設置錯誤識別
 			$result["passed"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 			unset($conf["variableCheck::getSimpleError"]);
 			#如果執行失敗
 			if($getSimpleError["status"]==="false"){
 				#設置執行錯誤訊息
 				$result["error"][]=$getSimpleError;
 				#回傳結果
 				return $result;
 				}#if end
 			$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 			unset($conf["variableCheck::getSimpleError"]);
 			#如果執行失敗
 			if($getSimpleError["status"]==="false"){
 				#設置執行錯誤訊息
 				$result["error"][]=$getSimpleError;
 				#回傳結果
 				return $result;
 				}#if end
 		#如果檢查不通過
 		if($checkResult["passed"]=="false"){
 			#設置執正常
 			$result["status"]="true";
 			#設置錯誤識別
 			$result["passed"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 			unset($conf["variableCheck::getSimpleError"]);
 			#如果執行失敗
 			if($getSimpleError["status"]==="false"){
 				#設置執行錯誤訊息
 				$result["error"][]=$getSimpleError;
 				#回傳結果
 				return $result;
 				}#if end
 				$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 				unset($conf["variableCheck::getSimpleError"]);
 				#如果執行失敗
 				if($getSimpleError["status"]==="false"){
 					#設置執行錯誤訊息
 					$result["error"][]=$getSimpleError;
 					#回傳結果
 					return $result;
 					}#if end
 				$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 				unset($conf["variableCheck::getSimpleError"]);
 				#如果執行失敗
 				if($getSimpleError["status"]==="false"){
 					#設置執行錯誤訊息
 					$result["error"][]=$getSimpleError;
 					#回傳結果
 					return $result;
 					}#if end
 				#設置 $simpleError
 				$result["simpleError"]=$getSimpleError["content"];
 				#回傳結果
 				return $result;
 				}#if end
 			#如果檢查不通過
 			if($checkResult["passed"]=="false"){
 				#設置執正常
 				$result["status"]="true";
 				#設置錯誤識別
 				$result["passed"]="false";
 				#設置錯誤訊息
 				$result["error"]=$checkResult;
 				$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 				unset($conf["variableCheck::getSimpleError"]);
 				#如果執行失敗
 				if($getSimpleError["status"]==="false"){
 					#設置執行錯誤訊息
 					$result["error"][]=$getSimpleError;
 					#回傳結果
 					return $result;
 					}#if end
 				$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 				unset($conf["variableCheck::getSimpleError"]);
 				#如果執行失敗
 				if($getSimpleError["status"]==="false"){
 					#設置執行錯誤訊息
 					$result["error"][]=$getSimpleError;
 					#回傳結果
 					return $result;
 					}#if end
 			#如果 $conf["skipableVariableName"] 與 $conf["skipableVarDefaultValue"] 的元素數量不一致
 			if(count($conf["skipableVariableName"])!=count($conf["skipableVarDefaultValue"])){
 				#設置執正常
 				$result["status"]="true";
 				#設置錯誤識別
 				$result["passed"]="false";
 				#設置錯誤訊息
 				$result["error"][]="\$conf[\"skipableVariableName\"] 與 \$conf[\"skipableVarDefaultValue\"] 的元素數量不一致";
 				$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 				unset($conf["variableCheck::getSimpleError"]);
 				#如果執行失敗
 				if($getSimpleError["status"]==="false"){
 					#設置執行錯誤訊息
 					$result["error"][]=$getSimpleError;
 					#回傳結果
 					return $result;
 					}#if end
 										$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 										unset($conf["variableCheck::getSimpleError"]);
 										#如果執行失敗
 										if($getSimpleError["status"]==="false"){
 											#設置執行錯誤訊息
 											$result["error"][]=$getSimpleError;
 											#回傳結果
 											return $result;
 											}#if end
 						}#if end
 					}#if end
 				}#else end
 			#如果可省略變數有 any 型別
 			if(in_array("any",$conf["skipableVariableType"])){
 				#儲存可以為任意形態的變數
 				$anyTypeVarName=array();
 				#針對每個可省略參數的形態
 				foreach($conf["skipableVariableType"] as $varKey=>$varType){
 					#如果找到形態為any的變數形態
 					if($varType==="any"){
 						#儲存形態為 any 的可省略變數名稱
 						$anyTypeVarName[]=$conf["skipableVariableName"][$varKey];
 						}#if end
 					}#foreach end
 				#針對每個 any type 的可省略變數名稱
 				foreach($anyTypeVarName as $varName){
 					#如果該可省略變數存在
 					if(isset($conf["varInput"][$varName])){
 						#取得變數的形態
 						$varType=gettype($conf["varInput"][$varName]);
 						#判斷變數的形態
 						switch($varType){
 							#如果是字串
 							case "string":
 								#如果 $conf["disallowAllSkipableVarIsEmpty"] 設置為 "true"
 								if($conf["disallowAllSkipableVarIsEmpty"]==="true"){
 									#如果該變數是不被允許的空字串
 									if($conf["varInput"][$varName]===""){
 										#設置執行正常
 										$result["status"]="true";
 										#設置檢查不通過
 										$result["passed"]="false";
 										#設置錯誤訊息
 										$result["warning"][]="可省略參數".$varName."不都得為空陣列";
 										#回傳結果
 										return $result;
 										}#if end
 									}#if end
 								#跳出switch
 								break;
 							#如果是陣列
 							case "array":
 								#如果 $conf["disallowAllSkipableVarIsEmptyArray"] 為 "true"
 								if($conf["disallowAllSkipableVarIsEmptyArray"]==="true"){
 									#如果該變數是不被允許的空陣列
 									if($conf["varInput"][$varName]===array()){
 										#設置執行正常
 										$result["status"]="true";
 										#設置檢查不通過
 										$result["passed"]="false";
 										#設置錯誤訊息
 										$result["warning"][]="可省略參數".$varName."不都得為空陣列";
 										#回傳結果
 										return $result;
 										}#if end
 									}#if end
 								#跳出switch
 								break;
 							default:
 							}#switch end
 						}#if end
 					}#foreach end
 				}#if end
 			}#if end
 		#如果 $conf["skipableVarDefaultValue"] 有設置
 							$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 							unset($conf["variableCheck::getSimpleError"]);
 							#如果執行失敗
 							if($getSimpleError["status"]==="false"){
 								#設置執行錯誤訊息
 								$result["error"][]=$getSimpleError;
 								#回傳結果
 								return $result;
 								}#if end
 								$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 								unset($conf["variableCheck::getSimpleError"]);
 								#如果執行失敗
 								if($getSimpleError["status"]==="false"){
 									#設置執行錯誤訊息
 									$result["error"][]=$getSimpleError;
 									#回傳結果
 									return $result;
 									}#if end
 								$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 								unset($conf["variableCheck::getSimpleError"]);
 								#如果執行失敗
 								if($getSimpleError["status"]==="false"){
 									#設置執行錯誤訊息
 									$result["error"][]=$getSimpleError;
 									#回傳結果
 									return $result;
 									}#if end
 								$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 								unset($conf["variableCheck::getSimpleError"]);
 								#如果執行失敗
 								if($getSimpleError["status"]==="false"){
 									#設置執行錯誤訊息
 									$result["error"][]=$getSimpleError;
 									#回傳結果
 									return $result;
 									}#if end
 								#設置 $simpleError
 								$result["simpleError"]=$getSimpleError["content"];
 								#回傳結果
 								return $result;
 								}#if end
 							#如果檢查不通過
 							if($checkResult["passed"]=="false"){
 								$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 								unset($conf["variableCheck::getSimpleError"]);
 								#如果執行失敗
 								if($getSimpleError["status"]==="false"){
 									#設置執行錯誤訊息
 									$result["error"][]=$getSimpleError;
 									#回傳結果
 									return $result;
 									}#if end
 								$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 								unset($conf["variableCheck::getSimpleError"]);
 								#如果執行失敗
 								if($getSimpleError["status"]==="false"){
 									#設置執行錯誤訊息
 									$result["error"][]=$getSimpleError;
 									#回傳結果
 									return $result;
 									}#if end
 								}#if end
 							#如果檢查不通過
 							if($checkResult["passed"]=="false"){
 								#設置執正常
 								$result["status"]="true";
 								#設置錯誤識別
 								$result["passed"]="false";
 								#設置錯誤訊息
 								$result["error"]=$checkResult;
 								$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 								unset($conf["variableCheck::getSimpleError"]);
 								#如果執行失敗
 								if($getSimpleError["status"]==="false"){
 									#設置執行錯誤訊息
 									$result["error"][]=$getSimpleError;
 									#回傳結果
 									return $result;
 									}#if end
 							$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 							unset($conf["variableCheck::getSimpleError"]);
 							#如果執行失敗
 							if($getSimpleError["status"]==="false"){
 								#設置執行錯誤訊息
 								$result["error"][]=$getSimpleError;
 								#回傳結果
 								return $result;
 								}#if end
 						#如果檢查不通過
 						if($checkResult["passed"]=="false"){
 							#設置執正常
 							$result["status"]="true";
 							#設置錯誤識別
 							$result["passed"]="false";
 							#設置錯誤訊息
 							$result["error"]=$checkResult;
 							$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 							unset($conf["variableCheck::getSimpleError"]);
 							#如果執行失敗
 							if($getSimpleError["status"]==="false"){
 								#設置執行錯誤訊息
 								$result["error"][]=$getSimpleError;
 								#回傳結果
 								return $result;
 								}#if end
 						$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 						unset($conf["variableCheck::getSimpleError"]);
 						#如果執行失敗
 						if($getSimpleError["status"]==="false"){
 							#設置執行錯誤訊息
 							$result["error"][]=$getSimpleError;
 							#回傳結果
 							return $result;
 							}#if end
 					#如果檢查不通過
 					if($checkResult["passed"]=="false"){
 						#設置執正常
 						$result["status"]="true";
 						#設置錯誤識別
 						$result["passed"]="false";
 						#設置錯誤訊息
 						$result["error"]=$checkResult;
 						$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 						unset($conf["variableCheck::getSimpleError"]);
 						#如果執行失敗
 						if($getSimpleError["status"]==="false"){
 							#設置執行錯誤訊息
 							$result["error"][]=$getSimpleError;
 							#回傳結果
 							return $result;
 							}#if end
 					#如果跟第一個變數的元素數量不一樣
 					if($tempEqualCount[0]!=$tempEqualCount[$j]){
 						#設置執正常
 						$result["status"]="true";
 						#設置錯誤識別
 						$result["passed"]="false";
 						#設置錯誤訊息
 						$result["error"][]="key為".$conf["arrayCountEqualCheck"][$i][0]."與".$conf["arrayCountEqualCheck"][$i][$j]."的參數其元數數量不一致";
 						$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 						unset($conf["variableCheck::getSimpleError"]);
 						#如果執行失敗
 						if($getSimpleError["status"]==="false"){
 							#設置執行錯誤訊息
 							$result["error"][]=$getSimpleError;
 							#回傳結果
 							return $result;
 							}#if end
 				$arguArray[]=$conf["skipableVariableName"][$i];
 				}#for end
 			}#if end
 		#如果有可省略變數的any形態變數設定
 		if(isset($anyTypeVarName)){
 			#針對每個可省略的any形態變數
 			foreach($anyTypeVarName as $varName){
 				#記錄參數
 				$arguArray[]=$varName;
 				}#foreach end
 			}#if end
 		#初始化儲存已經輸入的參數名稱陣列
 		$inputVarArray=array();
 			$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 			unset($conf["variableCheck::getSimpleError"]);
 			#如果執行失敗
 			if($getSimpleError["status"]==="false"){
 				#設置執行錯誤訊息
 				$result["error"][]=$getSimpleError;
 				#回傳結果
 				return $result;
 				}#if end
 				$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 				unset($conf["variableCheck::getSimpleError"]);
 				#如果執行失敗
 				if($getSimpleError["status"]==="false"){
 					#設置執行錯誤訊息
 					$result["error"][]=$getSimpleError;
 					#回傳結果
 					return $result;
 					}#if end
 			}#if end
 		#如果有設定可省略參數且不允許所有可省略變數都不存在
 		if( isset($conf["skipableVariableName"]) && ($conf["disallowAllSkipableVarNotExist"]==="true") ){
 			#函式說明:
 			#檢查多個字串中的每個字串是否有多個關鍵字
 			#回傳結果:
 			#$result["status"],整體來說，執行是否成功，"true"代表執行成功，"false"代表執行失敗。
 			#$result["function"],當前執行的函數名稱.
 			#無.
 			#備註:
 			#無.
 			$findManyKeyWordsFromManyString=search::findManyKeyWordsFromManyString($conf["search::findManyKeyWordsFromManyString"]);
 			unset($conf["search::findManyKeyWordsFromManyString"]);
 			#如果執行失敗
 			if($findManyKeyWordsFromManyString["status"]==="false"){
 				#設置錯誤識別
 				$result["status"]="false";
 				#設置檢查不通過
 				$result["passed"]="false";
 				#設置執行錯誤訊息
 				$result["error"]=$findManyKeyWordsFromManyString;
 				#函式說明:
 				#取得簡單的錯誤訊息
 				$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 				unset($conf["variableCheck::getSimpleError"]);
 				#如果執行失敗
 				if($getSimpleError["status"]==="false"){
 					#設置執行錯誤訊息
 					$result["error"][]=$getSimpleError;
 					#回傳結果
 					return $result;
 					}#if end
 				#設置 $simpleError
 				$result["simpleError"]=$getSimpleError["content"];
 				#回傳結果
 				return $result;
 				}#if end
 			#如果沒有找到至少一個可省略參數存在
 			if(count($findManyKeyWordsFromManyString["foundedTrueKey"])===0){
 				#設置執行正常
 				$result["status"]="true";
 				#設置檢查不通過
 				$result["passed"]="false";
 				#設置執行錯誤訊息
 				$result["error"]=$findManyKeyWordsFromManyString;
 				#函式說明:
 				#取得簡單的錯誤訊息
 				$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);
 				unset($conf["variableCheck::getSimpleError"]);
 				#如果執行失敗
 				if($getSimpleError["status"]==="false"){
 					#設置執行錯誤訊息
 					$result["error"][]=$getSimpleError;
 					#回傳結果
 					return $result;
 					}#if end
 				#設置 $simpleError
 				$result["simpleError"]=$getSimpleError["content"];
 				#回傳結果
 				return $result;
 				}#if end
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function toSource(&$conf){
 		#初始化要回傳的內容
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果 $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"],執行不正常結束的錯訊息陣列.
 		#必填寫的參數：
 		#$conf["variableCheck.checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck.checkArguments"]["varInput"]=&$conf;
 		#$conf["variableCheck.checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck.checkArguments"]["mustBeFilledVariableName"]=array("var");
 		#$conf["variableCheck.checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck.checkArguments"]["mustBeFilledVariableType"]=array(null);
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck.checkArguments"]["referenceVarKey"]="variableCheck.checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"false"。
 		#$conf["canBeEmptyString"]="false";
 		#$conf["variableCheck.checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		#$conf["variableCheck.checkArguments"]["skipableVariableName"]=array("varPassed");
 		#$conf["variableCheck.checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		#$conf["variableCheck.checkArguments"]["skipableVariableType"]=array(null);
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		#$conf["variableCheck.checkArguments"]["skipableVarDefaultValue"]=array(null);
 		$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
 		#函式說明:
 		#記錄程式輸出的結果.
 		#回傳結果:
 		#$result["status"],爲查詢是否成功,若爲"true"則成功，若爲"false"則表示失敗了.
 		#$result["error"],錯誤訊息.
 		#無.
 		#備註:
 		#無.
 		$getOutput=record::getOutput($conf["record::getOutput"]);
 		unset($conf["record::getOutput"]);
 		#如果執行失敗
 		if($getOutput["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$getOutput;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得輸出
 		$result["content"]=$getOutput["content"];
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#functino toSource end
 	/*
 	#函式說明:
 	#隱藏元素中可能含有機密的內容.
 	#無.
 	#備註:
 	#目前不支援物件.
 	*/
 	public static function hideParams(&$conf){
 		#取得當前執行的函式
 		$result["function"]=__FUNCTION__;
 		#取得使用的參數
 		$result["argu"]=$conf;
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#若執行失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳內容
 			return $reuslt;
 			}#if end
 		#若檢查不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳內容
 			return $result;
 			}#if end
 		#初始化待處理的陣列變數
 		$unprocessedArray=array(&$conf["params"]);
 		#針對陣列中每個元素
 		while(isset($unprocessedArray[0])){
 			/*
 			#debug
 			echo "<p>";
 			var_dump($unprocessedArray);
 			*/
 			#取得當前元素
 			$element=&$unprocessedArray[0];
 			/*
 			#debug
 			echo "<br>";
 			var_dump(gettype($element));
 			*/
 			#如果元素為陣列
 			if(gettype($element)==="array"){
 				#針對每個變數
 				foreach($element as $arrayKey=>$arrayVal){
 					/*
 					#debug
 					echo "<p>";
 					echo "foreach in \$element, key=".$arrayKey."<br>";
 					echo "content of \$element:".print_r($element,true);
 					#debug
 					echo "<p>";
 					echo "check key:".$arrayKey;
 					*/
 					#函式說明:
 					#檢查一個字串裡面是否有多個關鍵字
 					#回傳結果:
 					#$result["status"],"true"代表執行成功，"false"代表執行失敗.
 					#$result["error"],錯誤訊息.
 					#無.
 					#備註:
 					#無.
 					$findManyKeyWords=search::findManyKeyWords($conf["search::findManyKeyWords"]);
 					unset($conf["search::findManyKeyWords"]);
 					/*
 					#debug
 					echo "<p>";
 					echo "content of \$findManyKeyWords:<br>";
 					var_dump($findManyKeyWords);
 					*/
 					#若執行失敗
 					if($findManyKeyWords["status"]==="false"){
 						#設置執行失敗
 						$result["status"]="false";
 						#設置錯誤訊息
 						$result["error"]=$findManyKeyWords;
 						#回傳內容
 						return $reuslt;
 						}#if end
 					#若有符合的關鍵字
 					if($findManyKeyWords["founded"]==="true"){
 						/*
 						#deubg
 						echo "<p>";
 						echo "置換 key 為 ".$arrayKey." 者的內容為 ".$conf["changedTo"];
 						*/
 						#替換其內容
 						$element[$arrayKey]=$conf["changedTo"];
 						/*
 						#debug
 						echo "<p>";
 						echo "替換其內容後 為 ".print_r($element,true);
 						*/
 						#針對下個元素
 						continue;
 						}#if end
 					#如果數值為陣列
 					if(gettype($arrayVal)==="array"){
 						/*
 						#deubg
 						echo "<p>";
 						echo "新增待處理的陣列 其 key 為 ".$arrayKey;
 						*/
 						#儲存到待處理的陣列中
 						$unprocessedArray[]=&$element[$arrayKey];
 						/*
 						#debug
 						echo "<p>";
 						echo "新增待處理的陣列後 其 內容 為 ".print_r($unprocessedArray,true);
 						*/
 						}#if end
 					}#foreach end
 				}#if end
 			/*
 			#debug
 			echo "<br>";
 			echo "before array_shift, count of \$unprocessedArray:".count($unprocessedArray);
 			echo "<br>";
 			var_dump($unprocessedArray);
 			*/
 			#將第一個元素移除
 			array_shift($unprocessedArray);
 			/*
 			#debug
 			echo "<br>";
 			echo "after array_shift, count of \$unprocessedArray:".count($unprocessedArray);
 			echo "<br>";
 			var_dump($unprocessedArray);
 			echo "<hr>";
 			*/
 			}#while end
 		#設置回傳內容
 		$result["content"]=$conf["params"];
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function hideParams end
 	/*
 	#函式說明:
 	#取得簡單的錯誤訊息
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function getSimpleError(&$conf){
 		#var_dump($conf);
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#無窮迴圈
 			while(true){
 				#遞迴執行
 				$conf["self::getSimpleError"]["error"]=$result;
 				$simpleError=self::getSimpleError($conf["self::getSimpleError"]);
 				unset($conf["self::getSimpleError"]);
 				#如果執行失敗
 				if($simpleError["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤訊息
 					$result["error"]=$simpleError;
 					#下一輪
 					continue;
 					}#if end
 				#結束 while
 				break;
 				}#while end
 			return $result;
 			}#if end
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#無窮迴圈
 			while(true){
 				#遞迴執行
 				$conf["self::getSimpleError"]["error"]=$result;
 				$simpleError=self::getSimpleError($conf["self::getSimpleError"]);
 				unset($conf["self::getSimpleError"]);
 				#如果執行失敗
 				if($simpleError["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤訊息
 					$result["error"]=$simpleError;
 					#下一輪
 					continue;
 					}#if end
 				#結束 while
 				break;
 				}#while end
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		#備註:
 		#無.
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果執行失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$checkArguments;
 			#無窮迴圈
 			while(true){
 				#遞迴執行
 				$conf["self::getSimpleError"]["error"]=$result;
 				$simpleError=self::getSimpleError($conf["self::getSimpleError"]);
 				unset($conf["self::getSimpleError"]);
 				#如果執行失敗
 				if($simpleError["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤訊息
 					$result["error"]=$simpleError;
 					#下一輪
 					continue;
 					}#if end
 				#如果檢查不通過
 				if($simpleError["passed"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤訊息
 					$result["error"]=$simpleError;
 					#下一輪
 					continue;
 					}#if end
 				#結束 while
 				break;
 				}#while end
 			#取得 simpleError
 			$result["simpleError"]=$simpleError["content"];
 			#回傳結果
 			return $result;
 			}#if end
 		#如果執行失敗
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$checkArguments;
 			#無窮迴圈
 			while(true){
 				#遞迴執行
 				$conf["self::getSimpleError"]["error"]=$result;
 				$simpleError=self::getSimpleError($conf["self::getSimpleError"]);
 				unset($conf["self::getSimpleError"]);
 				#如果執行失敗
 				if($simpleError["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤訊息
 					$result["error"]=$simpleError;
 					#下一輪
 					continue;
 					}#if end
 				#如果檢查不通過
 				if($simpleError["passed"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤訊息
 					$result["error"]=$simpleError;
 					#下一輪
 					continue;
 					}#if end
 				#結束 while
 				break;
 				}#while end
 			#取得 simpleError
 			$result["simpleError"]=$simpleError["content"];
 			#回傳結果
 			return $result;
 			}#if end
 		#var_dump($result);
 		#初始化簡單的錯誤
 		$result["content"]=&$conf["error"];
 		#如果底下有 error 元素
 		while(isset($result["content"]["error"])){
 			#var_dump($result["content"]["error"]);
 			#取得其位置
 			$result["content"]=&$result["content"]["error"];
 			}#while end
 		#初始化新的結果
 		$newContentStr="";
 		#如果 content 不是字串
 		if(gettype($result["content"])!=="string"){
 			#var_dump($result["content"]);
 			#針對每個錯誤訊息
 			foreach($result["content"] as $errorLine){
 				#如果不是字串
 				if(gettype($errorLine)!=="string"){
 					#將陣列轉換成字串
 					$errorLine=print_r($errorLine,true);
 					}#if end
 				#串接結果
 				$newContentStr=$newContentStr.$errorLine.PHP_EOL;
 				}#foreache end
 			}#if end
 		#設置結果內容
 		$result["content"]=$newContentStr;
 		#設置執行正常
 		$result["status"]=true;
 		#回傳結果
 		return $result;
 		}#function getSimpleError end
 	/*
 	#函式說明:
 	#檢查字串是否符合指定格式
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#grapheme_substr=>https://www.php.net/manual/en/function.grapheme-substr.php
 	#備註:
 	#無.
 	*/
 	public static function checkStringFormat(&$conf){
 		#初始化要回傳的內容
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果 $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["argu"]=$conf;
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#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
 		#預設剩下未檢查格式的input為空字串
 		$result["newInputArgu"]="";
 		#如果存在分段的格式設定
 		if(isset($conf["section"])){
 			#預設都是尚未檢驗的字串
 			$newInputArgu=$conf["input"];
 			#針對每段
 			foreach($conf["section"] as $index => $sec){
 				#更新input參數
 				$sec["input"]=$newInputArgu;
 				#處理該section
 				#函式說明:
 				#檢查字串是否符合指定格式
 				#回傳結果:
 				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 				#$conf["centerWith"]="";
 				#$conf["length"],字串整數,字串的長度要多少(bytes).
 				#$conf["length"]="";
 				#$conf["lengthGrapheme"],字串整數,字串的長度要多少字位(grapheme).
 				#$conf["lengthGrapheme"]="";
 				#$conf["variableCheck::checkStringFormat"]["section"]=$nextSectionArgu;
 				#參考資料:
 				#grapheme_strlen=>https://www.php.net/manual/en/function.grapheme-strlen.php
 				#grapheme/字位/可以書寫的最小單位=>https://zh.wikipedia.org/zh-tw/%E5%AD%97%E4%BD%8D
 				#備註:
 				#無.
 				$conf["variableCheck::checkStringFormat"]=$sec;
 				$checkStringFormat=variableCheck::checkStringFormat($conf["variableCheck::checkStringFormat"]);
 				unset($conf["variableCheck::checkStringFormat"]);
 				#如果執行失敗
 				if($checkStringFormat["status"]=="false"){
 					#設置錯誤識別
 					$result["status"]="false";
 					#設置錯誤訊息
 					$result["error"]=$checkStringFormat;
 					#回傳結果
 					return $result;
 					}#if end
 				#如果不通過
 				if($checkStringFormat["passed"]=="false"){
 					#回傳結果
 					return $checkStringFormat;
 					}#if end
 				#取得新的input參數
 				$newInputArgu=$checkStringFormat["newInputArgu"];
 				}#foreach end
 			}#if end
 		#到這邊代表不存在分段的格式設定
 		#初始化關鍵字
 		$keywords=array();
 		#如果有 startWith
 		if(isset($conf["startWith"])){
 			#設置關鍵字
 			$keywords[]=$conf["startWith"];
 			}#if end
 		#如果有 centerWith
 		if(isset($conf["centerWith"])){
 			#設置關鍵字
 			$keywords[]=$conf["centerWith"];
 			}#if end
 		#如果有 endWith
 		if(isset($conf["endWith"])){
 			#設置關鍵字
 			$keywords[]=$conf["endWith"];
 			}#if end
 		#如果存在關鍵字
 		if(!empty($keywords)){
 			#若有指定bytes長度
 			if(isset($conf["length"])){
 				#取得輸入的字串長度
 				$length=strlen($conf["input"]);
 				#如果長度不足
 				if($length<(int)$conf["length"]){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置詳細結果訊息陣列.
 					$result["content"][]="input參數(".$conf["input"].")的bytes長度(".$length.")小於length參數(".$conf["length"].")";
 					#回傳結果
 					return $result;
 					}#if end
 				#函式說明:
 				#unicode的字串分割,比str_split的支援度高.
 				#回傳結果:
 				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 				#$result["error"],錯誤訊息陣列.
 				#$result["function"],當前執行的函數名稱.
 				#$result["content"],分割好的內容陣列.
 				#$result["length"],unicode字串的長度.
 				#必填參數:
 				#$conf["str"],字串",要分割的字串.
 				#http://php.net/manual/en/function.str-split.php
 				#備註:
 				#無.
 				$str_split_unicode=stringProcess::str_split_unicode($conf["stringProcess::str_split_unicode"]);
 				unset($conf["stringProcess::str_split_unicode"]);
 				#如果執行失敗
 				if($str_split_unicode["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤訊息
 					$result["error"]=$str_split_unicode;
 					#回傳結果
 					return $result;
 					}#if end
 				#初始化給search::findKeyWordsPosition的input參數
 				$newInputArguForFindKeyWordsPosition="";
 				#初始化給variableCheck::checkStringFormat的input參數
 				$newInputArgu="";
 				#針對剩下的每個bytes
 				foreach($str_split_unicode["content"] as $index=>$splitedStr){
 					#屬於findKeyWordsPosition的input參數
 					if($index<(int)$conf["length"]){
 						#串接新的input參數bytes
 						$newInputArguForFindKeyWordsPosition=$newInputArguForFindKeyWordsPosition.$splitedStr;
 						}#if end
 					#反之
 					else{
 						#串接新的input參數bytes
 						$newInputArgu=$newInputArgu.$splitedStr;
 						}#else end
 					}#foreach end
 				}#if end
 			#反之不存在指定bytes長度
 			#但有指定字位長度
 			else if(isset($conf["lengthGrapheme"])){
 				#取得輸入的字位長度
 				$grapheme_strlen=grapheme_strlen($conf["input"]);
 				#如果長度不足
 				if($grapheme_strlen>(int)$conf["lengthGrapheme"]){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置詳細結果訊息陣列.
 					$result["content"][]="input參數(".$conf["input"].")的字位長度(".$grapheme_strlen.")小於lengthGrapheme參數(".$conf["lengthGrapheme"].")";
 					#回傳結果
 					return $result;
 					}#if end
 				#初始化給search::findKeyWordsPosition的input參數
 				$arguForFindKeyWordsPosition=grapheme_substr($conf["input"],0,$conf["lengthGrapheme"]);
 				#初始化給variableCheck::checkStringFormat的input參數
 				$newInputArgu=grapheme_substr($conf["input"],$conf["lengthGrapheme"]);
 				}#if end
 			#函式說明:
 			#取得關鍵字在字串的哪個位置(字首,字尾,中間)
 			#回傳結果:
 			#$result["status"],執行成功與否，若爲"true"，代表執行成功，若爲"false"代表執失敗。
 			#$result["error"],錯誤訊息陣列.
 			#$result["tail"][i],第i個關鍵字是否在字串的尾端,"true"代表是,"false"代表不是.
 			#$result["center"][i],第i個關鍵字是否在字串的中間,"true"代表是,"false"代表不是.
 			#$result["indexS"][i],第i個關鍵字在被搜尋字串的哪個位置開始.
 			#$result["indexE"][i],第i個關鍵字在被搜尋字串的哪個位置結束.
 			#必填參數:
 			#如果存在 newInputArguForFindKeyWordsPosition,就用之.
 			if(isset($newInputArguForFindKeyWordsPosition)){
 				#$conf["inputStr"],字串,被搜尋的字串.
 				$conf["search::findKeyWordsPosition"]["inputStr"]=$newInputArguForFindKeyWordsPosition;
 				}#if end
 			#反之用原始輸入字串
 			else{
 				#$conf["inputStr"],字串,被搜尋的字串.
 				$conf["search::findKeyWordsPosition"]["inputStr"]=$conf["input"];
 				}#else end
 			#$conf["keyWords"],字串陣列,要搜尋的多個關鍵字
 			$conf["search::findKeyWordsPosition"]["keyWords"]=$keywords;
 			#可省略參數:
 			#無.
 			#參考資料:
 			#http://php.net/manual/en/function.strpos.php
 			#備註:
 			#無.
 			$findKeyWordsPosition=search::findKeyWordsPosition($conf["search::findKeyWordsPosition"]);
 			unset($conf["search::findKeyWordsPosition"]);
 			#如果執行失敗
 			if($findKeyWordsPosition["status"]==="false"){
 				#設置錯誤識別
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$findKeyWordsPosition;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果三個參數 startWith、centerWith、endWith 都在
 			if( isset($conf["startWith"]) && isset($conf["centerWith"]) && isset($conf["endWith"]) ){
 				#如果其中一個關鍵字沒找到
 				if( $findKeyWordsPosition["head"][0]!=="true" || $findKeyWordsPosition["center"][1]!=="true" || $findKeyWordsPosition["tail"][2]!=="true" ){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置簡易資訊
 					$result["content"][]="input參數(".$conf["input"].")不完全符合startWith參數(".$conf["startWith"].")、centerWith參數(".$conf["centerWith"].")、endWith參數(".$conf["endWith"].")的條件";
 					#設置詳細資訊
 					$result["content"][]=$findKeyWordsPosition;
 					#回傳結果
 					return $result;
 					}#if end
 				#設置新的input參數
 				$result["newInputArgu"]="";
 				}#if end
 			#反之只有 startWith、centerWith 兩個參數
 			else if( isset($conf["startWith"]) && isset($conf["centerWith"]) ){
 				#如果其中一個關鍵字沒找到
 				if( $findKeyWordsPosition["head"][0]!=="true" || $findKeyWordsPosition["center"][1]!=="true" ){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置簡易資訊
 					$result["content"][]="input參數(".$conf["input"].")不完全符合startWith參數(".$conf["startWith"].")、centerWith參數(".$conf["centerWith"].")的條件";
 					#設置詳細資訊
 					$result["content"][]=$findKeyWordsPosition;
 					#回傳結果
 					return $result;
 					}#if end
 				#函式說明:
 				#unicode的字串分割,比str_split的支援度高.
 				#回傳結果:
 				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 				#$result["error"],錯誤訊息陣列.
 				#$result["function"],當前執行的函數名稱.
 				#$result["content"],分割好的內容陣列.
 				#$result["length"],unicode字串的長度.
 				#必填參數:
 				#$conf["str"],字串",要分割的字串.
 				#http://php.net/manual/en/function.str-split.php
 				#備註:
 				#無.
 				$str_split_unicode=stringProcess::str_split_unicode($conf["stringProcess::str_split_unicode"]);
 				unset($conf["stringProcess::str_split_unicode"]);
 				#如果執行失敗
 				if($str_split_unicode["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤訊息
 					$result["error"]=$str_split_unicode;
 					#回傳結果
 					return $result;
 					}#if end
 				#針對剩下的每個bytes
 				foreach($str_split_unicode["content"] as $splitedStr){
 					#串接新的input參數bytes
 					$result["newInputArgu"]=$result["newInputArgu"].$splitedStr;
 					}#foreach end
 				}#if end
 			#反之只有 startWith、endWith 兩個參數
 			else if( isset($conf["startWith"]) && isset($conf["endWith"]) ){
 				#如果其中一個關鍵字沒找到
 				if( $findKeyWordsPosition["head"][0]!=="true" || $findKeyWordsPosition["tail"][1]!=="true" ){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置簡易資訊
 					$result["content"][]="input參數(".$conf["input"].")不完全符合startWith參數(".$conf["startWith"].")、endWith參數(".$conf["endWith"].")的條件";
 					#設置詳細資訊
 					$result["content"][]=$findKeyWordsPosition;
 					#回傳結果
 					return $result;
 					}#if end
 				#設置新的input參數
 				$result["newInputArgu"]="";
 				}#if end
 			#反之只有 centerWith、endWith 兩個參數
 			else if( isset($conf["centerWith"]) && isset($conf["endWith"]) ){
 				#如果其中一個關鍵字沒找到
 				if( $findKeyWordsPosition["center"][0]!=="true" || $findKeyWordsPosition["tail"][1]!=="true" ){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置簡易資訊
 					$result["content"][]="input參數(".$conf["input"].")不完全符合centerWith參數(".$conf["centerWith"].")、endWith參數(".$conf["endWith"].")的條件";
 					#設置詳細資訊
 					$result["content"][]=$findKeyWordsPosition;
 					#回傳結果
 					return $result;
 					}#if end
 				#設置新的input參數
 				$result["newInputArgu"]="";
 				}#if end
 			#反之只有 startWith 參數
 			else if(isset($conf["startWith"])){
 				#如果其中一個關鍵字沒找到
 				if( $findKeyWordsPosition["head"][0]!=="true" ){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置簡易資訊
 					$result["content"][]="input參數(".$conf["input"].")不符合startWith參數(".$conf["startWith"].")的條件";
 					#設置詳細資訊
 					$result["content"][]=$findKeyWordsPosition;
 					#回傳結果
 					return $result;
 					}#if end
 				#函式說明:
 				#unicode的字串分割,比str_split的支援度高.
 				#回傳結果:
 				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 				#$result["error"],錯誤訊息陣列.
 				#$result["function"],當前執行的函數名稱.
 				#$result["content"],分割好的內容陣列.
 				#$result["length"],unicode字串的長度.
 				#必填參數:
 				#$conf["str"],字串",要分割的字串.
 				#http://php.net/manual/en/function.str-split.php
 				#備註:
 				#無.
 				$str_split_unicode=stringProcess::str_split_unicode($conf["stringProcess::str_split_unicode"]);
 				unset($conf["stringProcess::str_split_unicode"]);
 				#如果執行失敗
 				if($str_split_unicode["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤訊息
 					$result["error"]=$str_split_unicode;
 					#回傳結果
 					return $result;
 					}#if end
 				#針對剩下的每個bytes
 				foreach($str_split_unicode["content"] as $splitedStr){
 					#串接新的input參數bytes
 					$result["newInputArgu"]=$result["newInputArgu"].$splitedStr;
 					}#foreach end
 				}#if end
 			#反之只有 centerWith 參數
 			else if(isset($conf["centerWith"])){
 				#如果其中一個關鍵字沒找到
 				if( $findKeyWordsPosition["center"][0]!=="true" ){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置簡易資訊
 					$result["content"][]="input參數(".$conf["input"].")不符合centertWith參數(".$conf["centertWith"].")的條件";
 					#設置詳細資訊
 					$result["content"][]=$findKeyWordsPosition;
 					#回傳結果
 					return $result;
 					}#if end
 				#函式說明:
 				#unicode的字串分割,比str_split的支援度高.
 				#回傳結果:
 				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 				#$result["error"],錯誤訊息陣列.
 				#$result["function"],當前執行的函數名稱.
 				#$result["content"],分割好的內容陣列.
 				#$result["length"],unicode字串的長度.
 				#必填參數:
 				#$conf["str"],字串",要分割的字串.
 				#http://php.net/manual/en/function.str-split.php
 				#備註:
 				#無.
 				$str_split_unicode=stringProcess::str_split_unicode($conf["stringProcess::str_split_unicode"]);
 				unset($conf["stringProcess::str_split_unicode"]);
 				#如果執行失敗
 				if($str_split_unicode["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤訊息
 					$result["error"]=$str_split_unicode;
 					#回傳結果
 					return $result;
 					}#if end
 				#針對剩下的每個bytes
 				foreach($str_split_unicode["content"] as $splitedStr){
 					#串接新的input參數bytes
 					$result["newInputArgu"]=$result["newInputArgu"].$splitedStr;
 					}#foreach end
 				}#if end
 			#反之只有 endWith 參數
 			else if(isset($conf["endWith"])){
 				#如果其中一個關鍵字沒找到
 				if( $findKeyWordsPosition["tail"][0]!=="true" ){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置簡易資訊
 					$result["content"][]="input參數(".$conf["input"].")不符合endWith參數(".$conf["endWith"].")的條件";
 					#設置詳細資訊
 					$result["content"][]=$findKeyWordsPosition;
 					#回傳結果
 					return $result;
 					}#if end
 				#設置新的input參數
 				$result["newInputArgu"]="";
 				}#if end
 			#反之不可能發生的地方
 			else{
 				#設置錯誤識別
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"][]="非預期的錯誤";
 				#設置錯誤訊息
 				$result["error"][]=$findKeyWordsPosition;
 				#回傳結果
 				return $result;
 				}#else end
 			#如果存在
 			if(isset($newInputArgu)){
 				#更新之
 				$result["newInputArgu"]=$newInputArgu;
 				}#if end
 			}#if end
 		#反之,沒有關鍵字
 		else{
 			#若有指定bytes長度
 			if(isset($conf["length"])){
 				#取得輸入的字位長度
 				$length=length($conf["input"]);
 				#如果不相等
 				if($length!==(int)$conf["length"]){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置詳細結果訊息陣列.
 					$result["content"][]="input參數(".$conf["input"].")的bytes長度(".$length.")與length參數(".$conf["length"].")不相等";
 					#回傳結果
 					return $result;
 					}#if end
 				#函式說明:
 				#unicode的字串分割,比str_split的支援度高.
 				#回傳結果:
 				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 				#$result["error"],錯誤訊息陣列.
 				#$result["function"],當前執行的函數名稱.
 				#$result["content"],分割好的內容陣列.
 				#$result["length"],unicode字串的長度.
 				#必填參數:
 				#$conf["str"],字串",要分割的字串.
 				#http://php.net/manual/en/function.str-split.php
 				#備註:
 				#無.
 				$str_split_unicode=stringProcess::str_split_unicode($conf["stringProcess::str_split_unicode"]);
 				unset($conf["stringProcess::str_split_unicode"]);
 				#如果執行失敗
 				if($str_split_unicode["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤訊息
 					$result["error"]=$str_split_unicode;
 					#回傳結果
 					return $result;
 					}#if end
 				#針對剩下的每個bytes
 				foreach($str_split_unicode["content"] as $splitedStr){
 					#串接新的input參數bytes
 					$result["newInputArgu"]=$result["newInputArgu"].$splitedStr;
 					}#foreach end
 				}#if end
 			#反之不存在指定bytes長度
 			#但有指定字位長度
 			else if(isset($conf["lengthGrapheme"])){
 				#取得輸入的字位長度
 				$grapheme_strlen=grapheme_strlen($conf["input"]);
 				#如果不相等
 				if($grapheme_strlen!==(int)$conf["lengthGrapheme"]){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置詳細結果訊息陣列.
 					$result["content"][]="input參數(".$conf["input"].")的字位長度(".$grapheme_strlen.")與lengthGrapheme參數(".$conf["lengthGrapheme"].")不相等";
 					#回傳結果
 					return $result;
 					}#if end
 				#取得新的input參數
 				$result["newInputArgu"]=grapheme_substr($conf["input"],0,$conf["lengthGrapheme"]);
 				}#if end
 			#反之不存在指定字位長度
 			#但有指定 equalWith
 			else if(isset($conf["equalWith"])){
 				#如果不相等
 				if($conf["input"]!==$conf["equalWith"]){
 					#設置執行正常
 					$result["status"]="true";
 					#設置檢查不通過
 					$result["passed"]="false";
 					#設置詳細結果訊息陣列.
 					$result["content"][]="input參數(".$conf["input"].")與equalWith參數(".$conf["equalWith"].")不相等";
 					#回傳結果
 					return $result;
 					}#if end
 				}#if end
 			}#else(沒有關鍵字) end
 		#設置執行正常
 		$result["status"]="true";
 		#設置檢查通過
 		$result["passed"]="true";
 		#回傳結果
 		return $result;
 		}#checkStringFormat end
 	/*
 	#函式說明:
 	#檢查字串是否符合 RFC 3339/ISO-8601 格式
 	#rfc3339=>https://www.rfc-editor.org/rfc/rfc3339
 	#備註:
 	#無.
 	*/
 	public static function checkRFC3339(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#設置當其函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果 $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["argu"]=$conf;
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#必填寫的參數：
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("input");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或集合.
 		$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("UTC");
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("UTC");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true");
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查失敗
 		if($checkResult["status"]==="false"){
 			#設置執行失敗的訊息
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkResult["passed"]==="false"){
 			#設置執行失敗的訊息
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#計算時間點距離1970/01/01多少秒,亦即unixtime.
 		#回傳結果:
 		#$result["stauts"],執行是否成功，"true"代表執行成功；"false"代表執行失敗.
 		#$result["error"],錯誤訊息陣列.
 		#無.
 		#備註:
 		#無.
 		$caculateTimeAmount=time::caculateTimeAmount($conf["time::caculateTimeAmount"]);
 		unset($conf["time::caculateTimeAmount"]);
 		#如果檢查失敗
 		if($caculateTimeAmount["status"]==="false"){
 			#設置執行正常的識別
 			$result["status"]="true";
 			#設置檢查不通過
 			$result["passed"]="false";
 			#設置回饋的訊息
 			$result["content"]=$caculateTimeAmount;
 			#回傳結果
 			return $result;
 			}#if end
 		#設置執行正常的識別
 		$result["status"]="true";
 		#設置檢查通過
 		$result["passed"]="true";
 		#回傳結果
 		return $result;
 		}#function checkRFC3339 end
 	/*
 	#函式說明:
 	#處理各種錯誤與例外.
 	#無.
 	#備註:
 	#由於是使用 set_exception_handler 因此程式會結束執行.
 	*/
 	public static function setErrorHandler(&$conf=array()){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		#備註:
 		#無.
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果執行失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤資訊
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤資訊
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#設置給本函式使用的 conf
 		self::$setErrorHandlerConf=$conf;
 		#處理會導致程式無法執行的錯誤
 		set_error_handler(function($errno, $errstr, $errfile, $errline){
 			throw new \ErrorException($errstr, $errno, 0, $errfile, $errline);
 			});
 		#處理非導致程式無法執行的錯誤
 		#參考資料:
 		#http://php.net/manual/en/class.exception.php
 		set_exception_handler(function($exception){
 			#debug
 			#var_dump($exception);return true;
 			#無窮迴圈
 			while(true){
 				#取得給本函式使用的 conf
 				$conf=\qbpwcf\variableCheck::$setErrorHandlerConf;
 				#debug
 				#var_dump(__LINE__,$conf);
 				#初始化儲存錯誤訊息
 				$info=array();
 				#取得描述
 				$info["msg"]="Uncaught exception: ".$exception->getMessage();
 				#取得出錯檔案
 				$info["file"]="File: ".$exception->getFile();
 				#取得出錯行數
 				$info["line"]="Line: ".$exception->getLine();
 				#取得錯誤代碼
 				$info["code"]="The exception code is: ".$exception->getCode();
 				#函式說明:
 				#檢查多個字串中的每個字串是否有多個關鍵字
 				#回傳結果:
 				#$result["status"],整體來說，執行是否成功，"true"代表執行成功，"false"代表執行失敗。
 				#$result["function"],當前執行的函數名稱.
 				#無.
 				#備註:
 				#無.
 				$findManyKeyWordsFromManyString=search::findManyKeyWordsFromManyString($conf["search::findManyKeyWordsFromManyString"]);
 				unset($conf["search::findManyKeyWordsFromManyString"]);
 				#如果執行失敗
 				if($findManyKeyWordsFromManyString["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置錯誤資訊
 					$result["error"]=$findManyKeyWordsFromManyString;
 					#debug
 					var_dump(__LINE__,$result);
 					#結束執行,回傳代碼1給shell
 					exit(1);
 					}#if end
 				#如果有符合可以繼續執行的條件
 				if(count($findManyKeyWordsFromManyString["foundedTrueKey"])>0){
 					#debug
 					var_dump(__LINE__,$findManyKeyWordsFromManyString);
 					#結束while
 					break;
 					}#if end
 				#如果有要debug
 				if($conf["debug"]==="true"){
 					#判斷要呈現的方式
 					switch($conf["format"]){
 						#如果是 html
 						case "html":
 							#呈現錯誤訊息
 							echo "<p>".PHP_EOL;
 							echo "Uncaught exception: ".$exception->getMessage()."<br>".PHP_EOL;
 							echo "File: ".$exception->getFile()."<br>".PHP_EOL;
 							echo "Line: ".$exception->getLine()."<br>".PHP_EOL;
 							echo "Trace: ".print_r($exception->getTrace(),true)."<br>".PHP_EOL;
 							echo "The exception code is: ".$exception->getCode()."<br>".PHP_EOL;
 							#跳出 switch
 							break;
 						#如果是 cmd
 						case "cmd";
 							#呈現錯誤訊息
 							echo PHP_EOL;
 							echo "Uncaught exception: ".$exception->getMessage().PHP_EOL;
 							echo "File: ".$exception->getFile().PHP_EOL;
 							echo "Line: ".$exception->getLine().PHP_EOL;
 							echo "Trace: ".print_r($exception->getTrace(),true).PHP_EOL;
 							echo "The exception code is: ".$exception->getCode().PHP_EOL;
 							#跳出 switch
 							break;
 						#其他格式
 						default:
 							#用var_dump
 							var_dump($info);
 						}#switch end
 					}#if end
 				#debug
 				#var_dump(__LINE__,$findManyKeyWordsFromManyString);
 				#結束執行,回傳代碼1給shell
 				exit(1);
 				}#while end
 			#debug
 			#var_dump(__LINE__,"passed");
 			#視為可以繼續執行
 			return true;
 			});
 		}#funciton setErrorHandler end
 	}#class variableCheck end
 ?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/variableCheck.php – Rev 182 → 226