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;

/*
類別說明:
跟 PHP session 應用相關的類別.
備註:
無.
*/
class session{
        
        /*
        #函式說明:
        #當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$reuslt["error"],執行不正常結束的錯訊息陣列.
        #$result["function"],當前執行的函式名稱.
        #必填參數:
        #$method,物件,為物件實體或類別名稱,會自動置入該參數.
        #$arguments,陣列,為呼叫方法時所用的參數.
        #可省略參數:
        #無.
        #參考資料:
        #__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
        #備註:
        #無.
        */
        public function __call($method,$arguments){
                
                #取得當前執行的函式
                $result["function"]=__FUNCTION__;
                
                #設置執行不正常
                $result["status"]="false";
                
                #設置執行錯誤
                $result["error"][]=__NAMESPACE__ ."/".$method."() 不存在!";
                
                #設置所丟入的參數
                $result["error"][]=$arguments;
                
                #回傳結果
                return $result;
                
                }#function __call end
                
        /*
        #函式說明:
        #當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$reuslt["error"],執行不正常結束的錯訊息陣列.
        #$result["function"],當前執行的函式名稱.
        #必填參數:
        #$method,物件,為物件實體或類別名稱,會自動置入該參數.
        #$arguments,陣列,為呼叫方法時所用的參數.
        #可省略參數:
        #無.
        #參考資料:
        #__callStatic=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
        #備註:
        #無.
        */
        public static function __callStatic($method,$arguments){
                
                #取得當前執行的函式
                $result["function"]=__FUNCTION__;
                
                #設置執行不正常
                $result["status"]="false";
                
                #設置執行錯誤
                $result["error"][]="欲呼叫的". __NAMESPACE__ ."/".$method."() 不存在!";
                
                #設置所丟入的參數
                $result["error"][]=$arguments;
                
                #回傳結果
                return $result;
                
                }#function __callStatic end
        
        /*
        #函式說明:
        #取得session變數裡面的數值，然後卸除該session變數
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
        #$result["error"],錯誤訊息.
        #$result["founded"],是否找到session變數,"true"代表找到,"false"代表沒找到.
        #$result["content"],取得的變數內容.
        #$result["function"],當前執行的函數名稱.
        #必填參數:
        #$conf["sessionVarName"],字串,要取得內容的session變數名稱
        $conf["sessionVarName"]="";
        #可省略參數:
        #$conf["unsetSessionVar"],字串,代表要卸除session變數,預設為"false"不卸除,"true"代表要卸除.
        #$conf["unsetSessionVar"]="true";
        #$conf["autoCreate"],字串,是否要自動建立該 session 變數,"true"代表要,預設為"false"代表不要.
        #$conf["autoCreate"]="true";
        #$conf["initVal"],字串,"autoCreate"參數為"true"時,要給予的初始內容,預設為"".
        #$conf["initVal"]="";
        #參考資料：
        #call-time-pass-by-reference-easy-fix-available=>http://stackoverflow.com/questions/8971261/php-5-4-call-time-pass-by-reference-easy-fix-available
        #可變變數=>http://emn178.pixnet.net/blog/post/80119035-php%E6%95%99%E5%AD%B8---%E8%AE%8A%E6%95%B8%28variables%29
        #卸除參考的原始變數=>http://stackoverflow.com/questions/6654538/php-function-to-unset-variables-passed-by-reference
        #備註:
        #無.
        */
        public static function getSessionValue(&$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"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sessionVarName");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
                #$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["canBeEmptyString"]="false";
                #$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("unsetSessionVar","autoCreate","initVal");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","any");
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("false","false",null);
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("sessionArrayName","sessionArrayValue");
                #參考資料來源:
                #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        
                        
                #確認該session變數是否存在
                if(!isset($_SESSION[$conf["sessionVarName"]])){

                        #設置執行正常
                        $result["status"]="true";

                        #設置沒有找到session變數
                        $result["founded"]="false";

                        #如果要自動建立該 session 變數
                        if($conf["autoCreate"]==="true"){
                        
                                #函式說明:
                                #建立session變數，並指派其內容
                                #回傳結果:
                                #$result["status"],執行狀態，"true"代表執行成功；"false"代表執行失敗.
                                #$result["error"],錯誤訊息陣列.
                                #$result["function"],當前執行的函數名稱.
                                #必填參數:
                                #$conf["sessionName"],字串,要建立的session變數名稱，建議可採用name1.name2.name3的格式.
                                $conf["session::create"]["sessionName"]=$conf["sessionVarName"];
                                #可省略參數: 
                                
                                #如果有設置 $conf["initVal"]
                                if(isset($conf["initVal"])){
                                
                                        #$conf["sessionValue"],字串,session變數的內容，預設為"".
                                        $conf["session::create"]["sessionValue"]=$conf["initVal"];
                                
                                        }#if end
                                
                                $create=session::create($conf["session::create"]);
                                unset($conf["session::create"]);
                        
                                #遞迴執行
                                return session::getSessionValue($conf);
                        
                                }#if end

                        #回傳結果
                        return $result;

                        }#if end

