Subversion Repositories php-qbpwcf

<?php

/*

        QBPWCF, Quick Build PHP website Component base on Fedora Linux.
    Copyright (C) 2015~2024 Min-Jhin,Chen

    This file is part of QBPWCF.

    QBPWCF is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the 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 of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with QBPWCF.  If not, see <http://www.gnu.org/licenses/>.

*/
namespace qbpwcf;

/*
類別說明:
提供http header相關應用的類別.
備註:
無.
*/
class header{

        /*
        #函式說明:
        #當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
        #回傳結果:
        #$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,陣列,為呼叫方法時所用的參數.
        #參考資料:
        #__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
        */
        public static function __callStatic($method,$arguments){
                
                #取得當前執行的函式
                $result["function"]=__FUNCTION__;
                
                #設置執行不正常
                $result["status"]="false";
                
                #設置執行錯誤
                $result["error"][]="欲呼叫的". __NAMESPACE__ ."/".$method."() 不存在!";
                
                #設置所丟入的參數
                $result["error"][]=$arguments;
                
                #回傳結果
                return $result;
                
                }#function __callStatic end

        /*
        #函式說明:
        #設定檢視該網頁時預設的編碼
        #必填參數:
        #$conf["encodingName"],字串,為網頁顯示的編碼的名稱.例如："utf-8","big5".
        $conf["encodingName"]="utf-8";
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function htmlEncoding($conf){

                #設定網頁顯示的編碼
                header("Content-Type: text/html; charset='".$conf["encodingName"]."'");
                
                #避免header指定的檔案內容形態被修改
                #https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options
                header("X-Content-Type-Options: text/html");

                #讓網頁本文也能識別是UTF-8編碼
                echo "<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">";

                }#function htmlEncoding end

        /*
        #函式說明:
        #設定待網頁的前端程式執行完後n秒後轉址,
        #回傳結果:
        #$result["status"],"true"正常;"false"代表不正常.
        #$result["error"],錯誤訊息.
        #$result["argu"],使用的參數.
        #必填參數:
        #$conf["redirctionLocation"],為要轉址到的地方,若爲 $SERVER["PHP_SELF"],則爲回到目前頁面。
        $conf["redirctionLocation"]="";
        #$conf["interval"],幾秒後轉向,"0"為等待前端程式執行完後立即轉址。
        $conf["interval"]="";
        #可省略參數
        #$conf["exitNow"],預設為"true"後面的程式就不要執行了,反之為"false"後面的程式繼續執行.
        #$conf["exitNow"]="";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function redirection($conf){

                #初始化要回傳的結果
                $result=array();

                #取得當前執行的函數名稱
                $result["function"]=__FUNCTION__;

                #如果沒有參數
                if(func_num_args()==0){

                        #設置執行失敗
                        $result["status"]="false";

                        #設置執行錯誤訊息
                        $result["error"]="函數".$result["function"]."需要參數";

                        #回傳結果
                        return $result;

                        }#if end

                #取得參數
                $result["argu"]=$conf;

                #如果 $conf 不為陣列
                if(gettype($conf)!=="array"){

                        #設置執行失敗
                        $result["status"]="false";

                        #設置執行錯誤訊息
                        $result["error"][]="\$conf變數須為陣列形態";

                        #如果傳入的參數為 null
                        if(is_null($conf)){

                                #設置執行錯誤訊息
                                $result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";

                                }#if 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("redirctionLocation","interval");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string");
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                $conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
                #$conf["canNotBeEmpty"]=array();
                #$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
                #$conf["canBeEmpty"]=array();
                #$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
                $conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("exitNow");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("exitNow");
                #$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["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 $result;
                
                        }#if end
                        
                #如果檢查參數失敗
                if($checkArguments["passed"]==="false"){
                
                        #設置執行失敗
                        $result["status"]="false";
                
                        #設置錯誤訊息
                        $result["error"]=$checkArguments;
                        
                        #回傳結果
                        return $result;
                
                        }#if end

                #設定 $interval 秒後，轉向至 $redirectionLocation
                header("Refresh: ".$conf["interval"]."; url=".$conf["redirctionLocation"]);

                #如果要立即結束執行
                if($conf["exitNow"]==="true"){

                        #停止執行後面的程式，因爲要馬上進行轉址.
                        exit;
        
                        }

                #設置執行失敗
                $result["status"]="true";
                
                #設置錯誤訊息
                return $result;


                }#function  redirection end

        /*
        #函式說明:
        #設定session變數後,立即轉址.
        #回傳的結果:
        #$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
        #$result["function"],當前執行的函數名稱.
        #$result["error"],錯誤訊息陣列.
        #必填參數:
        #$conf["headerLocation"],為要轉址到的地方,若爲 $_SERVER["PHP_SELF"]，則爲回到目前頁面,全民資安素養網爲 https://isafe.moe.edu.tw/.
        $conf["headerLocation"]="";
        #可省略參數:
        #$conf["sessionName"],字串陣列,可以指派session變數的名稱.
        #$conf["sessionName"]=array("");
        #$conf["sessionValue"]字串陣列,可以指派session變數的內容.
        #$conf["sessionValue"]=array("");
        #參考資料:
        #http://php.net/manual/en/reserved.variables.server.php
        #備註:
        #無.
        */      
        public static function redirectionNow(&$conf){

                #初始化要回傳的內容
                $result=array();
                
                #設置當前執行的函數
                $result["function"]=__FUNCTION__;

                #如果 $conf 不為陣列
                if(gettype($conf)!="array"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"][]="\$conf變數須為陣列形態";

                        #如果傳入的參數為 null
                        if($conf==null){
                                
                                #設置執行錯誤訊息
                                $result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
                                
                                }#if end

                        #回傳結果
                        return $result;
                        
                        }#if end

                #初始化ifrmae語法內容
                $result["content"]="";
                
                #如果 $conf 不為陣列
                if(gettype($conf)!="array"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"][]="\$conf變數須為陣列形態";

                        #回傳結果
                        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["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("headerLocation");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
                #$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"]="true";
                #$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("sessionName","sessionValue");
                #$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","array");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,null);
                #$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["arrayCountEqualCheck"][]=array();
                $checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);
                
                #如果檢查失敗
                if($checkResult["status"]=="false"){
                        
                        #設置執行不正常
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$checkResult;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #如果檢查不通過
                if($checkResult["passed"]=="false"){
                        
                        #設置執行不正常
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$checkResult;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #如果 $conf["sessionName"] 與 $conf["sessionValue"] 皆為 true 代表皆有設置.
                if( isset($conf["sessionName"])==true && isset($conf["sessionValue"])==true ){
                        
                        #有幾個 $conf["sessionName"] 就執行幾次.
                        for($i=0;$i<count($conf["sessionName"]);$i++){

                                #函式說明:
                                #建立session變數，並指派其內容
                                #回傳的結果：
                                #$result["status"],執行狀態，"true"代表執行成功；"false"代表執行失敗.
                                #$result["error"],錯誤訊息陣列.
                                #$result["function"],當前執行的函數名稱.
                                #必填參數:
                                $conf["session"]["create"]["sessionName"]=$conf["sessionName"][$i];#要建立的session變數名稱，建議可採用name1.name2.name3的格式。
                                #可省略的參數： 
                                $conf["session"]["create"]["sessionValue"]=$conf["sessionValue"][$i];#session變數的內容要存放什麼呢？ 
                                $sessionCreatedResult=session::create($conf["session"]["create"]);
                                unset($conf["session"]["create"]);

                                #如果建立session變數失敗
                                if($sessionCreatedResult["status"]=="false"){
                                        
                                        #設置執行不正常
                                        $result["status"]="false";
                                        
                                        #設置錯誤訊息
                                        $result["error"]=$sessionCreatedResult;
                                        
                                        #回傳結果
                                        return $result;
                                        
                                        }#if end

                                }#for end

                        }#if end
                
                #立即轉址到特定網址.
                #header("Refresh: 0; url=".$conf["headerLocation"]);
                header("location:".$conf["headerLocation"]);

                #停止執行後面的程式，因爲要馬上進行轉址.
                exit;
                        
                }#function redirectionNow end.

        /*
        #函式說明:
        #用data:mimeType;base64,fileVar的形式來提供檔案的連結,亦即檔案儲存在變數裡面.
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$result["error"],錯誤訊息
        #$result["content"],檔案變數的內容
        #$result["fileTypeName"],副檔名,ex:「.tar.xz」.
        #$result["function"],當前執行的函數名稱 
        #必填參數:
        #$conf["filePosition"],要轉存成2元碼的圖片檔案位置與名稱
        $conf["filePosition"]="";
        #$conf["mimeType"],2元碼的內容是什麼
        $conf["mimeType"]="";
        #可省略參數:
        #$conf["compressType"],2元碼壓縮的方式,預設為"base64".
        #$conf["compressType"]="base64";
        #$conf["delFile"],讀取完檔案後,要移除檔案嗎？"true"代表要移除,"false"代表不要移除,預設為"false".
        #$conf["delFile"]="false";
        #參考資料:
        #將檔案用字串變數儲存起來=>http://php.net/manual/en/function.file-get-contents.php
        #壓縮2元碼=>http://php.net/manual/en/function.base64-encode.php
        #備註:
        #無.
        */
        public static function data(&$conf){
                
                #與fileAccess類別的data函數一樣
                return fileAccess::data($conf);
                
                }#function data end

        /*
        #函式說明:
        #透過轉址的方式來下載檔案.
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$result["error"],錯誤訊息
        #$result["function"],當前執行的函數名稱 
        #必填參數:
        #$conf["filePosition"],字串,爲要下載的檔案位置
        $conf["filePosition"]="";
        #$conf["fileType"],字串,檔案類型
        $conf["fileType"]="";
        #$conf["fileName"],字串,儲存時的檔案名稱.
        $conf["fileName"]="";
        #可省略參數:
        #$conf["fileTypeName"],字串,副檔名,ex:「.tar.gz」.
        #$conf["fileTypeName"]="";
        #參考資料:
        #header=>http://php.net/manual/en/function.header.php
        #備註:
        #請在沒有任何html輸出的頁面使用
        */      
        public static function downloadFile($conf){

                #初始化要回傳的變數
                $result=array();
                
                #記錄當前執行的函數名稱
                $result["function"]=__FUNCTION__;
                
                #如果 $conf 不為陣列
                if(gettype($conf)!="array"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"][]="\$conf變數須為陣列形態";

                        #如果傳入的參數為 null
                        if($conf==null){
                                
                                #設置執行錯誤訊息
                                $result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
                                
                                }#if end

                        #回傳結果
                        return $result;
                        
                        }#if end

                #檢查參數
                #函式說明：
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$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"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("filePosition","fileType","fileName");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string");
                #$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                $conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("fileTypeName");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null);
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array();
                #參考資料來源:
                #array_keys=>http://php.net/manual/en/function.array-keys.php
                $checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);

                #debug
                #var_dump($checkResult);
                #exit;

                #如果檢查失敗
                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

                #描述內容為檔案傳輸
                header("Content-Description: File Transfer");

                #設定檔案的類型
                header("Content-Type:".$conf["fileType"]);

                #如果 $conf["fileTypeName"] 存在
                if(isset($conf["fileTypeName"])){
                        
                        #加上副檔名
                        $conf["fileName"]=$conf["fileName"].$conf["fileTypeName"];
                        
                        }#if end

                #提示下載檔案與其資訊
                header("Content-Disposition: attachment; filename=\"".$conf["fileName"]."\"");

                header("Content-Transfer-Encoding: binary");#傳送模式爲2原碼傳送
                header("Expires: 0");
                header("Cache-Control: must-revalidate");
                header("Pragma: public");
                ob_clean();#清除物件
                flush();#清除記憶題

                #設定檔案的所在
                readfile($conf["filePosition"]);

                }#function downloadFile end

        /*
        #函式說明:
        #要求使用者Download某檔案
        #回傳結果：
        #$result["status"],字串,"true"爲成功，"false"反之失敗
        #$result["error"],陣列,錯誤訊息
        #$result["function"],字串,當前執行的函數名稱.
        #必填參數:
        $conf["filePositionAndName"],字串,檔案的位置與名稱
        $conf["filePositionAndName"]="";
        #可省略參數:
        #$conf["fileDisplayName"],字串,要顯示的檔案名稱，若要放中文請將其文字放在（）裏面，這樣種文字才會顯現。預設為 basename($conf["filePositionAndName"])." date:".$系統時間;
        #$conf["fileDisplayName"]="";
        #$conf["mimeType"],字串,檔案的mimeType,預設為"application/octet-stream".
        #$conf["mimeType"]="application/octet-stream";
        #參考資料:
        #http:#php.net/manual/en/function.readfile.php
        #備註:
        #建議改用data與downloadFile函數
        */
        public static function askUserDownloadFile(&$conf){
                
                #初始化要回傳的變數
                $result=array();
                
                #初始化當前執行的函數名稱
                $result["funciton"]=__FUNCTION__;
                
                #如果 $conf 不為陣列
                if(gettype($conf)!="array"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"][]="\$conf變數須為陣列形態";

                        #如果傳入的參數為 null
                        if($conf==null){
                                
                                #設置執行錯誤訊息
                                $result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
                                
                                }#if end

                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #檢查參數
                #函式說明：
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$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"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("filePositionAndName");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
                #$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                $conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("fileDisplayName","mimeType");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string");
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,"application/octet-stream");
                #$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
                
                #如果 $conf["fileDisplayName"] 不存在
                if(!isset($conf["fileDisplayName"])){

                        #回傳西元的目前時間,格式為2010年07月24日15時30分33秒
                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                        #$reuslt["error"],執行不正常結束的錯訊息陣列.
                        #$result["function"],當前執行的函式名稱.
                        #$result["content"],西元的目前時間.
                        #必填參數:
                        $conf["time"]["getFullDateAndTime"]["timeZone"]="Asia/Taipei";#時區代號,可以設定的時區列表:http:#www.php.net/manual/en/timezones.php
                                #ex:"Asia/Taipei"
                        #可省略的參數：
                        $conf["time"]["getFullDateAndTime"]["showSecond"]="true";#若爲"true"則會顯示秒數        
                        $systemTime=time::getFullDateAndTime($conf["time"]["getFullDateAndTime"]);
                        unset($conf["time"]["getFullDateAndTime"]);

                        #如果取得系統時間失敗
                        if($systemTime["status"]=="false"){
                                
                                #設置執行不正常
                                $result["status"]="false";
                                
                                #設置錯誤訊息
                                $result["error"]=$systemTime;
                                
                                #回傳結果
                                return $result;
                                
                                }#if end

                        #函式說明:
                        #將固定格式的字串分開，並回傳分開的結果。
                        #回傳的參數:
                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                        #$result["error"],錯誤訊息陣列
                        #$result["function"],當前執行的函數名稱.
                        #$result["oriStr"],要分割的原始字串內容
                        #$result["dataArray"],爲分割好字串的陣列內容,$result["dataArray"][$i]爲第($i+1)段的內容。
                        #$result["dataCounts"],爲總共分成幾段
                        #必填參數:
                        $conf["stringPross"]["spiltString"]["stringIn"]=basename($conf["filePositionAndName"]);#要處理的字串。
                        $conf["stringPross"]["spiltString"]["spiltSymbol"]=".";#爲以哪個符號作爲分割
                        $fileNameString=stringProcess::spiltString($conf["stringPross"]["spiltString"]);
                        unset($conf["stringPross"]["spiltString"]);     

                        #如果分割字串失敗
                        if($fileNameString["status"]=="false"){
                                
                                #設置錯誤識別
                                $result["status"]="false";
                                
                                #設置錯誤訊息
                                $result["error"]=$fileNameString;
                                
                                #回傳結果
                                return $result;
                                
                                }#if end

                        #檔案名稱為 / 後面的內容
                        $conf["fileDisplayName"]="(".$fileNameString["dataArray"][0]." date:".$systemTime["content"].")";

                        #若原始檔案名稱有副檔名
                        for($i=1;$i<$fileNameString["dataCounts"];$i++){
                                
                                #組合副檔名
                                $conf["fileDisplayName"]=$conf["fileDisplayName"].".".$fileNameString["dataArray"][$i];
                                
                                }#for end

                        }#if end

                #如果檔案存在
                if(file_exists($conf["filePositionAndName"])){

                        header("Content-Description: File Transfer");#描述
                        header("Content-Type: ".$conf["mimeType"]);#設定檔案類型
                        header("Content-Disposition: attachment; filename=\"".$conf["fileDisplayName"]);#附件檔案顯示名稱
                        header("Content-Transfer-Encoding: binary");#傳送模式爲2原碼傳送
                        header("Expires: 0");
                        header("Cache-Control: must-revalidate");
                        header("Pragma: public");
                        header("Content-Length:".filesize($conf["filePositionAndName"]));#headr的大小等於檔案的大小
                        ob_clean();#清除物件
                        flush();#清除記憶題
                        readfile($conf["filePositionAndName"]);#讀取檔案
                        
                        #設置執行正常
                        $result["status"]="true";

                        #回傳結果
                        return $result;

                        }#if end

                #如果檔案不存在則回傳錯誤訊息
                else{

                        #設置錯誤識別
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"][]="要下載的檔案不存在";
                        
                        #回傳結果
                        return $result;

                        }#else end
                        
                #照理說不應該執行到這邊      
                        
                #設置錯誤識別
                $result["status"]="false";
                
                #設置錯誤訊息
                $result["error"][]="下載檔案失敗";
                
                #回傳結果
                return $result;

                }#function end

        /*
        #函式說明:
        #建立網頁的標題，納入網絡搜尋的依據.
        #回傳的內容：
        #$result["status"],字串,"true"爲成功，"false"反之失敗.
        #$result["error"],陣列,錯誤訊息.
        #$result["function"],字串,當前執行的函數名稱.
        #$result["content"],字串,設定網頁資訊的字串變數.
        #必填參數:
        #$conf["title"],字串,網頁的標題.
        $conf["title"]="";
        #可省略參數:
        #$conf["desc"],字串,網站的描述.
        $conf["desc"]="";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function setPageInfo($conf){

                #初始化要回傳的變數
                $result=array();
                
                #初始化當前執行的函數名稱
                $result["funciton"]=__FUNCTION__;
                
                #如果 $conf 不為陣列
                if(gettype($conf)!="array"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"][]="\$conf變數須為陣列形態";

                        #如果傳入的參數為 null
                        if($conf==null){
                                
                                #設置執行錯誤訊息
                                $result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
                                
                                }#if end

                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #檢查參數
                #函式說明：
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$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"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("title");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
                #$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                $conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("desc");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("\$conf[\"title\"]");
                #$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

                #設置 title
                $title="<title>".$conf["title"]."</title>";

                #設置 meta desc
                $meta="<meta name=\"description\" content=\"".$conf["desc"]."\" ></meta>";
                                
                #設定資訊字串
                $result["content"]="<head>".$title.$meta."</head>";
        
                #設置執行正常
                $result["status"]="true";
        
                #回傳設定資訊
                return $result;

                }#function setPageInfo end
                
        /*
        #函式說明:
        #用彈出式視窗顯示訊息，接著設置seesion變數,最後進行轉址.
        #回傳的結果:
        #$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數名稱.
        #必填參數:
        #$conf["headerLocation"],為要轉址到的地方,若爲 $_SERVER["PHP_SELF"]，則爲回到目前頁面,全民資安素養網爲 https://isafe.moe.edu.tw/.
        $conf["headerLocation"]="";
        #$conf["alertMessage"],字串陣列,要顯示的彈出式視窗內容,第n個元素代表第n行的內容.
        $conf["alertMessage"]=array("");
        #可省略參數:
        #$conf["sessionName"],字串陣,可以指派要建立的session變數名稱.
        #$conf["sessionName"]=array("");
        #$conf["sessionValue"]字串陣列,可以指派要建立的session變數的內容.
        #$conf["sessionValue"]=array("");
        #參考資料:
        #http://php.net/manual/en/reserved.variables.server.php
        #備註:
        #無.
        */      
        public static function redirectionAfterAlertWindows(&$conf){
                
                #初始話要回傳的變數
                $result=array();
                
                #記錄當前執行的函數
                $result["function"]=__FUNCTION__;
                
                #如果 $conf 不為陣列
                if(gettype($conf)!="array"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"][]="\$conf變數須為陣列形態";

                        #如果傳入的參數為 null
                        if($conf==null){
                                
                                #設置執行錯誤訊息
                                $result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
                                
                                }#if end

                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #檢查參數
                #函式說明：
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$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"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("headerLocation","alertMessage");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $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"]["canBeEmptyString"]="false";
                #$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("sessionName","sessionValue");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","array");
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,null);
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                $conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("sessionName","sessionValue");
                #參考資料來源:
                #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
                                        
                #初始化要顯示的彈出式視窗內容
                $msg="";
                                
                #將 $conf["alertMessage"] 中 每個元素視為 $lineContent
                foreach($conf["alertMessage"] as $lineContent){
                        
                        #結尾加換行符號
                        $msg=$msg.$lineContent."\\n";
                        
                        }#foreach end 
                                                
                #函式說明:
                #彈出視窗
                #回傳的結果：
                #$result["status"],執行正確與否,"true"為執行正確,"false"為執行失敗.
                #$result["error"],錯誤訊息陣列.
                #$result["content"],avaScript語法.
                #必填的參數
                $conf["javaScript"]["alertWindow"]["alertSentence"]=$msg;#爲要彈出式視窗的內容。
                $javaScript=javaScript::alertWindow($conf["javaScript"]["alertWindow"]);
                unset($conf["javaScript"]);
                
                #如果 $javaScript["status"] 等於 "false"
                if($javaScript["status"]=="false"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$javaScript;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #印出javaScript
                echo $javaScript["content"];
        
                #如果 $conf["sessionName"] 參數存在 
                if(isset($conf["sessionName"])){
                        
                        #$conf["sessionName"]有幾個元素就執行幾次
                        for($i=0;$i<count($conf["sessionName"]);$i++){
                                
                                #設置session變數
                                #函式說明:
                                #建立session變數，並指派其內容
                                #回傳的結果：
                                #$result["status"]，執行狀態，"true"代表執行成功；"false"代表執行失敗。
                                #$result["error"]，錯誤訊息陣列
                                #必填參數:
                                $conf["session"]["create"]["sessionName"]=$conf["sessionName"][$i];#要建立的session變數名稱，建議可採用name1.name2.name3的格式。
                                #可省略的參數： 
                                $conf["session"]["create"]["sessionValue"]=$conf["sessionValue"][$i];#session變數的內容要存放什麼呢？ 
                                $createSessionResult=session::create($conf["session"]["create"]);
                                unset($conf["session"]);
                                
                                #如果 $createSessionResult["status"] 等於 "false"
                                if($createSessionResult["status"]=="false"){
                                        
                                        #設置執行失敗
                                        $result["status"]="false";
                                        
                                        #設置錯誤訊息
                                        $result["error"]=$createSessionResult;
                                        
                                        #回傳結果
                                        return $result;
                                        
                                        }#if end
                                
                                }#for end
                        
                        }#if end
                
                #函式說明:
                #設定網頁n秒後轉址
                #必填參數:
                $conf["header"]["redirection"]["redirctionLocation"]=$conf["headerLocation"];#為要轉址到的地方
                        #若爲 $SERVER["PHP_SELF"],則爲回到目前頁面。
                $conf["header"]["redirection"]["interval"]="0";#幾秒後轉向,"0"為等待javacript程式執行完後再立即轉址。
                header::redirection($conf["header"]["redirection"]);
                unset($conf["header"]);
                                        
                #執行到這邊代表不正常
                
                #設置執行失敗
                $result["status"]="false";
                                        
                #設置錯誤訊息
                $result["error"][]="非預期的錯誤";
                                        
                #回傳結果
                return $result;                 
                                        
                }#function redirectionAfterAlertWindows end 

        /*
        #函式說明:
        #接收表單變數後,轉存成session變數後,立即轉址.
        #回傳的結果:
        #$result["status"],執行是否成功，"true"代表執行成功；"false"代表執行失敗.
        #$result["function"],當前執行的函數.
        #$result["error"],錯誤訊息.
        #必填參數:
        #$conf["receivedVarName"],字串陣列,要接收的變數名稱.
        $conf["receivedVarName"]=array();
        #$conf["limitPrePage"],字串陣列,表單變數的來源頁面必須是陣列元素之一(不包含檔案路徑)
        $conf["limitPrePage"]=array();
        #$conf["sessionName"],字串陣列,表單變數要轉換成的session變數的名稱.
        $conf["sessionName"]=array("");
        #$conf["redirectionTo"],為要轉址到的地方,若爲 $_SERVER["PHP_SELF"]，則爲回到目前頁面,全民資安素養網爲 https://isafe.moe.edu.tw/.
        $conf["redirectionTo"]="";
        #可省略參數:
        #$conf["receiveFormMethod"],字串,傳送過來的資料是用"post/POST"還是"get/GET",預設為"post"
        #$conf["receiveFormMethod"]="post";
        #$conf["additionSessionName"]字串陣列,額外指派的session變數名稱.
        #$conf["additionSessionName"]=array(""); 
        #$conf["additionSessionValue"]字串陣列,可額外指派的session變數的內容.
        #$conf["additionSessionValue"]=array("");
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function formVarToSessionThenRedirection(&$conf){
                
                #設置要回傳的結果
                $result=array();
                
                #設置當前執行的函數
                $result["function"]=__FUNCTION__;
                
                #如果 $conf 不為陣列
                if(gettype($conf)!="array"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"][]="\$conf變數須為陣列形態";

                        #如果傳入的參數為 null
                        if($conf==null){
                                
                                #設置執行錯誤訊息
                                $result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
                                
                                }#if end

                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #設置要回傳的語法
                $result["content"]="";
                
                #檢查參數
                #函式說明：
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
                #$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"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("receivedVarName","limitPrePage","sessionName","redirectionTo");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","array","array","string",);
                #$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("receiveFormMethod","additionSessionName","additionSessionValue");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","array","array");
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("post",null,null);
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                $conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("sessionName","sessionValue");
                $conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("additionSessionName","additionSessionValue");
                #參考資料來源:
                #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
                
                #函式說明:
                #可以處理多個透過GET、POST而來的資訊，儲存成變數，同時限定傳送的方法、來源，來增加安全性，檢查有沒有皆收到必須要接收到的變數
                #回傳的結果：
                #$result["status"],執行是否成功，"true"代表執行成功；"false"代表執行失敗.
                #$result["function"],當前執行的函數.
                #$result["error"],錯誤訊息.
                #$result["passed"],是否有皆收到全部該接收到的變數，若有設定$conf["checkedVarName"]的話，執行正常後會回傳該結果。
                #$result["lostVarName"],沒有皆收到的變數名稱陣列
                #$result["inputDataContent"],所接收的參數陣列.
                #$result["inputDataContent"]["變數名稱"],所接收變數的內容.
                #$result["inputDataCount"],總共接收到幾個元素.
                #必填參數:
                #$conf["form.responseMultiInputDataSecurityEnhance"]["method"],字串,傳送過來的資料是用"post/POST"還是"get/GET"?
                $conf["form.responseMultiInputDataSecurityEnhance"]["method"]=$conf["receiveFormMethod"];
                #可省略的參數：
                #$conf["allowGet"],字串,是否要允許 get 傳值，"true"，代表允許；"false" ，代表不允許，預設爲不允許.
                #$conf["allowGet"]="true";
                #$conf["form.responseMultiInputDataSecurityEnhance"]["limitPrePage"],字串陣列,是否要限定前一頁的網址為哪些，才能接收內容，不符合則轉址.
                $conf["form.responseMultiInputDataSecurityEnhance"]["limitPrePage"]=$conf["limitPrePage"];
                #$conf["transferLocation"],字串,遇到get傳值的時候要轉址到的頁面，預設爲資安素養網"https://isafe.moe.edu.tw/"
                #$conf["transferLocation"]="";
                #$conf["ignore"]=字串陣列,如果要接收的變數名稱與該陣列其一元素一樣,則不放進要回傳的變數裏面.
                #$conf["ignore"]=array();
                #$conf["correctCharacter"]=,字串,如果爲"false"，則不處理可能導致網頁出問題的字串，預設爲要進行處理.
                #$conf["correctCharacter"]="false";
                #$conf["form.responseMultiInputDataSecurityEnhance"]["checkedVarName"],字串陣列,為檢查是否有接收到哪些變數.
                $conf["form.responseMultiInputDataSecurityEnhance"]["checkedVarName"]=$conf["receivedVarName"];
                #參考資料來源：
                #foreach 的用法 -> http://php.net/manual/en/control-structures.foreach.php
                #伺服器端的變數 -> http://php.net/manual/en/reserved.variables.server.php
                #備註：
                #表單變數的名稱若含有「.」，則會變成「-」。
                $receiveVar=form::responseMultiInputDataSecurityEnhance($conf["form.responseMultiInputDataSecurityEnhance"]);
                unset($conf["form.responseMultiInputDataSecurityEnhance"]);
                
                #如果接收變數失敗
                if($receiveVar["status"]=="false"){
                        
                        #設置錯誤
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$receiveVar;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #如果變數有缺
                if($receiveVar["passed"]=="false"){
                        
                        #設置錯誤
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$receiveVar;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #$conf["additionSessionName"]字串陣列,額外指派的session變數名稱.
                #$conf["additionsessionName"]=array(""); 
                #$conf["additionSessionValue"]字串陣列,可額外指派的session變數的內容.
                #$conf["additionSessionValue"]=array("");       
                        
                #如果有設置要另外設置的seesion變數
                if(isset($conf["additionSessionName"]) && isset($conf["additionSessionValue"])){
                        
                        #函式說明:
                        #建立多個session變數
                        #回傳結果:
                        #$result["status"],執行狀態,"true"代表執行成功；"false"代表執行失敗.
                        #$reuslt["function"],當前執行的函數.
                        #$result["error"],錯誤訊息陣列.
                        #必填參數:
                        #$conf["session.createMulti"]["sessionArrayName"],字串陣列,要建立的session陣列變數名稱，建議可採用name1.name2.name3的格式。
                        $conf["session.createMulti"]["sessionArrayName"]=$conf["additionSessionName"];
                        #$conf["session.createMulti"]["sessionArrayValue"],字串陣列,session變數的內容要存放什麼呢？
                        $conf["session.createMulti"]["sessionArrayValue"]=$conf["additionSessionValue"];
                        #可省略參數:
                        #無
                        $additionSessionCreateResult=session::createMulti($conf["session.createMulti"]);
                        unset($conf["session.createMulti"]);
                        
                        #如果建立session變數失敗
                        if($additionSessionCreateResult["status"]=="false"){
                                
                                #設置錯誤
                                $result["status"]="false";
                                
                                #設置錯誤訊息
                                $result["error"]=$additionSessionCreateResult;
                                
                                #回傳結果
                                return $result;
                                
                                }#if end
                        
                        }#if end        
                        
                #初始化要轉存成session的表單變數內容
                $formToSessionVarValue=array();
                
                #針對每個要接收的變數
                for($i=0;$i<count($conf["receivedVarName"]);$i++){
                        
                        #取得要轉存成session變數的數值
                        $formToSessionVarValue[]=$receiveVar["inputDataContent"][$conf["receivedVarName"][$i]];
                        
                        }#for end
                        
                #設置session變數並轉址
                #函式說明:
                #設定session變數後,立即轉址.
                #回傳的結果:
                #$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
                #$result["error"],錯誤訊息陣列.
                #必填參數:
                #$conf["headerLocation"],為要轉址到的地方,若爲 $_SERVER["PHP_SELF"]，則爲回到目前頁面,全民資安素養網爲 https://isafe.moe.edu.tw/.
                $conf["header.redirectionNow"]["headerLocation"]=$conf["redirectionTo"];
                #可省略參數:
                #$conf["header.redirectionNow"]["sessionName"],字串陣列,可以指派session變數的名稱.
                $conf["header.redirectionNow"]["sessionName"]=$conf["sessionName"];
                #$conf["header.redirectionNow"]["sessionValue"]字串陣列,可以指派session變數的內容.
                $conf["header.redirectionNow"]["sessionValue"]=$formToSessionVarValue;
                #參靠資料來源:
                #http://php.net/manual/en/reserved.variables.server.php
                $redirectionResult=header::redirectionNow($conf["header.redirectionNow"]);
                unset($conf["header.redirectionNow"]);
                
                #如果轉址失敗
                if($redirectionResult["status"]=="false"){
                        
                        #設置錯誤
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$redirectionResult;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #執行到這邊代表執行不正常
                $result["status"]="false";
                
                #設置錯誤訊息
                $result["error"][]="不可預期的錯誤";
                
                #回傳結果
                return $result;
                
                }#function formVarToSessionThenRedirection end
        
        /*
        #函式說明:
        #取得apache接收到的header
        #回傳結果:
        #$result["status"],執行成功與否,"true"代表成功,"false"代表失敗.
        #$result["content"],取得的header陣列.
        #$result["function"],當前執行的函數名稱.
        #必填參數:
        #無
        #可省略參數:
        #無 
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function getReceivedHeaders(){
                
                #設置要回傳的結果
                $result=array();
                
                #設置當前執行的函數
                $result["function"]=__FUNCTION__;
                
                #存放 header 的變數
                $result["content"]=array();
                
                #fix centos8 stream with php56
                #如果沒有 apache_request_headers 函式
                if(!function_exists("apache_request_headers"))
                {
                        #針對每個 $_SERVER 變數
                        foreach($_SERVER as $name => $val)
                        {
                                #設置關鍵字
                                $keyWord="HTTP";
                        
                                #如果 key 是 HTTP 開頭
                                if(strpos($name,$keyWord)===0)
                                {                               
                                        #將 HTTP 開頭字串剔除
                                        #函式說明:
                                        #將字串特定關鍵字與其前面的內容剔除
                                        #回傳結果:
                                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                                        #$result["error"],錯誤訊息陣列.
                                        #$result["warning"],警告訊息鎮列.
                                        #$result["founded"],有無找到定字串"true"代表有,"false"代表沒有.
                                        #$result["function"],當前執行的函數名稱.
                                        #$result["oriStr"],要處理的原始字串內容.
                                        #$result["content"],處理好的的字串內容.        
                                        #必填參數:
                                        #$conf["stringIn"],字串,要處理的字串.
                                        $conf["stringProcess::delStrBeforeKeyWord"]["stringIn"]=$name;
                                        #$conf["keyWord"],字串,特定字串.
                                        $conf["stringProcess::delStrBeforeKeyWord"]["keyWord"]=$keyWord;
                                        $delStrBeforeKeyWord=stringProcess::delStrBeforeKeyWord($conf["stringProcess::delStrBeforeKeyWord"]);
                                        unset($conf["stringProcess::delStrBeforeKeyWord"]);
                                
                                        #如果處理失敗
                                        if($delStrBeforeKeyWord["status"]==="false")
                                        {
                                        
                                                #執行到這邊代表執行不正常
                                                $result["status"]="false";
                                                
                                                #設置錯誤訊息
                                                $result["error"]=$delStrBeforeKeyWord;
                                                
                                                #回傳結果
                                                return $result;
                                        
                                        }#if end
                                        
                                        #取得 header
                                        $result["content"][$delStrBeforeKeyWord["content"]]=$val;
                                
                                }#if end
                        
                        }#foreach end
                
                }#if end
                
                else
                {
                
                        #取得 header
                        $result["content"]=@apache_request_headers();
                
                }#else end
                
                #如果取得 header 失敗
                if($result["content"]===FALSE){
                        
                        #執行到這邊代表執行不正常
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"][]="不可預期的錯誤";
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #執行到這邊代表執行正常
                $result["status"]="true";
                
                #回傳結果
                return $result;
                
                }#function getReceivedHeaders end
                
        /*
        #函式說明:
        #依根接收到的表單變數內容,轉址到特定地方.
        #回傳結果:
        #$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
        #$result["function"],當前執行的函數名稱.
        #$result["error"],錯誤訊息陣列.
        #必填參數:
        #$conf["varName"],字串,要接收到的變數名稱為何.
        $conf["varName"]="";
        #$conf["condition"],字串陣列,接收到的變數內容為什麼,則轉址到headerLocation對應的元素.
        $conf["condition"]=array();
        #$conf["headerLocation"],字串陣列,為要轉址到的地方,若爲 $_SERVER["PHP_SELF"]，則爲回到目前頁面,全民資安素養網爲 https://isafe.moe.edu.tw/.
        $conf["headerLocation"]=array("");
        #可省略參數:
        #$conf["limitPrePage"],字串陣列,是否要限定前一頁的網址為哪些，才能接收內容，不符合則轉址.
        #$conf["limitPrePage"]=array("");
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function transferByFormVar(&$conf=array()){
                
                #初始化要回傳的結果
                $result=array();

                #取得當前執行的函數名稱
                $result["function"]=__FUNCTION__;

                #如果沒有參數
                if(func_num_args()==0){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"]="函數".$result["function"]."需要參數";
                        
                        #回傳結果
                        return $result;
                        
                        }#if end

                #取得參數
                $result["argu"]=$conf;

                #如果 $conf 不為陣列
                if(gettype($conf)!=="array"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"][]="\$conf變數須為陣列形態";
                        
                        #如果傳入的參數為 null
                        if($conf===null){
                                
                                #設置執行錯誤訊息
                                $result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
                                
                                }#if end

                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #檢查參數
                #函式說明：
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息
                #必填寫的參數：
                #$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("varName","condition","headerLocation");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","array","array");
                #$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"]="true";
                #$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("limitPrePage");
                #$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null);
                #$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array();
                $checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);
                
                #如果檢查失敗
                if($checkResult["status"]=="false"){
                        
                        #設置執行不正常
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$checkResult;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #如果檢查不通過
                if($checkResult["passed"]=="false"){
                        
                        #設置執行不正常
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$checkResult;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #函式說明:
                #可以處理多個透過GET、POST而來的資訊，儲存成變數，同時限定傳送的方法、來源，來增加安全性，檢查有沒有皆收到必須要接收到的變數,沒有接收到的變數可以指定從session變數中取得.
                #回傳的結果：
                #$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
                #$result["error"],錯誤訊息陣列.
                #$resutl["function"],當前執行的涵式名稱.
                #$result["warning"],警告訊息陣列.
                #$result["passed"],是否有皆收到全部該接收到的變數，若有設定$conf["checkedVarName"]的話，執行正常後會回傳該結果。
                #$result["lostVarName"],沒有皆收到的變數名稱陣列
                #$result["inputDataContent"],所接收的參數陣列.
                #$result["inputDataContent"]["變數名稱"]，所接收變數的內容.
                #$result["inputDataCount"],從表單總共接收到幾個元素.
                #$result["HTTP_REFERER"],前一頁的網址,null代表不存在.
                #必填參數:
                #$conf["method"],字串,傳送過來的資料是用"post/POST"還是"get/GET"?
                $conf["form::responseMultiInputDataSecurityEnhance"]["method"]="post";
                #可省略的參數：
                #$conf["allowGet"],字串,是否要允許 get 傳值，"true"，代表允許；"false" ，代表不允許，預設爲不允許.
                #$conf["allowGet"]="true";
                
                #如果有設置 limitPrePage
                if(isset($conf["limitPrePage"])){
                        
                        #$conf["limitPrePage"],字串陣列,是否要限定前一頁的網址為哪些，才能接收內容，不符合則轉址.
                        $conf["form::responseMultiInputDataSecurityEnhance"]["limitPrePage"]=$conf["limitPrePage"];
                        
                        }#if end
                
                #$conf["transferLocation"],字串,遇到get傳值，或前一個頁面不符合要求時要轉址到的頁面，預設爲資安素養網"https://isafe.moe.edu.tw/"
                #$conf["transferLocation"]="";
                #$conf["ignore"]=字串陣列,如果要接收的變數名稱與該陣列其一元素一樣,則不放進要回傳的變數裏面.
                #$conf["ignore"]=array();
                #$conf["correctCharacter"]=,字串,如果爲"false"，則不處理可能導致網頁出問題的字串，預設爲要進行處理.
                #$conf["correctCharacter"]="false";
                #$conf["checkedVarName"],字串陣列,為檢查是否有接收到哪些變數.
                $conf["form::responseMultiInputDataSecurityEnhance"]["checkedVarName"]=array($conf["varName"]); 
                #$conf["canBeEmptyString"],字串,用$conf["checkedVarName"]指定接收的變數名稱陣列,若接收到的內容為空字串是否算有接收到內容,預設為"false","true"代表接收到的內容可以為空字串,"false"代表接收到的內容不可以為空字串.      
                #$conf["canBeEmptyString"]="false";
                #$conf["sessionNameArray"],陣列,若存在則代表若沒有從表單取得變數,則從session變數中取得內容,每個元素代表每個表單變數對應的session名稱,若不是要改用session方式取得變數內容的變數,請輸入null,數量請跟$conf["checkedVarName"]參數一致.
                #$conf["sessionNameArray"]=array();
                #$conf["unsetSessionArray"],陣列,與$conf["sessionNameArray"]對應的元素,是否要接收到變數後就卸除,"true"代表要卸除,"false"代表不要卸除.
                #$conf["unsetSessionArray"]=array();
                #參考資料來源：
                #foreach 的用法 -> http://php.net/manual/en/control-structures.foreach.php
                #伺服器端的變數 -> http://php.net/manual/en/reserved.variables.server.php
                #備註：
                #表單變數的名稱若含有「.」，則會變成「-」。
                $responseMultiInputDataSecurityEnhance=form::responseMultiInputDataSecurityEnhance($conf["form::responseMultiInputDataSecurityEnhance"]);
                unset($conf["form::responseMultiInputDataSecurityEnhance"]);
                
                #如果接收表單變數失敗
                if($responseMultiInputDataSecurityEnhance["status"]==="false"){
                        
                        #執行到這邊代表執行不正常
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$responseMultiInputDataSecurityEnhance;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #如果接收表單變數不通過
                if($responseMultiInputDataSecurityEnhance["passed"]==="false"){
                        
                        #執行到這邊代表執行不正常
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$responseMultiInputDataSecurityEnhance;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #依照每個 condition
                for($i=0;$i<count($conf["condition"]);$i++){
                        
                        #如果接收到的表單變數對應到 condition 元素
                        if($responseMultiInputDataSecurityEnhance["inputDataContent"][$conf["varName"]]===$conf["condition"][$i]){
                                
                                #轉址到對應的地方
                                #函式說明:
                                #設定session變數後,立即轉址.
                                #回傳的結果:
                                #$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
                                #$result["function"],當前執行的函數名稱.
                                #$result["error"],錯誤訊息陣列.
                                #必填參數:
                                #$conf["headerLocation"],為要轉址到的地方,若爲 $_SERVER["PHP_SELF"]，則爲回到目前頁面,全民資安素養網爲 https://isafe.moe.edu.tw/.
                                $conf["header::redirectionNow"]["headerLocation"]=$conf["headerLocation"][$i];
                                #可省略參數:
                                #$conf["sessionName"],字串陣列,可以指派session變數的名稱.
                                #$conf["sessionName"]=array("");
                                #$conf["sessionValue"]字串陣列,可以指派session變數的內容.
                                #$conf["sessionValue"]=array("");
                                #參靠資料來源:
                                #http://php.net/manual/en/reserved.variables.server.php
                                $redirectionNow=header::redirectionNow($conf["header::redirectionNow"]);
                                unset($conf["header::redirectionNow"]);
                                
                                #如果轉址失敗
                                if($redirectionNow["status"]==="false"){
                                        
                                        #執行到這邊代表執行不正常
                                        $result["status"]="false";
                                        
                                        #設置錯誤訊息
                                        $result["error"]=$redirectionNow;
                                        
                                        #回傳結果
                                        return $result;
                                        
                                        }#if end
                                        
                                #設置執行正常
                                $result["status"]="true";
                                
                                #回傳結果
                                return $result;
                                
                                }#if end
                        
                        }#for end
                
                #停止執行
                exit;           
                
                }#function transferByFormVar end
        
        /*
        #函式說明:
        #設置header的函式
        #回傳結果:
        #$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
        #$result["function"],當前執行的函數名稱.
        #$result["error"],錯誤訊息陣列.
        #$result["content"],回傳結果.
        #$result["content"]["http_response_code"],整數,http response code.
        #$result["content"]["header"],陣列,要送出的header清單.
        #必填參數:
        #$conf["header"],陣列變數,key代表要設置的header的名稱,value代表header的數值.
        $conf["header"]=array();
        #可省略參數:
        #$conf["clearFirst"],字串變數,"true"代表要清空header再處理,"false"代表直接增加header,預設為"false".
        #$conf["clearFirst"]="true";
        #$conf["statusCode"],整數,若有則代表要指定header status code,反之不用.常用的有200(ok),404(頁面找不到),500(內部錯誤)
        #$conf["statusCode"]=200;
        #參考資料:
        #https://www.php.net/manual/en/function.header-remove.php
        #https://www.php.net/manual/en/function.http-response-code.php
        #備註:
        #無.
        */
        public static function set(&$conf){

                #初始化要回傳的結果
                $result=array();

                #取得當前執行的函數名稱
                $result["function"]=__FUNCTION__;

                #如果沒有參數
                if(func_num_args()==0){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"]="函數".$result["function"]."需要參數";
                        
                        #回傳結果
                        return $result;
                        
                        }#if end

                #取得參數
                $result["argu"]=$conf;

                #如果 $conf 不為陣列
                if(gettype($conf)!=="array"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"][]="\$conf變數須為陣列形態";
                        
                        #如果傳入的參數為 null
                        if($conf===null){
                                
                                #設置執行錯誤訊息
                                $result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
                                
                                }#if end

                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #檢查參數
                #函式說明:
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$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("header");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("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["variableCheck::checkArguments"]["skipableVariableName"]=array("clearFirst","statusCode");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","integer");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("false",200);
                #$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 $result;
                        
                        }#if end
                        
                #如果檢查不通過
                if($checkArguments["passed"]=="false"){
                        
                        #設置執行不正常
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$checkArguments;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #如果要先清除掉 header
                if($conf["clearFirst"]==="true"){
                
                        #移除所有 header
                        header_remove();
                
                        }#if end
                
                #針對每個要設置的 header
                foreach($conf["header"] as $name => $value){
                
                        #將 $name 中的空格變更為 "-"
                        #函式說明:
                        #處理字串避免網頁出錯
                        #回傳的結果：
                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                        #$result["function"],當前執行的函數.
                        #$result["content"],爲處理好的字串.
                        #$result["error"],錯誤訊息陣列.
                        #$result["argu"],使用的參數. 
                        #必填參數:
                        $conf["stringProcess::correctCharacter"]["stringIn"]=$name;#爲要處理的字串
                        #可省略參數:
                        #$conf["selectedCharacter"]=array("");#爲被選擇要處理的字串/字元，須爲陣列值。
                                #若不設定則預設爲要將這些字串作替換 ("<",">","=","//","'","$","%","&","|","/*","*","#","\"").
                                #特殊字元，「\n」代表換行，「\t」代表tab鍵的間隔
                        #$conf["changeTo"]=array();#爲被選擇的字元要換成什麼字串/字元，須爲陣列值。若不設定，則預設爲更換成""(空字串).
                        #備註:
                        #無.
                        $correctCharacter=stringProcess::correctCharacter($conf["stringProcess::correctCharacter"]);
                        unset($conf["stringProcess::correctCharacter"]);
                
                        #如果檢查失敗
                        if($correctCharacter["status"]=="false"){
                                
                                #設置執行不正常
                                $result["status"]="false";
                                
                                #設置錯誤訊息
                                $result["error"]=$correctCharacter;
                                
                                #回傳結果
                                return $result;
                                
                                }#if end
                
                        #取得處理好的name
                        $name=$correctCharacter["content"];
                
                        #設置header
                        header($name.": ".$value);
                
                        }#foreach end
        
                #設置 staus code
                http_response_code($conf["statusCode"]);
        
                #設置執行正常
                $result["status"]="true";
                
                #初始化執行回應
                $result["content"]=array();
                
                #取得設置好的header清單
                $result["content"]["header"]=headers_list();
                
                #設置回應的http response code humber
                $result["content"]["http_response_code"]=http_response_code();
        
                #回傳結果
                return $result;
        
                }#function set end
        
        /*
        #函式說明:
        #依照OPTIONS的要求，判斷條件，給予允許呼叫的header,預設是全允許.
        #回傳結果:
        #$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
        #$result["function"],當前執行的函數名稱.
        #$result["error"],錯誤訊息陣列.
        #$result["content"],回傳結果.
        #$result["content"]["receivedHeader"],陣列,收到的header
        #$result["content"]["sendedHeader"],陣列,要送出的header.
        #必填參數:
        #無
        #可省略參數:
        #$conf["allowDomain"],陣列變數,代表允許的來源domain name.
        #$conf["allowDomain"]=array();
        #$conf["allowMethod"],陣列變數,代表允許的要求方法.
        #$conf["allowMethod"]=array();
        #$conf["allowHeader"],陣列變數,代表要允許的header.
        #$conf["allowHeader"]=array();
        #參考資料:
        #https://www.php.net/manual/en/function.header-remove.php
        #https://www.php.net/manual/en/function.http-response-code.php
        #備註:
        #無.
        */
        public static function accessControl(&$conf){
                
                #初始化要回傳的結果
                $result=array();

                #取得當前執行的函數名稱
                $result["function"]=__FUNCTION__;

                #取得參數
                $result["argu"]=$conf;

                #如果 $conf 不為陣列
                if(gettype($conf)!="array"){

                        #設置執行失敗
                        $result["status"]="false";

                        #設置執行錯誤訊息
                        $result["error"][]="\$conf變數須為陣列形態";

                        #如果傳入的參數為 null
                        if(is_null($conf)){

                                #設置執行錯誤訊息
                                $result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";

                                }#if 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["mustBeFilledVariableName"]=array();
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                #$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["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("allowDomain","allowMethod","allowHeader");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("allowDomain","allowMethod","allowHeader");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","array","array");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(array("*"),array("*"),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=array();
                        
                        #設置執行正常
                        $result["status"]="false";
                        
                        #設置未執行的結果
                        $result["error"]=$checkArguments;
                        
                        #回傳結果
                        return $result;
                
                        }#if end
                        
                #如果檢查參數不通過
                if($checkArguments["passed"]==="false"){
                
                        #初始化結果
                        $result=array();
                        
                        #設置執行正常
                        $result["status"]="false";
                        
                        #設置未執行的結果
                        $result["error"]=$checkArguments;
                        
                        #回傳結果
                        return $result;
                
                        }#if end
                
                /*
                #函式說明:
                #取得apache接收到的header
                #回傳結果:
                #$result["status"],執行成功與否,"true"代表成功,"false"代表失敗.
                #$result["content"],取得的header陣列.
                #$result["function"],當前執行的函數名稱.
                #必填參數:
                #無
                #可省略參數:
                #無 
                */
                $getReceivedHeaders=header::getReceivedHeaders();

                #如果取得Header失敗
                if($getReceivedHeaders["status"]==="false"){
                
                        #初始化結果
                        $result=array();
                        
                        #設置執行正常
                        $result["status"]="false";
                        
                        #設置未執行的結果
                        $result["error"]=$getReceivedHeaders;
                        
                        #回傳結果
                        return $result;
                
                        }#if end
                        
                #取得接收到header
                $result["content"]["receivedHeader"]=$getReceivedHeaders["content"];
                
                #如果沒有必備的 Origin header
                if(!isset($getReceivedHeaders["content"]["Origin"]))
                {
                        #設置允許所有Origin
                        $conf["allowDomain"]=array("*");
                
                }#if end
                
                #如果不是允許所有Origin
                if($conf["allowDomain"]!==array("*"))
                {
                        #涵式說明:
                        #檢查一個數值是否與陣列裏面的元素相同,找到一個相符合的元素後就會停止搜尋.
                        #回傳的結果:
                        #$result["status"],"true"表示執行正確，"false"表示執行錯誤.
                        #$result["founded"],"true"表示有找到相同的，"false"表示沒有找到相同的.
                        #$result["error"],錯誤訊息
                        #$result["function"],當前執行的函數名稱
                        #$result["argv"],使用的參數
                        #$result["equalVarName"],相等的變數名稱或key.
                        #$result["equalVarValue"],相等的變數數值內容.
                        #必填參數:
                        $conf["search::getEqualVar"]["conditionElement"]=$getReceivedHeaders["content"]["Origin"];#條件元素，要等於的元素內容.
                        $conf["search::getEqualVar"]["compareElements"]=$conf["allowDomain"];#要比對的陣列變數內容.
                        $getEqualVar=search::getEqualVar($conf["search::getEqualVar"]);
                        unset($conf["search::getEqualVar"]);

                        #如果檢查失敗
                        if($getEqualVar["status"]==="false")
                        {
                                #初始化結果
                                $result=array();
                                
                                #設置執行正常
                                $result["status"]="false";
                                
                                #設置未執行的結果
                                $result["error"]=$getEqualVar;
                                
                                #回傳結果
                                return $result;
                        
                        }#if end

                        #如果沒有符合的項目
                        if($getEqualVar["founded"]==="false")
                        {
                                #初始化結果
                                $result=array();
                                
                                #設置執行正常
                                $result["status"]="false";
                                
                                #設置未執行的結果
                                $result["error"]=$getEqualVar;
                                
                                #回傳結果
                                return $result;
                        
                        }#if end

                        #設置要允許的Origin
                        $allowDomainString=$getEqualVar["equalVarValue"];
                
                }#if end

                #反之
                else
                {
                        #設置為 "*"
                        $allowDomainString=$conf["allowDomain"][0];
                }
                
                #將陣列轉變成字串
                #函式說明:
                #將一維陣列轉換為用特定符號間隔的字串,ex:array("1","2","3") to "a;b;c;".
                #回傳的結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["function"],當前執行的function名稱
                #$result["error"],錯誤訊息陣列.
                #$result["content"],處理好的字串.
                #$result["argu"],使用的參數.
                #必填參數:
                #$conf["inputArray"],字串陣列,要轉成字串的一維陣列.
                $conf["arrays::arrayToString"]["inputArray"]=$conf["allowMethod"];
                #可省略參數:
                #$conf["spiltSymbol"],字串,用來區隔字串的符號,預設為;
                $conf["arrays::arrayToString"]["spiltSymbol"]=", ";
                #$conf["skipEnd"],字串,結尾是否不要加上符號,預設為"false",要加上符號,"true"代表不要加上符號。
                $conf["arrays::arrayToString"]["skipEnd"]="true";
                #備註:
                #無.
                $arrayToString=arrays::arrayToString($conf["arrays::arrayToString"]);
                unset($conf["arrays::arrayToString"]);

                #如果取得Header失敗
                if($arrayToString["status"]==="false"){
                
                        #初始化結果
                        $result=array();
                        
                        #設置執行正常
                        $result["status"]="false";
                        
                        #設置未執行的結果
                        $result["error"]=$arrayToString;
                        
                        #回傳結果
                        return $result;
                
                        }#if end
                
                #取得允許的domain name字串
                $allowMethodString=$arrayToString["content"];

                #將陣列轉變成字串
                #函式說明:
                #將一維陣列轉換為用特定符號間隔的字串,ex:array("1","2","3") to "a;b;c;".
                #回傳的結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["function"],當前執行的function名稱
                #$result["error"],錯誤訊息陣列.
                #$result["content"],處理好的字串.
                #$result["argu"],使用的參數.
                #必填參數:
                #$conf["inputArray"],字串陣列,要轉成字串的一維陣列.
                $conf["arrays::arrayToString"]["inputArray"]=$conf["allowHeader"];
                #可省略參數:
                #$conf["spiltSymbol"],字串,用來區隔字串的符號,預設為;
                $conf["arrays::arrayToString"]["spiltSymbol"]=", ";
                #$conf["skipEnd"],字串,結尾是否不要加上符號,預設為"false",要加上符號,"true"代表不要加上符號。
                $conf["arrays::arrayToString"]["skipEnd"]="true";
                #備註:
                #無.
                $arrayToString=arrays::arrayToString($conf["arrays::arrayToString"]);
                unset($conf["arrays::arrayToString"]);

                #如果取得Header失敗
                if($arrayToString["status"]==="false"){
                
                        #初始化結果
                        $result=array();
                        
                        #設置執行正常
                        $result["status"]="false";
                        
                        #設置未執行的結果
                        $result["error"]=$arrayToString;
                        
                        #回傳結果
                        return $result;
                
                        }#if end
                
                #取得允許的domain name字串
                $allowHeaderString=$arrayToString["content"];

                #設置header
                #函式說明:
                #設置header的函式
                #回傳結果:
                #$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
                #$result["function"],當前執行的函數名稱.
                #$result["error"],錯誤訊息陣列.
                #$result["content"],回傳結果.
                #$result["content"]["http_response_code"],整數,http response code.
                #$result["content"]["header"],陣列,要送出的header清單.
                #必填參數:
                #$conf["header"],陣列變數,key代表要設置的header的名稱,value代表header的數值.
                $conf["header::set"]["header"]["Access-Control-Allow-Origin"]=$allowDomainString;
                $conf["header::set"]["header"]["Access-Control-Allow-Methods"]=$allowMethodString;
                $conf["header::set"]["header"]["Access-Control-Allow-Headers"]=$allowHeaderString;
                #可省略參數:
                #$conf["clearFirst"],字串變數,"true"代表要清空header再處理,"false"代表直接增加header,預設為"false".
                #$conf["clearFirst"]="true";
                #$conf["statusCode"],整數,若有則代表要指定header status code,反之不用.常用的有200(ok),404(頁面找不到),500(內部錯誤)
                #$conf["statusCode"]=200;
                #參考資料:
                #https://www.php.net/manual/en/function.header-remove.php
                #https://www.php.net/manual/en/function.http-response-code.php
                #備註:
                #無.
                $set=header::set($conf["header::set"]);
                unset($conf["header::set"]);

                #如果設置Header失敗
                if($set["status"]==="false"){
                
                        #初始化結果
                        $result=array();
                        
                        #設置執行正常
                        $result["status"]="false";
                        
                        #設置未執行的結果
                        $result["error"]=$set;
                        
                        #回傳結果
                        return $result;
                
                        }#if end
                
                #函式說明:
                #撰寫log
                #回傳結果:
                #$result["status"],狀態,"true"或"false".
                #$result["error"],錯誤訊息陣列.
                #$result["function"],當前函式的名稱.
                #$result["argu"],使用的參數.
                #必填參數:
                #$conf["path"],log檔案的路徑與名稱.
                $conf["logs::record"]["path"]="/var/www/html/log/log.txt";
                #$conf["content"],字串,要寫的內容.
                $conf["logs::record"]["content"]=PHP_EOL.json_encode($set).PHP_EOL;
                #$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
                $conf["logs::record"]["fileArgu"]=__FILE__;
                #可省略參數:
                #$conf["rewrite"],預設為"false",接續寫入;反之"true"代表重新寫入.
                #$conf["rewrite"]="true";
                $record=logs::record($conf["logs::record"]);
                unset($conf["logs::record"]);
                
                #取得要傳送的header       
                $result["content"]["sendedHeader"]=$set["content"]["header"];

                #設置執行正常
                $result["status"]="true";
                
                #回傳結果
                return $result;

                }#function accessControl end
        
        }#clsss header end

?>