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

 <?php
 /*
 	QBPWCF, Quick Build PHP website Component base on Fedora Linux.
-    Copyright (C) 2015~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
 	#$arguments,陣列,為呼叫方法時所用的參數.
 	#參考資料:
 	#__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
 	*/
 	public function __call($method,$arguments){
 		#取得當前執行的函式
 		$result["function"]=__FUNCTION__;
 		#設置執行不正常
 		$result["status"]="false";
 		#設置執行錯誤
 		$result["error"][]=__NAMESPACE__ ."/".$method."() 不存在!";
 		#設置所丟入的參數
 		$result["error"][]=$arguments;
 		#回傳結果
 		return $result;
 		}#function __call end
 	/*
 	#函式說明:
 	#當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$arguments,陣列,為呼叫方法時所用的參數.
 	#參考資料:
 	#__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
 	*/
 	public static function __callStatic($method,$arguments){
 		#取得當前執行的函式
 		$result["function"]=__FUNCTION__;
 		#設置執行不正常
 		$result["status"]="false";
 		#設置執行錯誤
 		$result["error"][]="欲呼叫的". __NAMESPACE__ ."/".$method."() 不存在!";
 		#設置所丟入的參數
 		$result["error"][]=$arguments;
 		#回傳結果
 		return $result;
 		}#function __callStatic end
 	/*
 	#函式說明:
 	#用來檢查 $_SESSION['password'] 是否存在以及其值是否正確
 	#無.
 	#參考資料:
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function simpleAuthenticate(&$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("password");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["canBeEmptyString"]="false";
 		#$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["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"]);
 		#debug
 		#var_dump($checkResult);
 		#exit;
 		#debug
 		#var_dump($result);
 		#exit;
 		#如果檢查失敗
 		if($checkResult["status"]=="false"){
 			#debug
 			#var_dump($result);
 			#exit;
 			#debug
 			#var_dump($checkResult);
 			#exit;
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkResult["passed"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#debug
 		#var_dump($result);
 		#exit;
 		#echo "entered";
 		#若沒有供驗證的變數，或其驗證內容爲""
 		if(!isset($_SESSION['password']) || $_SESSION['password']===""){
 			#設置執行成功
 			$result["status"]="true";
 			#設置驗證不通過
 			$result["passed"]="false";
 			#回傳結果
 			return $result;
 			}#if end
 		#如果驗證碼不正確
 		if($_SESSION['password']!==$conf["password"]){
 			#設置執行成功
 			$result["status"]="true";
 			#設置驗證不通過
 			$result["passed"]="false";
 			#回傳結果
 			return $result;
 			}#if end
 		#反之驗證成功
 		else{
 			#設置執行成功
 			$result["status"]="true";
 			#設置驗證通過
 			$result["passed"]="true";
 			#回傳結果
 			return $result;
 			}#else end
 		#不應該執行到這邊
 		#設置執行失敗
 		$result["status"]="false";
 		#設置驗證不通過
 		$result["passed"]="false";
 		#回傳結果
 		return $result;
 		}#函式結束
 	/*
 	#函式說明:
 	#用來檢查 $_SESSION['password'] 是否存在以及其值是否正確,如果檢查不通過,則會轉址.
 	#無.
 	#參考資料:
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function sessionAuthenticate(&$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("failLocation","password");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["canBeEmptyString"]="false";
 		#$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["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["status"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得驗證碼驗證的回傳值
 		#函式說明:
 		#用來檢查 $_SESSION['password'] 是否存在以及其值是否正確
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"為正常,"false"為不正常.
 		$simpleAuthenticate=authenticate::simpleAuthenticate($conf["authenticate::simpleAuthenticate"]);
 		unset($conf["authenticate::simpleAuthenticate"]);
 		#如果執行驗證失敗
 		if($simpleAuthenticate["status"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$simpleAuthenticate;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果驗證失敗
 		if($simpleAuthenticate["passed"]=="false"){
 			#進行轉址
 			#函式說明:
 			#設定session變數後,立即轉址.
 			#回傳的結果:
 			#$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
 			#$conf["sessionValue"]=array("");
 			#參靠資料來源:
 			#http://php.net/manual/en/reserved.variables.server.php
 			$redirectionNow=header::redirectionNow($conf["header::redirectionNow"]);
 			unset($conf["header::redirectionNow"]);
 			#如果轉址失敗
 			if($redirectionNow["status"]=="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$redirectionNow;
 				#回傳結果
 				return $result;
 				}#if end
 			}#if end
 		#執行到這邊代表正常
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#函式結束
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function validateSession(&$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("key","content","failLocation");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","string","string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("unsetSess");
 		#$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("false");
 		#$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
 		#函式說明:
 		#取得指定的session數值
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
 		#$result["error"],錯誤訊息.
 		#$result["founded"],是否有該session變數,"true"代表有,"false"代表沒有.
 		#$result["content"],session變數的內容
 		#無.
 		#備註:
 		#無.
 		$getVal=session::getVal($conf["session::getVal"]);
 		unset($conf["session::getVal"]);
 		#如果執行異常
 		if($getVal["status"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$getVal;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果指定的session變數不存在 或 session 內容不一樣
 		if($getVal["founded"]==="false" || $getVal["content"]!==$conf["content"]){
 			#函式說明:
 			#設定session變數後,立即轉址.
 			#回傳的結果:
 			#$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
 			#$result["function"],當前執行的函數名稱.
 			#http://php.net/manual/en/reserved.variables.server.php
 			#備註:
 			#無.
 			$redirectionNow=header::redirectionNow($conf["header::redirectionNow"]);
 			unset($conf["header::redirectionNow"]);
 			#如果執行異常
 			if($redirectionNow["status"]=="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置執行錯誤訊息
 				$result["error"]=$redirectionNow;
 				#回傳結果
 				return $result;
 				}#if end
 			}#if end
 		}#function validateSession end
 	/*
 	#函式說明:
 	#檢查session裏面的使用者$_SESSION["account"]是否在會員清單裏面，與該會員所屬的羣組是否具有權限瀏覽該子功能頁面.
 	*/
 	public static function checkUserGroupAuthorities($conf){
 		#初始化要回傳的結果
 		$result=array();
 		#初始化儲存要回傳的警告訊息
 		$result["warning"]=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("thisSubSystemName","dbName","dbPassword");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("dbAddress","dbAccount","dtName.member","dtName.userGroup");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","string");
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("localhost","root","member","userGroupAuthorities");
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果 $checkResult["status"]=="false"
 		if($checkResult["status"]=="false"){
 			#設置執行不正常的適別
 			$result["status"]="false";
 			#設置執行錯誤的訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果 $checkResult["passed"] 等於 "false"
 		if($checkResult["passed"]=="false"){
 			#設置執行不正常的適別
 			$result["status"]="false";
 			#設置執行錯誤的訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查是否有session["username"],如果不存在
 		if(!isset($_SESSION["username"])){
 			#設置執行正常的適別
 			$result["status"]="true";
 			#設置檢查不通過
 			$result["passed"]="false";
 			#設置警告訊息
 			$result["warning"][]="使用者名稱變數不存在";
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查$_SESSION["username"]所屬的羣組爲何
 		#函式說明:
 		#一次取得資料庫、表的資料
 		#回傳的結果
 		#$result["status"],執行結果"true"為成功；"false"為執行失敗。
 		#$result["error"],錯誤訊息陣列。
 		$memberData=db::fastGetDbData($conf["db"]["fastGetDbData"]);
 		unset($conf["db"]["fastGetDbData"]);
 		#如果 $memberData["status"] 等於 "false"
 		if($memberData["status"]=="false"){
 			#設置執行不正常的適別
 			$result["status"]="false";
 			#設置執行錯誤的訊息
 			$result["error"]=$memberData;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果 $memberData["dataCount"] 等於 0
 		if($memberData["dataCount"]==0){
 			#代表沒有符合的帳戶
 			$result["status"]="true";
 			#設置警告訊息
 			$result["warning"][]="使用者沒有歸屬於任何群組";
 			#紀錄查詢用的sql
 			$result["sql"]=$memberData["sql"];
 			#設置檢查不通過
 			$result["passed"]="false";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得目前該使用者所屬的羣組
 		$userGroup=$memberData["dataContent"]["groupName"][0];#符合資料的會員群組名稱。
 		#檢查該群組能否瀏覽目標子系統
 		#函式說明:
 		#檢查資料庫裏的資料表有無指定條件的資料
 		#回傳的結果：
 		#$result["status"],執行是否成功,成功為"true",失敗為"false"。
 		#$result["error"],錯誤訊息
 		#$result["founded"],是否找到資料,"true"代表有符合的資料；"false"代表沒有符合的資料.
 		#必填參數:
 		$conf["db"]["checkDataExists"]["dbAddress"]=$conf["dbAddress"];#爲mysql-Server的位置
 		$conf["db"]["checkDataExists"]["dbAccount"]=$conf["dbAccount"];#爲用於連入mysql-Server時要使用的帳號
 		$conf["db"]["checkDataExists"]["selectedDataBaseName"]=$conf["dbName"];#爲指定的資料庫名稱,欲選擇的資料庫名稱
 		$conf["db"]["checkDataExists"]["selectedDataTableName"]=$conf["dtName.userGroup"];#欲選擇的資料表名稱
 		$conf["db"]["checkDataExists"]["dbPassword"]=$conf["dbPassword"];#爲連線到mysql-Server時要使用的密碼，可省略，若省略則代表不使用密碼
 		$conf["db"]["checkDataExists"]["conditionTargetName"]=array("groupName","visitableSubSystem");#用來判斷的資料表數值名稱，需爲陣列,可省略
 		$conf["db"]["checkDataExists"]["conditionTargetValue"]=array($userGroup,$conf["thisSubSystemName"]);#用來判斷的資料表數值名稱若等於該數值,表示條件成立，需爲陣列,可省略
 		$checkDataExistResult=db::checkDataExists($conf["db"]["checkDataExists"]);
 		unset($conf["db"]["checkDataExists"]);
 		#var_dump($checkDataExistResult);
 		#如果 $checkDataExistResult["status"] 等於 "false"
 		if($checkDataExistResult["status"]=="false"){
 			#代表操作失敗
 			$result["status"]="false";
 			#設置警告訊息
 			$result["error"]=$checkDataExistResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#反之代表執行成功
 		else{
 			#如果 $checkDataExistResult["founded"] 等於 "true"
 			if($checkDataExistResult["founded"]=="true"){
 				#代表有相符合的資料
 				#設置符合權限
 				$result["passed"]="true";
 				#設置執行正常
 				$result["status"]="true";
 				#回傳結果
 				return $result;
 				}#if end
 			#反之代表沒有找到相符的資料,不符合權限.
 			else{
 				#設置符合權限
 				$result["passed"]="false";
 				#設置執行正常
 				$result["status"]="true";
 				#設置警告訊息
 				$result["warning"][]="使用者所屬的群組沒有權限使用該子系統";
 				#回傳結果
 				return $result;
 				}#else end
 			}#else end
 		#執行到這邊代表執行不正常
 		$result["status"]="false";
 		#設置錯誤訊息
 		$result["error"][]="不應該執行到的位置";
 		#回傳結果
 		return $result;
 		}#函式結束
 	/*
 	#函式說明:
 	#建立以圖片(PNG格式)呈現的驗證碼.
 	#回傳的解果：
 	#$result["status"],執行是否正常,"true"代表執行成功,"false"代表執行失敗.
 	*/
 	public static function validationCode(&$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
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#必填參數:
 		#$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("imgAddressAndName","fileArgu");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("fileArgu","num","disableImg","imgToData","class","content");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","string","string","array");
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,"8","false","true",null,array("1","2","3","4","5","6","7","8","9","A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","V","U","W","X","Y","Z"));
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array();
 		$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
 		#可以出現的亂數字碼
 		$target=$conf["content"];
 		#跑$num次
 		for($i=0;$i<=($conf["num"]-1);$i++){
 			#則將該代數值轉換成對應的target陣列值。
 			$number[$i]=$target[rand(0,count($target)-1)];
 			#將轉換完的驗證碼合併
 			$randNumberWordUn=$randNumberWordUn.$number[$i];
 			}#for end
 		#將合併好的驗證碼到randNumberWord
 		$randNumberWord = $randNumberWordUn;
 		#如果有設定產出圖片
 		if($conf["disableImg"]=="false"){
 			#如果驗證碼數量爲$num則放置驗證碼的圖片寬度就等於
 			$backgroundImgWidth=$conf["num"]*10;
 			#函式說明:
 			#建立含有文字的png圖檔
 			#imageline=>http://php.net/manual/en/function.imageline.php
 			#imagepng=>http://php.net/manual/en/function.imagepng.php
 			#imagedestroy=>http://php.net/manual/en/function.imagedestroy.php
 			$imgAddress=img::create($conf["img::create"]);
 			unset($conf["img::create"]);
 			#如果建立圖片失敗
 			if($imgAddress["status"]=="false"){
 				#設置錯誤狀態
 				$result["status"]="false";
 				#設置錯誤提示
 				$result["error"]=$imgAddress;
 				return $result;
 				}#if end
 			#設置圖片的位置與名稱
 			$result["imgAddress"]=$imgAddress["content"];
 			#如果要把圖片轉存成base64
 			if($conf["imgToData"]=="true"){
 				#函數說明:
 				#用data:mimeType;base64,imgVar的形式來提供圖片的連結,亦即圖片儲存在變數裡面,本函式包含顯示圖片的語法.
 				#回傳結果:
 				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 				#$result["error"],錯誤訊息
 				#$result["content"]["imgWithoutImgTag"],img的src數值內容.
 				#$result["content"]["img"],圖片的連結資訊
 				#$result["function"],當前執行的函數名稱
 				#必填參數:
 				#$conf["imgPosition"],要轉存成2元碼的圖片檔案位置與名稱
 				$conf["img::data"]["imgPosition"]=$result["imgAddress"];
 				#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑.
 				$conf["img::data"]["fileArgu"]=$conf["fileArgu"];
 				#可省略參數:
 				#$conf["alt"],若沒有圖片要用什麼文字顯示。
 				#$conf["alt"]="";
 				#$conf["class"],圖片要套用的css樣式名稱.
 				#如果有設定 class
 				if(isset($conf["class"])){
 					#設置圖片的 class
 					$conf["img::data"]["class"]=$conf["class"];
 					}#if end
 				#$conf["mimeType"],2元碼的內容是什麼,預設為"image/*".
 				#$conf["mimeType"]="image/*";
 				#$conf["compressType"],2元碼壓縮的方式,預設為"base64".
 				#$conf["compressType"]="base64";
 				#$conf["delImg"],讀取完圖片檔案後,要移除圖片嗎？"true"代表要移除,"false"代表不要移除,預設為"false".
 				#參考資料:
 				#將檔案用字串變數儲存起來=>http://php.net/manual/en/function.file-get-contents.php
 				#壓縮2元碼=>http://php.net/manual/en/function.base64-encode.php
 				$data=img::data($conf["img::data"]);
 				unset($conf["img::data"]);
 				#如果轉存成base64失敗
 				if($data["status"]=="false"){
 					#設置錯誤狀態
 					$result["status"]="false";
 					#設置錯誤提示
 					$result["error"]=$data;
 					return $result;
 					}#if end
 				#設置圖片src的數值
 				$result["imgSrcVal"]=$data["content"]["imgWithoutImgTag"];
 				#更新圖片位置為base64
 				$result["imgAddress"]=$data["content"]["img"];
 				}#if end
 			}#if end
 		#設置執行成功狀態
 		$result["status"]="true";
 		#設置亂數文字結果
 		$result["randNumberWord"]=$randNumberWord;
 		#回傳內容
 		return $result;
 		}#函式結束
 	/*
 	#函式說明:
 	#產生亂數驗證碼或驗證亂數驗證碼與表單資料
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#必填參數:
 	#$conf["fileArgu"]
 	$conf["fileArgu"]=__FILE__;
 	#可省略參數:
 	#$conf["sendedName"],字串,傳送的post變數名稱,預設爲"formData".
 	#$conf["sendedName"]="";
 	#$conf["codeFormName"],字串,驗證碼表單的名稱,預設為"randomCode",對應的 session 變數名稱為 authenticate.verifyCodeAndFormData.$conf["codeFormName"]
 	#$conf["codeFormName"]="randomCode";
 	#$conf["names"],字串陣列,需要處理的表單必填變數.
 	#$conf["names"]=array();
 	#$conf["skipNames"],字串陣列,需要處理的表單可爲空變數.
 	#$conf["skipNames"]=array();
 	#參考資料:
 	#無.
 	#備註:
 	#請跟javaScript類別的randomCode函式搭配.應用情境在會員登入、驗證與寄送Email表單.
 	*/
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["function"],當前執行的函式名稱.
 		#$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
 		#如果沒有設置 $conf["names"]
 		if(!isset($conf["names"])){
 			#初始化
 			$conf["names"]=array($conf["codeFormName"]);
 			}#if end
 		#反之
 		else{
 			#加上驗證碼表單
 			$conf["names"][]=$conf["codeFormName"];
 			}#else end
 		#如果沒有設置 $conf["skipNames"]
 		if(!isset($conf["skipNames"])){
 			#初始化
 			$conf["skipNames"]=array();
 			}#if end
 		#函式說明:
 		#建立一個陣列，可以指派陣列的內容，然後回傳
 		#回傳的結果：
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["function"],當前執行的函數名稱.
 		#可省略參數:
 		$conf["arrays::create"]["arrayCounts"]=count($conf["names"])+count($conf["skipNames"]);#爲陣列的元素有幾個，若沒設定，則數量爲$conf["arrayContent"]裏的元素數量
 		$conf["arrays::create"]["theSameAs"]="true";#若設爲"true"，則所有元素內容都跟第一個元素內容相同
 		$create=arrays::create($conf["arrays::create"]);
 		unset($conf["arrays::create"]);
 		#如果失敗
 		if($create["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行失敗
 			$result["error"]=$create;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#將多個一維陣列串聯起來,key從0開始排序.
 		#回傳的結果：
 		#$result["status"],"true"表執行正常,"false"代表執行不正常.
 		#$result["error"],錯誤訊息陣列.
 		#可省略的參數:
 		#$conf["allowRepeat"],字串,預設為"true",允許重複的結果;若為"false"則不會出現重複的元素內容.
 		#$conf["allowRepeat"]="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
 		#如表單變數存在
 		if(isset($_POST[$conf["sendedName"]])){
 			#解碼
 			$urlEncodeStr=base64_decode($_POST[$conf["sendedName"]]);
 			#解碼
 			$jsonEncodeStr=urldecode($urlEncodeStr);
 			#解碼
 			$obj=json_decode($jsonEncodeStr);
 			#debug
 				#$conf["class"]="";
 				$validationCode=authenticate::validationCode($conf["authenticate::validationCode"]);
 				unset($conf["authenticate::validationCode"]);
 				#如果建立亂碼圖片失敗
 				if($validationCode["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行失敗
 					}#if end
 				#設置驗證碼到session變數
 				$_SESSION["authenticate.verifyCodeAndFormData.".$conf["codeFormName"]]=$validationCode["randNumberWord"];
 				#取得驗證碼長度
 				$json["content"]["randomCodeLength"]=strlen($_SESSION["authenticate.verifyCodeAndFormData.".$conf["codeFormName"]]);
 				#設置圖片data
 				$json["content"]["randomCodeSrc"]=$validationCode["imgSrcVal"];
 				#運行正常
 				$result["status"]="true";
 				#回傳結果
 				return $result;
 				}#if end
 			#反之有內容
 			else{
 				#清空post變數
 				$_POST=array();
 				#debug
 				#echo $urlEncodeStr."<p>";
 				#echo $jsonEncodeStr."<p>";
 				#var_dump($obj);
 				#依據每個物件
 				foreach($obj as $key=>$val){
 					#設置對應的 post 數值
 					$_POST[$key]=$val;
 					}#foreach end
 				#debug
 				#echo json_encode($_POST);
 					$json["status"]="true";
 					#設置通過驗證
 					$json["passed"]="true";
 					#設置訊息
 					$json["msg"]="通過驗證";
 					#取得要檢查的變數名稱
 					$mustBeFilledVariableName=$mergeArray["content"];
 					#取得要檢查的變數形態
 					$mustBeFilledVariableType=$create["content"];
 					#檢查POST參數
 					#函式說明:
 					#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 					#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 					#$reuslt["error"],執行不正常結束的錯訊息陣列.
 					$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 					unset($conf["variableCheck::checkArguments"]);
 					#如果檢查失敗
 					if($checkArguments["status"]==="false"){
 						#設置執行不正常
 						$jsons["status"]="false";
 						#設置檢查不通過
 						$json["passed"]="false";
 						#設置執行失敗
 						$json["error"]=$checkArguments;
 						#設置 json
 						$result["content"]=json_encode($json);
 						#運行正常
 						$result["status"]="true";
 						#回傳結果
 						return $result;
 						}#if end
 					#如果檢查不通過
 					if($checkArguments["passed"]==="false"){
 						#設置執行正常
 						$json["status"]="true";
 						#設置檢查不通過
 						$json["passed"]="false";
 						#設置執行失敗
 						$json["error"]=$checkArguments;
 						#設置 json
 						$result["content"]=json_encode($json);
 						#運行正常
 						$result["status"]="true";
 						#回傳結果
 						return $result;
 						}#if end
 					#設置執行正常
 					$json["status"]="true";
 					#設置通過驗證
 					$json["passed"]="true";
 					#設置抓到的 post 內容
 					$json["post"]=$_POST;
 					#設置 json
 					$result["content"]=json_encode($json);
 					#運行正常
 					$result["status"]="true";
 					#回傳結果
 					return $result;
 					}#if end
 				#反之
 				else{
 					$json["status"]="true";
 					#設置未通過驗證
 					$json["passed"]="false";
 					#設置錯誤訊息
 					$json["error"]="驗證碼錯誤";
 					#設置 json
 					$result["content"]=json_encode($json);
 					#運行正常
 					$result["status"]="true";
 					#回傳結果
 					return $result;
 					}#else end
 				}#else end
 			#設置執行正常
 			$json["status"]="false";
 			#設置通過驗證
 			$json["passed"]="false";
 			#設置錯誤訊息
 			$json["error"]="缺少POST變數";
 			#設置抓到的 post 內容
 			$json["post"]=$_POST;
 			#設置 json
 			$result["content"]=json_encode($json);
 			#運行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]="缺少POST變數";
 			#回傳結果
 			return $result;
 			}#if end
 		}#function verifyCodeAndFormData end
 	/*
 	#函式說明:
 	#加密或編碼字串,可以用的方法有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"],使用的參數.
 	#必填參數:
 	#json_decode=>https://www.php.net/manual/en/function.json-decode.php
 	#備註:
 	#無.
 	*/
 	public static function enCodeStr(&$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("enCodeStr","enCodeType");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array(null,"string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("sha1Raw","p_hash","keyForAes256","aes256Encode","qbpwcfDecode","gpgDecrypt","gpgId");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","string","string","string","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("false",null,null,null,"false","false",gnupgId);
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		$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
 		#判斷是哪一種加密方法
 		switch($conf["enCodeType"]){
 			#如果是 "sha1"
 			case "sha1":
 				#如果輸入不是字串
 				if(gettype($conf["enCodeStr"])!=="string"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"][]="enCodeStr shoud be string when enCodeType is ".$conf["enCodeType"];
 					#回傳結果
 					return $result;
 					}#if end
 				#如果要用2元碼輸出
 				if($conf["sha1Raw"]=="true"){
 					#sha1加密
 					$encodeStr=sha1($conf["enCodeStr"],TRUE);
 					#如果加密失敗
 					if($encodeStr==false){
 						#設置執行失敗
 						$result["status"]="false";
 						#設置執行錯誤
 						$result["error"][]="加密失敗";
 						#回傳結果
 						return $result;
 						}#if end
 					#反之加密成功
 					else{
 						#取得加密後的字串
 						$result["content"]=$encodeStr;
 						}#else end
 					}#if end
 				#反之用16進位數值輸出
 				else{
 					#sha1加密
 					$encodeStr=sha1($conf["enCodeStr"],FALSE);
 					#如果加密失敗
 					if($encodeStr==false){
 						#設置執行失敗
 						$result["status"]="false";
 						#設置執行錯誤
 						$result["error"][]="加密失敗";
 						#回傳結果
 						return $result;
 						}#if end
 					#反之加密成功
 					else{
 						#取得加密後的字串
 						$result["content"]=$encodeStr;
 						}#else end
 					}#else end
 				#跳出
 				break;
 			#如果是 "md5"
 			case "md5";
 				#如果輸入不是字串
 				if(gettype($conf["enCodeStr"])!=="string"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"][]="enCodeStr shoud be string when enCodeType is ".$conf["enCodeType"];
 					#回傳結果
 					return $result;
 					}#if end
 				#md5加密
 				$encodeStr=md5($conf["enCodeStr"]);
 				#如果加密失敗
 				if($encodeStr==false){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"][]="加密失敗";
 					#回傳結果
 					return $result;
 					}#if end
 				#反之加密成功
 				else{
 					#取得加密後的字串
 					$result["content"]=$encodeStr;
 					}#else end
 				#跳出
 				break;
 			#如果是"p_hash"
 			case "p_hash":
 				#如果輸入不是字串
 				if(gettype($conf["enCodeStr"])!=="string"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"][]="enCodeStr shoud be string when enCodeType is ".$conf["enCodeType"];
 					#回傳結果
 					return $result;
 					}#if end
 				#如果 $conf["p_hash"] 存在
 				if(isset($conf["p_hash"])){
 					#檢驗 $conf["enCodeStr"] 是否與 $conf["p_hash"] 相符
 					if(password_verify($conf["enCodeStr"],$conf["p_hash"])){
 						#設置執行正常
 						$result["status"]="true";
 						#回傳結果
 						return $result;
 						}#if end
 					#反之
 					else{
 						#設置執行失敗
 						$result["status"]="false";
 						#設置執行錯誤
 						$result["error"][]="密碼不正確";
 						#回傳結果
 						return $result;
 						}#else end
 					}#if end
 				#加密密碼
 				$encodeStr=password_hash($conf["enCodeStr"],PASSWORD_DEFAULT);
 				#如果加密失敗
 				if($encodeStr==false){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"][]="加密失敗";
 					#回傳結果
 					return $result;
 					}#if end
 				#反之加密成功
 				else{
 					#取得加密後的字串
 					$result["content"]=$encodeStr;
 					}#else end
 				break;
 			#如果是 AES 256 bit 加密
 			#參考資料:
 			#https://www.ucamc.com/e-learning/php/388-php%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8aes-openssl%E5%8A%A0%E5%AF%86%E4%BB%A3%E7%A2%BC%E3%80%81encrypt%E3%80%81decrypt
 			case "aes256":
 				#如果輸入不是字串
 				if(gettype($conf["enCodeStr"])!=="string"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"][]="enCodeStr shoud be string when enCodeType is ".$conf["enCodeType"];
 					#回傳結果
 					return $result;
 					}#if end
 				#如果參數有缺
 				if( !isset($conf["keyForAes256"]) || !isset($conf["aes256Encode"]) ){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"][]="aes256 演算法需要 keyForAes256 與 aes256Encode 參數";
 					#回傳結果
 					return $result;
 					}#if end
 				#如果是要加密
 				if($conf["aes256Encode"]==="true"){
 					#取得iv
 					$iv = openssl_random_pseudo_bytes(openssl_cipher_iv_length('aes-256-cbc'));
 					#加密內容
 					$encrypted = openssl_encrypt($conf["enCodeStr"], 'aes-256-cbc', $conf["keyForAes256"], 0, $iv);
 					#使用base64加密的內容
 					$result["content"]=base64_encode($encrypted . '::' . $iv);
 					#數值執行正常
 					$result["status"]="true";
 					#回傳結果
 					return $result;
 					}#if end
 				#反之是要解密
 				else{
 					#取得 base64_decoed 的本文與 iv
 					list($conf["enCodeStr"], $iv) = explode('::', base64_decode($conf["enCodeStr"]), 2);
 					#取得 解密好的內容
 					$result["content"]=openssl_decrypt($conf["enCodeStr"], 'aes-256-cbc', $conf["keyForAes256"], 0, $iv);
 					#數值執行正常
 					$result["status"]="true";
 					#回傳結果
 					return $result;
 					}#else end
 				#跳出迴圈
 				break;
 			#如果是 "qbpwcf"
 			case "qbpwcf":
 				#如果是要加密
 				if($conf["qbpwcfDecode"]==="false"){
 					#to json string
 					$jsonData=json_encode($conf["enCodeStr"]);
 					#如果出錯
 					if($jsonData===false){
 						#設置執行失敗
 						$result["status"]="false";
 						#設置執行錯誤
 						$result["error"][]="encode 「".$conf["enCodeStr"]."」 失敗";
 						#回傳結果
 						return $result;
 						}#if end
 					#設置加密好的內容
 					$result["content"]=base64_encode(urlencode($jsonData));
 					}#if end
 				#反之是要解密
 				else{
 					#base64_decode then urldecode data
 					$urlDecodeData=urldecode(base64_decode($conf["enCodeStr"]));
 					#json_decode data
 					$json_decode_data=json_decode($urlDecodeData);
 					#如果異常
 					if($urlDecodeData!==null && $json_decode_data===null){
 						#設置執行失敗
 						$result["status"]="false";
 						#設置執行錯誤
 						$result["error"][]="decode 「".$conf["enCodeStr"]."」 失敗";
 						#回傳結果
 						return $result;
 						}#if end
 					#設置解密好的內容
 					$result["content"]=$json_decode_data;
 					}#else end
 				#跳出 switch
 				break;
 			#若是bin2hex
 			case "bin2hex":
 				#用16進位的兩個字母來表示每個byte
 				$unpack=unpack("H*",$conf["enCodeStr"]);
 				#如果沒有結果
 				if(!isset($unpack[1])){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"][]="bin2hex failed";
 					#設置執行錯誤
 					$result["error"][]=$unpack;
 					#回傳結果
 					return $result;
 					}#if end
 				#取得結果
 				$result["content"]=$unpack[1];
 				#相當於
 				#$result["content"]=bin2hex($conf["enCodeStr"]);
 				#跳出 switch
 				break;
 			#若是hex2bin
 			case "hex2bin":
 				#將每個byte用兩個16進位字母來表示的字串變成 binary string
  				$pack=pack("H*",$conf["enCodeStr"]);
 				$result["content"]=$pack;
 				#跳出 switch
 				break;
 			#如果是"gpg加解密"
 			case "gpg":
 				#如果沒有 gpgId
 				if(!isset($conf["gpgId"])){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"]="param gpgId if required when enCodeType is ".$conf["enCodeType"];
 					#回傳結果
 					return $result;
 					}#if end
 				#如果是用加密
 				if($conf["gpgDecrypt"]==="false"){
 					#用GnuPG加密
 					#函式說明:
 					#呼叫shell執行系統命令,並取得回傳的內容.
 					#回傳結果:
 					#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 					#如果執行失敗
 					if($callShell["status"]==="false"){
 						#設置執行失敗
 						$result["status"]="false";
 						#設置執行錯誤
 						$result["error"]=$callShell;
 						#回傳結果
 						return $result;
 						}#if end
 					#取得加密後的內容
 					$result["content"]=$callShell["content"];
 					}#if end
 				#反之如果是解密
 				else if($conf["gpgDecrypt"]==="true"){
 					#用GnuPG解密
 					#函式說明:
 					#呼叫shell執行系統命令,並取得回傳的內容.
 					#回傳結果:
 					#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 					#如果執行失敗
 					if($callShell["status"]==="false"){
 						#設置執行失敗
 						$result["status"]="false";
 						#設置執行錯誤
 						$result["error"]=$callShell;
 						#回傳結果
 						return $result;
 						}#if end
 					#取得加密後的內容
 					$result["content"]=$callShell["content"];
 					}#else end
 				#跳出 switch
 				break;
 			#如果是其他內容
 			default:
 				#設置執行失敗
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"][]="不支援的加密方法「".$conf["enCodeType"]."」";
 				#回傳結果
 				return $result;
 			}#switch end
 		#執行到這邊代表執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function enCodeStr end
 	/*
 	#函式說明:
 	#將字串變成2元碼或2元碼變成字串.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$result["function"],當前執行的函數名稱.
 	#$result["content"],加密後的結果.
 	#$result["error"],錯誤訊息陣列.
 	#必填參數:
 	#$conf["input"],"字串",要hex或unhex的字串
 	$conf["input"]="";
 	#$conf["action"],"字串",要toBin或toStr.
 	$conf["action"]="";
 	#可省略參數:
 	#無.
 	#參考資料:
 	#hex2bin=>http://php.net/manual/en/function.hex2bin.php #bin2hex=>http://php.net/manual/en/function.binhex.php #pack=>http://php.net/manual/en/function.pack.php 轉換的方法似乎有問題. bin2hex可以將10進位數字字串轉換成2進位字串.
 	#備註:
 	#無.
 	*/
 	public static function str2bin(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#記錄當前執行的函數
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#如果 $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["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("input","action");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("sha1Raw","p_hash");
 		#$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("false",null);
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkResult["status"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果要hex
 		if($conf["action"]=="toBin"){
 			#將字串轉換成2進位
 			$result["content"]=pack('H*', base_convert($conf["input"], 2, 16));
 			}#if end
 		#反之如果要unhex
 		else if($conf["action"]=="toStr"){
 			#將2進位轉為字串
 			$result["content"]=unpack('H*',$conf["input"]);
 			#針對每個字
 			foreach($result["content"] as $key=>$bin){
 				#轉換成字串
 				$result["content"][$key]=base_convert($result["content"][1], 16, 2);
 				}#foreach end
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function str2bin end
 	/*
 	#函式說明:
 	#驗證Linux使用者的密碼或ssh private key是否正確.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$result["function"],當前執行的函數名稱.
 	#$result["error"],錯誤訊息陣列.
 	#$result["warninig"],警告訊息陣列.
 	#$result["valid"],是否為存在的使用者且密碼正確.
 	#必填參數:
 	#備註:
 	#僅能在命令列環境下運.
 	#目前僅支援驗證執行php端的使用者.
 	*/
 	public static function validUser(&$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
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		$conf["variableCheck::checkArguments"]["canBeEmpty"]=array("password");
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或集合.
 		#$conf["skipableVariableCanNotBeEmpty"]=array();
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("sshPrivateKey");
 		#$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("false");
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("conName","conVal");
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("target","styleAttr","styleVal");
 		#參考資料來源:
 		#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
 		#檢查使用者是否存在
 		#函式說明:
 		#呼叫shell執行系統命令,並取得回傳的內容.
 		#回傳的結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#exec=>http://php.net/manual/en/function.exec.php
 		#escapeshellcmd=>http://php.net/manual/en/function.escapeshellcmd.php
 		#escapeshellarg=>http://php.net/manual/en/function.escapeshellarg.php
 		$callShell=external::callShell($conf["external::callShell"]);
 		unset($conf["external::callShell"]);
 		#如果執行shell失敗
 		if($callShell["status"]==="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置執行錯誤
 			$result["error"]=$callShell;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果使用者 $conf["username"] 不存在
 		if($callShell["output"][0]==="id: ".$conf["username"].": no such user"){
 			#設置執行不正常
 			$result["status"]="true";
 			#設置使用者驗證失敗
 			$result["valid"]="false";
 			#設置使用者不存在的警告
 			$result["warninig"][]="使用者 \"".$conf["username"]."\" 不存在!";
 			#回傳結果
 			return $result;
 			}#if end
 		#如果要用ssh private key進行認證
 		if($conf["sshPrivateKey"]==="true"){
 			#可以用 echo "env | grep SSH_CONNECTION=" | ssh username@127.0.0.1 來驗證使用者的ssh連線是否成功
 			#預設用來測試ssh private key 與 username 是否可成功登入的賬戶
 			$sshAgentAcct="qbpwcf";
 			#確認用來測試登入ssh的使用者qbpwcf存在
 			#檢查使用者是否存在
 			#函式說明:
 			#呼叫shell執行系統命令,並取得回傳的內容.
 			#回傳的結果:
 			#exec=>http://php.net/manual/en/function.exec.php
 			#escapeshellcmd=>http://php.net/manual/en/function.escapeshellcmd.php
 			#escapeshellarg=>http://php.net/manual/en/function.escapeshellarg.php
 			$callShell=external::callShell($conf["external::callShell"]);
 			unset($conf["external::callShell"]);
 			#如果執行shell失敗
 			if($callShell["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$callShell;
 				#回傳結果
 				return $result;
 				}#if end
 			#另外儲存存放ssh使用者設定的目錄
 			$dotsshFolderOfsshAgent="/home/".$sshAgentAcct."/.ssh";
 			#如果使用者 $sshAgentAcct 不存在
 			if($callShell["output"][0]==="id: ".$sshAgentAcct.": no such user"){
 				#透過 qbpwcf-usock.service 服務建立對應的使用者
 				#函式說明:
 				#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 				#回傳結果:
 				#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 				#無.
 				#備註:
 				#無.
 				$execAnyCmdByQBPWCFunixSocket=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				#如果執行shell失敗
 				if($execAnyCmdByQBPWCFunixSocket["status"]==="false"){
 					#設置執行不正常
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"]=$execAnyCmdByQBPWCFunixSocket;
 					#回傳結果
 					return $result;
 					}#if end
 				#透過 qbpwcf-usock.service 服務建立設置對應使用者的 .ssh 目錄
 				#函式說明:
 				#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 				#回傳結果:
 				#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 				#$result["error"],錯誤訊息陣列.
 				#無.
 				#備註:
 				#無.
 				$execAnyCmdByQBPWCFunixSocket=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				#如果執行shell失敗
 				if($execAnyCmdByQBPWCFunixSocket["status"]==="false"){
 					#設置執行不正常
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"]=$execAnyCmdByQBPWCFunixSocket;
 					#回傳結果
 					return $result;
 					}#if end
 				}#if end
 			#確認 ssh 使用者設定的目錄 $dotsshFolderOfsshAgent 是否存在
 			#函式說明:
 			#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 			#回傳結果:
 			#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 			#無.
 			#備註:
 			#無.
 			$execAnyCmdByQBPWCFunixSocket=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 			unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 			#如果執行shell失敗
 			if($execAnyCmdByQBPWCFunixSocket["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$execAnyCmdByQBPWCFunixSocket;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果得到的結果不為 json
 			if(!json_validate($execAnyCmdByQBPWCFunixSocket["content"])){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$execAnyCmdByQBPWCFunixSocket;
 				#回傳結果
 				return $result;
 				}#if end
 			#解析 json 並轉換成 array
 			$execAnyCmdByQBPWCFunixSocket["content"]=(array)(json_decode($execAnyCmdByQBPWCFunixSocket["content"]));
 			#如果沒有找到要存在的 $dotsshFolderOfsshAgent 目錄
 			if(count($execAnyCmdByQBPWCFunixSocket["content"])===0){
 				#建立之
 				#函式說明:
 				#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 				#回傳結果:
 				#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 				#無.
 				#備註:
 				#無.
 				$createDotsshFolderOfsshAgent=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				#如果執行shell失敗
 				if($createDotsshFolderOfsshAgent["status"]==="false"){
 					#設置執行不正常
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"]=$createDotsshFolderOfsshAgent;
 					#回傳結果
 					return $result;
 					}#if end
 				}#if end
 			#如果沒有找到要存在的 $dotsshFolderOfsshAgent 目錄
 			else if($execAnyCmdByQBPWCFunixSocket[0]!==$dotsshFolderOfsshAgent){
 				#建立之
 				#函式說明:
 				#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 				#回傳結果:
 				#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 				#無.
 				#備註:
 				#無.
 				$createDotsshFolderOfsshAgent=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				#如果執行shell失敗
 				if($createDotsshFolderOfsshAgent["status"]==="false"){
 					#設置執行不正常
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"]=$createDotsshFolderOfsshAgent;
 					#回傳結果
 					return $result;
 					}#if end
 				}#if end
 			#取得 $dotsshFolderOfsshAgent 的權限與擁有着
 			#函式說明:
 			#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 			#回傳結果:
 			#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 			#無.
 			#備註:
 			#無.
 			$createDotsshFolderOfsshAgent=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 			unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 			#如果執行shell失敗
 			if($createDotsshFolderOfsshAgent["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$createDotsshFolderOfsshAgent;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果執行異常
 			if($createDotsshFolderOfsshAgent["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$createDotsshFolderOfsshAgent;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果沒有得到輸出
 			if(!isset($createDotsshFolderOfsshAgent["content"][0])){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$createDotsshFolderOfsshAgent;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果輸出結果不是json
 			if(!json_validate($createDotsshFolderOfsshAgent["content"][0])){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$createDotsshFolderOfsshAgent;
 				#回傳結果
 				return $result;
 				}#if end
 			#解析json
 			$node_info=json_decode($createDotsshFolderOfsshAgent["content"][0]);
 			#若 $dotsshFolderOfsshAgent 的權限,不為 "rwx------"
 			if($node_info->ownerPerm!=="rwx" || $node_info->groupPerm!=="---" || $node_info->otherPerm!=="---"){
 				#更新其權限設置
 				#函式說明:
 				#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 				#回傳結果:
 				#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 				#無.
 				#備註:
 				#無.
 				$createDotsshFolderOfsshAgent=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				#如果執行shell失敗
 				if($createDotsshFolderOfsshAgent["status"]==="false"){
 					#設置執行不正常
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"]=$createDotsshFolderOfsshAgent;
 					#回傳結果
 					return $result;
 					}#if end
 				}#if end
 			#若 $dotsshFolderOfsshAgent 的擁有着不為 $sshAgentAcct:$sshAgentAcct
 			if($node_info->ownerName!==$sshAgentAcct || $node_info->groupName!==$sshAgentAcct){
 				#更新其擁有着設置
 				#函式說明:
 				#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 				#回傳結果:
 				#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 				#無.
 				#備註:
 				#無.
 				$createDotsshFolderOfsshAgent=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				#如果執行shell失敗
 				if($createDotsshFolderOfsshAgent["status"]==="false"){
 					#設置執行不正常
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"]=$createDotsshFolderOfsshAgent;
 					#回傳結果
 					return $result;
 					}#if end
 				}#if end
 			#設置要使用的ssh private key
 			#函式說明:
 			#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 			#回傳結果:
 			#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 			#無.
 			#備註:
 			#無.
 			$createSshPrivateKey=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 			unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 			#如果執行shell失敗
 			if($createSshPrivateKey["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$createSshPrivateKey;
 				#回傳結果
 				return $result;
 				}#if end
 			#取得 ssh privacy key 檔案的權限與擁有着
 			#函式說明:
 			#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 			#回傳結果:
 			#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 			#無.
 			#備註:
 			#無.
 			$getSshPrivateKeyFileInfo=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 			unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 			#如果執行shell失敗
 			if($getSshPrivateKeyFileInfo["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$getSshPrivateKeyFileInfo;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果執行異常
 			if($createDotsshFolderOfsshAgent["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$getSshPrivateKeyFileInfo;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果沒有得到輸出
 			if(!isset($createDotsshFolderOfsshAgent["content"][0])){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$createDotsshFolderOfsshAgent;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果輸出結果不是json
 			if(!json_validate($createDotsshFolderOfsshAgent["content"][0])){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$createDotsshFolderOfsshAgent;
 				#回傳結果
 				return $result;
 				}#if end
 			#解析json
 			$node_info=json_decode($createDotsshFolderOfsshAgent["content"][0]);
 			#若 ssh privacy key 檔案的擁有着不為 $sshAgentAcct:$sshAgentAcct
 			if($node_info->ownerName!==$sshAgentAcct || $node_info->groupName!==$sshAgentAcct){
 				#更新 ssh privacy key 的檔案擁有者
 				#函式說明:
 				#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 				#回傳結果:
 				#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 				#無.
 				#備註:
 				#無.
 				$createDotsshFolderOfsshAgent=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				#如果執行shell失敗
 				if($createDotsshFolderOfsshAgent["status"]==="false"){
 					#設置執行不正常
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"]=$createDotsshFolderOfsshAgent;
 					#回傳結果
 					return $result;
 					}#if end
 				}#if end
 			#若 ssh privacy key 檔案的權限不為 "rw-------"
 			if($node_info->ownerPerm!=="rw-" || $node_info->groupPerm!=="---" || $node_info->otherPerm!=="---"){
 				#更新 ssh privacy key 的檔案擁有者
 				#函式說明:
 				#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 				#回傳結果:
 				#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 				#無.
 				#備註:
 				#無.
 				$createDotsshFolderOfsshAgent=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 				#如果執行shell失敗
 				if($createDotsshFolderOfsshAgent["status"]==="false"){
 					#設置執行不正常
 					$result["status"]="false";
 					#設置執行錯誤
 					$result["error"]=$createDotsshFolderOfsshAgent;
 					#回傳結果
 					return $result;
 					}#if end
 				}#if end
 			#嘗試進行連線,並確認是否成功
 			#函式說明:
 			#連線到 usr/bin/qbpwcf-usock.php 產生的  unix domain socket,運行指定的指令.
 			#回傳結果:
 			#$result["status"],"true"代表執行正常;"false"代表執行不正常.
 			#無.
 			#備註:
 			#無.
 			$createDotsshFolderOfsshAgent=sock::execAnyCmdByQBPWCFunixSocket($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 			unset($conf["sock::execAnyCmdByQBPWCFunixSocket"]);
 			#如果執行shell失敗
 			if($createDotsshFolderOfsshAgent["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$createDotsshFolderOfsshAgent;
 				#回傳結果
 				return $result;
 				}#if end
 			#若得到的輸出未含有ssh登入的資訊(SSH_CLIENT=127.0.0.1 ...)
 			if($createDotsshFolderOfsshAgent["content"]!=="1"){
 				#設置執行正常
 				$result["status"]="true";
 				#設置使用者驗證失敗
 				$result["valid"]="false";
 				#設置使用者不存在的警告
 				$result["warning"][]="使用者 \"".$conf["username"]."\"可能不存在或無法被ssh登入!";
 				#回傳結果
 				return $result;
 				}#if end
 			#設置執行正常
 			$result["status"]="true";
 			#設置使用者驗證正常
 			$result["valid"]="true";
 			#回傳結果
 			return $result;
 			}#if end
 		#反之
 		else{
 			#可以用 echo 'password' | su username -c 'echo valid' 來檢查使用者密碼是否正確
 			#檢查使用者是否存在
 			#函式說明:
 			#呼叫shell執行系統命令,並取得回傳的內容.
 			#回傳的結果:
 			#exec=>http://php.net/manual/en/function.exec.php
 			#escapeshellcmd=>http://php.net/manual/en/function.escapeshellcmd.php
 			#escapeshellarg=>http://php.net/manual/en/function.escapeshellarg.php
 			$callShell=external::callShell($conf["external::callShell"]);
 			unset($conf["external::callShell"]);
 			#如果執行shell失敗
 			if($callShell["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤
 				$result["error"]=$callShell;
 				#回傳結果
 				return $result;
 				}#if end
 			#範例輸出:
 			#Script started on Sat 05 Nov 2016 06:08:31 PM CST
 			#Password: valid
 			#如果輸出 "valid"
 			if($callShell["output"][1]=="Password: valid"){
 				#代表使用者密碼正確
 				#設置執行正常
 				$result["status"]="true";
 				#設置使用者驗證失敗
 				$result["valid"]="true";
 				#回傳結果
 				return $result;
 				}#if end
 			#反之如果是
 			else if($callShell["output"][1]==="Password: su: Authentication failure"){
 				#代表使用者密碼不正確
 				$result["status"]="true";
 				#設置使用者驗證失敗
 				$result["valid"]="false";
 				#設置使用者不存在的警告
 				$result["warning"][]="使用者 \"".$conf["username"]."\" 的密碼不為 \"".$conf["password"]."\" !";
 				#回傳結果
 				return $result;
 				}#if end
 			#反之
 			else{
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"][]="非預期的輸出結果!";
 				#設置錯誤訊息
 				$result["error"][]=$callShell;
 				#回傳結果
 				return $result;
 				}#else end
 			}#else end
 		#設置執行不正常
 		$result["status"]="false";
 		#設置錯誤訊息
 		$result["error"][]="非預期的結果!";
 		#回傳結果
 		return $result;
 		}#function validUser end
 	/*
 	#函式說明:
 	#用php的password_hash方法來單向加密密碼.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$reuslt["error"],執行不正常結束的錯訊息陣列.
 	#$result["function"],當前執行的函式名稱.
 	#$result["content"],呼叫完WebService所得回傳結果.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function encodePassword(&$conf=array()){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!=="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf===null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		#$conf["mustBeFilledVariableName"]=array();
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["skipableVariableCanNotBeEmpty"]=array();
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("password");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("qbpwcf");
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果驗證失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果驗證不成功
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得加密好的密碼
 		$result["content"]=password_hash($conf["password"],PASSWORD_DEFAULT);
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function encodePassword end
 	/*
 	#函式說明:
 	#用php的password_verify方法來驗證密碼是否正確.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$reuslt["error"],執行不正常結束的錯訊息陣列.
 	#$result["function"],當前執行的函式名稱.
 	#$result["content"],呼叫完WebService所得回傳結果.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function validPassword(&$conf=array()){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!=="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf===null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
 		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
 		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
 		#必填寫的參數:
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數:
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("input","password");
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["skipableVariableCanNotBeEmpty"]=array();
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("password");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("qbpwcf");
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
 		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果驗證失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果驗證不成功
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#儲存驗證後的結果
 		$pass=password_verify($conf["input"],$conf["password"]);
 		#如果驗證成功
 		if($pass){
 			#設置驗證成功
 			$result["passed"]="true";
 			}#if end
 		#反之驗證失敗
 		else{
 			#設置驗證成功
 			$result["passed"]="false";
 			}#else end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function validPassword end
 	/*
 	#函式說明:
 	#id指令來取得目標賬號的群組資訊
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function getUserGroup(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!=="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf===null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],執行不正常結束的錯訊息陣列.
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		#備註:
 		#無.
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果驗證失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果驗證不成功
 		if($checkArguments["passed"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#呼叫shell執行系統命令,並取得回傳的內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#備註:
 		#不是所有指令都能用apache的身份執行,目前已知java,javac指令無法執行,使用root身份可能會被selinux阻擋.
 		#若使用的 command、argu 參數，含有 ~ 則會被視為字串，若有需要其於 shell 中代表的家目錄位置，可用 fileAccess::tildeToPath 來進行轉換.
 		$callShell=external::callShell($conf["external::callShell"]);
 		unset($conf["external::callShell"]);
 		#如果執行異常
 		if($callShell["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$callShell;
 			#回傳結果
 			return $result;
 			}#if end
 		#若輸出不對
 		if(count($callShell["content"])===0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$callShell;
 			#回傳結果
 			return $result;
 			}#if end
 		#解析輸出資訊
 		#範例輸出:
 		#uid=1000(liveuser) gid=1000(liveuser) groups=1000(liveuser),10(wheel),1002(web)
 		#函式說明：
 		#尋找字串中是否含有符合格式的內容,且回傳解析好的變數數值.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#無.
 		#備註:
 		#無.
 		$findSpecifyStrFormat=search::findSpecifyStrFormat($conf["search::findSpecifyStrFormat"]);
 		unset($conf["search::findSpecifyStrFormat"]);
 		#如果執行異常
 		if($findSpecifyStrFormat["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$findSpecifyStrFormat;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果沒有符合格式的內容
 		if($findSpecifyStrFormat["found"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$findSpecifyStrFormat;
 			#回傳結果
 			return $result;
 			}#if end
 		#另存使用者id
 		$userId=$findSpecifyStrFormat["parsedVar"]["userId"][0];
 		#另存群組的id
 		$groupId=$findSpecifyStrFormat["parsedVar"]["groupId"][0];
 		#另存隸屬其他群組的資訊
 		$othergGroupStr=$findSpecifyStrFormat["parsedVar"]["othergGroupStr"][0];
 		#如果有其他群組資訊
 		if(!empty($othergGroupStr)){
 			#用逗號切割結果出來
 			#函式說明:
 			#將固定格式的字串分開,並回傳分開的結果.
 			#回傳結果:
 			#$result["status"],執行是否正常,"true"代表正常,"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["found"]==="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$spiltString;
 				#回傳結果
 				return $result;
 				}#if end
 			#依照分隔成的段數
 			foreach($spiltString["dataArray"] as $oginfo){
 				#解析groudId跟groupName
 				#範例輸出:
 				#10(wheel)
 				#函式說明：
 				#尋找字串中是否含有符合格式的內容,且回傳解析好的變數數值.
 				#回傳結果:
 				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 				#$reuslt["error"],執行不正常結束的錯訊息陣列.
 				#無.
 				#備註:
 				#無.
 				$findSpecifyStrFormat=search::findSpecifyStrFormat($conf["search::findSpecifyStrFormat"]);
 				unset($conf["search::findSpecifyStrFormat"]);
 				#如果執行異常
 				if($findSpecifyStrFormat["status"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置錯誤訊息
 					$result["error"]=$findSpecifyStrFormat;
 					#回傳結果
 					return $result;
 					}#if end
 				#如果格式異常
 				if($findSpecifyStrFormat["found"]==="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置錯誤訊息
 					$result["error"]=$findSpecifyStrFormat;
 					#回傳結果
 					return $result;
 					}#if end
 				#如果是 user 自己的群組
 				if($findSpecifyStrFormat["parsedVar"]["groupName"][0]===$user){
 					#跳過該群組資訊
 					continue;
 					}#if end
 				#儲存其他 group id
 				$otherGroupId[]=$findSpecifyStrFormat["parsedVar"]["groupId"][0];
 				#儲存其他 group name
 				$otherGroupName[]=$findSpecifyStrFormat["parsedVar"]["groupName"][0];
 				}#foreach end
 			}#if end
 		#設置 group id 結果
 		$result["content"]["groupId"]=$groupId;
 		#設置隸屬的 group 名稱
 		$result["content"]["belongGroupName"]=$otherGroupName;
 		#設置隸屬的 group id
 		$result["content"]["belongGroupId"]=$otherGroupId;
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function getUserGroup end
 	}#class authenticate end
 ?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/authenticate.php – Rev 207 → 226