Subversion Repositories qbpwcf-lib(archive)

<?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執行環境的類別.
備註:
無.
*/
class config{

        /*
        #函式說明:
        #當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
        #回傳結果:
        #$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

        /*
        #函式說明:
        #延長php的執行時間,每呼叫一次會初始化執行時間爲0，然後設定下次可以執行多久.
        #回傳結果:
        #$result["status"],執行是否正常,"true"為正常,"false"為不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數名稱.
        #必填參數：
        #$conf["sec"],整數,要延長多少執行時間,單位爲秒
        $conf["sec"]=30;
        #可省略參數:
        #無.
        #備註:
        #無.
        #參考資料:
        #http://php.net/manual/en/function.set-time-limit.php
        */
        public static function delayRunTimeExectionMax(&$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("sec");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("integer");
                #$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                $conf["variableCheck::checkArguments"]["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                #$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("asc");
                #$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
                        
                #初始化執行時間爲0，然後再延長$conf["sec"] 秒
                $setupResult=set_time_limit($conf["sec"]);
                
                #如果爲 FALSE
                if($setupResult==FALSE){
                        
                        #設置執行不正常
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"]="初始與重置執行時間上限失敗";
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #執行到這邊代表執行正常
                $result["status"]="true";
                
                #回傳結果
                return $result;
                
                }#function delayRunTimeExectionMax end
                
        /*
        #函式說明:
        #顯示目前的php設定值
        #回傳的結果：
        #$result["status"],執行是否正常,"true"為正常,"false"為不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數名稱.
        #$result["content"],常用的設定值的內容、也可指定想要看的設定值內容.
        #必填參數:
        #無.
        #可省略參數:
        #$conf["settingsName"],字串陣列,自己想要看的設定值內容,預設為array("display_errors","upload_max_filesize","post_max_size","output_buffering","session.auto_start","memory_limit").
        #$conf["settingsName"]=array();
        #$conf["showAll"],字串,是否要取得所有設定,"true"代表要,會覆寫$conf["settingsName"]的設定,"false"代表不要,預設為"fale".
        #$conf["showAll"]="";
        #參考資料:
        #http://www.php.net/manual/en/function.ini-get.php
        #http://www.php.net/manual/en/function.ini-get-all.php
        #備註:
        #無.
        */
        public static function showSettings(&$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("default");
                #$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["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                $conf["variableCheck::checkArguments"]["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("settingsName","showAll");
                #$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","string");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(array("display_errors","upload_max_filesize","post_max_size","output_buffering","session.auto_start","memory_limit"),"false");
                #$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["arrayCountEqualCheck"][]=array();
                #參考資料來源:
                #array_keys=>http://php.net/manual/en/function.array-keys.php
                $checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);

                #如果檢查參數失敗
                if($checkArguments["status"]=="false"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"]=$checkArguments;

                        #回傳結果
                        return $result;
                        
                        }#if end
                        
                #如果檢查不通過
                if($checkArguments["passed"]=="false"){
                        
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置執行錯誤訊息
                        $result["error"]=$checkArguments;

                        #回傳結果
                        return $result;
                        
                        }#if end
                
                #如果要顯示所有設定
                if($conf["showAll"]==="true"){
                        
                        #取得設定值
                        $config=ini_get_all();
                        
                        #如果取得設定值失敗
                        if($config==FALSE){
                                
                                #設置執行不正常
                                $result["status"]="true";
                                                
                                #設置錯誤訊息
                                $result["error"][]="取得所有設定值失敗";               
                                                        
                                #回傳結果
                                return $result;
                                
                                }#if end
                                
                        #反之
                        else{
                                
                                #取得設定值
                                $result["content"]=&$config;
                                
                                }#else end                                                                      
                        
                        }#if end
                
                #反之
                else{
                        
                        #針對每個要顯示的設定值
                        foreach($conf["settingsName"] as $key=>$value){
                                
                                #檢查設定值
                                $config=ini_get($value);
                                
                                #如果取得設定值失敗
                                if($config==FALSE){
                                        
                                        #設置執行不正常
                                        $result["status"]="true";
                                                        
                                        #設置錯誤訊息
                                        $result["error"][]="參數「".$value."」不存在";           
                                                                
                                        #回傳結果
                                        return $result;
                                        
                                        }#if end
                                
                                #反之
                                else{
                                        
                                        #取得設定值
                                        $result["content"][$value]=$config;
                                        
                                        }#else end
                                                                
                                }#foreach end
                        
                        }#else 
                
                #設置執行正常
                $result["status"]="true";
                
                #回傳結果
                return $result;
                                        
                }#function showSettings end
        
