Subversion Repositories php-qbpwcf

	#$conf["domain"],字串,csr內容的網域名稱.

	#$conf["domain"]="";

	#可省略參數:

	#$conf["country"],字串,csr內容的國家名稱,預設為"TW".

	#$conf["country"]="";

	#$conf["state"],字串,csr內容的State名稱,預設為"Taiwan".

	#$conf["state"]="";

	#$conf["org"],字串,csr內容的組織名稱,預設為"QBPWCF".

	#$conf["org"]="";

	#$conf["unit"],字串,csr內容的組織所屬單位,預設為"RD".

	#$conf["unit"]="";

	#參考資料:

	#無.

	#備註:

	#無.

	*/

	public static function createCSR(&$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"],執行不正常結束的錯訊息陣列.

		#$result["function"],當前執行的函式名稱.

		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過

		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在

		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確

		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息

		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.

		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.

		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.

		#$result["notNeedVar"],字串陣列,多餘的參數名稱.

		#必填寫的參數：

		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。

		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;

		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");

		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("domain");

		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");

		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");

		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.

		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";

		#可以省略的參數：

		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.

		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";

		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或集合.

		#$conf["skipableVariableCanNotBeEmpty"]=array();

		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");

		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("country","state","city","org","unit");

		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");

		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","string","string");

		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".

		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("TW","Taiwan","Taoyuan City","QBPWCF","RD");

		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.

		#$conf["arrayCountEqualCheck"][]=array();

		#參考資料來源:

		#array_keys=>http://php.net/manual/en/function.array-keys.php

		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);

		unset($conf["variableCheck::checkArguments"]);

		#如果檢查失敗

		if($checkArguments["status"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$checkArguments;

			#回傳結果

			return $result;

			}#if end

		#如果檢查不通過

		if($checkArguments["passed"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$checkArguments;

			#回傳結果

			return $result;

			}#if end

		#產生uuid名稱

		#函式說明:

		#使用 linux 的 uuid 指令來產生 uuid 字串

		#回傳結果:

		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

		#$result["error"],錯誤訊息.

		#$result["function"],當前執行的函式名稱.

		#$result["content"],uuid.

		#必填參數:

		#無.

		#可省略參數:

		#無.

		#參考資料:

		#無.

		#備註:

		#無.

		$uuid=cmd::uuid();

		#如果執行異常

		if($uuid["status"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$uuid;

			#回傳結果

			return $result;

			}#if end

		#取得暫存的檔案名稱

		$TFN=$uuid["content"];

		#函式說明:

		#於本套件位置底下的tmp資料夾下建立與回傳暫存檔案名稱路徑

		#回傳結果:

		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

		#$result["error"],錯誤訊息.

		#$result["function"],當前執行的函數名稱.

		#$result["content"],暫存檔案的路徑與名稱.

		#$result["fileName"],暫存檔案的名稱.

		#$result["path"],暫存檔案的路徑.

		#必填參數:

		#無.

		#可省略參數:

		#$conf["content"],陣列,每行檔案的內容,預設為空陣列,不寫入任何資料.

		#$conf["contant"]=array();

		#參考資料:

		#無.

		#備註:

		#無.

		$conf["fileAccess::createTempFile"]=array();

		$createTempFile=fileAccess::createTempFile($conf["fileAccess::createTempFile"]);

		unset($conf["fileAccess::createTempFile"]);

		#如果執行異常

		if($createTempFile["status"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$createTempFile;

			#回傳結果

			return $result;

			}#if end

		#暫存的檔案路徑與名稱

		$TFN=$createTempFile["content"];

		#產生 privae key

		#openssl genrsa -out output.key 4096 

		#函式說明:

		#呼叫shell執行系統命令,並取得回傳的內容.

		#回傳結果:

		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

		#$result["error"],錯誤訊息陣列.

		#$result["function"],當前執行的函數名稱.

		#$result["argu"],使用的參數.

		#$result["cmd"],執行的指令內容.

		#$result["fullCmd"],如果參數 $conf["inBackGround"] 為 "true" 則會回傳該值.

		#$result["output"],爲執行完後的輸出陣列,若 $conf["inBackGround"] 為 "true",則為當下的輸出.

		#$result["content"],為執行完後的輸出字串.

		#$result["tmpFileOutput"],儲存輸出的暫存檔案名稱,若 $conf["inBackGround"] 為 "true" 則會回傳該值.

		#$result["running"],是否還在執行.

		#$result["pid"],pid.

		#$result["statusCode"],執行結束後的代碼.

		#$result["escape"],陣列,儲存重新排序過且已經escape過的指令(key為"cmd")與參數(key為"argu")與兩者組合的一維陣列(key為"array").

		#$result["noEcaped"],陣列,儲存重新排序過未經過escape過的指令(key為"cmd")與參數(key為"argu")與兩者組合的一維陣列(key為"array").

		#必填參數:

		#$conf["command"],字串,要執行的指令.

		$conf["external::callShell"]["command"]="openssl";

		#$conf["fileArgu"],字串,變數__FILE__的內容.

		$conf["external::callShell"]["fileArgu"]=__FILE__;

		#可省略參數:

		#$conf["argu"],陣列字串,指令搭配的參數,預設為空陣列.

		$conf["external::callShell"]["argu"]=array("genrsa","-out",$TFN,"4096");

		#$conf["arguIsAddr"],陣列字串,指令搭配的哪些參數為路徑,為路徑的參數會進行轉換以便符合呼叫當前函數的位置,預設不指定,若有3個參數,其中第3個參數為路徑,則表示為array("false","false","true").

		#$conf["arguIsAddr"]=array();

		#$conf["pre"],陣列,要在本指令前執行的每個指令與參數.

		#$conf["pre"][$i]["cmd"],字串,要在本指令前執行的第$i+1個指令.

		#$conf["pre"][$i]["param"],陣列字串,要在本指令前執行的第$i+1個指令的參數.

		#$conf["enablePrintDescription"],字串,是否要印出$conf["printDescription"]的內容,"true"代表要,"false"代表不要,預設為"false".

		#$conf["enablePrintDescription"]="true";

		#$conf["printDescription"],字串,執行該外部程式前要印出來的的文字,預設為$conf["command"]的內容加上使用的$conf["argu"]參數.

		#$conf["printDescription"]="";

		#$conf["escapeshellarg"],字串,是否要啟用過濾參數,用了比較安全,但可能會出錯,"true"為啟用,"false"為不啟用,預設為"false".如果參數為"< 、<< 、> 、>> 、| 、2>&1"之一則不會過濾.

		#$conf["escapeshellarg"]="false";

		#$conf["thereIsShellVar"],陣列字串,指令搭配的參數"argu",若含有「\'」,則取代為「"」.每個argu參數都要有對應的元素."true"代表要置換.

		#$conf["thereIsShellVar"]=array();

		#$conf["username"],字串,要用什麼使用者來執行,預設為執行php的使用者,該參數不適用於apache環境.

		#$conf["username"]="";

		#$conf["password"],字串,root的使用者密碼,預設不使用密碼,該參數不適用於apache環境.

		#$conf["password"]="";

		#$conf["useScript"],字串,是否要啟用Linux的script指令來記錄輸出,"true"代表要,Fedora的selinux會擋住該操作;"false"代表不要,預設為"false".

		#$conf["useScript"]="";

		#$conf["logFilePath"],字串,當 $conf["useScript"] 為 "true" 時,輸出的內容要暫存到哪裡,預設為 "/tmp/.qbpwcf_tmp/external/callShell/".

		#$conf["logFilePath"]=".qbpwcf_tmp/external/callShell/";

		#$conf["inBackGround"],字串,是否要在背景執行,且不會等待程式執行結束再執行下一個指令,"true"代表是,"false"代表不要,預設為"false",如果$conf["command"]有用「;」區隔的多個指令將會出錯.

		#$conf["inBackGround"]="";

		#$conf["getErr"],字串,"true"代表將錯誤輸出變成標準輸出,反之"false"為不變動.

		#$conf["getErr"]="false";

		#$conf["doNotRun"],字串,"true"代表不執行指令,預設為"false"會執行指令.

		$conf["external::callShell"]["doNotRun"]="true";

		#參考資料：

		#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

		#備註:

		#不是所有指令都能用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

		#debug

		#var_dump(__LINE__,$callShell);exit;

		#函式說明:

		#透過proc來多執行序運作.

		#回傳結果:

		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

		#$reuslt["error"],執行不正常結束的錯訊息陣列.

		#$result["function"],當前執行的函式名稱.

		#$result["argu"],使用的參數.

		#$result["content"],陣列,每個元素為其指令執行的結果訊息陣列,key為"status"代表執行是否正常的識別;key為"statusCode"代表程式結束後回傳給對應executeBy程式的數值,若為"?"則代表程序尚未結束,若為整數0,則代表順利執行結束,可透過proc_update函式進行資訊的更新與取得;key為"output"代表標準輸出,若為resource,則代表為pipe;key為"error"代表非標準輸出,若為resource,則代表為pipe;key為"input"代表成功輸入的指令;key為"process"代表該程序經proc_open後的process source;key為"proc_get_status"代表程序的資訊.

		#必填參數:

		#$conf["cmds"],字串陣列,每個元素代表單一程序要執行的指令與參數.

		$conf["threads::proc"]["cmds"]=array($callShell["cmd"]);

		#可省略參數:

		#$conf["wait"],字串,是否需要等待所有程序結束,預設為"true"要等待;反之為"false"不要等待.

		$conf["threads::proc"]["wait"]="true";

		#$conf["timeout"],字串陣列,每個元素代表單一程序執行的最大等待秒數,超過後將會強迫停止執行,僅當wait參數為"true"時生效.

		#$conf["timeout"]=array("10");

		#$conf["workingDir"],字串陣列,個別程式執行時的家目錄,預設不指定.

		#$conf["workingDir"]=array("path");

		#$conf["envs"],2維字串陣列,每個元素代表個別程式執行時的指定環境變數,key變數名稱;value為變數內容.預設為array("QBPWCF" => "Quick Build PHP Website Componment base on Fedora Linux");

		#$conf["envs"]=array(array("key"=>"value"));

		#$conf["executeBy"],字串陣列,每個元素代表個別指令要用什麼程式執行,預設為"bash".

		#$conf["executeBy"]=array("bash");

		#參考資料:

		#https://www.php.net/manual/en/function.proc-open.php

		#https://www.php.net/manual/en/function.proc-get-status.php

		#https://www.php.net/manual/en/function.proc-terminate.php

		#備註:

		#若需要取得當下的執行狀況,請使用 self::proc_update 來更新.

		$proc=threads::proc($conf["threads::proc"]);

		unset($conf["threads::proc"]);

		#如果執行異常

		if($proc["status"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$proc;

			#回傳結果

			return $result;

			}#if end

		#debug

		#var_dump(__LINE__,$proc);exit;

		#如果執行異常

		if($proc["content"][0]["status"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$proc["content"][0]["error"];

			#回傳結果

			return $result;

			}#if end

		#儲存錯誤訊息

		$errorMsg=$proc["content"][0]["error"];

		#如果有錯誤訊息

		if(!empty($errorMsg)){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$errorMsg;

			#回傳結果

			return $result;

			}#if end

		#範例指令

		#C,國家,例如TW,代表Taiwan

		#ST,州、省，要完整名稱,例如:Taiwan

		#L,城市名稱,例如Taoyuan City.

		#O=,組織或公司名稱,例如QBPWCF.

		#OU,單位名稱,例如RD.

		#CN,網域名稱,例如www.qbpwcf.org

		#openssl req -new -key qbpwcf.org.key -out qbpwcf.org.csr "-subj=/C=TW/ST=Taiwan/L=Taoyuan City/O=QBPWCF/OU=RD/CN=www.qbpwcf.org/"

		#初始化subj參數

		$subjStr="-subj=/";

		#設置 Country 參數

		$subjStr=$subjStr."C=".$conf["country"]."/";

		#設置 State 參數

		$subjStr=$subjStr."ST=".$conf["state"]."/";

		#設置 city 參數

		$subjStr=$subjStr."L=".$conf["city"]."/";

		#設置 Org 參數

		$subjStr=$subjStr."O=".$conf["org"]."/";

		#設置 Unit 參數

		$subjStr=$subjStr."OU=".$conf["unit"]."/";

		#設置 domain name 參數

		$subjStr=$subjStr."CN=".$conf["domain"]."/";

		#函式說明:

		#呼叫shell執行系統命令,並取得回傳的內容.

		#回傳結果:

		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

		#$result["error"],錯誤訊息陣列.

		#$result["function"],當前執行的函數名稱.

		#$result["argu"],使用的參數.

		#$result["cmd"],執行的指令內容.

		#$result["fullCmd"],如果參數 $conf["inBackGround"] 為 "true" 則會回傳該值.

		#$result["output"],爲執行完後的輸出陣列,若 $conf["inBackGround"] 為 "true",則為當下的輸出.

		#$result["content"],為執行完後的輸出字串.

		#$result["tmpFileOutput"],儲存輸出的暫存檔案名稱,若 $conf["inBackGround"] 為 "true" 則會回傳該值.

		#$result["running"],是否還在執行.

		#$result["pid"],pid.

		#$result["statusCode"],執行結束後的代碼.

		#$result["escape"],陣列,儲存重新排序過且已經escape過的指令(key為"cmd")與參數(key為"argu")與兩者組合的一維陣列(key為"array").

		#$result["noEcaped"],陣列,儲存重新排序過未經過escape過的指令(key為"cmd")與參數(key為"argu")與兩者組合的一維陣列(key為"array").

		#必填參數:

		#$conf["command"],字串,要執行的指令.

		$conf["external::callShell"]["command"]="openssl";

		#$conf["fileArgu"],字串,變數__FILE__的內容.

		$conf["external::callShell"]["fileArgu"]=__FILE__;

		#可省略參數:

		#$conf["argu"],陣列字串,指令搭配的參數,預設為空陣列.

		$conf["external::callShell"]["argu"]=array("req","-new","-key",$TFN,$subjStr);

		#$conf["arguIsAddr"],陣列字串,指令搭配的哪些參數為路徑,為路徑的參數會進行轉換以便符合呼叫當前函數的位置,預設不指定,若有3個參數,其中第3個參數為路徑,則表示為array("false","false","true").

		#$conf["arguIsAddr"]=array();

		#$conf["pre"],陣列,要在本指令前執行的每個指令與參數.

		#$conf["pre"][$i]["cmd"],字串,要在本指令前執行的第$i+1個指令.

		#$conf["pre"][$i]["param"],陣列字串,要在本指令前執行的第$i+1個指令的參數.

		#$conf["enablePrintDescription"],字串,是否要印出$conf["printDescription"]的內容,"true"代表要,"false"代表不要,預設為"false".

		#$conf["enablePrintDescription"]="true";

		#$conf["printDescription"],字串,執行該外部程式前要印出來的的文字,預設為$conf["command"]的內容加上使用的$conf["argu"]參數.

		#$conf["printDescription"]="";

		#$conf["escapeshellarg"],字串,是否要啟用過濾參數,用了比較安全,但可能會出錯,"true"為啟用,"false"為不啟用,預設為"false".如果參數為"< 、<< 、> 、>> 、| 、2>&1"之一則不會過濾.

		$conf["external::callShell"]["escapeshellarg"]="true";

		#$conf["thereIsShellVar"],陣列字串,指令搭配的參數"argu",若含有「\'」,則取代為「"」.每個argu參數都要有對應的元素."true"代表要置換.

		#$conf["thereIsShellVar"]=array();

		#$conf["username"],字串,要用什麼使用者來執行,預設為執行php的使用者,該參數不適用於apache環境.

		#$conf["username"]="";

		#$conf["password"],字串,root的使用者密碼,預設不使用密碼,該參數不適用於apache環境.

		#$conf["password"]="";

		#$conf["useScript"],字串,是否要啟用Linux的script指令來記錄輸出,"true"代表要,Fedora的selinux會擋住該操作;"false"代表不要,預設為"false".

		#$conf["useScript"]="";

		#$conf["logFilePath"],字串,當 $conf["useScript"] 為 "true" 時,輸出的內容要暫存到哪裡,預設為 "/tmp/.qbpwcf_tmp/external/callShell/".

		#$conf["logFilePath"]=".qbpwcf_tmp/external/callShell/";

		#$conf["inBackGround"],字串,是否要在背景執行,且不會等待程式執行結束再執行下一個指令,"true"代表是,"false"代表不要,預設為"false",如果$conf["command"]有用「;」區隔的多個指令將會出錯.

		#$conf["inBackGround"]="";

		#$conf["getErr"],字串,"true"代表將錯誤輸出變成標準輸出,反之"false"為不變動.

		#$conf["getErr"]="false";

		#$conf["doNotRun"],字串,"true"代表不執行指令,預設為"false"會執行指令.

		$conf["external::callShell"]["doNotRun"]="true";

		#參考資料：

		#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

		#備註:

		#不是所有指令都能用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

		#debug

		#var_dump(__LINE__,$callShell);exit;

		#函式說明:

		#透過proc來多執行序運作.

		#回傳結果:

		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

		#$reuslt["error"],執行不正常結束的錯訊息陣列.

		#$result["function"],當前執行的函式名稱.

		#$result["argu"],使用的參數.

		#$result["content"],陣列,每個元素為其指令執行的結果訊息陣列,key為"status"代表執行是否正常的識別;key為"statusCode"代表程式結束後回傳給對應executeBy程式的數值,若為"?"則代表程序尚未結束,若為整數0,則代表順利執行結束,可透過proc_update函式進行資訊的更新與取得;key為"output"代表標準輸出,若為resource,則代表為pipe;key為"error"代表非標準輸出,若為resource,則代表為pipe;key為"input"代表成功輸入的指令;key為"process"代表該程序經proc_open後的process source;key為"proc_get_status"代表程序的資訊.

		#必填參數:

		#$conf["cmds"],字串陣列,每個元素代表單一程序要執行的指令與參數.

		$conf["threads::proc"]["cmds"]=array($callShell["cmd"]);

		#可省略參數:

		#$conf["wait"],字串,是否需要等待所有程序結束,預設為"true"要等待;反之為"false"不要等待.

		$conf["threads::proc"]["wait"]="true";

		#$conf["timeout"],字串陣列,每個元素代表單一程序執行的最大等待秒數,超過後將會強迫停止執行,僅當wait參數為"true"時生效.

		#$conf["timeout"]=array("10");

		#$conf["workingDir"],字串陣列,個別程式執行時的家目錄,預設不指定.

		#$conf["workingDir"]=array("path");

		#$conf["envs"],2維字串陣列,每個元素代表個別程式執行時的指定環境變數,key變數名稱;value為變數內容.預設為array("QBPWCF" => "Quick Build PHP Website Componment base on Fedora Linux");

		#$conf["envs"]=array(array("key"=>"value"));

		#$conf["executeBy"],字串陣列,每個元素代表個別指令要用什麼程式執行,預設為"bash".

		#$conf["executeBy"]=array("bash");

		#參考資料:

		#https://www.php.net/manual/en/function.proc-open.php

		#https://www.php.net/manual/en/function.proc-get-status.php

		#https://www.php.net/manual/en/function.proc-terminate.php

		#備註:

		#若需要取得當下的執行狀況,請使用 self::proc_update 來更新.

		$proc=threads::proc($conf["threads::proc"]);

		unset($conf["threads::proc"]);

		#如果執行異常

		if($proc["status"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$proc;

			#回傳結果

			return $result;

			}#if end

		#如果執行異常

		if($proc["content"][0]["status"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$proc["content"][0]["error"];

			#回傳結果

			return $result;

			}#if end

		#debug

		#var_dump(__LINE__,$proc);exit;

		#儲存csr

		$csr=$proc["content"][0]["content"];

		#取得 csr 內容

		$result["content"]=$csr;

		#移除private key

		#函式說明:

		#移除檔案

		#回傳結果:

		#$result["status"],"true"代表移除成功,"false"代表移除失敗.

		#$result["error"],錯誤訊息陣列.

		#$result["warning"],警告訊息陣列.

		#$result["function"],當前執行的函數名稱.

		#$result["argu"],當前函式使用的參數.

		#必填參數:

		#$conf["fileAddress"],字串,要移除檔案的位置.

		$conf["fileAccess::delFile"]["fileAddress"]=$TFN;

		#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑.

		$conf["fileAccess::delFile"]["fileArgu"]=__FILE__;

		#可省略參數:

		#$conf["commentsArray"],字串陣列,提示的文字描述,$conf["commentsArray"][$i]代表第($+1)行的描述.

		#$conf["commentsArray"]=array("");

		#$conf["allowDelSymlink"],字串,預設為"false",不移除軟連結;"true"代表要移除軟連結.

		#$conf["allowDelSymlink"]="true";

		#$conf["allowDelFolder"],字串,預設為"false",不移除目錄;"true"代表要移除目錄.

		#$conf["allowDelFolder"]="true";

		#參考資料:

		#無.

		#備註:

		#無.

		$delFile=fileAccess::delFile($conf["fileAccess::delFile"]);

		unset($conf["fileAccess::delFile"]);

		#如果執行異常

		if($delFile["status"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$delFile;

			#回傳結果

			return $result;

			}#if end

		#設置執行正常

		$result["status"]="true";

		#回傳結果

		return $result;

		}#function createCSR end

	/*

	#函式說明:

	#提供certificate sign request(CSR)透過zerossl產生cergificate.

	#回傳結果:

	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

	#$reuslt["error"],執行不正常結束的錯訊息陣列.

	#$result["function"],當前執行的函式名稱.

	#$result["argu"],所使用的參數.

	#$result["curl_verbose_info"],curl執行的詳細資訊.

	#$result["id"],用於zerossl api驗證domain的id.

	#$result["content"],字串,得到的json字串回應.

	#$result["cnameKey"],用於dns CNAME驗證鍵名.

	#$result["cnameVal"],用於dms CNAME驗證鍵值.

	#必填參數:

		#驗證結果是否為 json

		$json_validate=json_validate($curlCmd["fullContent"]);

		#如果回應不是 json

		if(!$json_validate){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$curlCmd;

			return $result;

			}#if end

		#設置json string結果

		#解析json

		$jsonRes=json_decode($result["content"]);

		#取得用於 dns CNAME 驗證的名稱

		$result["cnameKey"]=$jsonRes->validation->other_methods->$conf["certificate_domains"]->cname_validation_p1;

		#取得用於 dns CNAME 驗證的數值

		$result["cnameVal"]=$jsonRes->validation->other_methods->$conf["certificate_domains"]->cname_validation_p2;

		#取得用於認證domain時識別用的id

		$result["id"]=$jsonRes->id;

		}#function createCertificate end

	/*

	#函式說明:

	#新增DNS記錄到檔案裡面.

	#回傳結果:

	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

	#$reuslt["error"],執行不正常結束的錯訊息陣列.

	#$result["function"],當前執行的函式名稱.

	#$result["argu"],所使用的參數.

	#$result["content"],字串陣列,更新後的檔案RR(DNS記錄).

	#$result["content"]["domain"],字串,RR所屬domain.

	#$result["content"]["defaultTTL"],字串,預設的RR更新時間.

	#$result["comment"],字串陣列,逐行的註解.

	#必填參數:

	#$conf["add"],多維陣列,每個元素有為有三個元素的陣列,key有"query"跟"update"跟"type"跟"value"以及"comment",分別代表要查詢的數值、更新周期、類型、答案、註解.

	$conf["add"]=array();

	#$conf["dnsRecordFile"],字串,該ZONE檔案位置與名稱.

	$conf["dnsRecordFile"]="";

	#可省略參數:

	#$conf["writeNow"],字串,是否要直接寫入既有ZONE檔案,預設為"false",不寫入;"true"為直接覆寫內容.

	#$conf["writeNow"]="false";

	#參考資料:

	#無.

	#備註:

	#目前支援的DNS記錄檔案是給bind(Berkeley Internet Name Domain)套件使用的.

	#通常qbpwcf使用者沒有權限存取RR(dns記錄檔案),本套件是透過sshfs掛載來繞過該問題.

	#php-pear上的Net_DNS2也可以解析RR.

	*/

	public static function updateDnsRecordFile(&$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"],執行不正常結束的錯訊息陣列.

		#$result["function"],當前執行的函式名稱.

		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過

		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在

		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確

		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息

		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.

		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.

		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.

		#$result["notNeedVar"],字串陣列,多餘的參數名稱.

		#必填寫的參數：

		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。

		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;

		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");

		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("add","dnsRecordFile");

		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");

		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","string");

		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.

		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";

		#可以省略的參數：

		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.

		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";

		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或集合.

		#$conf["skipableVariableCanNotBeEmpty"]=array();

		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");

		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("writeNow");

		#$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

		$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

		#初始化要回傳的content

		$result["content"]=array();

		#初始化儲存逐行的註解.

		$result["comment"]=array();

		#預設的zone file domain為空

		$result["domain"]="";

		#預設的 update 時間

		$result["defaultTTL"]=3600;

		#取得 dns 記錄檔案的內容

		#函式說明:

		#依據行號分隔抓取檔案的內容,結果會回傳一個陣列

		#回傳的變數說明:

		#$result["status"],執行是否成功，"true"代表成功；"fasle"代表失敗.

		#$result["error"],錯誤訊息提示.

		#$result["warning"],警告訊息.

		#$result["function"],當前執行的函數名稱.

		#$result["fileContent"],爲檔案的內容陣列.

		#$result["lineCount"],爲檔案內容總共的行數.

		#$result["fullContent"],為檔案的完整內容.

		#$result["base64dataOnly"],檔案的base64data.

		#$result["base64data"],為在網頁上給予src參數的數值.

		#$result["mimeType"],為檔案的mime type.

		#必填參數:

		#$conf["filePositionAndName"],字串,爲檔案的位置以及名稱.

		$conf["fileAccesss::getFileContent"]["filePositionAndName"]=$conf["dnsRecordFile"];

		#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑

		$conf["fileAccesss::getFileContent"]["fileArgu"]=__FILE__;

		#可省略參數:

		#$conf["web"],是要取得網路上的檔案則為"true";反之預設為"false".

		$conf["fileAccesss::getFileContent"]["web"]="false";

		#$conf["createIfnotExist"],字串,預設為"false"代表檔案不存在也不需要建立;反之為"true".

		#$conf["createIfnotExist"]="false";

		#$conf["autoDeleteSpaceOnEachLineStart"],字串,預設為"false",不做額外處理;反之為"true"

		#$conf["autoDeleteSpaceOnEachLineStart"]="false";

		#參考資料：

		#file(),取得檔案內容的行數.

		#file=>http:#php.net/manual/en/function.file.php

		#rtrim(),剔除透過file()取得每行內容結尾的換行符號.

		#filesize=>http://php.net/manual/en/function.filesize.php

		#參考資料:

		#無.

		#備註:

		#無.

		$getFileContent=fileAccess::getFileContent($conf["fileAccesss::getFileContent"]);

		unset($conf["fileAccesss::getFileContent"]);

		#如果檢查失敗

		if($getFileContent["status"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$getFileContent;

			#回傳結果

			return $result;

			}#if end

		#取得每行內容

		$lines=$getFileContent["fileContent"];

		/*

		範例每行內容:

		$ORIGIN server.domain.	;base domain-name,in this Resource Records (RR) file,"@" equal to base domain-name.

		$TTL 86400	;default TTL for zone

		@	1200	IN	SOA	dns.server.domain. admin.server.domain. 2026012205 10800 1800 1728000 1200 ;domain name server, admin mail, serial, refresh time, expire, Negative Caching, https://bind9.readthedocs.io/en/latest/chapter3.html#term-SOA-minimum

		@	3600	IN	TXT	"v=spf1 a mx ~all"

		@	86400	IN	MX	1 mail.server.domain.

		@	86400	IN	A	1.1.1.1

		mail.server.domain.	IN	1.1.1.1

		10-42-0-1	IN	A	10.42.0.1

		101-free        IN      A	101.101.101.101

		127-0-0-1	IN	A	127.0.0.1

		_dmarc	IN	TXT	"v=DMARC1;p=reject;sp=reject;pct=100;adkim=r;aspf=r;fo=1;ri=86400;rua=mailto:admin@server.domain"

		default._domainkey	IN	TXT	( "v=DKIM1; k=rsa;" "p=MIGfMA0GCSqG/SIb3DQEBAQQAB" )  ; ----- DKIM key default for qbpwcf.org

		...

		*/

		#針對每行內容

		foreach($lines as $lineNo => $line){

			#另存一份要處理的RR

			$unFormatStr=$line;

			#/*

			#debug

			#函式說明:

			#撰寫log

			#回傳結果:

			#$result["status"],狀態,"true"或"false".

			#$result["error"],錯誤訊息陣列.

			#$result["function"],當前函式的名稱.

			#$result["argu"],使用的參數.

			#$result["content"],要寫入log的內容字串.

			#必填參數:

			#$conf["path"],字串,log檔案的路徑與名稱.

			$conf["logs::record"]["path"]="/tmp/zerossl::".__FUNCTION__;

			#$conf["content"],any,要寫的內容,若內容不為字串則會用var_dump的格式寫入.

			$conf["logs::record"]["content"]="processing lineNo:".$lineNo." content:".$line.PHP_EOL;

			#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑

			$conf["logs::record"]["fileArgu"]=__FILE__;

			#可省略參數:

			#$conf["rewrite"],預設為"false",接續寫入;反之"true"代表重新寫入.

			#$conf["rewrite"]="false";

			#$conf["returnOnly"],預設為"false",會寫入到log檔案.若為"true"則不會寫入log.

			#$conf["returnOnly"]="true";

			#參考資料:

			#無.

			#備註:

			#無.

			$record=logs::record($conf["logs::record"]);

			unset($conf["logs::record"]);

			#*/

			#初始化該行的資訊陣列

			$info=array();

			#尋找";"開頭的內容,亦即整行都是註解.

			#函式說明：

			#尋找字串中是否含有符合格式的內容,且回傳解析好的變數數值.

			#回傳結果:

			#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

			#$reuslt["error"],執行不正常結束的錯訊息陣列.

			#$result["function"],當前執行的函式名稱.

			#$result["argu"],所使用的參數.

			#$result["found"],是否有找到符合格式的字串內容,"true"代表有找到,"false"代表沒有找到.

			#$result["content"],陣列,若為n個${*},則當found為"true"時,就會回傳n個元素.

			#$result["parsedVar"][varName],陣列,解析好的變數陣列,varName為${}中的內容.

			#必填參數:

			#$conf["input"],字串,要檢查的字串.

			$conf["search::findSpecifyStrFormat"]["input"]=$unFormatStr;

			#$conf["format"],格式字串,要尋找的格式字串.格式為固定的字串("fixedStr format")與變數("${keyWordVarName}")組成.

			$conf["search::findSpecifyStrFormat"]["format"]=";\${else}";

			#可省略參數:

			#$conf["varEqual"],陣列,變數對應的數值,null代表不指定,其他內容代表該變數解析出來必須要為該內容.

			#$conf["varEqual"]=array(null,"found");