Subversion Repositories php-qbpwcf

						#如果有指定 cmd

						if(isset($checkListen["cmd"])){

							#檢查參數

							#函式說明:

							#檢查必填與可省略參數，可省略參數可指定預設要給與什麼數值內容。

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

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

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

							#$result["argu"],設置給予的參數.

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

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

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

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

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

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

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

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

							#必填寫的參數:

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

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

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

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

							#可以省略的參數:

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

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

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

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

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

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

							#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.

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

							#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.

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

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

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

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

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

							#$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("10");

							#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".

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

							#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".

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

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

							#$conf["variableCheck::checkArguments"]["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="false";

							#透過 proc 運行 cmd,並最多等待 timeout 秒.

							#函式說明:

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

							#回傳結果:

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

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

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

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

							#$result["content"],陣列,每個元素為其指令執行的結果訊息陣列,key為"status"代表執行是否正常的識別;key為"statusCode"代表程式結束後回傳給對應executeBy程式的數值,若為"?"則代表程序尚未結束,可透過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($checkListen["cmd"]["cmd"]);

							#可省略參數:

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

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

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

							$conf["threads::proc"]["timeout"]=$checkListen["cmd"]["timeout"];

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

							#備註:

							#若需要取得當下的執行狀況,請使用 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;

								#回傳結果

								return $result;

								}#if end

							#如果程序結束代碼為0

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

								#設置檢查通過

								$pass="true";

								}#if end

							#如果檢查不通過

							if($pass==="false"){

								#提示問題

								echo "service ".$conf["name"]." process not pass test by commamd(".$checkListen["cmd"]["cmd"].")!".PHP_EOL;

								#如果只要 Report

								if($conf["reportOnly"]==="true"){

									#輸出

									echo "service ".$conf["name"]." need to restart!".PHP_EOL;;

									#下一輪

									continue;

									}#if end

								#啟動服務

								#函式說明:

								#執行 systemd 程序來管理服務.

								#回傳結果:

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

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

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

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

								#$result["content"],執行的結果.

								#$result["content"]["srerviceInfo"]["on"],"true",代表運行中,"false",代表無運行. 

								#$result["content"]["srerviceInfo"]["auto"],"true",代表自動啟動,"false",代表不自動啟動. 

								#必填參數:

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

								$conf["cmd::systemd"]["fileArgu"]=$conf["fileArgu"];

								#$conf["name"],字串,服務名稱.

								$conf["cmd::systemd"]["name"]=$conf["name"];

								#可省略參數:

								#$conf["operation"],字串,"enable","disable","start","stop","restart",預設為"list".

								$conf["cmd::systemd"]["operation"]="start";

								#$conf["username"],字串,要用什麼使用者來執行,預設為root使用者

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

								#$conf["password"],字串,使用者的密碼,預設不使用.

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

								$systemd=cmd::systemd($conf["cmd::systemd"]);

								unset($conf["cmd::systemd"]);

								#若運行出錯

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

									#設置執行失敗

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

									#設置錯誤訊息

									$result["error"]=$systemd;

									#回傳結果

									return $result;

									}#if end

								#下一輪

								continue;

								}#if end

							}#if end