                #取得session變數的內容
                $result["content"]=$_SESSION[$conf["sessionVarName"]];
        
                #設置有找到session變數
                $result["founded"]="true";

                #如果 $conf["unsetSessionVar"] 為 "true"
                if($conf["unsetSessionVar"]=="true"){
                                
                        #移除session變數的內容
                        unset($_SESSION[$conf["sessionVarName"]]);
                                                                
                        }#if end
                                                
                #設置執行正常
                $result["status"]="true";

                #回傳結果
                return $result; 
                        
                }#function getSessionValue end
        
        /*
        #函式說明:
        #取得多個指定的session變數,卸除之.
        #回傳結果:
        #$result["status"]，執行狀態，"true"代表執行成功；"false"代表執行失敗。
        #$result["error"]，錯誤訊息陣列
        #$result["function"],當前執行的函式名稱.
        #$result["foundedAll"],是否找到所有的session變數,"true"代表找到,"false"代表沒找到.
        #$result["founded"],每個session變數是否取得，"true"代表找到,"false"代表沒找到.
        #$result["content"],取得的session變數內容陣列
        #必填參數:
        #$conf["sessionVarNameArray"],字串陣列,要取得內容的多個session變數名稱
        $conf["sessionVarNameArray"]=array();
        #可省略參數:
        #$conf["keyArrayOfGotSessionValue"],字串陣列,取得的session變數是否要將其key從「0,1,2...」改成自定的「名稱1,名稱2,名稱3...」.
        #$conf["keyArrayOfGotSessionValue"]=array();
        #$conf["unsetSessionVars"],字串,"true"代表要卸除取值完的session變數,反之"false"爲保留session變數,預設爲"true".
        #$conf["unsetSessionVars"]="true";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function getMultiSessionValues(&$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"]=array();
                
                #檢查參數
                #函式說明:
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息
                #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
                #$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
                #$result["notNeedVar"],字串陣列,多餘的參數名稱.
                #必填寫的參數：
                #$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sessionVarNameArray");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");
                #$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["canBeEmptyString"]="false";
                #$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("keyArrayOfGotSessionValue","unsetSessionVars");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","string");
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,"true");
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("sessionArrayName","sessionArrayValue");
                #參考資料來源:
                #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
                                        
                #有幾個session變數要接收就執行幾次
                for($i=0;$i<count($conf["sessionVarNameArray"]);$i++){
                        
                        #函式說明:
                        #取得session變數裡面的數值，然後卸除該session變數
                        #回傳結果:
                        #$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
                        #$result["error"],錯誤訊息
                        #$result["founded"],是否找到session變數,"true"代表找到,"false"代表沒找到.
                        #$result["content"],取得的變數內容
                        #必填參數:
                        $conf["session.getSessionValue"]["sessionVarName"]=$conf["sessionVarNameArray"][$i];#要取得內容的session變數名稱
                        #可省略參數:
                        $conf["session.getSessionValue"]["unsetSessionVar"]=$conf["unsetSessionVars"];#"true"代表要卸除session變數,預設不卸除
                        #參考資料：
                        #http://stackoverflow.com/questions/8971261/php-5-4-call-time-pass-by-reference-easy-fix-available
                        #可變變數->http://emn178.pixnet.net/blog/post/80119035-php%E6%95%99%E5%AD%B8---%E8%AE%8A%E6%95%B8%28variables%29
                        #卸除參考的原始變數->http://stackoverflow.com/questions/6654538/php-function-to-unset-variables-passed-by-reference
                        $getSessionValueResult=session::getSessionValue($conf["session.getSessionValue"]);
                        unset($conf["session.getSessionValue"]);
                        
                        #debug
                        #var_dump($getSessionValueResult);
                        
                        #如果取得session變數失敗
                        if($getSessionValueResult["status"]=="false"){
                                
                                #設置執行不正常
                                $result["status"]="false";
                                
                                #設置執行錯誤的訊息
                                $result["error"]=$checkResult;
                                
                                #回傳結果
                                return $result;
                                
                                }#if end
                                
                        #如果該session變數不存在
                        if($getSessionValueResult["founded"]=="false"){
                                
                                #設置該session變數不存在
                                $result["founded"][$i]="false";
                                
                                }#if end
                                
                        #反之session變數存在
                        else{
                                
                                #設置該session變數存在
                                $result["founded"][$i]="true";
                                
                                #取得session變數的內容
                                $result["content"][$i]=$getSessionValueResult["content"];
                                
                                }#else end
                        
                        }#for end
                
                #如果 $conf["keyArrayOfGotSessionValue"] 有設置
                if(isset($conf["keyArrayOfGotSessionValue"])){
                        
                        #如果 $conf["keyArrayOfGotSessionValue"] 與 $conf["sessionVarNameArray"] 的元素數量相等
                        if(count($conf["keyArrayOfGotSessionValue"])==count($conf["sessionVarNameArray"])){
                                
                                #$conf["keyArrayOfGotSessionValue"]有幾個元素就執行幾次
                                for($i=0;$i<count($conf["keyArrayOfGotSessionValue"]);$i++){
                                        
                                        #給與新key
                                        $result["founded"][$conf["keyArrayOfGotSessionValue"][$i]]=$result["founded"][$i];
                                        
                                        #如果存在session變數
                                        if(isset($result["content"][$i])){
                                        
                                                #給與新key
                                                $result["content"][$conf["keyArrayOfGotSessionValue"][$i]]=$result["content"][$i];
                                        
                                                #移除舊key的變數
                                                unset($result["content"][$i]);
                                        
                                                }#if end
                                        
                                        #移除舊key的變數
                                        unset($result["founded"][$i]);
                                                                                        
                                        }#for end 
                                                                        
                                }#if end
                                
                        #反之 $conf["keyArrayOfGotSessionValue"] 與 $conf["sessionVarNameArray"] 的元素數量不相等
                        else{
                                
                                #設置執行不正常
                                $result["status"]="false";
                                
                                #設置執行錯誤的訊息
                                $result["error"][]="\$conf[\"keyArrayOfGotSessionValue\"] 與 \$conf[\"sessionVarNameArray\"] 的元素數量不相等";
                                
                                #回傳結果
                                return $result;
                                
                                }#else end
                        
                        }#if end
                
                #如果有一個session變數沒找到
                foreach($result["founded"] as $value){
                        
                        #如果等於 "false"
                        if($value=="false"){
                                
                                #設置沒有每個session變數都抓到
                                $result["foundedAll"]="false";
                                
                                #跳出foreach
                                break;
                                
                                }#if end
                        
                        }#foreach end
                
                #如果 $result["foundedAll"] 沒有設置
                if(!isset($result["foundedAll"])){
                        
                        #設爲 "true"
                        $result["foundedAll"]="true";
                        
                        }#if end
                
                #設置執行結果爲正常
                $result["status"]="true";
                
                #回傳結果
                return $result;
                
                }#funtion getMultiSessionValues end
                
        /*
        #函式說明:
        #建立session變數，並指派其內容
        #回傳結果:
        #$result["status"],執行狀態，"true"代表執行成功；"false"代表執行失敗.
        #$result["error"],錯誤訊息陣列.
        #$result["argu"],使用的參數.
        #$result["function"],當前執行的函數名稱.
        #必填參數:
        #$conf["sessionName"],字串,要建立的session變數名稱，建議可採用name1.name2.name3的格式.
        $conf["sessionName"]="";
        #可省略參數: 
        #$conf["sessionValue"],字串,session變數的內容，預設為"".
        #$conf["sessionValue"]="";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function create(&$conf){
                
                #初始化要回傳的變數
                $result=array();
                
                #儲存使用的參數
                $result["argu"]=$conf;
                
                #記錄當前執行的函數名稱
                $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"],每個參數設定的錯誤訊息
                #必填寫的參數：
                #$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sessionName");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["canBeEmptyString"]="false";
                #$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("sessionValue");
                #$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                #$conf["variableCheck::checkArguments"]["skipableVariableType"]=array();
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("");
                #$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
                        
                #建立session變數,並指派其直
                $_SESSION[$conf["sessionName"]]=$conf["sessionValue"];
                                        
                #設置執行成功的辨識訊息
                $result["status"]="true";
                
                #回傳結果
                return $result;
                
                }#function create end
        
        /*
        #函式說明:
        #記錄當前訪問的頁面,並且保存上一個訪問的頁面.
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
        #$result["error"],錯誤訊息.
        #$result["function"],當前執行的函數名稱.
        #$result["nowPosition"],現在瀏覽的路徑.
        #$result["prePosition"],上一個瀏覽的路徑.
        #$result["phpNowViewed"],當前瀏覽的檔案名稱.
        #$resutl["phpPreViewed"],上一個瀏覽的檔案名稱.
        #必填參數:
        #無.
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #當一個頁面有多個頁框時,會導致當前瀏覽的頁面與上一個瀏覽的頁面被複寫.
        */
        public static function getPreAndNowPosition(){

                #初始化要回傳的變數
                $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["function"]=__FUNCTION__;

                #如果 $_SESSION["session"]["getPreAndNowPosition"]["prePlace"] 不存在
                if(!isset($_SESSION["session"]["getPreAndNowPosition"]["prePlace"])){

                        #將之設為 ""
                        $_SESSION["session"]["getPreAndNowPosition"]["prePlace"]="";
                        
                        }#if end
                
                #如果 $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"] 存在
                if(isset($_SESSION["session"]["getPreAndNowPosition"]["nowPlace"])){
                        
                        #設置 $_SESSION["session"]["getPreAndNowPosition"]["prePlace"] 為 $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"]
                        $_SESSION["session"]["getPreAndNowPosition"]["prePlace"]=$_SESSION["session"]["getPreAndNowPosition"]["nowPlace"];
                                
                        #設置 $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"] 為 $_SERVER["PHP_SELF"]
                        $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"]=$_SERVER["PHP_SELF"];
                                
                        }#if end
                        
                #反之 $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"] 沒有設置
                else{
                
                        #將 $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"] 設為 $_SERVER["PHP_SELF"]
                        $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"]=$_SERVER["PHP_SELF"];
                
                        }#else end
                
                #記錄要回傳的內容
                
                #記錄當前瀏覽的目錄
                #函式說明:
                #將固定格式的字串分開，並回傳分開的結果。
                #回傳的參數:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["error"],錯誤訊息陣列
                #$result["function"],當前執行的函數名稱.
                #$result["oriStr"],要分割的原始字串內容
                #$result["dataArray"],爲分割好字串的陣列內容,$result["dataArray"][$i]爲第($i+1)段的內容。
                #$result["dataCounts"],爲總共分成幾段
                #必填參數:
                $conf["stringIn"]=$_SESSION["session"]["getPreAndNowPosition"]["nowPlace"];#要處理的字串。
                $conf["spiltSymbol"]="/";#爲以哪個符號作爲分割
                $processedStr=stringProcess::spiltString($conf);
                unset($conf);
                
                #如果處理字串失敗
                if($processedStr["status"]=="false"){
                        
                        #設置錯誤識別
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$processedStr;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #初始化 $result["phpNowViewed"] 為 ""
                $result["nowPosition"]="";
                
                #針對 $processedStr["dataCounts"] 的數字來合併目錄
                for($i=0;$i<$processedStr["dataCounts"]-1;$i++){
                        
                        #合併目錄
                        $result["nowPosition"]=$result["nowPosition"].$processedStr["dataArray"][$i]."/";
                        
                        }#for end
                
                #記錄上一個瀏覽的目錄
                #函式說明:
                #將固定格式的字串分開，並回傳分開的結果。
                #回傳的參數:
                #$result["oriStr"],要分割的原始字串內容
                #$result["dataArray"],爲分割好字串的陣列內容,$result["dataArray"][$i]爲第($i+1)段的內容。
                #$result["dataCounts"],爲總共分成幾段
                #必填參數:
                $conf["stringIn"]=$_SESSION["session"]["getPreAndNowPosition"]["prePlace"];#要處理的字串。
                $conf["spiltSymbol"]="/";#爲以哪個符號作爲分割
                $processedStr=stringProcess::spiltString($conf);
                unset($conf);
                
                #如果處理字串失敗
                if($processedStr["status"]=="false"){
                        
                        #設置錯誤識別
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$processedStr;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #初始化 $result["prePosition"] 為 ""
                $result["prePosition"]="";
                
                #針對 $processedStr["dataCounts"] 的數字來合併目錄
                for($i=0;$i<$processedStr["dataCounts"]-1;$i++){
                        
                        #合併目錄
                        $result["prePosition"]=$result["prePosition"].$processedStr["dataArray"][$i]."/";
                        
                        }#for end
                
                #記錄當前瀏覽的檔案名稱
                $result["phpNowViewed"]=basename($_SESSION["session"]["getPreAndNowPosition"]["nowPlace"]);
                
                #記錄上一筆瀏覽的檔案名稱
                $result["phpPreViewed"]=basename($_SESSION["session"]["getPreAndNowPosition"]["prePlace"]);
                
                #設置執行正常
                $result["status"]="true";
                
                #回傳結果
                return $result;
                        
                }#function getPreAndNowPosition end
        
        /*
        #函式說明:
        #建立多個session變數
        #回傳結果:
        #$result["status"],執行狀態,"true"代表執行成功；"false"代表執行失敗.
        #$reuslt["function"],當前執行的函數.
        #$result["error"],錯誤訊息陣列.
        #必填參數:
        #$conf["sessionArrayName"],字串陣列,要建立的session陣列變數名稱，建議可採用name1.name2.name3的格式。
        $conf["sessionArrayName"]=array("");
        #$conf["sessionArrayValue"],字串陣列,session變數的內容要存放什麼呢？
        $conf["sessionArrayValue"]=array("");
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function createMulti(&$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"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sessionArrayName","sessionArrayValue");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","array");
                #$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["canBeEmptyString"]="false";
                #$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                #$conf["variableCheck::checkArguments"]["skipableVariableName"]=array();
                #$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                #$conf["variableCheck::checkArguments"]["skipableVariableType"]=array();
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("");
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                $conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("sessionArrayName","sessionArrayValue");
                #參考資料來源:
                #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
                                
                #執行迴圈 count($conf["sessionArrayName"]) 次
                for($i=0;$i<count($conf["sessionArrayName"]);$i++){
                        
                        #函式說明:
                        #建立session變數，並指派其內容
                        #回傳結果:
                        #$result["status"]，執行狀態，"true"代表執行成功；"false"代表執行失敗。
                        #$result["error"]，錯誤訊息陣列
                        #必填參數:
                        $conf["session.create"]["sessionName"]=$conf["sessionArrayName"][$i];#要建立的session變數名稱，建議可採用name1.name2.name3的格式。
                        #可省略參數: 
                        $conf["session.create"]["sessionValue"]=$conf["sessionArrayValue"][$i];#session變數的內容要存放什麼呢？ 
                        $sessionCreateResult=session::create($conf["session.create"]);
                        unset($conf["session.create"]);
                        
                        #如果 建立 session 變數失敗
                        if($sessionCreateResult["status"]=="false"){
                                
                                #設置執行錯誤的識別
                                $result["status"]="false";
                                
                                #設置執行失敗的錯誤訊息
                                $result["error"]=$sessionCreateResult;
                                
                                #回傳結果
                                return $result;
                                
                                }#if end
                        
                        }#for end
                        
                #執行到這邊代表執行成功
                $result["status"]="true";
                        
                #設置執行正常的識別
                $result["status"]="true";
                        
                #回傳結果
                return $result;
                        
                }#function createMulti end
        
        /*
        #函式說明:
        #接收post表單變數後另存成session變數 
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$result["errot"],錯誤訊息陣列.
        #$result["function"],當前的函數名稱.
        #必填參數:
        #$conf["checkedVarName"],字串陣列,要接收的表單變數名稱陣列，如果有缺就代表不通過.
        $conf["checkedVarName"]=array();
        #可省略參數:
        #$conf["limitPrePage"],字串陣列,為前一頁的名稱須為陣列元素之一，不滿足則代表不合法，因此要轉址。
        #$conf["limitPrePage"]=array();
        #$conf["transferLocation"],變數來的途徑不合法時要轉址到的地方,預設爲資安素養網"https://isafe.moe.edu.tw/
        #$conf["transferLocation"]="";
        #$conf["sessionArrayName"],字串陣列,各個表單變數要轉存成session變數時的key為何.
        #$conf["sessionArrayName"]=array();
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function formVarToSession(&$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"],每個參數設定的錯誤訊息
                #必填寫的參數：
                #$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck.checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck.checkArguments"]["mustBeFilledVariableName"]=array("checkedVarName");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck.checkArguments"]["mustBeFilledVariableType"]=array("array");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck.checkArguments"]["referenceVarKey"]="variableCheck.checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"false"。
                $conf["variableCheck.checkArguments"]["canBeEmptyString"]="false";
                #$conf["variableCheck.checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck.checkArguments"]["skipableVariableName"]=array("limitPrePage","transferLocation","sessionArrayName");
                #$conf["variableCheck.checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck.checkArguments"]["skipableVariableType"]=array("array","string","array");
                #$conf["variableCheck.checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定.
                $conf["variableCheck.checkArguments"]["skipableVarDefaultValue"]=array(null,null,"\$conf[\"checkedVarName\"]");
                $checkResult=variableCheck::checkArguments($conf["variableCheck.checkArguments"]);
                unset($conf["variableCheck.checkArguments"]);
                
                #如果檢查失敗
                if($checkResult["status"]=="false"){
                        
                        #設置執行不正常
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$checkResult;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #函式說明:
                #可以處理多個透過GET、POST而來的資訊，儲存成變數，同時限定傳送的方法、來源，來增加安全性，檢查有沒有皆收到必須要接收到的變數
                #回傳結果:
                #$result["status"]，執行是否成功，"true"代表執行成功；"false"代表執行失敗.
                #$result["error"]，錯誤訊息.
                #$result["passed"],是否有皆收到全部該接收到的變數，若有設定$conf["checkedVarName"]的話，執行正常後會回傳該結果。
                #$result["lostVarName"],沒有皆收到的變數名稱陣列
                #$result["inputDataContent"],所接收的參數陣列.
                #$result["inputDataContent"]["變數名稱"]，所接收變數的內容.
                #$result["inputDataCount"],總共接收到幾個元素.
                #必填參數:
                #$conf["method"],字串,傳送過來的資料是用"post/POST"還是"get/GET"?
                $conf["form.responseMultiInputDataSecurityEnhance"]["method"]="post";
                #可省略參數:
                #$conf["allowGet"],字串,是否要允許 get 傳值，"true"，代表允許；"false" ，代表不允許，預設爲不允許.
                #$conf["allowGet"]="true";
                
                #如果有設定 $conf["limitPrePage"]
                if(isset($conf["limitPrePage"])){
                        
                        #$conf["form.responseMultiInputDataSecurityEnhance"]["limitPrePage"],字串陣列,是否要限定前一頁的網址為哪些，才能接收內容，不符合則轉址.
                        $conf["form.responseMultiInputDataSecurityEnhance"]["limitPrePage"]=$conf["limitPrePage"];
                        
                        }#if end
                
                #如果 $conf["transferLocation"] 有設定
                if(isset($conf["transferLocation"])){
                        
                        #$conf["form.responseMultiInputDataSecurityEnhance"]["transferLocation"],字串,遇到get傳值的時候要轉址到的頁面，預設爲資安素養網"https://isafe.moe.edu.tw/"
                        $conf["form.responseMultiInputDataSecurityEnhance"]["transferLocation"]=$conf["transferLocation"];
                        
                        }#if end
                
                #$conf["ignore"]=字串陣列,如果要接收的變數名稱與該陣列其一元素一樣,則不放進要回傳的變數裏面.
                #$conf["ignore"]=array();
                #$conf["correctCharacter"]=,字串,如果爲"false"，則不處理可能導致網頁出問題的字串，預設爲要進行處理.
                #$conf["correctCharacter"]="false";
                
                #如果 $conf["checkedVarName"] 有設定
                if(isset($conf["checkedVarName"])){
                
                        #$conf["form.responseMultiInputDataSecurityEnhance"]["checkedVarName"],字串陣列,為檢查是否有接收到哪些變數.
                        $conf["form.responseMultiInputDataSecurityEnhance"]["checkedVarName"]=$conf["checkedVarName"];
                        
                        }#if end
                        
                #參考資料來源：
                #foreach 的用法 -> http://php.net/manual/en/control-structures.foreach.php
                #伺服器端的變數 -> http://php.net/manual/en/reserved.variables.server.php
                #備註：
                #表單變數的名稱若含有「.」，則會變成「-」。
                $receivedVar=form::responseMultiInputDataSecurityEnhance($conf["form.responseMultiInputDataSecurityEnhance"]);
                unset($conf["form.responseMultiInputDataSecurityEnhance"]);
                
                #如果接受變數失敗
                if($receivedVar["status"]=="false"){
                        
                        #設置執行不正常
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$receivedVar;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                                                
                #初始化轉好的session變數數值陣列
                $sessionValueArray=array();     
                        
                #建立要轉換成session變數的form變數數值陣列
                foreach($conf["checkedVarName"] as $value){
                        
                        #取得要轉換成session變數的form變數數值內容
                        $sessionValueArray[]=$receivedVar["inputDataContent"][$value];
                        
                        }#foreach end   
                        
                #函式說明:
                #建立多個session變數
                #回傳結果:
                #$result["status"],執行狀態,"true"代表執行成功；"false"代表執行失敗.
                #$reuslt["function"],當前執行的函數.
                #$result["error"],錯誤訊息陣列.
                #必填參數:
                #$conf["session.createMulti"]["sessionArrayName"],字串陣列,要建立的session陣列變數名稱，建議可採用name1.name2.name3的格式。
                $conf["session.createMulti"]["sessionArrayName"]=$conf["sessionArrayName"];
                #$conf["session.createMulti"]["sessionArrayValue"],字串陣列,session變數的內容要存放什麼呢？
                $conf["session.createMulti"]["sessionArrayValue"]=$sessionValueArray;
                #可省略參數:
                #無
                $createSessionVarStatus=session::createMulti($conf["session.createMulti"]);
                unset($conf["session.createMulti"]);                    
                
                #如果建立session變數失敗
                if($createSessionVarStatus["status"]=="false"){
                        
                        #設置執行不正常
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $reuslt["error"]=$createSessionVarStatus;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #執行到這邊代表執行正常
                $result["status"]="true";
                
                #回傳結果
                return $result;
                
                }#function formVarToSession end
                
        /*
        #函式說明:
        #取得指定的session數值 
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
        #$result["error"],錯誤訊息.
        #$result["founded"],是否有該session變數,"true"代表有,"false"代表沒有.
        #$result["content"],session變數的內容
        #$result["address"],session變數的位址,請用 $yourVar=&$result["address"] 來取得位址.
        #$result["function"],當前執行的函數名稱.
        #$result["argu"],使用的參數.
        #必填參數:
        #$conf["key"],字串陣列,session的key名稱與層級.
        $conf["key"]=array();
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function getVal(&$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["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
                #$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
                #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
                #$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
                #$result["notNeedVar"],字串陣列,多餘的參數名稱.
                #必填寫的參數：
                #$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("key");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                #$conf["canBeEmptyString"]="false";
                #$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
                #$conf["canNotBeEmpty"]=array();
                #$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
                #$conf["canBeEmpty"]=array();
                #$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
                #$conf["skipableVariableCanNotBeEmpty"]=array();
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                #$conf["skipableVariableName"]=array();
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                #$conf["skipableVariableType"]=array();
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                #$conf["skipableVarDefaultValue"]=array("");
                #$conf["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
                
                #取得session的副本
                $session=$_SESSION;
                
                #儲存session的位址
                $sessionAddress=&$_SESSION;
                
                #針對每個key
                foreach($conf["key"] as $keyVal){
                        
                        #如果 key 為 $keyVal 的 session 變數不存在
                        if(!isset($session[$keyVal])){
                                
                                #設置執行正常 
                                $result["status"]="true";
                                
                                #設置未找到session變數
                                $result["founded"]="false";
                                
                                #取得 session 的位址
                                $result["address"]=&$sessionAddress;
                                
                                #回傳結果
                                return $result;
                                
                                }#if end
                                
                        #反之
                        else{
                                
                                #取得 session 該層的內容
                                $session=$session[$keyVal];
                                                                
                                #取得 session 的位址
                                $sessionAddress=&$sessionAddress[$keyVal];
                                
                                }#else end
                        
                        }#foreach end
                        
                #設置執行正常
                $result["status"]="true";
                
                #設置有找到 session 變數
                $result["founded"]="true";
                
                #設置取得的session內容
                $result["content"]=$session;
                
                #取得 session 的位址
                $result["address"]=&$sessionAddress;
                
                #回傳結果
                return $result;
                
                }#function getVal end
                
        /*
        #函式說明:
        #設置指定的session變數 
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
        #$result["error"],錯誤訊息.
        #$result["founded"],是否有該session變數,"true"代表有,"false"代表沒有.
        #$result["content"],session變數的內容
        #$result["address"],session變數的位址,請用 $yourVar=&$result["address"] 來取得位址.
        #$result["function"],當前執行的函數名稱.
        #$result["argu"],使用的參數.
        #必填參數:
        #$conf["key"],字串陣列,session的key名稱與層級.
        $conf["key"]=array();
        #$conf["val"],任意型態,指定的session變數內容.
        $conf["val"]=$var;
        #可省略參數:
        #$conf["storeAsNotRepeatArray"],字串,"true"代表要將變數內容存成陣列,預設為"false".
        #$conf["storeAsNotRepeatArray"]="false";
        #參考資料:
        #http://php.net/manual/en/function.array-keys.php
        #http://php.net/manual/en/function.end.php
        #備註:
        #無.
        */
        public static function setVal(&$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["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
                #$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
                #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
                #$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
                #$result["notNeedVar"],字串陣列,多餘的參數名稱.
                #必填寫的參數：
                #$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("key","val");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","any");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$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("storeAsNotRepeatArray");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("false");
                #$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["arrayCountEqualCheck"][]=array();
                #參考資料來源:
                #array_keys=>http://php.net/manual/en/function.array-keys.php
                #建議:
                #增加可省略參數全部不能為空字串或空陣列的參數功能.
                $checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);
                
                #若檢查參數失敗
                if($checkArguments["status"]==="false"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"]=$checkArguments;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #若檢查參數不通過
                if($checkArguments["passed"]==="false"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"]=$checkArguments;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #取得seesion變數的層級數目
                $lastLayer=count($conf["key"]);
                        
                #設置初始的層級
                $layer=1;       
                
                #取得session變數的位址
                $session=&$_SESSION;
                        
                #數化要查詢的session key階層
                $sa=array();    
                        
                #針對session變數的每個層級
                foreach($conf["key"] as $keyVal){
                        
                        #如果是最後一層
                        if($layer===$lastLayer){
                                
                                #如果要儲存成陣列
                                if($conf["storeAsNotRepeatArray"]==="true"){
                                        
                                        #如果目標變數有存在了
                                        if(isset($session[$keyVal])){
                                                
                                                #如果不是陣列
                                                if(gettype($session[$keyVal])!=="array"){
                                                        
                                                        #設置執行失敗
                                                        $result["status"]="false";
                                                        
                                                        #設置執行錯誤訊息
                                                        $result["error"]=$checkArguments;
                                                        
                                                        #設置錯誤訊息
                                                        $result["error"][]="變數內容不是陣列";
                                                        
                                                        #回傳結果
                                                        return $result;
                                                        
                                                        }#if end
                                                        
                                                #如果是新的元素
                                                if(!in_array($conf["val"],$session[$keyVal])){
                                                        
                                                        #新增元素
                                                        $session[$keyVal][]=$conf["val"];
                                                        
                                                        }#if end
                                                
                                                }#if end
                                                
                                        #反之
                                        else{
                                                
                                                #新增元素
                                                $session[$keyVal][]=$conf["val"];
                                                
                                                }#else end
                                        
                                        $keys=array_keys($session[$keyVal]);
                                        
                                        #get last key
                                        $lastKey=end($keys);
                                                
                                        #取得當前參照的session階層位址
                                        $session=&$session[$keyVal][$lastKey];  
                                        
                                        }#if end
                                        
                                #反之直接儲存
                                else{
                                        
                                        #設置 session 變數的內容
                                        $session[$keyVal]=$conf["val"]; 
                                        
                                        #取得當前參照的session階層位址
                                        $session=&$session[$keyVal];                            

                                        }#else end
                                
                                #跳出迴圈
                                break;
                                
                                }#if end
                        
                        #設置要檢查的session key階層
                        $sa[]=$keyVal;
                                
                        #函式說明:
                        #取得指定的session數值 
                        #回傳結果:
                        #$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
                        #$result["error"],錯誤訊息.
                        #$result["founded"],是否有該session變數,"true"代表有,"false"代表沒有.
                        #$result["content"],session變數的內容
                        #$result["address"],session變數的位址,請用 $yourVar=&$result["address"] 來取得位址.
                        #$result["function"],當前執行的函數名稱.
                        #$result["argu"],使用的參數.
                        #必填參數:
                        #$conf["key"],字串陣列,session的key名稱與層級.
                        $conf["session::getVal"]["key"]=$sa;
                        $getVal=session::getVal($conf["session::getVal"]);
                        unset($conf["session::getVal"]);        
                                
                        #如果取得 session key 的內容失敗
                        if($getVal["status"]==="false"){
                                
                                #設置執行失敗
                                $result["status"]="false";
                                
                                #設置執行錯誤訊息
                                $result["error"]=$getVal;
                                
                                #回傳結果
                                return $result;
                                
                                }#if end
                                
                        #如果 session 不存在
                        if($getVal["founded"]==="false"){
                                
                                #建立該 session 階層並設為空陣列
                                $getVal["address"][$keyVal]=array();
                                
                                #取得當前參照的session階層位址
                                $session=&$getVal["address"][$keyVal];                          
                                
                                }#if end                        
                        
                        #如果 session 存在  
                        else{
                                
                                #取得當前參照的session階層位址
                                $session=&$getVal["address"];
                                
                                }#else end      
                                
                        #層級加一
                        $layer++;
                        
                        }#foreach end
                
                #設置執行正常
                $result["status"]="true";
                
                #設置session變數的位址
                $result["address"]=&$session;
                
                #回傳節果
                return $result;
                
                }#function setVal end
                
        /*
        #函式說明:
        #設置多個session變數的內容 
        #$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
        #$result["error"],錯誤訊息.
        #$result["founded"],是否有該session變數,"true"代表有,"false"代表沒有.
        #$result["content"],每個設置好的session變數資訊
        #$result["function"],當前執行的函數名稱.
        #$result["argu"],使用的參數.
        #必填參數:
        #$conf["key"],二維陣列,每個session的key名稱與層級.
        $conf["key"]=array(array());
        #$conf["val"],陣列,每個指定的session變數內容.
        $conf["val"]=array($var);
        #可省略參數:
        #$conf["storeAsNotRepeatArray"],字串,"true"代表要將變數內容存成陣列,預設為"false".
        #$conf["storeAsNotRepeatArray"]="false";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function setMultiVal(&$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["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
                #$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
                #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
                #$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
                #$result["notNeedVar"],字串陣列,多餘的參數名稱.
                #必填寫的參數：
                #$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("key","val");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","array");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$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("storeAsNotRepeatArray");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("false");
                #$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                $conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("key","val");
                #參考資料來源:
                #array_keys=>http://php.net/manual/en/function.array-keys.php
                #建議:
                #增加可省略參數全部不能為空字串或空陣列的參數功能.
                $checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);
                
                #若檢查參數失敗
                if($checkArguments["status"]==="false"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"]=$checkArguments;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #若檢查參數不通過
                if($checkArguments["passed"]==="false"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"]=$checkArguments;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #針對每個 $conf["key"]
                foreach($conf["key"] as $index=>$keyVal){
                        
                        #設置指定的session變數 
                        #回傳結果:
                        #$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
                        #$result["error"],錯誤訊息.
                        #$result["founded"],是否有該session變數,"true"代表有,"false"代表沒有.
                        #$result["content"],session變數的內容
                        #$result["address"],session變數的位址,請用 $yourVar=&$result["address"] 來取得位址.
                        #$result["function"],當前執行的函數名稱.
                        #$result["argu"],使用的參數.
                        #必填參數:
                        #$conf["key"],字串陣列,session的key名稱與層級.
                        $conf["session::setVal"]["key"]=$keyVal;
                        #$conf["val"],任意型態,指定的session變數內容.
                        $conf["session::setVal"]["val"]=$conf["val"][$index];
                        #可省略參數:
                        #$conf["storeAsNotRepeatArray"],字串,"true"代表要將變數內容存成陣列,預設為"false".
                        $conf["session::setVal"]["storeAsNotRepeatArray"]=$conf["storeAsNotRepeatArray"];                       
                        $setVal=session::setVal($conf["session::setVal"]);
                        unset($conf["session::setVal"]);
                        
                        #如果設置 session 變數失敗 
                        if($setVal["status"]==="false"){
                                
                                #設置執行失敗
                                $result["status"]="false";
                                
                                #設置執行錯誤訊息
                                $result["error"]=$setVal;
                                
                                #回傳結果
                                return $result;
                                
                                }#if end
                                
                        #取得設置好的結果
                        $result["content"][]=$setVal;
                        
                        }#foreach end
                        
                #設置執行正常
                $result["status"]="true";
                
                #回傳結果
                return $result;
                
                }#function setMutiVal end
        
        }#session class end

?>