Rev 32 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed
<?php/*QBPWCF, Quick Build PHP website Component base on Fedora Linux.Copyright (C) 2014~2025 Min-Jhin,ChenThis file is part of QBPWCF.QBPWCF is free software: you can redistribute it and/or modifyit under the terms of the GNU General Public License as published bythe Free Software Foundation, either version 3 of the License, or(at your option) any later version.QBPWCF is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See theGNU General Public License for more details.You should have received a copy of the GNU General Public Licensealong with QBPWCF. If not, see <http://www.gnu.org/licenses/>.*/namespace qbpwcf;/*類別說明:跟函式參數檢查相關的類別.備註:無.*/class variableCheck{#給予 $setErrorHandler 函式使用的 confpublic static $setErrorHandlerConf=array();/*#函式說明:#當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#必填參數:#$method,物件,為物件實體或類別名稱,會自動置入該參數.#$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"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#必填參數:#$method,物件,為物件實體或類別名稱,會自動置入該參數.#$arguments,陣列,為呼叫方法時所用的參數.#可省略資料:#無.#參考資料:#__callStatic=>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/*#函式說明:#檢查陣列裡面的特定元素是否存在以及其變數型態是否正確,如果沒有設定則回傳提示訊息。#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#$result["argu"],設置給予的參數.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result["warning"],警告訊息#$result["content"][$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result["content"][$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result["content"][$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息#必填參數:$conf["varInput"],陣列,要檢查的陣列變數$conf["varInput"]=array();$conf["variableCheck"],陣列,要檢查的變數名稱陣列,形態爲陣列變數,例如: $conf["variableCheck"] = array("id","account","password");$conf["variableCheck"]=array();#可省略參數:#$conf["variableType"],字串陣列,要檢查的陣列變數內的元素應該爲何種變數形態,形態爲陣列 例如: $conf[variableType] = array("string","int","double"); ,null/any代表沒有指定變數形態.若為"resource"則包含"resource (closed)".#$conf["variableType"]=array();##$conf["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話,請設為"false",預設為也算是有設置.#$conf["canBeEmpty"],陣列,可以為空字串或集合的變數,僅當$conf["canBeEmptyString"]為"false"時生效.#$conf["canBeEmpty"]=array();#$conf["canNotBeEmpty"],陣列,不可以為空字串或集合的變數,僅當$conf["canBeEmptyString"]為"true"時生效.#$conf["canNotBeEmpty"]=array();#參考資料:#無.#備註:#無.*/public static function isexistMulti(&$conf){#初始化要回傳的內容$result=array();#取得當前執行的函式$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif($conf==null){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#回傳結果return $result;}#if end#取得所使用的參數$result["argu"]=$conf;#如果 $conf["varInput"] 沒有設定if(!isset($conf["varInput"])){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$resutl["error"][]="\$conf[\"varInput\"]未設置";#回傳結果return $result;}#if end#反之代表 $conf["varInput"] 有設定else{#如果 gettype($conf["varInput"]) 不等於 "array"if(gettype($conf["varInput"])!=="array"){#echo "須為陣列";#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"][]="\$conf[\"varInput\"]型態須為陣列";#回傳結果return $result;}#if end}#else end#如果 $conf["variableCheck"] 沒有設定if(!isset($conf["variableCheck"])){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$resutl["error"][]="\$conf[\"variableCheck\"]未設置";#回傳結果return $result;}#if end#如果可為空值的變數不存在if(!isset($conf["canBeEmptyString"])){#預設為 "true"$conf["canBeEmptyString"]="true";}#if end#如果未設置 $conf["canBeEmpty"]if(!isset($conf["canBeEmpty"])){#設置為空陣列$conf["canBeEmpty"]=array();}#if end#如果未設置 $conf["canNotBeEmpty"]if(!isset($conf["canNotBeEmpty"])){#設置為空陣列$conf["canNotBeEmpty"]=array();}#if end#反之 $conf["variableCheck"] 有設定else{#如果 gettype($conf["variableCheck"]) 不等於 "array"if(gettype($conf["variableCheck"])!="array"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$resutl["error"][]="\$conf[\"variableCheck\"]型態須為陣列";#回傳結果return $result;}#if end}#else end#初始化目前要檢查的變數型態計數$typeCount=-1;#針對每個要檢查的變數名稱foreach($conf["variableCheck"] as $shouldBtCheckedVarName){#目前要檢查的變數型態計數+1$typeCount++;#如果有輸入的參數if(isset($conf["varInput"])){#如果 $conf["varInput"] 裡面有元素if(count($conf["varInput"])!=0){#var_dump($conf["varInput"]);#針對每個已經放入的參數foreach($conf["varInput"] as $varInputKey=>$varInputValue){#函式說明:#檢查一個數值是否與陣列裏面的元素相同,找到一個相符合的元素後就會停止搜尋.#回傳結果:#$result["status"],"true"表示執行正確,"false"表示執行錯誤.#$result["founded"],"true"表示有找到相同的,"false"表示沒有找到相同的.#$result["error"],錯誤訊息#$result["function"],當前執行的函數名稱#$result["equalVarName"],相等的變數名稱或key.#$result["equalVarValue"],相等的變數數值內容.#必填參數:$conf["search"]["getEqualVar"]["conditionElement"]=$shouldBtCheckedVarName;#條件元素,要等於的元素內容。$conf["search"]["getEqualVar"]["compareElements"]=array($varInputKey);#要比對的陣列變數內容。$temp=search::getEqualVar($conf["search"]["getEqualVar"]);unset($conf["search"]["getEqualVar"]);#如果 search::getEqualVar 執行失敗if($temp["status"]=="false"){#設置執行不正常$result["status"]="false";#設置錯誤訊息陣列$result["error"]=$temp;#回傳結果return $result;}#if end#如果 search::getEqualVar 找不到必填的參數if($temp["founded"]=="false"){#則儲存其結果$result["content"][$shouldBtCheckedVarName]["varExist"]="false";#儲存給予的參數$result["content"][$shouldBtCheckedVarName]["argu"]=$temp["argv"];}#if end#反之有找到必填的參數else{#如果$conf["canBeEmptyString"]為"false"#代表變數內容不能為空字串if($conf["canBeEmptyString"]=="false"){#如果該參數不在可例外為空字串或集合的陣列裡面if(!(in_array($varInputKey,$conf["canBeEmpty"]))){#變數要有存在才行if(isset($varInputValue)){#則檢查變數內容是否為空字串if($varInputValue===""){#則儲存其結果$result["content"][$shouldBtCheckedVarName]["varExist"]="false";#設置警告訊息訊息$result["error"][]="變數「".$shouldBtCheckedVarName."」不得為空字串";#將其設為 "false"$result["passed"]="false";#換找下一個變數是否存在break;}#if end#初始化計數為0$countOFvarInputValue=false;#如果是陣列if(gettype($varInputValue)==="array"){#計數$countOFvarInputValue=count($varInputValue);}#if end#則檢查變數內容是否為空陣列if($countOFvarInputValue===0){#則儲存其結果$result["content"][$shouldBtCheckedVarName]["varExist"]="false";#設置警告訊息訊息$result["error"][]="變數「".$shouldBtCheckedVarName."」不得為空陣列";#將其設為 "false"$result["passed"]="false";#換找下一個變數是否存在break;}#if end}#if end}#if end}#if end#反之 $conf["canBeEmptyString"]為"true"#代表變數內容可為空字串else if($conf["canBeEmptyString"]==="true"){#如果該參數不在可例外不為空字串或集合if((in_array($varInputKey,$conf["canNotBeEmpty"]))){#則檢查變數內容是否為空字串#或是空集合if($varInputValue===""){#則儲存其結果$result["content"][$shouldBtCheckedVarName]["varExist"]="false";#設置警告訊息訊息$result["error"][]="變數「".$shouldBtCheckedVarName."」不得為空字串";#將其設為 "false"$result["passed"]="false";#換找下一個變數是否存在break;}#if end#反之如果可以計數else if(is_array($varInputValue)){#或是空集合if(count($varInputValue)==0){#則儲存其結果$result["content"][$shouldBtCheckedVarName]["varExist"]="false";#設置警告訊息訊息$result["error"][]="變數「".$shouldBtCheckedVarName."」不得為空陣列";#將其設為 "false"$result["passed"]="false";#換找下一個變數是否存在break;}#if end}#else end}#if end}#if end#則儲存其結果$result["content"][$shouldBtCheckedVarName]["varExist"]="true";#如果有設定$conf["variableType"]if(isset($conf["variableType"])){#如果正確 type 為 "resource"if($conf["variableType"][$typeCount]==="resource"){#如果是 resource 開頭的形態if(strpos(gettype($varInputValue),$conf["variableType"][$typeCount])===0){#則給予型態認證通過的識別$result["content"][$shouldBtCheckedVarName]["varType"]="true";}#if end}#if end#反之如果該變數的型態正確 或是要求的形態為null 或為 "any"else if($conf["variableType"][$typeCount]===gettype($varInputValue) || $conf["variableType"][$typeCount]===null || $conf["variableType"][$typeCount]==="any"){#則給予型態認證通過的識別$result["content"][$shouldBtCheckedVarName]["varType"]="true";}#if end#反之形態不正確else{#則給予型態認不證通過的識別$result["content"][$shouldBtCheckedVarName]["varType"]="false";/*#debugvar_dump($varInputValue);echo "實際是=>".gettype($varInputValue);echo "規定要=>".$conf["variableType"][$typeCount];var_dump($typeCount);*/#設置錯誤的形態$result["content"][$shouldBtCheckedVarName]["wrongType"]=gettype($varInputValue);#設置正確的形態$result["content"][$shouldBtCheckedVarName]["rightType"]=$conf["variableType"][$typeCount];#設置錯誤形態的數值內容$result["content"][$shouldBtCheckedVarName]["value"]=$varInputValue;}#else end}#if end#換找下一個變數是否存在break;}#else end}#foreach end}#if end#反之 $conf["varInput"] 裡面沒有元素else{#設置該變數不存在$result["content"][$shouldBtCheckedVarName]["varExist"]="false";#設置該變數形態不對$result["content"][$shouldBtCheckedVarName]["varType"]="false";}#else end}#if end}#foreach end#如果有要檢查的變數if(isset($result["content"])){#檢查是否每個要檢查的變數都存在且形態皆正確foreach($result["content"] as $name => $statusArray){#檢查是否存在與形態是否正確的識別foreach($statusArray as $status){#如果有個變數的檢查是否通過識別為 "false"if($status=="false"){#將其設為 "false"$result["passed"]="false";}#if end}#foreach end}#foreach end}#if end#如果 $result["passed"] 沒有設置if(!isset($result["passed"])){#將其設為 true$result["passed"]="true";}#if end#執行到這邊代表執行正常$result["status"]="true";#回傳陣列結果return $result;}#function isexistMulti end/*#函式說明:#檢查變數的形態是否正確#回傳結果:#$result["status"],執行是否正常#$result["error"].錯誤訊息陣列#$result["passed"],若爲"true"則表示形態正確,"false"為形態有誤.#$result["function"],當前執行的函數名稱.#必填參數:#$conf["vName"],字串,要檢查的變數.$conf["vName"]="";#$conf["vType"],字串,變數的形態,若為"any"則代表不檢查型態,若為"resource",則也允許"resource (closed)".$conf["vType"]="";#可省略參數:#無.#參考資料:#無.#備註:#無.*/public static function checkType(&$conf){#初始化要回傳的變數$result=array();#取得當前執行的函數名稱$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif($conf==null){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#回傳結果return $result;}#if end#如果 $conf["vName"] 變數不存在if(!isset($conf["vName"])){#設置執行錯誤$result["status"]="false";#設置錯誤訊息$result["error"][]="\$conf[\"vName\"]參數不存在";#回傳結果return $result;}#if end#如果 $conf["vType"] 變數不存在if(!isset($conf["vType"])){#設置執行錯誤$result["status"]="false";#設置錯誤訊息$result["error"][]="\$conf[\"vType\"]參數不存在";#回傳結果return $result;}#if end#如果是 resourceif($conf["vType"]==="resource"){#如果不是開頭為 "resource" 的形態if(strpos(gettype($conf["vName"]),$conf["vType"])!==0){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置錯誤訊息$result["error"][]="變數\$conf[\"vName\"]的形態應為".$conf["vType"];#回傳結果return $result;}#if end}#if end#反之若其變數形態不爲 $conf["vType"] 且期望的變數型態不為 "any"else if(gettype($conf["vName"])!=$conf["vType"] && $conf["vType"]!=="any"){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置錯誤訊息$result["error"][]="變數\$conf[\"vName\"]的形態應為".$conf["vType"];#回傳結果return $result;}#if end#執行到這表代表執行正常$result["status"]="true";#執行到這邊代表形態檢查通過$result["passed"]="true";#回傳結果return $result;}#function checkType end/*#函式說明:#檢查一個陣列變數裏面含有指定key的元素共有個#回傳結果:#$result["status"],執行是否正常#$result["error"].錯誤訊息陣列#$result["function"],當前執行的函數名稱.#$result["content"],爲總共找到幾個不是空值的數量#必填參數:#$conf["conditionValue"],陣列,想要調查具有該名稱的陣列元素,須為陣列值.$conf["conditionValue"]=array();#$conf["inputArray"],陣列,想要檢查的陣列變數,須為陣列值.$conf["inputArray"]=array();#可省略參數:#無.#參考資料:#無.#備註:#無.*/public static function computeIsset(&$conf){#初始化要回傳的變數$result=array();#取得當前執行的函數名稱$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif($conf==null){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#回傳結果return $result;}#if end#如果 $conf["conditionValue"] 變數不存在if(!isset($conf["conditionValue"])){#回傳錯誤訊息return "\$conf[\"conditionValue\"]參數不存在";}#if end#如果 $conf["inputArray"] 變數不存在if(!isset($conf["inputArray"])){#回傳錯誤訊息return "\$conf[\"inputArray\"]參數不存在";}#if end#設定預設的計數爲0$result["content"]=0;#看有幾個要尋找是否存在的變數,就執行幾次for($i=0;$i<count($conf["conditionValue"]);$i++){#檢查是否有該變數存在if(isset($conf["inputArray"][$conf["conditionValue"][$i]])){#若存在則計數+1$result["content"]++;}#if end}#for end#設置執行正常$result["status"]="true";#回傳結果return $result;}#function computeIsset end/*#函式說明:#檢查某個元素是否存在於該一維陣列變數裏面#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#$result["founded"],"true",表示該元素已經存在於該一維陣列變數裏面,"false"表示該元素不存在於該一維陣列變數裏面 .#必填參數:#$conf["searchString"],字串,要搜尋的元素內容.$conf["searchString"]="";#$conf["searchArray"],字串陣列,要搜尋的陣列變數.$conf["searchArray"]=array();#可省略參數:#無.#參考資料:#無.#備註:#無.*/public static function checkElementExistFromAnArray(&$conf){#初始化要回傳的內容$result=array();#記錄當前執行的函數名稱$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif($conf==null){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#回傳結果return $result;}#if end#檢查參數#函式說明:#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容。#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息#$result["argu"],字串陣列,目前輸入的參數名稱陣列.#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.#$result["notNeedVar"],字串陣列,多餘的參數名稱.#必填參數:#$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。$conf["variableCheck::checkArguments"]["varInput"]=&$conf;#$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列,形態爲陣列變數,元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("searchString","searchArray");#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","array");#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";#可省略參數:#$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"true"。$conf["variableCheck::checkArguments"]["variableCheck::checkArguments"]["canBeEmptyString"]="false";#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("firstLineVarName");#$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#檢查 $conf["searchString"] 是否存在於 $conf["searchArray"]$in_array=in_array($conf["searchString"],$conf["searchArray"]);#如果 $conf["searchString"] 存在於 $conf["searchArray"]if($in_array){#設置沒有找到元素$result["founded"]="true";}#if end#反之else{#設置沒有找到元素$result["founded"]="false";}#else end#設置執行正常$result["status"]="true";#回傳結果return $result;}#function checkElementExistFromAnArray end/*#函式說明:#判斷session變數 $_SESSION["key1"]["key2"]["key3"]... 是否存在,若存在則可以將其內容回傳,若目標session變數不存在則可以指定要回傳的內容,取得變數內容之後可以卸除其session變數.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#$result["content"],取得的session變數內容#必填參數:#$conf["sessionName"],陣列字串,要取得的session變數名稱,須爲陣列字串值。$conf["sessionName"][0]對應的是session變數的第1個key;$conf["sessionName"][1]對應的是session變數的第2個key;$conf["sessionName"][2]對應的是session變數的第3個key。$conf["sessionName"]=array();#可省略參數:#$conf["ifEmptyThenSet"],字串,如果目標session變數不存在,則指派爲什麼樣的數值給目標變數?預設爲"".#$conf["ifEmptyThenSet"]="";#$conf["unsetSessionVar"],字串,是否要在指派完變數之後將該sesssion變數卸除,其數值會變成NULL,若設爲"true",表示要卸除,預設為"false",表示不卸除.#$conf["unsetSessionVar"]="true";#參考資料:#無.#備註:#無.*/public static function assignSessionValueToVar(&$conf){#初始化要回傳的內容$result=array();#記錄當前執行的函數名稱$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif($conf==null){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#回傳結果return $result;}#if end#檢查參數#函式說明:#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容。#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.#$result["argu"],字串陣列,目前輸入的參數名稱陣列.#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.#$result["notNeedVar"],字串陣列,多餘的參數名稱.#必填參數:#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。$conf["variableCheck::checkArguments"]["varInput"]=&$conf;#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列,形態爲陣列變數,元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sessionName");#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";#可省略參數:#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"true",可以為空字串.$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或集合.#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array();#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("ifEmptyThenSet","unsetSessionVar");#$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");#$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#指派一個沒有內容的變數$tempVar=null;#依據 $conf["sessionName"] 的元素數量與內如來判斷特定的 session 變數是否存在.for($i=0;$i<count($conf["sessionName"]);$i++){#如果是第一層if($i==0){#如果 session 變數不存在if(!isset($_SESSION[$conf["sessionName"][$i]])){#取得指定的內容$result["content"]=$conf["ifEmptyThenSet"];#設置執行正常$result["status"]="true";#回傳結果return $result;}#if end#取得第一層 session 變數的參照$tempVar=&$_SESSION[$conf["sessionName"][$i]];}#if end#反之else{#如果 session 變數不存在if(!isset($tempVar[$conf["sessionName"][$i]])){#取得指定的內容$result["content"]=$conf["ifEmptyThenSet"];#設置執行正常$result["status"]="true";#回傳結果return $result;}#if end#取得 session 變數下一層key的參照$tempVar=&$tempVar[$conf["sessionName"][$i]];}#else end}#for end#取得 session 變數的內容$result["content"]=$tempVar;#如果 $conf["unsetSessionVar"] 為 "true"if($conf["unsetSessionVar"]=="true"){#透過指定 session 變數為 NULL 來卸除變數$tempVar=NULL;#卸除session變數,僅會卸除$tempVar而已,session變數不會卸除.#unset($tempVar);}#if end#設置執行正常$result["status"]="true";#回傳結果return $result;}#assignSessionValueToVariable end/*#函式說明:#判斷變數是否存在,將之儲存到session變數裏面#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#$result["founded"],變數是否存在,"true"為存在,"false"為不存在.#必填參數:#$conf["var"],參考變數,想要確認是否存在的變數$conf["var"]=&;#$conf["sessionVarName"],陣列字串,要將變數存到key為什麼的session多維變數裏面$conf["sessionVarName"]=array();#可省略參數:#無.#參考資料:#無.#備註:#要改寫成可以依據 $conf["sessionVarName"] 元素數量建立多維的session變數.*/public static function assignVarToSessionValue(&$conf){#初始化要回傳的內容$result=array();#記錄當前執行的函數名稱$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif($conf==null){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#回傳結果return $result;}#if end#檢查參數#函式說明:#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容。#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.#$result["argu"],字串陣列,目前輸入的參數名稱陣列.#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.#$result["notNeedVar"],字串陣列,多餘的參數名稱.#必填參數:#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。$conf["variableCheck::checkArguments"]["varInput"]=&$conf;#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列,形態爲陣列變數,元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("var","sessionVarName");#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array(null,"array");#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";#可省略參數:#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"true",可以為空字串.#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或集合.#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array();#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("ifEmptyThenSet","unsetSessionVar");#$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");#$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#若變數是不存在if(!isset($conf["var"])){#設置找不到變數$result["founded"]="false";}#if end#反之else{#設置找到變數$result["founded"]="true";#初始化暫存 session 變數參考的變數$tempVar;#依據 $conf["sessionVarName"] 的元素個數建立 session 變數for($i=0;$i<count($conf["sessionVarName"]);$i++){#如果是第一層if($i==0){#如果是最後一層if($i==count($conf["sessionVarName"])-1){#建立 session 變數,並指定內容.$_SESSION[$conf["sessionVarName"][$i]]=$conf["var"];}#if end#反之else{#如果 session 變數未建立if(!isset($_SESSION[$conf["sessionVarName"][$i]])){#建立 session 變數,指派為空陣列$_SESSION[$conf["sessionVarName"][$i]]=array();}#if end}#else end#取得 session 變數的參考$tempVar=&$_SESSION[$conf["sessionVarName"][$i]];}#if end#反之else{#如果是最後一層if($i==count($conf["sessionVarName"])-1){#建立 session 變數,並指定內容.$tempVar[$conf["sessionVarName"][$i]]=$conf["var"];}#if end#反之else{#如果 session 變數未建立if(!isset($tempVar[$conf["sessionVarName"][$i]])){#建立 session 變數,指派為空陣列$tempVar[$conf["sessionVarName"][$i]]=array();}#if end}#else end#取得 session 變數的參考$tempVar=&$tempVar[$conf["sessionVarName"][$i]];}#else end#debug#unset($_SESSION["manageDbAndTable"]);#unset($_SESSION[""]);#unset($_SESSION["variableCheck"]);#var_dump($_SESSION);}#for end}#else end#設置執行正常$result["status"]="true";#回傳結果return $result;}#function assignVarToSessionValue end/*#函式說明:#檢查一包含數個可省略變數的陣列變數,其型態是否正確,省略掉的陣列變數可以直接給定預設值。#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],參數是否都通過檢查,"true",代表有通過檢查,"false"代表沒有通過檢查。#必填參數:#$conf["checkedVar"],陣列,要檢查的變數陣列名稱為?$conf["checkedVar"]=$conf;#$conf["sikpableVarNameArray"],字串陣列,要檢查型態是否設定正確的變數名稱陣列.$conf["sikpableVarNameArray"]=array("",);#$argu,要直接存取的陣列變數名稱,變數前面加上「&」,如果要在別的函式裡面使用本函式,請記得將變動過結果($argu)給使用該函式的設定變數(通常是$conf=$argu).$argu=&$conf;#可省略參數:#$conf["skipableVarTypeArray"],字串陣列,要檢查的每個變數,其型態應該要為何,null代表不指定變數形態.#$conf["skipableVarTypeArray"]=array("",);#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的變數要初始化為什麼,null代表不指定.#$conf["skipableVarDefaultValue"]=array("",);#參考資料:#無.#備註:#無.*/public static function checkSkipableVarType($conf,&$argu){#初始化要回傳的內容$result=array();#記錄當前執行的函數名稱$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif($conf==null){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#回傳結果return $result;}#if end#設置當前函式名稱#參考資料來源:#http://php.net/manual/en/language.constants.predefined.php$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#回傳結果return $result;}#if end#檢查參數#函式說明:#檢查陣列裡面的特定元素是否存在以及其變數型態是否正確,如果沒有設定則回傳提示訊息。#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#必填參數:$conf["variableCheck::isexistMulti"]["varInput"]=$conf;#要檢查的陣列變數$conf["variableCheck::isexistMulti"]["variableCheck"]=array("checkedVar","sikpableVarNameArray");#要檢查的變數名稱陣列,形態爲陣列變數,例如: $conf["variableCheck"] = array("id","account","password");#可省略參數:$conf["variableCheck::isexistMulti"]["variableType"]=array("array","array");#要檢查的陣列變數內的元素應該爲何種變數形態,形態爲陣列 例如: $conf[variableType] = array("string","int","double");#$conf["variableCheck::isexistMulti"]["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話,請設為"false",預設為也算是有設置。$checkResult=variableCheck::isexistMulti($conf["variableCheck::isexistMulti"]);unset($conf["variableCheck::isexistMulti"]);#如果 $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#依據每個要檢查的可省略變數keyfor($i=0;$i<count($conf["sikpableVarNameArray"]);$i++){#如果 $conf["checkedVar"][$conf["sikpableVarNameArray"][$i]] 有設定if(isset($conf["checkedVar"][$conf["sikpableVarNameArray"][$i]])){#如果有設定 $conf["skipableVarTypeArray"][$i]if(isset($conf["skipableVarTypeArray"][$i])){#如果 $conf["checkedVar"][$conf["sikpableVarNameArray"][$i]] 的型態不等於 $conf["sikpableVarTypeArray"][$i] 且 $conf["skipableVarTypeArray"][$i] 不為 nullif(gettype($conf["checkedVar"][$conf["sikpableVarNameArray"][$i]])!=$conf["skipableVarTypeArray"][$i] && $conf["skipableVarTypeArray"][$i]!=null){#type "any" 不用檢查if($conf["skipableVarTypeArray"][$i]!=="any"){#設置執行正常$result["status"]="true";#設置執行錯誤識別$result["passed"]="false";#設置錯誤訊息$result["error"][]=$conf["sikpableVarNameArray"][$i]."須為".$conf["skipableVarTypeArray"][$i]."型態";#回傳結果return $result;}#if end}#if end}#if end}#if end#反之該變數不存在else{#如果 $conf["skipableVarDefaultValue"] 有設置if(isset($conf["skipableVarDefaultValue"])){#如果 $conf["skipableVarDefaultValue"] 為 "array"if(gettype($conf["skipableVarDefaultValue"])=="array"){#如果 $conf["skipableVarDefaultValue"][$i] 完全不等於 nullif($conf["skipableVarDefaultValue"][$i]!==null){#初始化該變數內容$argu[$conf["sikpableVarNameArray"][$i]]=$conf["skipableVarDefaultValue"][$i];}#if end}#if end}#if end}#else end}#for end#設置執行正常$result["status"]="true";#執行到這邊代表檢查通過$result["passed"]="true";#回傳結果return $result;}#funciton checkSkipableVarType end/*#函式說明:#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],執行不正常結束的錯訊息陣列.#$result["simpleError"],簡單表示的錯誤訊息.#$result["function"],當前執行的函式名稱.#$result["argu"],設置給予的參數.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.#$result["argu"],字串陣列,目前輸入的參數名稱陣列.#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.#$result["notNeedVar"],字串陣列,多餘的參數名稱.#必填參數:#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。$conf["varInput"]=&$conf;#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.$conf["referenceVarKey"]="variableCheck::checkArguments";#可省略參數:#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列,形態爲陣列變數,元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");#$conf["mustBeFilledVariableName"]=array();#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null、any代表不指定變數形態.其中 resource也包含"resource (closed)".#$conf["mustBeFilledVariableType"]=array();#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"true",可以為空字串.#$conf["canBeEmptyString"]="false";#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.#$conf["canNotBeEmpty"]=array();#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.#$conf["canBeEmpty"]=array();#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.#$conf["skipableVariableCanNotBeEmpty"]=array();#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");#$conf["skipableVariableName"]=array();#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableType"] = array("string",integer,"double");#$conf["skipableVariableType"]=array();#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一,請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".#$conf["skipableVarDefaultValue"]=array("");#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".#$conf["disallowAllSkipableVarIsEmpty"]="";#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".#$conf["disallowAllSkipableVarIsEmptyArray"]="";#$conf["disallowAllSkipableVarNotExist"],字串,是否不允許每個可省略參數都不存在,預設為"false"代表允許,反之為"true".#$conf["disallowAllSkipableVarNotExist"]="";#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.#$conf["arrayCountEqualCheck"][]=array();#參考資料:#array_keys=>http://php.net/manual/en/function.array-keys.php#備註:#無.*/public static function checkArguments(&$conf){#初始化要回傳的結果$result=array();#設置當其函數名稱$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif($conf===null){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#設置放置的參數$result["argu"]=$conf;#檢查必填參數#函式說明:#檢查陣列裡面的特定元素是否存在以及其變數型態是否正確,如果沒有設定則回傳提示訊息。#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息#必填參數:$conf["variableCheck.isexistMulti"]["varInput"]=$conf;#要檢查的陣列變數$conf["variableCheck.isexistMulti"]["variableCheck"]=array("varInput","referenceVarKey");#要檢查的變數名稱陣列,形態爲陣列變數,例如: $conf["variableCheck"] = array("id","account","password");#可省略參數:$conf["variableCheck.isexistMulti"]["variableType"]=array("array","string");#要檢查的陣列變數內的元素應該爲何種變數形態,形態爲陣列 例如: $conf[variableType] = array("string","int","double");$conf["variableCheck.isexistMulti"]["canBeEmptyString"]="true";#變數內容如果是空字串就不能算是有設置的話,請設為"false",預設為也算是有設置。#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.#$conf["variableCheck.isexistMulti"]["canNotBeEmpty"]=array();#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.#$conf["variableCheck.isexistMulti"]["canBeEmpty"]=array();$checkResult=variableCheck::isexistMulti($conf["variableCheck.isexistMulti"]);unset($conf["variableCheck.isexistMulti"]);#如果檢查失敗if($checkResult["status"]==="false"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果檢查不通過if($checkResult["passed"]==="false"){#設置執正常$result["status"]="true";#設置錯誤識別$result["passed"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#檢查可省略參數#函式說明:#檢查一包含數個可省略變數的陣列變數,其型態是否正確,省略掉的陣列變數可以直接給定預設值。#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],參數是否都通過檢查,"true",代表有通過檢查,"false"代表沒有通過檢查。#必填參數:#$conf["variableCheck.checkSkipableVarType"]["checkedVar"],陣列,要檢查的變數陣列名稱為?$conf["variableCheck.checkSkipableVarType"]["checkedVar"]=$conf;#$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"],字串陣列,要檢查型態是否設定正確的變數名稱陣列.$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"]=array("mustBeFilledVariableName","mustBeFilledVariableType","canBeEmptyString","canNotBeEmpty","canBeEmpty","skipableVariableCanNotBeEmpty","skipableVariableName","skipableVariableType","skipableVarDefaultValue","arrayCountEqualCheck","disallowAllSkipableVarIsEmpty","disallowAllSkipableVarNotExist","disallowAllSkipableVarIsEmptyArray");#$argu,要直接存取的陣列變數名稱,變數前面加上「&」,如果要在別的函式裡面使用本函式,請記得將變動過結果($argu)給使用該函式的設定變數(通常是$conf=$argu).$argu=&$conf;#可省略參數:#$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"],字串陣列,要檢查的每個變數,其型態應該要為何?$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"]=array("array","array","string","array","array","array","array","array","array","array","string","string","string");#$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"],字串陣列,每個不存的變數要初始化為什麼,"null"代表不指定.$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"]=array(null,null,"true",null,null,null,null,null,null,null,"false","false","false");$checkResult=variableCheck::checkSkipableVarType($conf["variableCheck.checkSkipableVarType"],$argu);unset($conf["variableCheck.checkSkipableVarType"]);#如果檢查失敗if($checkResult["status"]=="false"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果檢查不通過if($checkResult["passed"]=="false"){#設置執正常$result["status"]="true";#設置錯誤識別$result["passed"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果有設置 $conf["mustBeFilledVariableName"] 跟 $conf["mustBeFilledVariableType"]if( isset($conf["mustBeFilledVariableName"])===true && isset($conf["mustBeFilledVariableType"])===true ){#檢查輸入參數的數量是否不一致if(count($conf["mustBeFilledVariableName"])!==count($conf["mustBeFilledVariableType"])){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"][]="參數 \"mustBeFilledVariableName\" 與 \"mustBeFilledVariableType\" 的數量要一致";#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#函式說明:#檢查陣列裡面的特定元素是否存在以及其變數型態是否正確,如果沒有設定則回傳提示訊息。#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息#必填參數:$conf["variableCheck.isexistMulti"]["varInput"]=$conf["varInput"];#要檢查的陣列變數$conf["variableCheck.isexistMulti"]["variableCheck"]=$conf["mustBeFilledVariableName"];#要檢查的變數名稱陣列,形態爲陣列變數,例如: $conf["variableCheck"] = array("id","account","password");#可省略參數:$conf["variableCheck.isexistMulti"]["variableType"]=$conf["mustBeFilledVariableType"];#要檢查的陣列變數內的元素應該爲何種變數形態,形態爲陣列 例如: $conf[variableType] = array("string","int","double");#變數內容如果是空字串就不能算是有設置的話,請設為"false",預設為也算是有設置。$conf["variableCheck.isexistMulti"]["canBeEmptyString"]=$conf["canBeEmptyString"];#如果設定必填參數可以為空字串或集合if($conf["canBeEmptyString"]=="true"){#如果有設定要排除的不能為空字串或空集合的變數if(isset($conf["canNotBeEmpty"])){#設定其參數$conf["variableCheck.isexistMulti"]["canNotBeEmpty"]=$conf["canNotBeEmpty"];}#if end}#if end#如果設定必填參數不可以為空字串或集合else if($conf["canBeEmptyString"]=="false"){#如果有設定要排除的不能為空字串或空集合的變數if(isset($conf["canBeEmpty"])){#設定其參數$conf["variableCheck.isexistMulti"]["canBeEmpty"]=$conf["canBeEmpty"];}#if end}#if end$checkResult=variableCheck::isexistMulti($conf["variableCheck.isexistMulti"]);unset($conf["variableCheck.isexistMulti"]);#如果檢查失敗if($checkResult["status"]=="false"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果檢查不通過if($checkResult["passed"]=="false"){#設置執正常$result["status"]="true";#設置錯誤識別$result["passed"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end}#if end#如果 $conf["skipableVariableName"] 與 $conf["skipableVariableType"] 存在if(isset($conf["skipableVariableName"]) && isset($conf["skipableVariableType"])){#如果 $conf["skipableVariableName"] 與 $conf["skipableVariableType"] 的元素數量不一致if(count($conf["skipableVariableName"])!=count($conf["skipableVariableType"])){#設置錯誤識別$result["status"]="false";#設置錯誤識別$result["passed"]="false";#設置錯誤訊息$result["error"][]="\$conf[\"skipableVariableName\"] 與 \$conf[\"skipableVariableType\"] 的元素數量不一致";#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end}#if end#如果 $conf["skipableVariableName"] 有設置if(isset($conf["skipableVariableName"]) && isset($conf["skipableVarDefaultValue"])){#如果 $conf["skipableVariableName"] 與 $conf["skipableVarDefaultValue"] 的元素數量不一致if(count($conf["skipableVariableName"])!=count($conf["skipableVarDefaultValue"])){#設置執正常$result["status"]="true";#設置錯誤識別$result["passed"]="false";#設置錯誤訊息$result["error"][]="\$conf[\"skipableVariableName\"] 與 \$conf[\"skipableVarDefaultValue\"] 的元素數量不一致";#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end}#if end#如果有可省略變數的型態限定if(isset($conf["skipableVariableType"])){#如果可省略變數有 string 型別if(in_array("string",$conf["skipableVariableType"])){#如果 $conf["disallowAllSkipableVarIsEmpty"] 設置為 "true"if($conf["disallowAllSkipableVarIsEmpty"]==="true"){#設置檢查不通過$pass=false;#如果沒有指定可省略參數if(!isset($conf["skipableVariableName"])){#設置通過檢測$pass=true;}#if end#反之若可省略參數大於0else if(count($conf["skipableVariableName"])>0){#設置是否有設置可省略變數$haveSkipVar=false;#針對每個可省略的變數foreach($conf["skipableVariableName"] as $varKey=>$varName){#如果該可省略變數有設置if(isset($conf["varInput"][$varName])){#設置有設置可省略變數$haveSkipVar=true;#如果是字串型態if(gettype($conf["varInput"][$varName])==="string"){#如果是空字串if($conf["varInput"][$varName]!==""){#設置通過檢測$pass=true;#跳過檢查break;}#if end}#if end}#if end}#foreach end#如果未設置可省略參數if(!$haveSkipVar){#設置通過檢測$pass=true;}#if end}#if end#反之else{#設置通過檢測$pass=true;}#else end#如果檢查不通過if(!$pass){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置錯誤訊息$result["warning"][]="可省略參數不都得為空字串";#回傳結果return $result;}#if end}#if end}#if end#如果可省略變數有 array 型別if(in_array("array",$conf["skipableVariableType"])){#如果 $conf["disallowAllSkipableVarIsEmptyArray"] 為 "true"if($conf["disallowAllSkipableVarIsEmptyArray"]==="true"){#設置檢查不通過$pass=false;#如果沒有指定可省略參數if(!isset($conf["skipableVariableName"])){#設置通過檢測$pass=true;}#if end#反之若可省略參數大於0else if(count($conf["skipableVariableName"])>0){#針對每個可省略的變數foreach($conf["skipableVariableName"] as $varKey=>$varName){#如果該可省略變數有設置if(isset($conf["varInput"][$varName])){#如果是陣列型態if(gettype($conf["varInput"][$varName])==="array"){#函式說明:#檢查一陣列變數是否為空陣列#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],css動畫設定的語法#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#$result["empty"],"true"代表為空陣列,"false"代表不為空陣列.#必填參數:#$conf["var"],陣列變數.$conf["variableCheck::emptyArray"]["var"]=$conf["varInput"][$varName];#備註:#無$emptyArray=variableCheck::emptyArray($conf["variableCheck::emptyArray"]);unset($conf["variableCheck::emptyArray"]);#如果檢查失敗if($emptyArray["status"]==="false"){#設置執行失敗$result["status"]="false";#設置錯誤訊息$result["error"]=$emptyArray;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果不是空陣列if($emptyArray["empty"]==="false"){#設置通過檢測$pass=true;#跳過檢查break;}#if end}#if end}#if end}#foreach end}#if end#反之else{#設置通過檢測$pass=true;}#else end#如果檢查不通過if(!$pass){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置錯誤訊息$result["warning"][]="可省略參數不都得為空陣列";#回傳結果return $result;}#if end}#if end}#else end#如果可省略變數有 any 型別if(in_array("any",$conf["skipableVariableType"])){#儲存可以為任意形態的變數$anyTypeVarName=array();#針對每個可省略參數的形態foreach($conf["skipableVariableType"] as $varKey=>$varType){#如果找到形態為any的變數形態if($varType==="any"){#儲存形態為 any 的可省略變數名稱$anyTypeVarName[]=$conf["skipableVariableName"][$varKey];}#if end}#foreach end#針對每個 any type 的可省略變數名稱foreach($anyTypeVarName as $varName){#如果該可省略變數存在if(isset($conf["varInput"][$varName])){#取得變數的形態$varType=gettype($conf["varInput"][$varName]);#判斷變數的形態switch($varType){#如果是字串case "string":#如果 $conf["disallowAllSkipableVarIsEmpty"] 設置為 "true"if($conf["disallowAllSkipableVarIsEmpty"]==="true"){#如果該變數是不被允許的空字串if($conf["varInput"][$varName]===""){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置錯誤訊息$result["warning"][]="可省略參數".$varName."不都得為空陣列";#回傳結果return $result;}#if end}#if end#跳出switchbreak;#如果是陣列case "array":#如果 $conf["disallowAllSkipableVarIsEmptyArray"] 為 "true"if($conf["disallowAllSkipableVarIsEmptyArray"]==="true"){#如果該變數是不被允許的空陣列if($conf["varInput"][$varName]===array()){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置錯誤訊息$result["warning"][]="可省略參數".$varName."不都得為空陣列";#回傳結果return $result;}#if end}#if end#跳出switchbreak;default:}#switch end}#if end}#foreach end}#if end}#if end#如果 $conf["skipableVarDefaultValue"] 有設置if(isset($conf["skipableVarDefaultValue"])){#檢查 $conf["skipableVariableName"] 陣列中的每個可省略變數名稱for($i=0;$i<count($conf["skipableVariableName"]);$i++){#如果 $conf["skipableVarDefaultValue"] 有設置if(isset($conf["skipableVarDefaultValue"])){#如果 $conf["skipableVarDefaultValue"][$i] 為字串且不為空字串if(gettype($conf["skipableVarDefaultValue"][$i])==="string" && $conf["skipableVarDefaultValue"][$i]!=""){#尋找有無$開頭的字串#函式說明:#取得字首一樣的字串,並回傳其字串。#回傳結果:#$result["status"],若爲"true"則代表執行正常;若爲"false"則代表執行失敗。#$result["founded"],若為"true"則代表有找到符合字首條件的結果;若爲"false"則代表沒有找到。#$result["function"],當前執行的函數名稱.#$result["error"],錯誤訊息陣列.#$result["returnString"],爲符合字首條件的字串內容。#必填參數:$conf["search.getMeetConditionsString"]["checkString"]=$conf["skipableVarDefaultValue"][$i];#要檢查的字串$conf["search.getMeetConditionsString"]["frontWord"]="\$";#用來檢查字首應該要有什麼字串#用到的涵式:#str_spilt(),可以將字串依照字母分割成一個個陣列字串。$isVariable=search::getMeetConditionsString($conf["search.getMeetConditionsString"]);unset($conf["search.getMeetConditionsString"]);#如果尋找失敗if($isVariable["status"]=="false"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$isVariable;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果含有 "\$" 開頭if($isVariable["founded"]=="true"){#用 " 分割含有 $ 的字串,取得中間那一段#函式說明:#將固定格式的字串分開,並回傳分開的結果。#回傳的參數:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列#$result["oriStr"],要分割的原始字串內容#$result["dataArray"],爲分割好字串的陣列內容,$result["dataArray"][$i]爲第($i+1)段的內容。#$result["dataCounts"],爲總共分成幾段#必填參數:$conf["stringProcess.spiltString"]["stringIn"]=$isVariable["returnString"];#要處理的字串。$conf["stringProcess.spiltString"]["spiltSymbol"]="\"";#爲以哪個符號作爲分割#備註:#建議新增如果透過" "分割後的內容含有""的元素,將其移除,並將後面有內容的元素補上,key也重新排序。$spiltedStr=stringProcess::spiltString($conf["stringProcess.spiltString"]);unset($conf["stringProcess.spiltString"]);#如果分割失敗if($spiltedStr["status"]=="false"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$spiltedStr;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果分割出來沒有大於等於三段if($spiltedStr["dataCounts"]<3){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$spiltedStr;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#函式說明:#檢查一包含數個可省略變數的陣列變數,其型態是否正確,省略掉的陣列變數可以直接給定預設值。#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],參數是否都通過檢查,"true",代表有通過檢查,"false"代表沒有通過檢查。#必填參數:#$conf["variableCheck.checkSkipableVarType"]["checkedVar"],陣列,要檢查的變數陣列名稱為?$conf["variableCheck.checkSkipableVarType"]["checkedVar"]=$conf["varInput"];#$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"],字串陣列,要檢查型態是否設定正確的變數名稱陣列.$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"]=array($conf["skipableVariableName"][$i]);#$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"],字串陣列,要檢查的每個變數,其型態應該要為何?$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"]=array($conf["skipableVariableType"][$i]);#如果要採用的預設值變數存在if(isset($conf["varInput"][$spiltedStr["dataArray"][1]])){#代表該元素的預設值為在檢查參數時自動產生的,因此要透過動態變數取得預設值$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"]=array($conf["varInput"][$spiltedStr["dataArray"][1]]);#如果變數後面需要串接內容if(isset($spiltedStr["dataArray"][3])){#串接後面的內容$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"][0]=$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"][0].$spiltedStr["dataArray"][3];}#if end}#if end#$argu,要直接存取的陣列變數名稱,變數前面加上「&」,如果要在別的函式裡面使用本函式,請記得將變動過結果($argu)給使用該函式的設定變數(通常是$conf=$argu).$argu=&$conf["varInput"];#可省略參數:$checkResult=variableCheck::checkSkipableVarType($conf["variableCheck.checkSkipableVarType"],$argu);unset($conf["variableCheck.checkSkipableVarType"]);#如果檢查失敗if($checkResult["status"]=="false"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果檢查不通過if($checkResult["passed"]=="false"){#設置錯誤識別$result["status"]="true";#設置錯誤識別$result["passed"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end}#if end#反之 預設值沒有含有 "$"else{#函式說明:#檢查一包含數個可省略變數的陣列變數,其型態是否正確,省略掉的陣列變數可以直接給定預設值。#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],參數是否都通過檢查,"true",代表有通過檢查,"false"代表沒有通過檢查。#必填參數:#$conf["variableCheck.checkSkipableVarType"]["checkedVar"],陣列,要檢查的變數陣列名稱為?$conf["variableCheck.checkSkipableVarType"]["checkedVar"]=$conf["varInput"];#$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"],字串陣列,要檢查型態是否設定正確的變數名稱陣列.$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"]=array($conf["skipableVariableName"][$i]);#$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"],字串陣列,要檢查的每個變數,其型態應該要為何?$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"]=array($conf["skipableVariableType"][$i]);#$argu,要直接存取的陣列變數名稱,變數前面加上「&」,如果要在別的函式裡面使用本函式,請記得將變動過結果($argu)給使用該函式的設定變數(通常是$conf=$argu).$argu=&$conf["varInput"];#可省略參數:$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"]=array($conf["skipableVarDefaultValue"][$i]);$checkResult=variableCheck::checkSkipableVarType($conf["variableCheck.checkSkipableVarType"],$argu);unset($conf["variableCheck.checkSkipableVarType"]);#如果檢查失敗if($checkResult["status"]=="false"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果檢查不通過if($checkResult["passed"]=="false"){#設置執正常$result["status"]="true";#設置錯誤識別$result["passed"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end}#else end}#if end#反之預設值非字串else{#函式說明:#檢查一包含數個可省略變數的陣列變數,其型態是否正確,省略掉的陣列變數可以直接給定預設值。#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],參數是否都通過檢查,"true",代表有通過檢查,"false"代表沒有通過檢查。#必填參數:#$conf["variableCheck.checkSkipableVarType"]["checkedVar"],陣列,要檢查的變數陣列名稱為?$conf["variableCheck.checkSkipableVarType"]["checkedVar"]=$conf["varInput"];#$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"],字串陣列,要檢查型態是否設定正確的變數名稱陣列.$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"]=array($conf["skipableVariableName"][$i]);#$argu,要直接存取的陣列變數名稱,變數前面加上「&」,如果要在別的函式裡面使用本函式,請記得將變動過結果($argu)給使用該函式的設定變數(通常是$conf=$argu).$argu=&$conf["varInput"];#可省略參數:#如果有設定 $conf["skipableVariableType"]if(isset($conf["skipableVariableType"])){#$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"],字串陣列,要檢查的每個變數,其型態應該要為何?$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"]=array($conf["skipableVariableType"][$i]);}#if end#$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"],字串陣列,每個不存的變數要初始化為什麼,null代表不指定.$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"]=array($conf["skipableVarDefaultValue"][$i]);#var_dump($conf);$checkResult=variableCheck::checkSkipableVarType($conf["variableCheck.checkSkipableVarType"],$argu);unset($conf["variableCheck.checkSkipableVarType"]);#如果檢查失敗if($checkResult["status"]=="false"){#設置執行失敗$result["status"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果檢查不通過if($checkResult["passed"]=="false"){#設置執正常$result["status"]="true";#設置錯誤識別$result["passed"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end}#else end}#if end#反之沒有設定預設值else{#函式說明:#檢查一包含數個可省略變數的陣列變數,其型態是否正確,省略掉的陣列變數可以直接給定預設值。#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],參數是否都通過檢查,"true",代表有通過檢查,"false"代表沒有通過檢查。#必填參數:#$conf["variableCheck.checkSkipableVarType"]["checkedVar"],陣列,要檢查的變數陣列名稱為?$conf["variableCheck.checkSkipableVarType"]["checkedVar"]=$conf["varInput"];#$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"],字串陣列,要檢查型態是否設定正確的變數名稱陣列.$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"]=array($conf["skipableVariableName"][$i]);#$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"],字串陣列,要檢查的每個變數,其型態應該要為何?$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"]=array($conf["skipableVariableType"][$i]);#$argu,要直接存取的陣列變數名稱,變數前面加上「&」,如果要在別的函式裡面使用本函式,請記得將變動過結果($argu)給使用該函式的設定變數(通常是$conf=$argu).$argu=&$conf["varInput"];#可省略參數:#$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"]=array($conf["skipableVarDefaultValue"][$i]);$checkResult=variableCheck::checkSkipableVarType($conf["variableCheck.checkSkipableVarType"],$argu);unset($conf["variableCheck.checkSkipableVarType"]);#如果檢查失敗if($checkResult["status"]=="false"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果檢查不通過if($checkResult["passed"]=="false"){#設置執正常$result["status"]="true";#設置錯誤識別$result["passed"]="false";#設置錯誤訊息$result["error"]=$checkResult;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end}#else end}#for end}#if end#如果 $conf["arrayCountEqualCheck"] 存在if(isset($conf["arrayCountEqualCheck"])){#$conf["arrayCountEqualCheck"]有幾組元素就執行幾次for($i=0;$i<count($conf["arrayCountEqualCheck"]);$i++){#初始化暫存元素數量的陣列$tempEqualCount=array();#該組有幾個元素就執行幾次for($j=0;$j<count($conf["arrayCountEqualCheck"][$i]);$j++){#如果要判斷元素數量是否一致的變數陣列存在if(isset($conf["varInput"][$conf["arrayCountEqualCheck"][$i][$j]])){#儲存該組該變數的元素數量$tempEqualCount[]=count($conf["varInput"][$conf["arrayCountEqualCheck"][$i][$j]]);}#if end}#for end#如果該組只有一個元素數量資料if(count($tempEqualCount)==0){#跳出迴圈break;}#if end#看 $tempEqualCount 中的元素計數是否都一樣#$tempEqualCount 有幾個元素就執行幾次for($j=1;$j<count($tempEqualCount);$j++){#如果跟第一個變數的元素數量不一樣if($tempEqualCount[0]!=$tempEqualCount[$j]){#設置執正常$result["status"]="true";#設置錯誤識別$result["passed"]="false";#設置錯誤訊息$result["error"][]="key為".$conf["arrayCountEqualCheck"][$i][0]."與".$conf["arrayCountEqualCheck"][$i][$j]."的參數其元數數量不一致";#設置錯誤訊息$result["error"][]=array("key為".$conf["arrayCountEqualCheck"][$i][0]."的參數",$conf["varInput"][$conf["arrayCountEqualCheck"][$i][0]]);#設置錯誤訊息$result["error"][]=array("key為".$conf["arrayCountEqualCheck"][$i][$j]."的參數",$conf["varInput"][$conf["arrayCountEqualCheck"][$i][$j]]);#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end}#for end}#for end}#if end#初始化儲存所有參數名稱的陣列$arguArray=array();#如果有要必填的參數名稱if(isset($conf["mustBeFilledVariableName"])){#記錄必填的參數$arguArray=$conf["mustBeFilledVariableName"];}#if end#若有可省略的參數if(isset($conf["skipableVariableName"])){#有幾個可省略參數就執行幾次for($i=0;$i<count($conf["skipableVariableName"]);$i++){#記錄參數$arguArray[]=$conf["skipableVariableName"][$i];}#for end}#if end#如果有可省略變數的any形態變數設定if(isset($anyTypeVarName)){#針對每個可省略的any形態變數foreach($anyTypeVarName as $varName){#記錄參數$arguArray[]=$varName;}#foreach end}#if end#初始化儲存已經輸入的參數名稱陣列$inputVarArray=array();#移除不要的參考陣列unset($conf["varInput"][$conf["referenceVarKey"]]);#有幾個輸入的參數就執行幾次foreach($conf["varInput"] as $key=>$value ){#儲存參數的名稱$inputVarArray[]=$key;}#foreach end#有幾個輸入的參數就執行幾次for($i=0;$i<count($inputVarArray);$i++){#初始化是否有找到對應的必填或可省參數$matched="false";#檢查該輸入的參數是否應該存在for($j=0;$j<count($arguArray);$j++){#如果該輸入的參數屬於應該要有的參數if($inputVarArray[$i]==$arguArray[$j]){#設置有找到對應的必填或可省參數$matched="true";}#if end}#for end#如果對照了所有必填與可省略參數都沒有找到一樣的參數名稱if($matched=="false"){#記錄目前輸入的參數名稱陣列$result["argu"]=$inputVarArray;#記錄合法可用的參數名稱陣列.$result["legalVarName"]=$arguArray;#記錄不應該存在的參數名稱$result["notNeedVar"][]=$inputVarArray[$i];}#if end}#for end#如果有不應該存在的參數名稱if(isset($result["notNeedVar"])){#設置錯誤識別$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置錯誤訊息$result["error"]="發現「".count($result["notNeedVar"])."」個多餘的參數";#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#初始化儲存沒有符合規定的參數訊息$result["shouldNotBeEmpty"]=array();#如果有設定 $conf["skipableVariableCanNotBeEmpty"]if(isset($conf["skipableVariableCanNotBeEmpty"])){#針對每個不能為空值跟空集合的變數名稱foreach($conf["skipableVariableCanNotBeEmpty"] as $varName){#如果可省略變數 $varName 存在if(isset($conf["varInput"][$varName])){#如果其為 空字串 或 空陣列if($conf["varInput"][$varName]==""){#記錄沒有符合規定的參數訊息$result["shouldNotBeEmpty"][]="參數「".$varName."」不得為空字串";}#if end#反之如果為陣列else if(gettype($conf["varInput"][$varName])==="array"){#如果為空陣列if(count($conf["varInput"][$varName])===0){#記錄沒有符合規定的參數訊息$result["shouldNotBeEmpty"][]="參數「".$varName."」不得為空集合";}#if end}#else end}#if end}#foreach end#如果 $result["shouldNotBeEmpty"] 存在元素if(count($result["shouldNotBeEmpty"])>0){#設置錯誤識別$result["status"]="true";#設置檢查不通過$result["passed"]="false";#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end}#if end#如果有設定可省略參數且不允許所有可省略變數都不存在if( isset($conf["skipableVariableName"]) && ($conf["disallowAllSkipableVarNotExist"]==="true") ){#函式說明:#檢查多個字串中的每個字串是否有多個關鍵字#回傳結果:#$result["status"],整體來說,執行是否成功,"true"代表執行成功,"false"代表執行失敗。#$result["function"],當前執行的函數名稱.#$result["error"],錯誤訊息.#$result["argu"],使用的參數.#$result["foundedTrueKey"],結果為"true"的被搜尋元素key陣列,與其數值內容.#$result["foundedKeyWords"],找到的關鍵字陣列.#$result["foundedFalseKey"],結果為"false"的被搜尋元素key陣列,與其數值內容.#$result["foundedTrueKeyWords"],二維陣列,各個字串有找到的關鍵字陣列.#$result["foundedAll"],是否每個關鍵字都有找到,"true"代表每個都有找到,"false"代表沒有每個都找到.#必填參數:#$conf["keyWords"],字串陣列,想要搜尋的關鍵字.$conf["search::findManyKeyWordsFromManyString"]["keyWords"]=$conf["skipableVariableName"];#$conf["stringArray"],字串陣列,要被搜尋的字串內容陣列.$conf["search::findManyKeyWordsFromManyString"]["stringArray"]=array_keys($conf["varInput"]);#可省略參數:#$conf["completeEqual"],字串,是否內容要完全符合,不能多出任何不符合的內容,預設為"false"不需要完全符合.#$conf["completeEqual"]="true";#參考資料:#無.#備註:#無.$findManyKeyWordsFromManyString=search::findManyKeyWordsFromManyString($conf["search::findManyKeyWordsFromManyString"]);unset($conf["search::findManyKeyWordsFromManyString"]);#如果執行失敗if($findManyKeyWordsFromManyString["status"]==="false"){#設置錯誤識別$result["status"]="false";#設置檢查不通過$result["passed"]="false";#設置執行錯誤訊息$result["error"]=$findManyKeyWordsFromManyString;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end#如果沒有找到至少一個可省略參數存在if(count($findManyKeyWordsFromManyString["foundedTrueKey"])===0){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置執行錯誤訊息$result["error"]=$findManyKeyWordsFromManyString;#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:$conf["variableCheck::getSimpleError"]=array();#$conf["error"],陣列,要處理的變數.$conf["variableCheck::getSimpleError"]["error"]=$result;#可省略參數:#無#參考資料:#無.#備註:#無.$getSimpleError=variableCheck::getSimpleError($conf["variableCheck::getSimpleError"]);unset($conf["variableCheck::getSimpleError"]);#如果執行失敗if($getSimpleError["status"]==="false"){#設置執行錯誤訊息$result["error"][]=$getSimpleError;#回傳結果return $result;}#if end#設置 $simpleError$result["simpleError"]=$getSimpleError["content"];#回傳結果return $result;}#if end}#if end#設置執行正常$result["status"]="true";#設置錯誤識別$result["passed"]="true";#回傳結果return $result;}#function checkArguments end/*#函式說明:#檢查一陣列變數是否為空陣列#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果陣列.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#$result["empty"],"true"代表為空陣列,"false"代表不為空陣列.#必填參數:#$conf["var"],陣列變數.$conf["var"]=;#可省略參數:#無.#參考資料:#無.#備註:#無.*/public static function emptyArray(&$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變數須為陣列形態";#如果傳入的參數為 nullif($conf===null){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#回傳結果return $result;}#if end#檢查參數#函式說明:#檢查陣列裡面的特定元素是否存在以及其變數型態是否正確,如果沒有設定則回傳提示訊息。#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result["warning"],警告訊息#$result["content"][$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result["content"][$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result["content"][$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息#必填參數:$conf["variableCheck::isexistMulti"]["varInput"]=$conf;#要檢查的陣列變數$conf["variableCheck::isexistMulti"]["variableCheck"]=array("var");#要檢查的變數名稱陣列,形態爲陣列變數,例如: $conf["variableCheck"] = array("id","account","password");#可省略參數:$conf["variableCheck::isexistMulti"]["variableType"]=array("array");#要檢查的陣列變數內的元素應該爲何種變數形態,形態爲陣列 例如: $conf[variableType] = array("string","int","double"); ,null代表沒有指定變數形態.#$conf["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話,請設為"false",預設為也算是有設置.#$conf["cnaBeEmpty"],陣列,可以為空字串或集合的變數,僅當$conf["canBeEmptyString"]為"false"時生效.#$conf["cnaBeEmpty"]=array();#$conf["cnaNotBeEmpty"],陣列,不可以為空字串或集合的變數,僅當$conf["canBeEmptyString"]為"true"時生效.#$conf["cnaNotBeEmpty"]=array();$isexistMulti=variableCheck::isexistMulti($conf["variableCheck::isexistMulti"]);unset($conf["variableCheck::isexistMulti"]);#如果檢查變數失敗if($isexistMulti["status"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$isexistMulti;#回傳結果return $result;}#if end#如果檢查變數不通過if($isexistMulti["passed"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$isexistMulti;#回傳結果return $result;}#if end#如果裡面有內容if(count($conf["var"])!==0){#針對每個內容foreach($conf["var"] as $var){#如果內容不是陣列if(gettype($var)!=="array"){#設置執行失敗$result["status"]="true";#設置不為空陣列$result["empty"]="false";#回傳結果return $result;}#if end#反之是陣列else{#呼叫自己$conf["variableCheck::emptyArray"]["var"]=$var;$emptyArray=variableCheck::emptyArray($conf["variableCheck::emptyArray"]);unset($conf["variableCheck::emptyArray"]);#如果執行失敗if($emptyArray["status"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$emptyArray;#回傳結果return $result;}#if end#如果不是空陣列if($emptyArray["empty"]==="false"){#設置執行失敗$result["status"]="true";#設置不為空陣列$result["empty"]="false";#回傳結果return $result;}#if end}#else end}#foreach end#設置執行正常$result["status"]="true";#設置為空陣列$result["empty"]="true";#回傳結果return $result;}#if end#反之為空陣列else{#設置執行正常$result["status"]="true";#設置為空陣列$result["empty"]="true";#回傳結果return $result;}#else end}#function emptyArray end/*#函式說明:#回傳變數的解析結果.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],變數的解析結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:#$conf["var"],any,任意內容,通常為變數.$conf["var"]=;#可省略參數:#無.#參考資料:#無.#備註:#無.*/public static function toSource(&$conf){#初始化要回傳的內容$result=array();#取得當前執行的函數名稱$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif($conf==null){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#回傳結果return $result;}#if end#檢查參數#函式說明:#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容。#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$reuslt["error"],執行不正常結束的錯訊息陣列.#$result["function"],當前執行的函式名稱.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息#必填寫的參數:#$conf["variableCheck.checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。$conf["variableCheck.checkArguments"]["varInput"]=&$conf;#$conf["variableCheck.checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列,形態爲陣列變數,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");$conf["variableCheck.checkArguments"]["mustBeFilledVariableName"]=array("var");#$conf["variableCheck.checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");$conf["variableCheck.checkArguments"]["mustBeFilledVariableType"]=array(null);#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.$conf["variableCheck.checkArguments"]["referenceVarKey"]="variableCheck.checkArguments";#可以省略的參數:#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"false"。#$conf["canBeEmptyString"]="false";#$conf["variableCheck.checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");#$conf["variableCheck.checkArguments"]["skipableVariableName"]=array("varPassed");#$conf["variableCheck.checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableType"] = array("string",integer,"double");#$conf["variableCheck.checkArguments"]["skipableVariableType"]=array(null);#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定,若預設值是必填參數之一,請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".#$conf["variableCheck.checkArguments"]["skipableVarDefaultValue"]=array(null);$checkArguments=variableCheck::checkArguments($conf["variableCheck.checkArguments"]);unset($conf["variableCheck.checkArguments"]);#如果 檢查參數 失敗if($checkArguments["status"]==="false"){#設置執行不正常$result["status"]="false";#設置執行錯誤$result["error"]=$checkArguments;#回傳節果return $result;}#if end#如果 檢查參數 不通過if($checkArguments["passed"]==="false"){#設置執行不正常$result["status"]="false";#設置執行錯誤$result["error"]=$checkArguments;#回傳節果return $result;}#if end#函式說明:#記錄程式輸出的結果.#回傳結果:#$result["status"],爲查詢是否成功,若爲"true"則成功,若爲"false"則表示失敗了.#$result["error"],錯誤訊息.#$result["content"],程式的輸出.#$result["function"],當前執行的涵式#必填參數:#$conf["code2run"],字串陣列,爲要運行的程式內容,每個元素代表一段php程式.內容不必含有php tag,但結尾必須為「;」.$conf["record::getOutput"]["code2run"]=array("var_dump(\$varPassed[0]);");#可省略參數:#可省略參數:#$conf["varPassed"],陣列,為要使用到的變數,在code2run參數裡面"\$varPassed[n]"代表第n+1個變數.$conf["record::getOutput"]["varPassed"]=array($conf["var"]);#參考資料:#無.#備註:#無.$getOutput=record::getOutput($conf["record::getOutput"]);unset($conf["record::getOutput"]);#如果執行失敗if($getOutput["status"]==="false"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$getOutput;#回傳結果return $result;}#if end#取得輸出$result["content"]=$getOutput["content"];#設置執行正常$result["status"]="true";#回傳結果return $result;}#functino toSource end/*#函式說明:#隱藏元素中可能含有機密的內容.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],隱藏內容後的結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:#$conf["params"],陣列,要處理的變數.$conf["params"]=;#可省略參數:#$conf["keyWords"],字串陣列,針對params中每一個的key,若擁有該陣列中任一元素的數值(關鍵字),則要將其內容隱藏,預設為array("password","key","secret").#$conf["keyWords"]=array("password","key","secret","Secret");#$conf["changeTo"],字串,將要隱藏的參數內容置換為什麼字串內容,預設為"[classified content]".#$conf["changeTo"]="[classified content]";#參考資料:#無.#備註:#目前不支援物件.*/public static function hideParams(&$conf){#取得當前執行的函式$result["function"]=__FUNCTION__;#取得使用的參數$result["argu"]=$conf;#函式說明:#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容.#回傳結果:#$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"]=&$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("params");#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");#$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("hideSecret");#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("keyWords","changedTo");#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableType"] = array("string",integer,"double");$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","string");#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一,請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(array("password","key","secret","Secret"),"[classified content]");#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".#$conf["disallowAllSkipableVarIsEmpty"]="";#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".#$conf["disallowAllSkipableVarIsEmptyArray"]="";#$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 $reuslt;}#if end#若檢查不通過if($checkArguments["passed"]==="false"){#設置執行失敗$result["status"]="false";#設置錯誤訊息$result["error"]=$checkArguments;#回傳內容return $result;}#if end#初始化待處理的陣列變數$unprocessedArray=array(&$conf["params"]);#針對陣列中每個元素while(isset($unprocessedArray[0])){/*#debugecho "<p>";var_dump($unprocessedArray);*/#取得當前元素$element=&$unprocessedArray[0];/*#debugecho "<br>";var_dump(gettype($element));*/#如果元素為陣列if(gettype($element)==="array"){#針對每個變數foreach($element as $arrayKey=>$arrayVal){/*#debugecho "<p>";echo "foreach in \$element, key=".$arrayKey."<br>";echo "content of \$element:".print_r($element,true);#debugecho "<p>";echo "check key:".$arrayKey;*/#函式說明:#檢查一個字串裡面是否有多個關鍵字#回傳結果:#$result["status"],"true"代表執行成功,"false"代表執行失敗.#$result["error"],錯誤訊息.#$result["function"],當前執行的函數名稱.#$result["founded"],是否有找到的關鍵字,"true"代表有找到關鍵字;"false"代表沒有找到關鍵字.#$result["foundedKeyWords"],找到的關鍵字.#$result["foundedAll"],是否有找到全部的關鍵字,"true"代表有;"false"代表沒有.#$result["argu"],使用的參數.#必填參數:#$conf["keyWords"],字串陣列,想要搜尋的關鍵字.$conf["search::findManyKeyWords"]["keyWords"]=$conf["keyWords"];#$conf["string"],字串,要被搜尋的字串內容.$conf["search::findManyKeyWords"]["string"]=$arrayKey;#可省略參數:#$conf["completeEqual"],字串,是否內容要完全符合,不能多出任何不符合的內容,預設為不需要完全符合.#$conf["completeEqual"]="true";#參考資料:#無.#備註:#無.$findManyKeyWords=search::findManyKeyWords($conf["search::findManyKeyWords"]);unset($conf["search::findManyKeyWords"]);/*#debugecho "<p>";echo "content of \$findManyKeyWords:<br>";var_dump($findManyKeyWords);*/#若執行失敗if($findManyKeyWords["status"]==="false"){#設置執行失敗$result["status"]="false";#設置錯誤訊息$result["error"]=$findManyKeyWords;#回傳內容return $reuslt;}#if end#若有符合的關鍵字if($findManyKeyWords["founded"]==="true"){/*#deubgecho "<p>";echo "置換 key 為 ".$arrayKey." 者的內容為 ".$conf["changedTo"];*/#替換其內容$element[$arrayKey]=$conf["changedTo"];/*#debugecho "<p>";echo "替換其內容後 為 ".print_r($element,true);*/#針對下個元素continue;}#if end#如果數值為陣列if(gettype($arrayVal)==="array"){/*#deubgecho "<p>";echo "新增待處理的陣列 其 key 為 ".$arrayKey;*/#儲存到待處理的陣列中$unprocessedArray[]=&$element[$arrayKey];/*#debugecho "<p>";echo "新增待處理的陣列後 其 內容 為 ".print_r($unprocessedArray,true);*/}#if end}#foreach end}#if end/*#debugecho "<br>";echo "before array_shift, count of \$unprocessedArray:".count($unprocessedArray);echo "<br>";var_dump($unprocessedArray);*/#將第一個元素移除array_shift($unprocessedArray);/*#debugecho "<br>";echo "after array_shift, count of \$unprocessedArray:".count($unprocessedArray);echo "<br>";var_dump($unprocessedArray);echo "<hr>";*/}#while end#設置回傳內容$result["content"]=$conf["params"];#設置執行正常$result["status"]="true";#回傳結果return $result;}#function hideParams end/*#函式說明:#取得簡單的錯誤訊息#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["content"],結果.#$result["function"],當前執行的函數#$result["error"],涵式錯誤訊息陣列#必填參數:#$conf["error"],陣列,要處理的變數.$conf["error"]=array();#可省略參數:#無#參考資料:#無.#備註:#無.*/public static function getSimpleError(&$conf){#var_dump($conf);#初始化要回傳的結果$result=array();#取得當前執行的函數名稱$result["function"]=__FUNCTION__;#如果沒有參數if(func_num_args()==0){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]="函數".$result["function"]."需要參數";#無窮迴圈while(true){#遞迴執行$conf["self::getSimpleError"]["error"]=$result;$simpleError=self::getSimpleError($conf["self::getSimpleError"]);unset($conf["self::getSimpleError"]);#如果執行失敗if($simpleError["status"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$simpleError;#下一輪continue;}#if end#結束 whilebreak;}#while endreturn $result;}#if end#取得參數$result["argu"]=$conf;#如果 $conf 不為陣列if(gettype($conf)!=="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif(is_null($conf)){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#無窮迴圈while(true){#遞迴執行$conf["self::getSimpleError"]["error"]=$result;$simpleError=self::getSimpleError($conf["self::getSimpleError"]);unset($conf["self::getSimpleError"]);#如果執行失敗if($simpleError["status"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$simpleError;#下一輪continue;}#if end#結束 whilebreak;}#while end#回傳結果return $result;}#if end#函式說明:#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容.#回傳結果:#$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"]=&$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("error");#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"true",可以為空字串.$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.#$conf["variableCheck::checkArguments"]["canNotBeEmpty"]=array("gw_primary_ids");#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.#$conf["canBeEmpty"]=array();#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.#$conf["skipableVariableCanNotBeEmpty"]=array();#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");#$conf["skipableVariableName"]=array();#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableType"] = array("string",integer,"double");#$conf["skipableVariableType"]=array();#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一,請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".#$conf["skipableVarDefaultValue"]=array("");#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".#$conf["disallowAllSkipableVarIsEmpty"]="";#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".#$conf["disallowAllSkipableVarIsEmptyArray"]="";#$conf["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;#無窮迴圈while(true){#遞迴執行$conf["self::getSimpleError"]["error"]=$result;$simpleError=self::getSimpleError($conf["self::getSimpleError"]);unset($conf["self::getSimpleError"]);#如果執行失敗if($simpleError["status"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$simpleError;#下一輪continue;}#if end#如果檢查不通過if($simpleError["passed"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$simpleError;#下一輪continue;}#if end#結束 whilebreak;}#while end#取得 simpleError$result["simpleError"]=$simpleError["content"];#回傳結果return $result;}#if end#如果執行失敗if($checkArguments["passed"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$checkArguments;#無窮迴圈while(true){#遞迴執行$conf["self::getSimpleError"]["error"]=$result;$simpleError=self::getSimpleError($conf["self::getSimpleError"]);unset($conf["self::getSimpleError"]);#如果執行失敗if($simpleError["status"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$simpleError;#下一輪continue;}#if end#如果檢查不通過if($simpleError["passed"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$simpleError;#下一輪continue;}#if end#結束 whilebreak;}#while end#取得 simpleError$result["simpleError"]=$simpleError["content"];#回傳結果return $result;}#if end#var_dump($result);#初始化簡單的錯誤$result["content"]=&$conf["error"];#如果底下有 error 元素while(isset($result["content"]["error"])){#var_dump($result["content"]["error"]);#取得其位置$result["content"]=&$result["content"]["error"];}#while end#初始化新的結果$newContentStr="";#如果 content 不是字串if(gettype($result["content"])!=="string"){#var_dump($result["content"]);#針對每個錯誤訊息foreach($result["content"] as $errorLine){#如果不是字串if(gettype($errorLine)!=="string"){#將陣列轉換成字串$errorLine=print_r($errorLine,true);}#if end#串接結果$newContentStr=$newContentStr.$errorLine.PHP_EOL;}#foreache end}#if end#設置結果內容$result["content"]=$newContentStr;#設置執行正常$result["status"]=true;#回傳結果return $result;}#function getSimpleError end/*#函式說明:#檢查字串是否符合指定格式#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["passed"],檢查是否通過,"true"代表通過,"false"代表不通過.#$result["content"],詳細結果訊息陣列,若passed為"false"則會有該內容.#$result["newInputArgu"],剩下尚未檢驗格式的input.#$result["function"],當前執行的函數.#$result["error"],涵式錯誤訊息陣列.#必填參數:#$conf["input"],字串,要檢查格式的字串.$conf["input"]="";#可省略參數:#$conf["equalWith"],字串,輸入字串是否等於該參數內容.#$conf["equalWith"]="";#$conf["startWith"],字串,開頭要是什麼字串內容.#$conf["startWith"]="";#$conf["endWith"],字串,結尾要是什麼字串內容.#$conf["endWith"]="";#$conf["centerWith"],字串,非開頭(預設無,若有指定startWith參數,則為該參數內容)跟結尾(預設無,若有指定endWith參數,則為該參數內容)的內容中要有什麼字串.#$conf["centerWith"]="";#$conf["length"],字串整數,字串的長度要多少(bytes).#$conf["length"]="";#$conf["lengthGrapheme"],字串整數,字串的長度要多少字位(grapheme).#$conf["lengthGrapheme"]="";#$conf["section"],字串陣列,元素數量代表,輸入字串的格式可以區分成多少段.每個元素為本函式的參數陣列剔除input跟section參數.#$conf["section"]=array();#參考資料:#grapheme_strlen=>https://www.php.net/manual/en/function.grapheme-strlen.php#grapheme/字位/可以書寫的最小單位=>https://zh.wikipedia.org/zh-tw/%E5%AD%97%E4%BD%8D#grapheme_substr=>https://www.php.net/manual/en/function.grapheme-substr.php#備註:#無.*/public static function checkStringFormat(&$conf){#初始化要回傳的內容$result=array();#取得當前執行的函數名稱$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif($conf==null){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#回傳結果return $result;}#if end#取得參數$result["argu"]=$conf;#函式說明:#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],執行不正常結束的錯訊息陣列.#$result["simpleError"],簡單表示的錯誤訊息.#$result["function"],當前執行的函式名稱.#$result["argu"],設置給予的參數.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.#$result["argu"],字串陣列,目前輸入的參數名稱陣列.#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.#$result["notNeedVar"],字串陣列,多餘的參數名稱.#必填參數:#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。$conf["variableCheck::checkArguments"]["varInput"]=&$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");#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"true",可以為空字串.#$conf["variadble::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("equalWith","startWith","centerWith","endWith","length","lengthGrapheme","section");#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("equalWith","startWith","centerWith","endWith","length","lengthGrapheme","section");#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableType"] = array("string",integer,"double");$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","string","string","string","array");#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一,請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".#$conf["skipableVarDefaultValue"]=array("");#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".#$conf["disallowAllSkipableVarIsEmpty"]="";#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".#$conf["disallowAllSkipableVarIsEmptyArray"]="";#$conf["disallowAllSkipableVarNotExist"],字串,是否不允許每個可省略參數都不存在,預設為"false"代表允許,反之為"true".$conf["variableCheck::checkArguments"]["disallowAllSkipableVarNotExist"]="true";#$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#預設剩下未檢查格式的input為空字串$result["newInputArgu"]="";#如果存在分段的格式設定if(isset($conf["section"])){#預設都是尚未檢驗的字串$newInputArgu=$conf["input"];#針對每段foreach($conf["section"] as $index => $sec){#更新input參數$sec["input"]=$newInputArgu;#處理該section#函式說明:#檢查字串是否符合指定格式#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["passed"],檢查是否通過,"true"代表通過,"false"代表不通過.#$result["content"],詳細結果訊息陣列,若passed為"false"則會有該內容.#$result["newInputArgu"],剩下尚未檢驗格式的input.#$result["function"],當前執行的函數.#$result["error"],涵式錯誤訊息陣列.#必填參數:#$conf["input"],字串,要檢查格式的字串.#$conf["variableCheck::checkStringFormat"]["input"]=$newInputArgu;#可省略參數:#$conf["equalWith"],字串,輸入字串是否等於該參數內容.#$conf["equalWith"]="";#$conf["startWith"],字串,開頭要是什麼字串內容.#$conf["startWith"]="";#$conf["endWith"],字串,結尾要是什麼字串內容.#$conf["endWith"]="";#$conf["centerWith"],字串,非開頭(預設無,若有指定startWith參數,則為該參數內容)跟結尾(預設無,若有指定endWith參數,則為該參數內容)的內容中要有什麼字串.#$conf["centerWith"]="";#$conf["length"],字串整數,字串的長度要多少(bytes).#$conf["length"]="";#$conf["lengthGrapheme"],字串整數,字串的長度要多少字位(grapheme).#$conf["lengthGrapheme"]="";#$conf["variableCheck::checkStringFormat"]["section"]=$nextSectionArgu;#參考資料:#grapheme_strlen=>https://www.php.net/manual/en/function.grapheme-strlen.php#grapheme/字位/可以書寫的最小單位=>https://zh.wikipedia.org/zh-tw/%E5%AD%97%E4%BD%8D#備註:#無.$conf["variableCheck::checkStringFormat"]=$sec;$checkStringFormat=variableCheck::checkStringFormat($conf["variableCheck::checkStringFormat"]);unset($conf["variableCheck::checkStringFormat"]);#如果執行失敗if($checkStringFormat["status"]=="false"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$checkStringFormat;#回傳結果return $result;}#if end#如果不通過if($checkStringFormat["passed"]=="false"){#回傳結果return $checkStringFormat;}#if end#取得新的input參數$newInputArgu=$checkStringFormat["newInputArgu"];}#foreach end}#if end#到這邊代表不存在分段的格式設定#初始化關鍵字$keywords=array();#如果有 startWithif(isset($conf["startWith"])){#設置關鍵字$keywords[]=$conf["startWith"];}#if end#如果有 centerWithif(isset($conf["centerWith"])){#設置關鍵字$keywords[]=$conf["centerWith"];}#if end#如果有 endWithif(isset($conf["endWith"])){#設置關鍵字$keywords[]=$conf["endWith"];}#if end#如果存在關鍵字if(!empty($keywords)){#若有指定bytes長度if(isset($conf["length"])){#取得輸入的字串長度$length=strlen($conf["input"]);#如果長度不足if($length<(int)$conf["length"]){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置詳細結果訊息陣列.$result["content"][]="input參數(".$conf["input"].")的bytes長度(".$length.")小於length參數(".$conf["length"].")";#回傳結果return $result;}#if end#函式說明:#unicode的字串分割,比str_split的支援度高.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函數名稱.#$result["content"],分割好的內容陣列.#$result["length"],unicode字串的長度.#必填參數:#$conf["str"],字串",要分割的字串.$conf["stringProcess::str_split_unicode"]["str"]=$conf["input"];#可省略參數:#$conf["length"],整數,分割的長度.#$conf["stringProcess::str_split_unicode"]["length"]=(int)$conf["length"];#參考資料:#http://php.net/manual/en/function.str-split.php#備註:#無.$str_split_unicode=stringProcess::str_split_unicode($conf["stringProcess::str_split_unicode"]);unset($conf["stringProcess::str_split_unicode"]);#如果執行失敗if($str_split_unicode["status"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$str_split_unicode;#回傳結果return $result;}#if end#初始化給search::findKeyWordsPosition的input參數$newInputArguForFindKeyWordsPosition="";#初始化給variableCheck::checkStringFormat的input參數$newInputArgu="";#針對剩下的每個bytesforeach($str_split_unicode["content"] as $index=>$splitedStr){#屬於findKeyWordsPosition的input參數if($index<(int)$conf["length"]){#串接新的input參數bytes$newInputArguForFindKeyWordsPosition=$newInputArguForFindKeyWordsPosition.$splitedStr;}#if end#反之else{#串接新的input參數bytes$newInputArgu=$newInputArgu.$splitedStr;}#else end}#foreach end}#if end#反之不存在指定bytes長度#但有指定字位長度else if(isset($conf["lengthGrapheme"])){#取得輸入的字位長度$grapheme_strlen=grapheme_strlen($conf["input"]);#如果長度不足if($grapheme_strlen>(int)$conf["lengthGrapheme"]){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置詳細結果訊息陣列.$result["content"][]="input參數(".$conf["input"].")的字位長度(".$grapheme_strlen.")小於lengthGrapheme參數(".$conf["lengthGrapheme"].")";#回傳結果return $result;}#if end#初始化給search::findKeyWordsPosition的input參數$arguForFindKeyWordsPosition=grapheme_substr($conf["input"],0,$conf["lengthGrapheme"]);#初始化給variableCheck::checkStringFormat的input參數$newInputArgu=grapheme_substr($conf["input"],$conf["lengthGrapheme"]);}#if end#函式說明:#取得關鍵字在字串的哪個位置(字首,字尾,中間)#回傳結果:#$result["status"],執行成功與否,若爲"true",代表執行成功,若爲"false"代表執失敗。#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函數名稱.#$result["found"],是否有關鍵字存在,若為"true",代表存在;反之為"false".#$result["argu"],傳入的參數.#$result["head"][i],第i個關鍵字是否在字串的開頭,"true"代表是,"false"代表不是.#$result["tail"][i],第i個關鍵字是否在字串的尾端,"true"代表是,"false"代表不是.#$result["center"][i],第i個關鍵字是否在字串的中間,"true"代表是,"false"代表不是.#$result["indexS"][i],第i個關鍵字在被搜尋字串的哪個位置開始.#$result["indexE"][i],第i個關鍵字在被搜尋字串的哪個位置結束.#必填參數:#如果存在 newInputArguForFindKeyWordsPosition,就用之.if(isset($newInputArguForFindKeyWordsPosition)){#$conf["inputStr"],字串,被搜尋的字串.$conf["search::findKeyWordsPosition"]["inputStr"]=$newInputArguForFindKeyWordsPosition;}#if end#反之用原始輸入字串else{#$conf["inputStr"],字串,被搜尋的字串.$conf["search::findKeyWordsPosition"]["inputStr"]=$conf["input"];}#else end#$conf["keyWords"],字串陣列,要搜尋的多個關鍵字$conf["search::findKeyWordsPosition"]["keyWords"]=$keywords;#可省略參數:#無.#參考資料:#http://php.net/manual/en/function.strpos.php#備註:#無.$findKeyWordsPosition=search::findKeyWordsPosition($conf["search::findKeyWordsPosition"]);unset($conf["search::findKeyWordsPosition"]);#如果執行失敗if($findKeyWordsPosition["status"]==="false"){#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"]=$findKeyWordsPosition;#回傳結果return $result;}#if end#如果三個參數 startWith、centerWith、endWith 都在if( isset($conf["startWith"]) && isset($conf["centerWith"]) && isset($conf["endWith"]) ){#如果其中一個關鍵字沒找到if( $findKeyWordsPosition["head"][0]!=="true" || $findKeyWordsPosition["center"][1]!=="true" || $findKeyWordsPosition["tail"][2]!=="true" ){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置簡易資訊$result["content"][]="input參數(".$conf["input"].")不完全符合startWith參數(".$conf["startWith"].")、centerWith參數(".$conf["centerWith"].")、endWith參數(".$conf["endWith"].")的條件";#設置詳細資訊$result["content"][]=$findKeyWordsPosition;#回傳結果return $result;}#if end#設置新的input參數$result["newInputArgu"]="";}#if end#反之只有 startWith、centerWith 兩個參數else if( isset($conf["startWith"]) && isset($conf["centerWith"]) ){#如果其中一個關鍵字沒找到if( $findKeyWordsPosition["head"][0]!=="true" || $findKeyWordsPosition["center"][1]!=="true" ){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置簡易資訊$result["content"][]="input參數(".$conf["input"].")不完全符合startWith參數(".$conf["startWith"].")、centerWith參數(".$conf["centerWith"].")的條件";#設置詳細資訊$result["content"][]=$findKeyWordsPosition;#回傳結果return $result;}#if end#函式說明:#unicode的字串分割,比str_split的支援度高.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函數名稱.#$result["content"],分割好的內容陣列.#$result["length"],unicode字串的長度.#必填參數:#$conf["str"],字串",要分割的字串.$conf["stringProcess::str_split_unicode"]["str"]=$conf["input"];#可省略參數:#$conf["length"],整數,分割的長度.$conf["stringProcess::str_split_unicode"]["length"]=$findKeyWordsPosition["indexE"][1];#參考資料:#http://php.net/manual/en/function.str-split.php#備註:#無.$str_split_unicode=stringProcess::str_split_unicode($conf["stringProcess::str_split_unicode"]);unset($conf["stringProcess::str_split_unicode"]);#如果執行失敗if($str_split_unicode["status"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$str_split_unicode;#回傳結果return $result;}#if end#針對剩下的每個bytesforeach($str_split_unicode["content"] as $splitedStr){#串接新的input參數bytes$result["newInputArgu"]=$result["newInputArgu"].$splitedStr;}#foreach end}#if end#反之只有 startWith、endWith 兩個參數else if( isset($conf["startWith"]) && isset($conf["endWith"]) ){#如果其中一個關鍵字沒找到if( $findKeyWordsPosition["head"][0]!=="true" || $findKeyWordsPosition["tail"][1]!=="true" ){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置簡易資訊$result["content"][]="input參數(".$conf["input"].")不完全符合startWith參數(".$conf["startWith"].")、endWith參數(".$conf["endWith"].")的條件";#設置詳細資訊$result["content"][]=$findKeyWordsPosition;#回傳結果return $result;}#if end#設置新的input參數$result["newInputArgu"]="";}#if end#反之只有 centerWith、endWith 兩個參數else if( isset($conf["centerWith"]) && isset($conf["endWith"]) ){#如果其中一個關鍵字沒找到if( $findKeyWordsPosition["center"][0]!=="true" || $findKeyWordsPosition["tail"][1]!=="true" ){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置簡易資訊$result["content"][]="input參數(".$conf["input"].")不完全符合centerWith參數(".$conf["centerWith"].")、endWith參數(".$conf["endWith"].")的條件";#設置詳細資訊$result["content"][]=$findKeyWordsPosition;#回傳結果return $result;}#if end#設置新的input參數$result["newInputArgu"]="";}#if end#反之只有 startWith 參數else if(isset($conf["startWith"])){#如果其中一個關鍵字沒找到if( $findKeyWordsPosition["head"][0]!=="true" ){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置簡易資訊$result["content"][]="input參數(".$conf["input"].")不符合startWith參數(".$conf["startWith"].")的條件";#設置詳細資訊$result["content"][]=$findKeyWordsPosition;#回傳結果return $result;}#if end#函式說明:#unicode的字串分割,比str_split的支援度高.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函數名稱.#$result["content"],分割好的內容陣列.#$result["length"],unicode字串的長度.#必填參數:#$conf["str"],字串",要分割的字串.$conf["stringProcess::str_split_unicode"]["str"]=$conf["input"];#可省略參數:#$conf["length"],整數,分割的長度.$conf["stringProcess::str_split_unicode"]["length"]=$findKeyWordsPosition["indexE"][0];#參考資料:#http://php.net/manual/en/function.str-split.php#備註:#無.$str_split_unicode=stringProcess::str_split_unicode($conf["stringProcess::str_split_unicode"]);unset($conf["stringProcess::str_split_unicode"]);#如果執行失敗if($str_split_unicode["status"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$str_split_unicode;#回傳結果return $result;}#if end#針對剩下的每個bytesforeach($str_split_unicode["content"] as $splitedStr){#串接新的input參數bytes$result["newInputArgu"]=$result["newInputArgu"].$splitedStr;}#foreach end}#if end#反之只有 centerWith 參數else if(isset($conf["centerWith"])){#如果其中一個關鍵字沒找到if( $findKeyWordsPosition["center"][0]!=="true" ){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置簡易資訊$result["content"][]="input參數(".$conf["input"].")不符合centertWith參數(".$conf["centertWith"].")的條件";#設置詳細資訊$result["content"][]=$findKeyWordsPosition;#回傳結果return $result;}#if end#函式說明:#unicode的字串分割,比str_split的支援度高.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函數名稱.#$result["content"],分割好的內容陣列.#$result["length"],unicode字串的長度.#必填參數:#$conf["str"],字串",要分割的字串.$conf["stringProcess::str_split_unicode"]["str"]=$conf["input"];#可省略參數:#$conf["length"],整數,分割的長度.$conf["stringProcess::str_split_unicode"]["length"]=$findKeyWordsPosition["indexE"][0];#參考資料:#http://php.net/manual/en/function.str-split.php#備註:#無.$str_split_unicode=stringProcess::str_split_unicode($conf["stringProcess::str_split_unicode"]);unset($conf["stringProcess::str_split_unicode"]);#如果執行失敗if($str_split_unicode["status"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$str_split_unicode;#回傳結果return $result;}#if end#針對剩下的每個bytesforeach($str_split_unicode["content"] as $splitedStr){#串接新的input參數bytes$result["newInputArgu"]=$result["newInputArgu"].$splitedStr;}#foreach end}#if end#反之只有 endWith 參數else if(isset($conf["endWith"])){#如果其中一個關鍵字沒找到if( $findKeyWordsPosition["tail"][0]!=="true" ){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置簡易資訊$result["content"][]="input參數(".$conf["input"].")不符合endWith參數(".$conf["endWith"].")的條件";#設置詳細資訊$result["content"][]=$findKeyWordsPosition;#回傳結果return $result;}#if end#設置新的input參數$result["newInputArgu"]="";}#if end#反之不可能發生的地方else{#設置錯誤識別$result["status"]="false";#設置錯誤訊息$result["error"][]="非預期的錯誤";#設置錯誤訊息$result["error"][]=$findKeyWordsPosition;#回傳結果return $result;}#else end#如果存在if(isset($newInputArgu)){#更新之$result["newInputArgu"]=$newInputArgu;}#if end}#if end#反之,沒有關鍵字else{#若有指定bytes長度if(isset($conf["length"])){#取得輸入的字位長度$length=length($conf["input"]);#如果不相等if($length!==(int)$conf["length"]){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置詳細結果訊息陣列.$result["content"][]="input參數(".$conf["input"].")的bytes長度(".$length.")與length參數(".$conf["length"].")不相等";#回傳結果return $result;}#if end#函式說明:#unicode的字串分割,比str_split的支援度高.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],錯誤訊息陣列.#$result["function"],當前執行的函數名稱.#$result["content"],分割好的內容陣列.#$result["length"],unicode字串的長度.#必填參數:#$conf["str"],字串",要分割的字串.$conf["stringProcess::str_split_unicode"]["str"]=$conf["input"];#可省略參數:#$conf["length"],整數,分割的長度.$conf["stringProcess::str_split_unicode"]["length"]=(int)$conf["input"];#參考資料:#http://php.net/manual/en/function.str-split.php#備註:#無.$str_split_unicode=stringProcess::str_split_unicode($conf["stringProcess::str_split_unicode"]);unset($conf["stringProcess::str_split_unicode"]);#如果執行失敗if($str_split_unicode["status"]==="false"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"]=$str_split_unicode;#回傳結果return $result;}#if end#針對剩下的每個bytesforeach($str_split_unicode["content"] as $splitedStr){#串接新的input參數bytes$result["newInputArgu"]=$result["newInputArgu"].$splitedStr;}#foreach end}#if end#反之不存在指定bytes長度#但有指定字位長度else if(isset($conf["lengthGrapheme"])){#取得輸入的字位長度$grapheme_strlen=grapheme_strlen($conf["input"]);#如果不相等if($grapheme_strlen!==(int)$conf["lengthGrapheme"]){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置詳細結果訊息陣列.$result["content"][]="input參數(".$conf["input"].")的字位長度(".$grapheme_strlen.")與lengthGrapheme參數(".$conf["lengthGrapheme"].")不相等";#回傳結果return $result;}#if end#取得新的input參數$result["newInputArgu"]=grapheme_substr($conf["input"],0,$conf["lengthGrapheme"]);}#if end#反之不存在指定字位長度#但有指定 equalWithelse if(isset($conf["equalWith"])){#如果不相等if($conf["input"]!==$conf["equalWith"]){#設置執行正常$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置詳細結果訊息陣列.$result["content"][]="input參數(".$conf["input"].")與equalWith參數(".$conf["equalWith"].")不相等";#回傳結果return $result;}#if end}#if end}#else(沒有關鍵字) end#設置執行正常$result["status"]="true";#設置檢查通過$result["passed"]="true";#回傳結果return $result;}#checkStringFormat end/*#函式說明:#檢查字串是否符合 RFC 3339/ISO-8601 格式#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["passed"],檢查是否通過,"true"代表通過,"false"代表不通過.#$result["argu"],使用的參數.#$result["function"],當前執行的函數.#$result["error"],涵式錯誤訊息陣列.#必填參數:#$conf["input"],字串,要檢查格式的字串.$conf["input"]="";#可省略參數:#$conf["UTC"],字串,是否要用當前時區的設定去換算成unixtime,預設為"true",代表要;反之為"false".#$conf["UTC"]="true";#參考資料:#ISO 8601-2:2019=>https://www.rfc-editor.org/info/rfc3339#rfc3339=>https://www.rfc-editor.org/rfc/rfc3339#備註:#無.*/public static function checkRFC3339(&$conf){#初始化要回傳的結果$result=array();#設置當其函數名稱$result["function"]=__FUNCTION__;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif($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[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息#$result["argu"],字串陣列,目前輸入的參數名稱陣列.#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.#$result["notNeedVar"],字串陣列,多餘的參數名稱.#必填寫的參數:#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。$conf["variableCheck::checkArguments"]["varInput"]=&$conf;#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列,形態爲陣列變數,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("input");#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";#可以省略的參數:#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或集合.$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("UTC");#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"true"。$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("UTC");#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableType"] = array("string",integer,"double");$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一,請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true");#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.#$conf["arrayCountEqualCheck"][]=array();#參考資料來源:#array_keys=>http://php.net/manual/en/function.array-keys.php$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);unset($conf["variableCheck::checkArguments"]);#如果檢查失敗if($checkResult["status"]==="false"){#設置執行失敗的訊息$result["status"]="false";#設置錯誤訊息$result["error"]=$checkResult;#回傳結果return $result;}#if end#如果檢查不通過if($checkResult["passed"]==="false"){#設置執行失敗的訊息$result["status"]="false";#設置錯誤訊息$result["error"]=$checkResult;#回傳結果return $result;}#if end#函式說明:#計算時間點距離1970/01/01多少秒,亦即unixtime.#回傳結果:#$result["stauts"],執行是否成功,"true"代表執行成功;"false"代表執行失敗.#$result["error"],錯誤訊息陣列.#$result["content"],時間點距離1970/01/01的多少秒.#$result["oriDateAndTime"],原始輸入的內容,若replace0參數為"true",才會有該回傳內容.#必填參數:#$conf["dateAndTime"],字串,格式爲 2011-05-27 23:59:59.$conf["time::caculateTimeAmount"]["dateAndTime"]=$conf["input"];#可省略參數:#$conf["UTC"],字串,是否要用當前時區的設定去換算成unixtime,預設為"false",代表不要;反之為"true".$conf["time::caculateTimeAmount"]["UTC"]=$conf["UTC"];#$conf["replace0"],字串,是否要將連續為0的內容替換成當下時間,預設為"true"代表要;反之為"false".$conf["time::caculateTimeAmount"]["replace0"]="false";#參考資料:#無.#備註:#無.$caculateTimeAmount=time::caculateTimeAmount($conf["time::caculateTimeAmount"]);unset($conf["time::caculateTimeAmount"]);#如果檢查失敗if($caculateTimeAmount["status"]==="false"){#設置執行正常的識別$result["status"]="true";#設置檢查不通過$result["passed"]="false";#設置回饋的訊息$result["content"]=$caculateTimeAmount;#回傳結果return $result;}#if end#設置執行正常的識別$result["status"]="true";#設置檢查通過$result["passed"]="true";#回傳結果return $result;}#function checkRFC3339 end/*#函式說明:#處理各種錯誤與例外.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["argu"],使用的參數.#$result["function"],當前執行的函數.#$result["error"],涵式錯誤訊息陣列.#必填參數:#無.#可省略參數:#$conf["allowCodition"],陣列,滿足什麼條件的錯誤跟例外要繼續執行而不中斷.#$conf["allowCodition"]=array();#$conf["debug"],字串,"true"代表遇到不允許繼續執行的例外時要輸出debug資訊;預設為"false";#$conf["debug"]="false";#$conf["format"],字串,遇到不允許的錯誤時,要用什麼格式呈現,預設為"html",其他選擇有"cmd".#$conf["format"]="html";#參考資料:#無.#備註:#由於是使用 set_exception_handler 因此程式會結束執行.*/public static function setErrorHandler(&$conf=array()){#初始化要回傳的結果$result=array();#取得當前執行的函數名稱$result["function"]=__FUNCTION__;#取得參數$result["argu"]=$conf;#如果 $conf 不為陣列if(gettype($conf)!="array"){#設置執行失敗$result["status"]="false";#設置執行錯誤訊息$result["error"][]="\$conf變數須為陣列形態";#如果傳入的參數為 nullif(is_null($conf)){#設置執行錯誤訊息$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";}#if end#回傳結果return $result;}#if end#檢查參數#函式說明:#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容.#回傳結果:#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.#$result["error"],執行不正常結束的錯訊息陣列.#$result["simpleError"],簡單表示的錯誤訊息.#$result["function"],當前執行的函式名稱.#$result["argu"],設置給予的參數.#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.#$result["argu"],字串陣列,目前輸入的參數名稱陣列.#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.#$result["notNeedVar"],字串陣列,多餘的參數名稱.#必填參數:#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。$conf["variableCheck::checkArguments"]["varInput"]=&$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("stream","data");#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("resource","array");#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"true",可以為空字串.#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.#$conf["variableCheck::checkArguments"]["canNotBeEmpty"]=array("stream");#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.#$conf["canBeEmpty"]=array();#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.#$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("msgEndType","autoClose");#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("allowCodition","debug","format");#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableType"] = array("string",integer,"double");$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","string","string");#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一,請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,"false","html");#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".#$conf["disallowAllSkipableVarIsEmpty"]="";#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".#$conf["disallowAllSkipableVarIsEmptyArray"]="";#$conf["disallowAllSkipableVarNotExist"],字串,是否不允許每個可省略參數都不存在,預設為"false"代表允許,反之為"true".#$conf["disallowAllSkipableVarNotExist"]="";#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.#$conf["arrayCountEqualCheck"][]=array();#參考資料:#array_keys=>http://php.net/manual/en/function.array-keys.php#備註:#無.$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);unset($conf["variableCheck::checkArguments"]);#如果執行失敗if($checkArguments["status"]==="false"){#設置執行失敗$result["status"]="false";#設置錯誤資訊$result["error"]=$checkArguments;#回傳結果return $result;}#if end#如果檢查不通過if($checkArguments["passed"]==="false"){#設置執行失敗$result["status"]="false";#設置錯誤資訊$result["error"]=$checkArguments;#回傳結果return $result;}#if end#設置給本函式使用的 confself::$setErrorHandlerConf=$conf;#處理會導致程式無法執行的錯誤set_error_handler(function($errno, $errstr, $errfile, $errline){throw new \ErrorException($errstr, $errno, 0, $errfile, $errline);});#處理非導致程式無法執行的錯誤#參考資料:#http://php.net/manual/en/class.exception.phpset_exception_handler(function($exception){#debug#var_dump($exception);return true;#無窮迴圈while(true){#取得給本函式使用的 conf$conf=\qbpwcf\variableCheck::$setErrorHandlerConf;#debug#var_dump(__LINE__,$conf);#初始化儲存錯誤訊息$info=array();#取得描述$info["msg"]="Uncaught exception: ".$exception->getMessage();#取得出錯檔案$info["file"]="File: ".$exception->getFile();#取得出錯行數$info["line"]="Line: ".$exception->getLine();#取得錯誤代碼$info["code"]="The exception code is: ".$exception->getCode();#函式說明:#檢查多個字串中的每個字串是否有多個關鍵字#回傳結果:#$result["status"],整體來說,執行是否成功,"true"代表執行成功,"false"代表執行失敗。#$result["function"],當前執行的函數名稱.#$result["error"],錯誤訊息.#$result["argu"],使用的參數.#$result["foundedTrueKey"],結果為"true"的被搜尋元素key陣列,與其數值內容.#$result["foundedKeyWords"],找到的關鍵字陣列.#$result["foundedFalseKey"],結果為"false"的被搜尋元素key陣列,與其數值內容.#$result["foundedTrueKeyWords"],二維陣列,各個字串有找到的關鍵字陣列.#$result["foundedAll"],是否每個關鍵字都有找到,"true"代表每個都有找到,"false"代表沒有每個都找到.#必填參數:#$conf["keyWords"],字串陣列,想要搜尋的關鍵字.$conf["search::findManyKeyWordsFromManyString"]["keyWords"]=$conf["allowCodition"];#$conf["stringArray"],字串陣列,要被搜尋的字串內容陣列.$conf["search::findManyKeyWordsFromManyString"]["stringArray"]=$info;#可省略參數:#$conf["completeEqual"],字串,是否內容要完全符合,不能多出任何不符合的內容,預設為"false"不需要完全符合.#$conf["completeEqual"]="true";#參考資料:#無.#備註:#無.$findManyKeyWordsFromManyString=search::findManyKeyWordsFromManyString($conf["search::findManyKeyWordsFromManyString"]);unset($conf["search::findManyKeyWordsFromManyString"]);#如果執行失敗if($findManyKeyWordsFromManyString["status"]==="false"){#設置執行失敗$result["status"]="false";#設置錯誤資訊$result["error"]=$findManyKeyWordsFromManyString;#debugvar_dump(__LINE__,$result);#結束執行,回傳代碼1給shellexit(1);}#if end#如果有符合可以繼續執行的條件if(count($findManyKeyWordsFromManyString["foundedTrueKey"])>0){#debugvar_dump(__LINE__,$findManyKeyWordsFromManyString);#結束whilebreak;}#if end#如果有要debugif($conf["debug"]==="true"){#判斷要呈現的方式switch($conf["format"]){#如果是 htmlcase "html":#呈現錯誤訊息echo "<p>".PHP_EOL;echo "Uncaught exception: ".$exception->getMessage()."<br>".PHP_EOL;echo "File: ".$exception->getFile()."<br>".PHP_EOL;echo "Line: ".$exception->getLine()."<br>".PHP_EOL;echo "Trace: ".print_r($exception->getTrace(),true)."<br>".PHP_EOL;echo "The exception code is: ".$exception->getCode()."<br>".PHP_EOL;#跳出 switchbreak;#如果是 cmdcase "cmd";#呈現錯誤訊息echo PHP_EOL;echo "Uncaught exception: ".$exception->getMessage().PHP_EOL;echo "File: ".$exception->getFile().PHP_EOL;echo "Line: ".$exception->getLine().PHP_EOL;echo "Trace: ".print_r($exception->getTrace(),true).PHP_EOL;echo "The exception code is: ".$exception->getCode().PHP_EOL;#跳出 switchbreak;#其他格式default:#用var_dumpvar_dump($info);}#switch end}#if end#debug#var_dump(__LINE__,$findManyKeyWordsFromManyString);#結束執行,回傳代碼1給shellexit(1);}#while end#debug#var_dump(__LINE__,"passed");#視為可以繼續執行return true;});}#funciton setErrorHandler end}#class variableCheck end?>