        /*      
        #函式說明:
        #將php設定檔常用的設定進行調整使之變成適用於開發模式、釋出模式、或自訂要調整哪些設定值
        #回傳結果:
        #$result["status"],執行是否正常,"true"為正常,"false"為不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數名稱.
        #必填參數:
        #$conf["mode"],參數設定的模式，"release"代表是指共一般使用所需;"develop"代表是在開發狀態下所需;"custom"代表自訂參數設定內容
        $conf["mode"]="release";
        #可省略參數:
        #$conf["customSettings"],要自訂的參數與其數值，例如array("display_errors=On").
        #$conf["customSettings"]=array();
        #參考資料:
        #ini_set=>http://www.php.net/manual/en/function.ini-set.php
        #各個參數適用的修改方式=>http://www.php.net/manual/en/ini.list.php
        #各個參數適用的修改方式的解說=>http://hi.baidu.com/richardali/item/d28104083c70c638a2332a60
        #備註:
        #使用該函式後，網頁會無法顯示。
        */
        public static function changeSettings(&$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["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("mode");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("customSettings");
                #$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["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
                        
                #依據模式來進行設定
                switch($conf["mode"]){
                        
                        #如果是給大家正式使用的狀況
                        case "release":
                        
                                #設置設定值
                                
                                #關閉顯示錯誤訊息
                                $conf["customSettings"][]="display_errors=Off";
                                
                                #初始化計數為0
                                $count=0;
                        
                                #針對每個 $conf["customSettings"]
                                foreach($conf["customSettings"] as $configStr){
                                        
                                        #用 "=" 分割設定字串
                                        #函式說明:
                                        #將固定格式的字串分開，並回傳分開的結果。
                                        #回傳的參數:
                                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                                        #$result["error"],錯誤訊息陣列
                                        #$result["function"],當前執行的函數名稱.
                                        #$result["oriStr"],要分割的原始字串內容
                                        #$result["dataArray"],爲分割好字串的陣列內容,$result["dataArray"][$i]爲第($i+1)段的內容。
                                        #$result["dataCounts"],爲總共分成幾段
                                        #必填參數:
                                        $conf["stringProcess::spiltString"]["stringIn"]=$configStr;#要處理的字串。
                                        $conf["stringProcess::spiltString"]["spiltSymbol"]="=";#爲以哪個符號作爲分割
                                        #備註：
                                        #建議新增如果透過" "分割後的內容含有""的元素，將其移除，並將後面有內容的元素補上,key也重新排序。
                                        $spiltString=stringProcess::spiltString($conf["stringProcess::spiltString"]);
                                        unset($conf["stringProcess::spiltString"]);
                                        
                                        #如果分割設定值字串失敗
                                        if($spiltString["status"]=="false"){
                                                
                                                #設置錯誤識別
                                                $result["status"]="false";
                                                
                                                #設置錯誤訊息
                                                $result["error"]=$spiltString;
                                                
                                                #回傳結果
                                                return $result;
                                                
                                                }#if end
                                                
                                        #如果只有一段內容
                                        if($spiltString["dataCounts"]=="1"){
                                                
                                                #設置錯誤識別
                                                $result["status"]="false";
                                                
                                                #設置錯誤訊息
                                                $result["error"][]="設定值字串「".$configStr."」必須要用「=」來間隔設定屬性與其數值";
                                                
                                                #回傳結果
                                                return $result;
                                                
                                                }#if end
                                                
                                        #設定暫時的設定值
                                        $oldConfigValue=ini_set($spiltString["dataArray"][0],$spiltString["dataArray"][1]);
                                        
                                        #如果設定失敗
                                        if($oldConfigValue===false){
                                                
                                                #設置錯誤識別
                                                $result["status"]="false";
                                                
                                                #設置錯誤訊息
                                                $result["error"][]="將屬性「".$spiltString["dataArray"][0]."」設定為「".$spiltString["dataArray"][1]."」失敗";
                                                
                                                #回傳結果
                                                return $result;
                                                
                                                }#if end
                                                
                                        #反之儲存舊的永久設地數值
                                        else{
                                                
                                                #取得舊的設定值
                                                $result["config"][$count]["oldValue"]=$spiltString["dataArray"][0]."=".$oldConfigValue;
                                                $result["config"][$spiltString["dataArray"][0]]["oldValue"]=$spiltString["dataArray"][0]."=".$oldConfigValue;
                                                                                                
                                                #取得新的設定值
                                                $result["config"][$count]["newValue"]=$spiltString["dataArray"][0]."=".$spiltString["dataArray"][1];
                                                $result["config"][$spiltString["dataArray"][0]]["newValue"]=$spiltString["dataArray"][0]."=".$spiltString["dataArray"][1];
                                                
                                                #計數加1
                                                $count++;
                                                
                                                }#else end
                                        
                                        }#foreach end
                                                
                                #跳出switch
                                break;
                                
                        #如果是開發狀態下
                        case "develop";
                        
                                #設置設定值
                                
                                #開啟顯示錯誤訊息
                                $conf["customSettings"][]="display_errors=On";
                                
                                #關閉使用記憶體的上限
                                $conf["customSettings"][]="memory_limit=-1";
                                
                                #關閉php script執行的時間上限
                                $conf["customSettings"][]="max_execution_time=0";
                                
                                #初始化計數為0
                                $count=0;
                        
                                #針對每個 $conf["customSettings"]
                                foreach($conf["customSettings"] as $configStr){
                                        
                                        #用 "=" 分割設定字串
                                        #函式說明:
                                        #將固定格式的字串分開，並回傳分開的結果。
                                        #回傳的參數:
                                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                                        #$result["error"],錯誤訊息陣列
                                        #$result["function"],當前執行的函數名稱.
                                        #$result["oriStr"],要分割的原始字串內容
                                        #$result["dataArray"],爲分割好字串的陣列內容,$result["dataArray"][$i]爲第($i+1)段的內容。
                                        #$result["dataCounts"],爲總共分成幾段
                                        #必填參數:
                                        $conf["stringProcess::spiltString"]["stringIn"]=$configStr;#要處理的字串。
                                        $conf["stringProcess::spiltString"]["spiltSymbol"]="=";#爲以哪個符號作爲分割
                                        #備註：
                                        #建議新增如果透過" "分割後的內容含有""的元素，將其移除，並將後面有內容的元素補上,key也重新排序。
                                        $spiltString=stringProcess::spiltString($conf["stringProcess::spiltString"]);
                                        unset($conf["stringProcess::spiltString"]);
                                        
                                        #如果分割設定值字串失敗
                                        if($spiltString["status"]=="false"){
                                                
                                                #設置錯誤識別
                                                $result["status"]="false";
                                                
                                                #設置錯誤訊息
                                                $result["error"]=$spiltString;
                                                
                                                #回傳結果
                                                return $result;
                                                
                                                }#if end
                                                
                                        #如果只有一段內容
                                        if($spiltString["dataCounts"]=="1"){
                                                
                                                #設置錯誤識別
                                                $result["status"]="false";
                                                
                                                #設置錯誤訊息
                                                $result["error"][]="設定值字串「".$configStr."」必須要用「=」來間隔設定屬性與其數值";
                                                
                                                #回傳結果
                                                return $result;
                                                
                                                }#if end
                                                
                                        #設定暫時的設定值
                                        $oldConfigValue=ini_set($spiltString["dataArray"][0],$spiltString["dataArray"][1]);
                                        
                                        #如果設定失敗
                                        if($oldConfigValue===false){
                                                
                                                #設置錯誤識別
                                                $result["status"]="false";
                                                
                                                #設置錯誤訊息
                                                $result["error"][]="將屬性「".$spiltString["dataArray"][0]."」設定為「".$spiltString["dataArray"][1]."」失敗";
                                                
                                                #回傳結果
                                                return $result;
                                                
                                                }#if end
                                                
                                        #反之儲存舊的永久設地數值
                                        else{
                                                
                                                #取得舊的設定值
                                                $result["config"][$count]["oldValue"]=$spiltString["dataArray"][0]."=".$oldConfigValue;
                                                $result["config"][$spiltString["dataArray"][0]]["oldValue"]=$spiltString["dataArray"][0]."=".$oldConfigValue;
                                                                                                
                                                #取得新的設定值
                                                $result["config"][$count]["newValue"]=$spiltString["dataArray"][0]."=".$spiltString["dataArray"][1];
                                                $result["config"][$spiltString["dataArray"][0]]["newValue"]=$spiltString["dataArray"][0]."=".$spiltString["dataArray"][1];
                                                
                                                #計數加1
                                                $count++;
                                                
                                                }#else end
                                        
                                        }#foreach end           
                                                                
                                #跳出switch
                                break;
                                
                        #如果是自訂設定值的狀態
                        case "custom":
                                        
                                #初始化計數為0
                                $count=0;
                        
                                #針對每個 $conf["customSettings"]
                                foreach($conf["customSettings"] as $configStr){
                                        
                                        #用 "=" 分割設定字串
                                        #函式說明:
                                        #將固定格式的字串分開，並回傳分開的結果。
                                        #回傳的參數:
                                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                                        #$result["error"],錯誤訊息陣列
                                        #$result["function"],當前執行的函數名稱.
                                        #$result["oriStr"],要分割的原始字串內容
                                        #$result["dataArray"],爲分割好字串的陣列內容,$result["dataArray"][$i]爲第($i+1)段的內容。
                                        #$result["dataCounts"],爲總共分成幾段
                                        #必填參數:
                                        $conf["stringProcess::spiltString"]["stringIn"]=$configStr;#要處理的字串。
                                        $conf["stringProcess::spiltString"]["spiltSymbol"]="=";#爲以哪個符號作爲分割
                                        #備註：
                                        #建議新增如果透過" "分割後的內容含有""的元素，將其移除，並將後面有內容的元素補上,key也重新排序。
                                        $spiltString=stringProcess::spiltString($conf["stringProcess::spiltString"]);
                                        unset($conf["stringProcess::spiltString"]);
                                        
                                        #如果分割設定值字串失敗
                                        if($spiltString["status"]=="false"){
                                                
                                                #設置錯誤識別
                                                $result["status"]="false";
                                                
                                                #設置錯誤訊息
                                                $result["error"]=$spiltString;
                                                
                                                #回傳結果
                                                return $result;
                                                
                                                }#if end
                                                
                                        #如果只有一段內容
                                        if($spiltString["dataCounts"]=="1"){
                                                
                                                #設置錯誤識別
                                                $result["status"]="false";
                                                
                                                #設置錯誤訊息
                                                $result["error"][]="設定值字串「".$configStr."」必須要用「=」來間隔設定屬性與其數值";
                                                
                                                #回傳結果
                                                return $result;
                                                
                                                }#if end
                                                
                                        #設定暫時的設定值
                                        $oldConfigValue=ini_set($spiltString["dataArray"][0],$spiltString["dataArray"][1]);
                                        
                                        #如果設定失敗
                                        if($oldConfigValue===false){
                                                
                                                #設置錯誤識別
                                                $result["status"]="false";
                                                
                                                #設置錯誤訊息
                                                $result["error"][]="將屬性「".$spiltString["dataArray"][0]."」設定為「".$spiltString["dataArray"][1]."」失敗";
                                                
                                                #回傳結果
                                                return $result;
                                                
                                                }#if end
                                                
                                        #反之儲存舊的永久設地數值
                                        else{
                                                
                                                #取得舊的設定值
                                                $result["config"][$count]["oldValue"]=$spiltString["dataArray"][0]."=".$oldConfigValue;
                                                $result["config"][$spiltString["dataArray"][0]]["oldValue"]=$spiltString["dataArray"][0]."=".$oldConfigValue;
                                                                                                
                                                #取得新的設定值
                                                $result["config"][$count]["newValue"]=$spiltString["dataArray"][0]."=".$spiltString["dataArray"][1];
                                                $result["config"][$spiltString["dataArray"][0]]["newValue"]=$spiltString["dataArray"][0]."=".$spiltString["dataArray"][1];
                                                
                                                #計數加1
                                                $count++;
                                                
                                                }#else end
                                        
                                        }#foreach end
                                                                
                                #跳出switch
                                break;
                        
                        #如果不是以上狀況，那就是參數錯誤       
                        default :
                        
                                #設置錯誤訊息
                                $result["error"][]="\$conf[\"mode\"]模式設定錯誤";
                        
                                #設置執行失敗
                                $result["status"]="false";
                        
                                #回傳結果
                                return $result;
                        
                        }#switch end
                        
                #設置執行正常
                $result["status"]="true";
        
                #回傳結果
                return $result;
                
                }#funciton changeSettings end
                
        /*
        #函式說明:
        #依照條件增加記憶體的上限.
        #回傳結果:
        #$result["status"],執行是否正常,"true"為正常,"false"為不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數名稱.
        #$result["argu"],使用的參數.
        #$result["founded"],"true"代表有找到定義,"false"代表沒有找到定義.
        #$result["content"],提示訊息.
        #必填參數:
        #無.
        #可省略參數:
        #$conf["stepAmount"],一次要增加多少上限，預設為當前環境的上限,單位位M(Mega Bytes).
        #$conf["stepAmount"]="";
        #$conf["whenAviMemLessThan"],字串整數,什麼時候要增加記憶體,預設為可用的記憶體不超過10%時,亦即10;範圍為1~50,亦即範圍為1~50%.
        #$conf["whenAviMemLessThan"]="10"
        #$conf["client"],陣列,存放所有client資訊的陣列,預設不使用.
        #$conf["client"]=array();
        #參考資料:
        #https://www.php.net/manual/en/function.memory-get-usage.php
        #https://www.php.net/manual/en/ini.core.php#ini.memory-limit
        #https://www.php.net/manual/en/function.ini-set.php
        #備註:
        #無.
        */
        public static function autoAddMemory(&$conf=array()){
        
                #初始化要回傳的結果
                $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
                
                #函式說明:
                #顯示目前的php設定值
                #回傳的結果：
                #$result["status"],執行是否正常,"true"為正常,"false"為不正常.
                #$result["error"],錯誤訊息陣列.
                #$result["function"],當前執行的函數名稱.
                #$result["content"],常用的設定值的內容、也可指定想要看的設定值內容.
                #必填參數:
                #無.
                #可省略參數:
                #$conf["settingsName"],字串陣列,自己想要看的設定值內容,預設為array("display_errors","upload_max_filesize","post_max_size","output_buffering","session.auto_start","memory_limit").
                $conf["config::showSettings"]["settingsName"]=array("memory_limit");
                #$conf["showAll"],字串,是否要取得所有設定,"true"代表要,會覆寫$conf["settingsName"]的設定,"false"代表不要,預設為"fale".
                #$conf["showAll"]="";
                #參考資料:
                #http://www.php.net/manual/en/function.ini-get.php
                #http://www.php.net/manual/en/function.ini-get-all.php
                #備註:
                #無.
                $showSettings=config::showSettings($conf["config::showSettings"]);
                unset($conf["config::showSettings"]);
                
                #如果執行失敗
                if($showSettings["status"]==="false"){
                
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置錯誤資訊
                        $result["error"]=$showSettings;
                
                        #回傳結果
                        return $result;
                
                        }#if end
                
                #取得系統設定的php記憶體上限
                $phpMaxMemInConfig=$showSettings["memory_limit"];
                
                #如果單位是M
                #函式說明:
                #取得符合特定字首與字尾的字串
                #回傳結果:
                #$result["status"]，若爲"true"則代表執行正常；若爲"false"則代表執行失敗。
                #$result["function"],當前執行的函數名稱.
                #$result["error"],錯誤訊息陣列.
                #$result["founded"],若為"true"則代表有找到符合字首條件的結果；若爲"false"則代表沒有找到。
                #$result["content"],符合條件的字串,去掉字首字尾後的結果.
                #$result["returnString"]，爲符合字首字、尾條件的字串內容。
                #$result["argu"],使用的參數.
                #必填參數:
                #$conf["checkString"],字串,要檢查的字串.
                $conf["stringProcess::getMeetConditionsString"]["checkString"]=$phpMaxMemInConfig;
                #可省略參數:
                #$conf["frontWord"],字串,用來檢查字首應該要有什麼字串,預設不指定.
                #$conf["stringProcess::getMeetConditionsString"]["frontWord"]="";
                #$conf["tailWord"],字串,用來檢查字尾應該要有什麼字串,預設不指定.
                $conf["stringProcess::getMeetConditionsString"]["tailWord"]="M";
                #參考資料:
                #str_spilt(),可以將字串依照字母分割成一個個陣列字串。
                #備註:
                #無.
                $getMeetConditionsString=stringProcess::getMeetConditionsString($conf["stringProcess::getMeetConditionsString"]);
                unset($conf["stringProcess::getMeetConditionsString"]);
                
                #如果執行失敗
                if($getMeetConditionsString["status"]==="false"){
                
                        #設置執行失敗
                        $result["status"]="false";
                        
                        #設置錯誤資訊
                        $result["error"]=$getMeetConditionsString;
                
                        #回傳結果
                        return $result;
                
                        }#if end
                        
                #如果是M結尾
                if($getMeetConditionsString["founded"]==="true"){
                
                        #轉換為bytes
                        $phpMaxMemInConfig=$phpMaxMemInConfig*1024*1024;
                
                        }#if end
                                
                #函式說明:
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["error"],執行不正常結束的錯訊息陣列.
                #$result["simpleError"],簡單表示的錯誤訊息.
                #$result["function"],當前執行的函式名稱.
                #$result["argu"],設置給予的參數.
                #$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
                #$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
                #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
                #$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
                #$result["notNeedVar"],字串陣列,多餘的參數名稱.
                #必填參數:
                #$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可省略參數:
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("stepAmount");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
                #$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("stepAmount","whenAviMemLessThan");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("stepAmount","whenAviMemLessThan","client");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","array");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array($phpMaxMemInConfig,"10",null);
                #$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
                        
                #如果參數 whenAviMemLessThan 不為 
                $whenAviMemLessThan=(int)($conf["whenAviMemLessThan"]);
                
                #如果小於1
                if($whenAviMemLessThan<1){
                
                        #設置為1
                        $whenAviMemLessThan=1;
                
                        }#if end
                        
                #如果大於50
                else if($whenAviMemLessThan>50){
                
                        #設置為50
                        $whenAviMemLessThan=50;
                
                        }#if end
                
                #計算需要增加記憶體的門檻
                $condition=$phpMaxMemInConfig*$whenAviMemLessThan/100;
                        
                #get memeory usage
                $memUsedInBytes=\memory_get_usage();
                
                #如果使用的記憶體已經達到門檻
                if($memUsedInBytes>=$condition){
                
                        #計算新的記憶體上限
                        $newMemoryLimit=$phpMaxMemInConfig+$stepAmount;
                
                        #依照 stepAmount 來增加可用記憶體的上限
                        $return=\ini_set("memory_limit",$stepAmount);
                
                        #如果設置失敗
                        if($return===false){
                        
                                #設置執行失敗
                                $result["status"]="false";

                                #設置執行錯誤訊息
                                $result["error"][]="加大記憶體上限失敗";
                                
                                #回傳結果
                                return $result;
                        
                                }#if end
                                
                        #設置正常訊息
                        $result["content"]="memeory_limit changed from ".$return." to ".$newMemoryLimit;
                                        
                        }#if end
                        
                #提示未改變
                $result["content"]="memeory_limit not changed"; 
                        
                #設置執行正常
                $result["status"]="true";
                
                #回傳結果
                return $result;
                
                }#function autoAddMemory end
        
        /*
        #函式說明:
        #建立供 apache 讀取的設定檔案.
        #回傳結果:
        #$result["status"],執行是否正常,"true"為正常,"false"為不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數名稱.
        #$result["content"],定義對應的內容.
        #必填參數:
        #$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
        $conf["fileArgu"]=__FILE__;
        #$conf["configFileAddr"],字串,定義檔位置與名稱
        $conf["configFileAddr"]="";
        #$conf["content"],陣列,要儲存的key -> value 陣列.
        $conf["content"]=array("169.254.1.1"=>array("groupName"=>"local"));
        #可省略參數:
        #$conf["web"],是要取得網路上的檔案則為"true";反之則為"false",預設為後者.
        #$conf["web"]="false";
        #參考資料:
        #無.
        #備註:
        #檔案內容的格式為多行json編碼然後url編碼然後base64編碼後的內容,每行代表一組定義.每組定義的json格式為php多維陣列所組成.
        */
        public static function create(&$conf=array()){
        
                #初始化要回傳的結果
                $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["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("fileArgu","configFileAddr","content");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","array");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                $conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("web");
                #$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
                        
                #debug
                #var_dump($conf["content"]);exit;       
                        
                #函式說明:
                #將字串寫入到檔案
                #回傳結果:
                #$result["status"],"true"表示檔案寫入成功,"false"表示檔案寫入失敗.
                #$result["error"],錯誤訊息陣列.
                #$result["function"],當前執行的函數名稱.
                #$result["fileInfo"],實際上寫入的檔案資訊陣列.
                #$result["fileInfo"]["createdFileName"],建立好的檔案名稱.
                #$result["fileInfo"]["createdFilePath"],檔案建立的路徑.
                #$result["fileInfo"]["createdFilePathAndName"].建立好的檔案名稱與路徑.
                #$result["argu"],使用的參數.
                #必填參數:
                #$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
                $conf["fileAccess::writeTextIntoFile"]["fileArgu"]=$conf["fileArgu"];
                #可省略參數:
                #$conf["fileName"],字串,爲要編輯的檔案名稱,預設為隨機產生的檔案名稱.
                $conf["fileAccess::writeTextIntoFile"]["fileName"]=$conf["configFileAddr"];
                #$conf["inputString"],字串,爲要寫入到裏面的內容，若要每筆資料寫入後換行，則可以在字串內容後面加上 \r\n 即可,預設為"".
                $conf["fileAccess::writeTextIntoFile"]["inputString"]=base64_encode(urlencode(json_encode($conf["content"])));
                #$conf["writeMethod"],字串,爲檔案撰寫的方式,可省略,是複寫'a'還是,重新寫入'w',預設爲'w',重新寫入.
                #$conf["writeMethod"]="a";
                #$conf["checkRepeat"],字串,"true"代表建立檔案之前要先檢查檔案是否存在,若存在則在原名稱後面加上從(1)開始的編號.
                #$conf["checkRepeat"]="";
                #$conf["filenameExtensionStartPoint"],字串,檔案的副檔名是從倒數第幾個小數點(dot)開始,預設為"1",最後一個小數點,必須與$conf["checkRepeat"]搭配才會生效.
                #$conf["filenameExtensionStartPoint"]="";
                #$conf["repeatNameRule"],字串,遇到相同名稱的檔案要如何加上識別的編號,編號用「\$i」表示,預設為"(\$i)",必須與$conf["checkRepeat"]搭配才會生效.
                #$conf["repeatNameRule"]="";
                #$conf["web"],檔案是否位於網站上"true",若是在檔案系統則為"false",預設為"true".
                $conf["fileAccess::writeTextIntoFile"]["web"]="false";
                #參考資料:
                #無.
                #備註:
                #無.
                $writeTextIntoFile=fileAccess::writeTextIntoFile($conf["fileAccess::writeTextIntoFile"]);
                unset($conf["fileAccess::writeTextIntoFile"]);
        
                #如果執行敗
                if($writeTextIntoFile["status"]=="false"){
                        
                        #設置錯誤識別
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$writeTextIntoFile;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
        
                #設置定義正常
                $result["status"]="true";
        
                #回傳結果
                return $result;
        
                }#function create end
        
        /*
        #函式說明:
        #提供post的變數查尋定義檔，給予回應.
        #回傳結果:
        #$result["status"],執行是否正常,"true"為正常,"false"為不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數名稱.
        #$result["argu"],使用的參數陣列.
        #$result["founded"],"true"代表有找到定義,"false"代表沒有找到定義.
        #$result["content"],定義對應的內容.
        #必填參數:
        #$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
        $conf["fileArgu"]=__FILE__;
        #$conf["configFileAddr"],字串,定義檔位置與名稱
        $conf["configFileAddr"]="";
        #可省略參數:
        #$conf["web"],是要取得網路上的檔案則為"true";反之則為"false",預設為後者.
        #$conf["web"]="false";
        #參考資料:
        #無.
        #備註:
        #檔案內容的格式為多行json編碼然後url編碼然後base64編碼後的內容,每行代表一組定義.每組定義的json格式為php多維陣列所組成.
        */
        public static function server(&$conf=array()){
        
                #初始化要回傳的結果
                $result=array();

                #儲存當前執行的函數
                $result["function"]=__FUNCTION__;

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

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

                        #回傳結果
                        return $result;
        
                        }#if end
        
                #記錄所使用的參數
                $result["argu"]=$conf;
        
                #檢查參數
                #函式說明：
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息
                #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
                #$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
                #$result["notNeedVar"],字串陣列,多餘的參數名稱.
                #必填寫的參數：
                #$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("fileArgu","configFileAddr");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("web");
                #$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
        
                #debug
                #var_dump($checkArguments);exit;
        
                #函式說明：
                #依據行號分隔抓取檔案的內容,結果會回傳一個陣列
                #回傳的變數說明:
                #$result["status"],執行是否成功，"true"代表成功；"fasle"代表失敗.
                #$result["error"],錯誤訊息提示.
                #$result["warning"],警告訊息.
                #$result["function"],當前執行的函數名稱.
                #$result["fileContent"],爲檔案的內容陣列.
                #$result["lineCount"],爲檔案內容總共的行數.
                #$result["fullContent"],為檔案的完整內容.
                #$result["base64data"],為檔案的base64內容.
                #$result["mimeType"],為檔案的mime type.
                #必填的參數：
                #$conf["filePositionAndName"],字串,爲檔案的位置以及名稱.
                $conf["fileAccess::getFileContent"]["filePositionAndName"]=$conf["configFileAddr"];
                #$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
                $conf["fileAccess::getFileContent"]["fileArgu"]=$conf["fileArgu"];
                #可省略參數:
                #$conf["web"],是要取得網路上的檔案則為"true";反之則為"false".
                $conf["fileAccess::getFileContent"]["web"]=$conf["web"];
                #參考資料：
                #file(),取得檔案內容的行數.
                #file=>http:#php.net/manual/en/function.file.php
                #rtrim(),剔除透過file()取得每行內容結尾的換行符號.
                #filesize=>http://php.net/manual/en/function.filesize.php
                $getFileContent=fileAccess::getFileContent($conf["fileAccess::getFileContent"]);
                unset($conf["fileAccess::getFileContent"]);
                
                #如果讀取檔案失敗
                if($getFileContent["status"]==="false"){
                
                        #設置錯誤識別
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$getFileContent;
                        
                        #回傳結果
                        return $result;
                
                        }#if end
                
                #debug
                #var_dump($getFileContent);exit;
                
                #儲存key的結構
                $keys=array();
                
                #如果沒有 post 變數存在
                if(count($_POST)<1){
                
                        #設置錯誤識別
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"][]="沒有post變數";
                        
                        #回傳結果
                        return $result;
                
                        }#if end
                
                #debug
                #var_dump($_POST);exit;
                
                #取得第一層key
                $layer=array_keys($_POST)[0];
                
                #取得數值內容
                $values=$_POST[$layer];
                
                #如果該層級內容形態是陣列
                while(gettype($values)==="array"){
                
                        #抓取查尋的key結構
                        $keys[]=$layer;
                        
                        #取得新層級的key
                        $layer=array_keys($values)[0];
                        
                        #取得新的內容
                        $values=$values[$layer];
                        
                        }#while end
                        
                #取得最後一層的key
                $keys[]=$layer;
                
                #debug
                #var_dump($keys);exit;
                
                #設置預設的定義內容
                $result["content"]="undefined";
                
                #var_dump($getFileContent);
                #var_dump(base64_decode($getFileContent));
                #var_dump(urldecode(base64_decode($getFileContent)));
                #var_dump(json_decode(urldecode(base64_decode($getFileContent))));
                #exit;
                
                #針對每行
                foreach($getFileContent["fileContent"] as $line){
                
                        #解析內容
                        $def=(array)json_decode(urldecode(base64_decode($line)));
                                
                        #debug
                        #var_dump($def);exit;
                        #var_dump($keys[$i]);exit;
                                
                        #初始化要找到的層級
                        $i=0;
                
                        #如果有所屬的層級
                        while(isset($def[$keys[$i]])){
                        
                                #取得層級所屬的內容
                                $def=(array)$def[$keys[$i]];
                        
                                #debug
                                #var_dump($def);exit;
                        
                                #如果還不是最後一個key層級
                                if(isset($keys[$i+1])){
                                
                                        #層級加一
                                        $i++;
                                
                                        }#if end
                        
                                #反之是最後一個key的層級了
                                else{
                                
                                        #設置定義的內容
                                        $result["content"]=$def;
                                
                                        #設置有找到定義
                                        $result["founded"]="true";
                                
                                        #設置定義正常
                                        $result["status"]="true";
                                
                                        #回傳結果
                                        return $result;
                                
                                        }#else end
                        
                                }#while end
                                
                        #到這邊代表沒有符合的元素
                
                        }#foreach end
                        
                #設置定義正常
                $result["status"]="true";
        
                #設置沒有找到定義
                $result["founded"]="false";
        
                #回傳結果
                return $result;
        
                }#function server end
        
        /*
        #函式說明:
        #查尋有使用 server 函式提供組態設定檔的服務,取得key的value.
        #回傳結果:
        #$result["status"],執行是否正常,"true"為正常,"false"為不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數名稱.
        #$result["content"],結果.
        #必填參數:
        #$conf["server"],字串,組態服務設定服務的網址
        $conf["server"]="";
        #$conf["postName"],字串,POST變數的名稱,亦即要查尋的定義名稱.
        $conf["postName"]="";
        #$conf["fileArgu"],字串,變數__FILE__的內容.
        $conf["fileArgu"]=__FILE__;
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #目前僅能跟server函式提供的服務對接.
        */
        public static function client(&$conf=array()){
        
                #初始化要回傳的結果
                $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["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("server","postName","fileArgu");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); 
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                #$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("web");
                #$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
                
                #函式說明:
                #運行curl cmd
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["error"],錯誤訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["content"],取得的回應內容陣列.
                #$result["fullContent"],取得回應的完整字串內容.
                #$result["cookie"],cookie檔案的位置與名稱.
                #$result["cmd"],執行的command.
                #$result["argu],使用的參數.
                #必填參數:
                #$conf["url"],字串,目標url.
                $conf["cmd::curlCmd"]["url"]=$conf["server"];
                #$conf["fileArgu"],字串,變數__FILE__的內容.
                $conf["cmd::curlCmd"]["fileArgu"]=$conf["fileArgu"];
                #可省略參數:
                #$conf["header"],字串陣列,要傳送的header.
                #$conf["header"]=array();
                #$conf["allowAnySSLcertificate"],字串,是否允許不可信任的SSL憑證,預設為"true".
                #$conf["allowAnySSLcertificate"]="";
                #$conf["postVar"],字串陣列,每個要傳送的post變數名稱(陣列的key值)與數值.
                $conf["cmd::curlCmd"]["postVar"]=array($conf["postName"]=>"");
                #$conf["rawPost"]="字串",要傳送的raw post內容.
                #$conf["rawPost"]="";
                #$conf["urlEncode"],字串,post的內容是否要url_encode,"true"代表要,預設為"false"代表不要.
                #$conf["urlEncode"]="false";
                #$conf["agent"],字串,user agent的名稱.
                #$conf["agent"]="";
                #$conf["cookie"],字串，cookie位置與檔案位置.
                #$conf["cookie"]="";
                #$conf["forceNewCookie"],字串,是否要重置cookie,"true"代表要,"false"代表不要,預設為"false".
                #$conf["forceNewCookie"]="";
                #$conf["inBg"],字串,"true"代表要在背景中執行;反之則為"false".
                #$conf["inBg"]="true";
                #備註:
                #無.
                $curlCmd=catchWebContent::curlCmd($conf["cmd::curlCmd"]);
                unset($conf["cmd::curlCmd"]);
        
                #如果執行失敗
                if($curlCmd["status"]==="false"){
                
                        #設置錯誤識別
                        $result["status"]="false";
                        
                        #設置錯誤訊息
                        $result["error"]=$curlCmd;
                        
                        #回傳結果
                        return $result;
                
                        }#if end
                
                #設置執行正常
                $result["status"]="true";
        
                #設置回應的內容
                $result["content"]=json_decode($curlCmd["fullContent"]);
                
                #回傳結果
                return $result;
        
                }#function client end
        
        }#class config end

?>