WebSVN – php-qbpwcf – /trunk/usr/lib64/qbpwcf/arrays.php

<?php

/*

        QBPWCF, Quick Build PHP website Component base on Fedora Linux.
    Copyright (C) 2014~2025 MIN ZHI, 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;

/*
類別說明:
跟陣列處理相關的類別.
備註:
無.
*/
class arrays{

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

        /*
        #函式說明:
        #建立一個陣列，可以指派陣列的內容，然後回傳
        #回傳的結果：
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$result["function"],當前執行的函數名稱.
        #$result["error"],錯誤訊息陣列.
        #$result["argu"],使用的參數.
        #$result["content"],爲陣列變數內容
        #必填參數：
        #$conf["arrayContent"],陣列,陣列元素的內容，須爲陣列值。
        $conf["arrayContent"]=array();
        #可省略參數：
        #$conf["arrayCounts"],字串,爲陣列的元素有幾個，若沒設定，則數量爲$conf["arrayContent"]裏的元素數量.
        #$conf["arrayCounts"]="";
        #$conf["theSameAs"],字串,若設爲"true"，則所有元素內容都跟第一個元素內容相同.
        #$conf["theSameAs"]="true";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function create(&$conf){

                #初始化要回傳的變數
                $result=array();

                #初始化要回傳的變數
                $result["content"]=array();

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

                #取得參數
                $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["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #必填寫的參數：
                $conf["arrays"]["isexistMuti"]["varInput"]=$conf;#要檢查的陣列變數
                $conf["arrays"]["isexistMuti"]["variableCheck"]=array("arrayContent");#要檢查的變數名稱陣列，形態爲陣列變數，例如: $conf["variableCheck"] = array("id","account","password");
                #可以省略的參數：
                $conf["variableType"]=array("array");#要檢查的陣列變數內的元素應該爲何種變數形態，形態爲陣列 例如: $conf[variableType] = array("string","int","double");
                #$conf["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話，請設為"false",預設為也算是有設置。
                $checkResult=variableCheck::isexistMulti($conf["arrays"]["isexistMuti"]);
                unset($conf["arrays"]["isexistMuti"]);

                #如果 $checkResult 執行失敗
                if($checkResult["status"]=="false"){

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

                        #設置執行錯誤訊息
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #如果參數檢查有誤
                if($checkResult["passed"]=="false"){

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

                        #設置執行錯誤訊息
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #如果 $conf["arrayCounts"] 與 $conf["theSameAs"] 有設定
                if(isset($conf["arrayCounts"]) && isset($conf["theSameAs"])){

                        #如果 $conf["theSameAs"] 爲 "true"
                        if($conf["theSameAs"]=="true"){

                                #執行 $conf["arrayCounts"] 次
                                for($i=0;$i<$conf["arrayCounts"];$i++){

                                        #放置陣列元素
                                        $result["content"][$i]=$conf["arrayContent"][0];

                                        }#for end

                                }#if end

                        #反之
                        else{

                                echo"<p>請搭配\$conf[\"theSameAs\"]參數使用!<p>";

                                }#else end

                        }#else end

                #反之依據給於的元素數量去給與陣列內容的數量
                else{

                        #執行 count($conf["arrayContent"]) 次
                        for($i=0;$i<count($conf["arrayContent"]);$i++){

                                #放置陣列元素
                                $result["content"][$i]=$conf["arrayContent"][$i];

                                }#for end

                        }#else end

                #執行到這邊代表執行正常
                $result["status"]="true";

                #回傳結果
                return $result;

                }#function create end

        /*
        #函式說明:
        #將陣列的key重新排序，然後回傳，以便後續存取,也可以指定key的內容,但一定要跟元素數量相同。
        #回傳的解果：
        #$result["status"],執行是否成功,"true"代表成功,"false"代表失敗.
        #$result["error"],執行錯誤的訊息.
        #$result["function"],當前執行的函數名稱.
        #$result["dataContent"],儲存陣列元素的內容.若指定了key的名稱，則 $result["dataContent"] 會變成 $result["dataContent"]["指定的key名稱"]
        #$result["dataCount"],儲存陣列元素的數量.
        #必填參數：
        #$conf["arrayContent"],陣列,陣列變數.
        $conf["arrayContent"]=array();
        #可省略參數：
        #$conf["specifiesKeyArray"],陣列,指定key的名稱，須與$conf["arrayContent"]的元素數量相同.
        #$conf["specifiesKeyArray"]=array();
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function createV2(&$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

                #如果 $conf["arrayContent"] 不存在
                if(!isset($conf["arrayContent"])){

                        #設置執行錯誤
                        $result["status"]="false";

                        #設置錯誤訊息
                        $result["error"][]="參數\$conf[\"arrayContent\"]未設置！";

                        #回傳結果
                        return $result;

                        }#if end

                #如果 $conf["arrayContent"] 存在
                if(isset($conf["arrayContent"])){

                        #檢查 $conf["arrayContent"] 形態是否正確
                        #回傳的結果：
                        #$result["status"],執行是否正常
                        #$result["error"].錯誤訊息陣列
                        #$result["passed"],若爲"true"則表示形態正確，"false"為形態有誤.
                        #$result["function"],當前執行的函數名稱.
                        #必填參數:
                        $conf_checkType["vName"]=$conf["arrayContent"];#要檢查的變數
                        $conf_checkType["vType"]="array";#變數的形態
                        $checkType=variableCheck::checkType($conf_checkType);
                        unset($conf_checkType);

                        #如果檢查形態失敗
                        if($checkType["status"]=="false"){

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

                                #設置執行錯誤
                                $result["error"]=$checkType;

                                #回傳結果
                                return $result;

                                }#if end

                        #如果檢查形態不通過
                        if($checkType["passed"]=="false"){

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

                                #設置執行錯誤
                                $result["error"]=$checkType;

                                #回傳結果
                                return $result;

                                }#if end

                        }#if end

                #初始化計數變數
                $times=0;

                #針對每個陣列元素
                foreach($conf["arrayContent"] as $arrayContentKey=>$arrayContentValue){

                        #如果有指定 $conf["specifiesKeyArray"]
                        if(isset($conf["specifiesKeyArray"])){

                                #檢查有無進入該判斷式
                                #echo "<p>entered!<p>";

                                #則指派key的名稱
                                #將其指派到 $result["dataContent"] 陣列裏面
                                $result["dataContent"][$conf["specifiesKeyArray"][$times]]=$arrayContentValue;

                                #檢查變數內容
                                #var_dump($result);

                                #計數加1
                                $times++;

                                }#if end

                        #反之，按照預設的key
                        else{

                                #將其指派到 $result["dataContent"] 陣列裏面
                                $result["dataContent"][]=$arrayContentValue;

                                }#else end

                        }#foreach end

                #取得陣列元素的數量
                $result["dataCount"]=count($result["dataContent"]);

                #執行到這邊代表執行正常
                $result["status"]="true";

                #回傳結果
                return $result;

                }#function end

        /*
        #函式說明:
        #建立連續整數的陣列
        #回傳的結果：
        #$result["status"],執行是否正常,"true"為正常,"false"為不正常.
        #$result["error"],錯誤訊息陣列
        #$result["function"],當前執行的函數名稱
        #$result["counts"],爲整數陣列裏面有幾個元素。
        #$result["content"],爲整數陣列元素的內容。
        #必填參數：
        #$conf["end"],字串/整數,爲整數陣列的結束點.
        $conf["end"]="";
        #可省略參數
        #$conf["start"],字串/整數,爲整數陣列的起始點，預設爲從"1"開始。
        #$conf["start"]="";
        #參考資料
        #無.
        #備註:
        #無.
        */
        public static function createIntArray(&$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

                #如果 $conf["end"] 參數未設置
                if(!isset($conf["end"])){

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

                        #設置錯誤訊息
                        $result["error"][]="\$conf[\"end\"]未設置!";

                        #回傳結果
                        return $result;

                        }#if end

                #如果 $conf["start"] 參數未設置
                if(!isset($conf["start"])){

                        #則預設設爲"1"
                        $conf["start"]=1;

                        }#if end

                #執行 $conf["end"]-$conf["start"]+1 次
                for($i=(int)($conf["start"]);$i<=$conf["end"];$i++){

                        #指派陣列元素
                        $result["content"][]=$i;

                        }#for end

                #設置執行成功
                $result["status"]="true";

                #取得陣列元素的數量
                $result["counts"]=count($result["content"]);

                #回傳陣列的結果
                return $result;

                }#function createIntArray end

        /*
        #函式說明:
        #建立含有前置與後置字串的號碼連續陣列.
        #回傳的結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$result["function"],當前執行的函數名稱.
        #$result["error"],錯誤訊息陣列.
        #$result["counts"]#爲整數陣列裏面有幾個元素。
        #$result["content"]#爲整數陣列元素的內容。
        #必填參數:
        #$conf["end"],字串,爲整數陣列的結束點.
        $conf["end"]="";#爲整數陣列的結束點.
        #可省略參數:
        #$conf["stringHead"],字串,陣列內元素內容的前置字串，預設為 "q-".
        #$conf["stringHead"]="q-";
        #$conf["stringTail"],字串,陣列內元素內容的後置字串，預設為 ".".
        #$conf["stringTail"]=".";
        #$conf["start"],字串/整數,爲整數陣列的起始點，預設爲從"1"開始.
        #$conf["start"]="1";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function createCustomIntArray(&$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

                #如果 $conf["end"] 參數未設置
                if(!isset($conf["end"])){

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

                        #設置錯誤訊息
                        $result["error"]="\$conf[\"end\"]未設置!";

                        #回傳結果
                        return $result;

                        }#if end

                #如果 $conf["stringHead"] 參數未設置
                if(!isset($conf["stringHead"])){

                        #則預設設爲"q-"
                        $conf["stringHead"]="q-";

                        }#if end

                #如果 ($conf["stringTail"] 參數未設置
                if(!isset($conf["stringTail"])){

                        #則預設為"."
                        $conf["stringTail"]=".";

                        }#if end

                #如果 $conf["start"] 參數未設置
                if(!isset($conf["start"])){

                        #則預設設爲"1"
                        $conf["start"]="1";

                        }#if end

                #執行 $conf["end"]-$conf["start"]+1 次
                for($i=$conf["start"];$i<=$conf["end"];$i++){

                        #指派陣列元素
                        $result["content"][]=$conf["stringHead"].$i.$conf["stringTail"];

                        }#if end

                #取得陣列元素的數量
                $result["counts"]=count($result["content"]);

                #執行到這邊代表執行正常
                $result["status"]="true";

                #回傳結果
                return $result;

                }#end function

        /*
        #函式說明:
        #比對兩個陣列變數，如果其中一個陣列變數的元素不存在，則將之消去，然後進行替補。另一個陣列變數則也要做同步的動作。
        #回傳的結果：
        #$result["status"],執行是否正常，"true"代表正常，"false"代表不正常.
        #$result["error"],錯誤訊息.
        #$result["function"],當前執行的函數名稱.
        #$result["newArraysA"]，經過整理與同步的陣列變數A.
        #$result["newArraysB"]，經過整理與同步的陣列變數B.
        #必填參數：
        #$conf["arraysA"],陣列,用來跟陣列變數B比較的陣列變數A.
        $conf["arraysA"]=array();
        #$conf["arraysB"],陣列,用來跟陣列變數A比較的陣列變數B.
        $conf["arraysB"]=array();
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function compareAndModifyTwoArrays(&$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

                #將陣列A放規則的陣列裏面
                #函式說明:
                #將陣列的key重新排序，然後回傳，以便後續存取。
                #回傳的解果：
                #$result["status"],執行是否成功,"true"代表成功,"false"代表失敗.
                #$result["error"],執行錯誤的訊息.
                #$result["function"],當前執行的函數名稱.
                #$result["dataContent"],儲存陣列元素的內容.
                #必填參數：
                $conf_createV2["arrayContent"]=$conf["arraysA"];#陣列變數
                $newArraysA=arrays::createV2($conf_createV2);
                unset($conf_createV2);

                #如果 $newArraysA 執行失敗
                if($newArraysA["status"]=="false"){

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

                        #設置執行錯誤
                        $result["error"]=$newArraysA;

                        #回傳結果
                        return $result;

                        }#if end

                #將陣列B放規則的陣列裏面
                #函式說明:
                #將陣列的key重新排序，然後回傳，以便後續存取。
                #回傳的解果：
                #$result["status"],執行是否成功,"true"代表成功,"false"代表失敗.
                #$result["error"],執行錯誤的訊息.
                #$result["function"],當前執行的函數名稱.
                #$result["dataContent"],儲存陣列元素的內容.
                #必填參數：
                $conf_createV2["arrayContent"]=$conf["arraysB"];#陣列變數
                $newArraysB=arrays::createV2($conf_createV2);
                unset($conf_createV2);

                #如果 $newArraysB 執行失敗
                if($newArraysB["status"]=="false"){

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

                        #設置執行錯誤
                        $result["error"]=$newArraysB;

                        #回傳結果
                        return $result;

                        }#if end

                #將新的陣列A與B當中屬於null的對稱位置踢除，然後進行替補。
                for($i=0;$i<count($newArraysA["dataContent"]);$i++){

                        #如果對稱的變數內容存在
                        if( isset($newArraysA["dataContent"][$i]) && isset($newArraysB["dataContent"][$i]) ){

                                #將對稱的變數放進新的陣列裏面
                                $result["newArraysA"][]=$newArraysA["dataContent"][$i];
                                $result["newArraysB"][]=$newArraysB["dataContent"][$i];

                                }#if end

                        }#for end

                #執行到這邊代表執行正常
                $result["status"]="true";

                #回傳結果
                return $result;

                }# funciton compareAndModify2Arrays end

        /*
        #函式說明:
        #將陣列A中存在於陣列B中的元素移除,並重新按照順序排序.
        #回傳的結果：
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$result["error"],錯誤訊息.
        #$result["function"],當前執行的函數.
        #$result["argu"],使用的參數.
        #$result["empty"],移除完元素後是否為空陣列,"true"為是,"false"為否.
        #$result["content"]["byName"],剔除掉特定元素的陣列,使用原來陣列的key來儲存.
        #$result["content"]["byNumber"],剔除掉特定元素的陣列,使用從0開始的整數key來儲存.
        #必填參數：
        #$conf["arrayA"],陣列,要處理的原始數字陣列.
        $conf["arrayA"]=array();
        #$conf["arrayB"],陣列,如果arrayA裡面的元素數值有出現在此陣列，則要從A陣列與B陣列中移除.
        $conf["arrayB"]=array();
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #用array_diff()可快速得到結果
        */
        public static function eraseRepeatedElement(&$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["argu"]=$conf;

                #檢查參數
                #函式說明:
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
                #$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("arrayA","arrayB");
                #$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["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

                #剔除掉特定元素的陣列,使用原來陣列的key來儲存.
                $result["content"]["byName"]=array();

                #剔除掉特定元素的陣列,使用從0開始的整數key來儲存.
                $result["content"]["byNumber"]=array();

                #如果arrayB沒有內容
                if(count($conf["arrayB"])===0){

                        #直接將arrayA的內容放進去
                        $result["content"]["byName"]=$conf["arrayA"];

                        #針對每隔陣列a
                        foreach($conf["arrayA"] as $val){

                                $result["content"]["byNumber"][]=$val;

                                }

                        }#if end

                else{
                        #針對 $conf["arrayA"] 的每個元素
                        foreach($conf["arrayA"] as $aAk => $aAv){

                                #針對 $conf["arrayB"] 的每個元素
                                foreach($conf["arrayB"] as $aBk => $aBv){

                                        /*
                                        #debug
                                        echo "\$aAV:".$aAv.PHP_EOL;
                                        echo "\$aBV:".$aBv.PHP_EOL;
                                        echo "(\$aAv===\$aBv):".($aAv===$aBv).PHP_EOL;
                                        */

                                        #如果arrayA的元素數值存在於陣列arrayB
                                        if($aAv===$aBv){

                                                /*
                                                #debug
                                                echo "(\$aAv===\$aBv):".($aAv===$aBv).PHP_EOL;
                                                */

                                                #移除重複的元素
                                                #unset($conf["arrayA"][$aAk]);
                                                #unset($conf["arrayB"][$aBk]);

                                                /*
                                                #debug
                                                echo $aAv." repeated, ignore it.".PHP_EOL;
                                                */

                                                #跳過
                                                continue 2;

                                                }#if end

                                        /*
                                        #debug
                                        echo "(\$aAv!==\$aBv):".($aAv!==$aBv).PHP_EOL;
                                        echo "add ".$aAv." ".PHP_EOL;
                                        */

                                        #如果還沒比較到最後一個
                                        #參考資料:
                                        #array_key_last => https://stackoverflow.com/questions/1070244/how-to-determine-the-first-and-last-iteration-in-a-foreach-loop
                                        if($conf["arrayB"][$aBk]!==$conf["arrayB"][array_key_last($conf["arrayB"])]){

                                                /*
                                                #debug
                                                echo "not last, continue...".PHP_EOL;
                                                */

                                                #繼續比
                                                continue;

                                                }#if end

                                        #以key取得未重複的元素
                                        $result["content"]["byName"][$aAk]=$aAv;

                                        #如果IP未重複
                                        if(!in_array($aAv,$result["content"]["byNumber"])){

                                                #重新排列未重複的元素
                                                $result["content"]["byNumber"][]=$aAv;

                                                }#if end

                                        }#foreach end

                                }#foreach end

                        }#else end

                #設置有剩下未重複的元素
                $result["empty"]="false";

                #如果沒有剩下未重複的元素
                if($result["content"]["byName"]===array()){

                        #設置沒有剩下未重複的元素
                        $result["empty"]="true";

                        }#if end

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

                #回傳結果
                return $result;

                }#function eraseRepeatedElement end

        /*
        #函式說明:
        #將陣列中特定元素剔除,並重新按照順序排序
        #回傳的結果：
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$result["error"],錯誤訊息
        #$result["function"],當前執行的函數
        #$result["empty"],移除完元素後是否為空陣列,"true"為是,"false"為否.
        #$result["content"]["byName"],剔除掉特定元素的陣列,使用原來陣列的key來儲存.
        #$result["content"]["byNumber"],剔除掉特定元素的陣列,使用從0開始的整數key來儲存.
        #必填參數：
        #$conf["rawInputArray"],陣列,要處理的原始數字陣列.
        $conf["rawInputArray"]=array();
        #$conf["eraseElementKey"],陣列,要移除的元素key值.
        $conf["eraseElementKey"]=array();
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function eraseElement(&$conf){

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

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

                #初始化要回傳的陣列
                $result["content"]=array();

                #如果 $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("rawInputArray","eraseElementKey");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","string");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                $conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$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

                #計數的變數
                $times=0;

                #整理陣列
                foreach($conf["rawInputArray"] as $key => $value){

                        #如果不是要剔除的元素則放進新的陣列裏面
                        if($key!=$conf["eraseElementKey"]){

                                /*

                                #用數字0開始來儲存要取的元素內容
                                $result["content"]["byName"][$times]=$value;

                                #用元素自己的名字來儲存要取的元素內容
                                $result["content"]["byNumber"][$key]=$value;

                                */

                                #用數字0開始來儲存要取的元素內容
                                $result["content"]["byNumber"][$times]=$value;

                                #用元素自己的名字來儲存要取的元素內容
                                $result["content"]["byName"][$key]=$value;

                                #記數加一
                                $times++;

                                }#if end

                        }#foreach end

                #如果 $result["content"]["byName"] 不存在
                if(!isset($result["content"]["byName"])){

                        #設為"true",移除元素後為空陣列.
                        $result["empty"]="true";

                        #設置要回傳的空陣列
                        $result["content"]["byNumber"]=array();
                        $result["content"]["byName"]=array();

                        }#if end

                #反之
                else{

                        #設為"false",移除元素後不為空陣列.
                        $result["empty"]="false";

                        }#else end

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

                #回傳結果
                return $result;

                }#function eraseElement end

        /*
        #函式說明:
        #將陣列轉換成存有key與value的陣列
        #回傳的結果:
        #$result["status"],執行式否正常的識別,"true"代表執行正常,"false"代表執行不正常.
        #$result["function"],當前執行的函數
        #$result["error"],錯誤訊息.
        #$result[$i]["key"],原先$i+1個元素的key.
        #$result[$i]["value"],原先$i+1個元素的value.
        #必填參數：
        #$conf["rawInputArray"],陣列,要轉換的陣列變數.
        $conf["rawInputArray"]=array();
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function getKeyAndValue(&$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

                #如果 $conf["rawInputArray"] 沒有設置
                if(!isset($conf["rawInputArray"])){

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

                        #設置錯誤訊息
                        $result["error"]="\$conf[\"rawInputArray\"]沒有設置!";

                        #回傳結果
                        return $result;

                        }#if end

                #初始化計數
                $count=1;

                #取得每個元素的key值
                foreach($conf["rawInputArray"] as $key=>$value){

                        #另存 key
                        $result[$count]["key"]=$key;

                        #另存 value
                        $result[$count]["value"]=$value;

                        #$count加1
                        $count=$count+1;

                        }#foreach end

                #執行到這邊代表,執行正常
                $result["status"]="true";

                #回傳結果
                return $result;

                }#function getKeyAndValue end

        /*
        #函式說明:
        #將一個數值放進陣列指定的key裡面
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數名稱.
        #$result["content"],加入指定元素後的陣列.
        #必填參數:
        #$conf["value"],字串,要放入的數值.
        $conf["value"]="";
        #$conf["keyArray"],陣列,陣列的key,若為array("a","b","c"),則會建立$result["content"]["a"]["b"]["c"]陣列變數,其數值為$conf["value"].
        $conf["keyArray"]=array();
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function assignVarToArray(&$conf){

                #初始化要回傳的變數
                $result=array();

                #初始化當前執行的函數名稱
                $result["funciton"]=__FUNCTION__;

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

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

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

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

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

                                }#if end

                        #回傳結果
                        return $result;

                        }#if end

                #檢查參數設定是否正確
                #函式說明:
                #檢查陣列裡面的特定元素是否存在以及其變數型態是否正確，如果沒有設定則回傳提示訊息。
                #回傳的結果:
                #$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #必填寫的參數：
                $conf["variableCheck"]["isexistMuti"]["varInput"]=$conf;#要檢查的陣列變數
                $conf["variableCheck"]["isexistMuti"]["variableCheck"]=array("value","keyArray");#要檢查的變數名稱陣列，形態爲陣列變數，例如: $conf["variableCheck"] = array("id","account","password");
                #可以省略的參數：
                #$conf["variableType"]=array();#要檢查的陣列變數內的元素應該爲何種變數形態，形態爲陣列 例如: $conf[variableType] = array("string","int","double");
                #$conf["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話，請設為"false",預設為也算是有設置。
                $checkResult=variableCheck::isexistMulti($conf["variableCheck"]["isexistMuti"]);
                unset($conf["variableCheck"]["isexistMuti"]);

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

                #用於累加路徑層級的變數初始值
                $addedLayerVar=array();

                #針對每個key
                for($i=count($conf["keyArray"])-1;$i>=0;$i--){

                        #如果最底層的key
                        if($i==count($conf["keyArray"])-1){

                                #取得值
                                $addedLayerVar[$conf["keyArray"][$i]]=$conf["value"];

                                }#if end

                        #反之不是最底層的key
                        else{

                                #增加key的路徑
                                $addedLayerVar[$conf["keyArray"][$i]]=$addedLayerVar;

                                #移除舊有的路徑
                                unset($addedLayerVar[$conf["keyArray"][$i+1]]);

                                }#else end

                        }#for end

                #取得要回傳的陣列
                $result["content"]=$addedLayerVar;

                #執行到這邊代表執行正常
                $result["status"]="true";

                #回傳結果
                return $result;

                }#funciton assignVarToArray end

        /*
        #函式說明:
        #將含有特定符號的一行字串轉換為陣列
        #回傳的結果:
        #$result["status"],執行式否正常的識別,"true"代表執行正常,"false"代表執行不正常.
        #$result["function"],當前執行的函數
        #$result["error"],錯誤訊息.
        #$result["content"],分割好的字串陣列.
        #必填參數:
        #conf["inputString"],字串,要轉換為陣列的字串
        $conf["inputString"]="";#要轉換為陣列的字串
        #可省略參數:
        #$conf["spiltSymbol"],字串,用來分割 $conf["inputString"] 的字串,預設為",".
        #$conf["spiltSymbol"]=",";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function getArrayFromString(&$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["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #必填寫的參數：
                $conf["variableCheck"]["isexistMuti"]["varInput"]=$conf;#要檢查的陣列變數
                $conf["variableCheck"]["isexistMuti"]["variableCheck"]=array("inputString");#要檢查的變數名稱陣列，形態爲陣列變數，例如: $conf["variableCheck"] = array("id","account","password");
                #可以省略的參數：
                #$conf["variableType"]=array();#要檢查的陣列變數內的元素應該爲何種變數形態，形態爲陣列 例如: $conf[variableType] = array("string","int","double");
                #$conf["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話，請設為"false",預設為也算是有設置。
                $checkResult=variableCheck::isexistMulti($conf["variableCheck"]["isexistMuti"]);
                unset($conf["variableCheck"]["isexistMuti"]);

                #如果參數檢查失敗
                if($checkResult["status"]=="false"){

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

                        #設置執行錯誤
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #如果參數檢查不通過
                if($checkResult["passed"]=="false"){

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

                        #設置執行錯誤
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #如果 $conf["spiltSymbol"] 沒有設置
                if(!isset($conf["spiltSymbol"])){

                        #預設為","
                        $conf["spiltSymbol"]=",";

                        }#if end

                #函式說明:
                #將固定格式的字串分開，並回傳分開的結果。
                #回傳的參數:
                #$result["dataArray"],爲分割好字串的陣列內容,$result["dataArray"][$i]爲第($i+1)段的內容。
                #$result["dataCounts"],爲總共分成幾段
                #必填參數：
                $conf["stringProcess"]["spiltString"]["stringIn"]=$conf["inputString"];#要處理的字串。

                #如果 $conf["spiltSymbol"] 有設置
                if(isset($conf["spiltSymbol"])){

                        #設置分割用的字串
                        $conf["stringProcess"]["spiltString"]["spiltSymbol"]=$conf["spiltSymbol"];

                        }#if end

                $spiledString=stringProcess::spiltString($conf["stringProcess"]["spiltString"]);
                unset($conf["stringProcess"]["spiltString"]);

                #如果分割字串失敗
                if($spiledString["status"]=="false"){

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

                        #設置執行錯誤
                        $result["error"]=$spiledString;

                        #回傳結果
                        return $result;

                        }#if end

                #如果有最後一個選項
                if(isset($result["dataArray"][count($spiledString["dataArray"])-1])){

                        #如果最後一個選項為空
                        if($result["dataArray"][count($spiledString["dataArray"])-1]==""){

                                #卸除該元素
                                unset($result["dataArray"][count($spiledString["dataArray"])-1]);

                                }#if end

                        }#if end

                #取得陣列
                $result["content"]=$spiledString["dataArray"];

                #執行正常的識別
                $result["status"]="true";

                #回傳結果
                return $result;

                }#function getArrayFromString end

        /*
        #函式說明:
        #將多個一維陣列串聯起來,key從0開始排序.
        #回傳的結果：
        #$result["status"],"true"表執行正常,"false"代表執行不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數.
        #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
        #$result["content"],合併好的一維陣列.
        #必填參數
        #$conf["inputArray"],陣列,要合併的一維陣列變數，例如：=array($array1,$array2);
        $conf["inputArray"]=array();
        #可省略參數:
        #$conf["allowRepeat"],字串,預設為"true",允許重複的結果;若為"false"則不會出現重複的元素內容.
        #$conf["allowRepeat"]="true";
        #$conf["looseDiff"],字串,預設為"false",代表要嚴謹判斷為有相異,例如陣列中元素的key順序不同(整數)就代表有相異;反之為"true",例如陣列中元素的key順序不同(非整數),但value有相同,則視為無相異.
        #$conf["looseDiff"]="false";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function mergeArray(&$conf){

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

                #初始話要回傳的陣列
                $result["content"]=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["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("inputArray");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                #$conf["canBeEmptyString"]="false";
                #$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
                #$conf["canNotBeEmpty"]=array();
                #$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
                #$conf["canBeEmpty"]=array();
                #$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
                #$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("logPath");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("allowRepeat","looseDiff");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true","false");
                #$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

                #針對要合併的每組一維陣列
                foreach($conf["inputArray"] as $array){

                        #如果要合併的元素不是陣列
                        if(gettype($array)!=="array"){

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

                                #設置錯誤訊息
                                $result["error"]=$checkArguments;

                                #回傳結果
                                return $result;

                                }#if end

                        #針對該陣列中的每個元素
                        foreach($array as $arrayAdded){

                                #如果不允許重複的內容
                                if($conf["allowRepeat"]==="false"){

                                        #如果要寬鬆的視為相異
                                        if($conf["looseDiff"]==="true"){

                                                #如果有重複了
                                                if(in_array($arrayAdded,$result["content"])){

                                                        #跳到下一個
                                                        continue;

                                                        }#if end

                                                }#if end

                                        #反之,代表不能寬鬆的認為相異
                                        else{

                                                #針對每個既有的元素
                                                foreach($result["content"] as $key=>$val){

                                                        #取得元素的參考
                                                        $valExist=&$val;

                                                        #取得要檢查是否重複的元素
                                                        $valAdded=&$arrayAdded;

                                                        #如果既有元素跟要檢查是否重複的元素均是陣列
                                                        if( (gettype($valExist)==="array") && (gettype($valAdded)==="array") ){

                                                                #預設不知道是否有差異
                                                                $varExistAndValAddedIsDiff="?";

                                                                #針對每個已存在元素
                                                                foreach($valExist as $veKey => $veVal){

                                                                        #若存在 key 相同的地方
                                                                        if(isset($valAdded[$veKey])){

                                                                                #如果 $veVal 跟 $valAdded[$veKey] 兩者都是陣列
                                                                                if( gettype($veVal)==="array" && gettype($valAdded[$veKey])==="array" ){

                                                                                        #用來判斷是否 陣列 $veVal 跟 $valAdded[$veKey] 有相異的元素數量
                                                                                        $sameCount=count($veVal);

                                                                                        #如果 陣列 $valAdded 的元素數量比較多
                                                                                        if($sameCount<count($valAdded[$veKey])){

                                                                                                #更新 用來判斷是否 陣列 $veVal 跟 $valAdded[$veKey] 有相異的元素數量
                                                                                                $sameCount=count($valAdded[$veKey]);

                                                                                                }#if end

                                                                                        #遞回處理
                                                                                        #函式說明:
                                                                                        #將多個一維陣列串聯起來,key從0開始排序.
                                                                                        #回傳的結果：
                                                                                        #$result["status"],"true"表執行正常,"false"代表執行不正常.
                                                                                        #$result["error"],錯誤訊息陣列.
                                                                                        #$result["function"],當前執行的函數.
                                                                                        #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
                                                                                        #$result["content"],合併好的一維陣列.
                                                                                        #必填參數
                                                                                        #$conf["inputArray"],陣列,要合併的一維陣列變數，例如：=array($array1,$array2);
                                                                                        $conf["arrays::mergeArray"]["inputArray"]=array($veVal,$valAdded[$veKey]);
                                                                                        #可省略參數:
                                                                                        #$conf["allowRepeat"],字串,預設為"true",允許重複的結果;若為"false"則不會出現重複的元素內容.
                                                                                        $conf["arrays::mergeArray"]["allowRepeat"]=$conf["allowRepeat"];
                                                                                        #$conf["looseDiff"],字串,預設為"false",代表要嚴謹判斷為有相異,例如陣列中元素的key順序不同(整數)就代表有相異;反之為"true",例如陣列中元素的key順序不同(整數)，但value有相對應且相同.
                                                                                        $conf["arrays::mergeArray"]["looseDiff"]=$conf["looseDiff"];
                                                                                        #參考資料:
                                                                                        #無.
                                                                                        #備註:
                                                                                        #無.
                                                                                        $mergeArray=arrays::mergeArray($conf["arrays::mergeArray"]);
                                                                                        unset($conf["arrays::mergeArray"]);

                                                                                        #如果執行失敗
                                                                                        if($mergeArray["status"]==="false"){

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

                                                                                                #設置錯誤訊息
                                                                                                $result["error"]=$mergeArray;

                                                                                                #回傳結果
                                                                                                return $result;

                                                                                                }#if end

                                                                                        #如果 合併好元素數量大於 陣列 $veVal 跟 $valAdded[$veKey] 有相異的元素數量
                                                                                        if( count($mergeArray["content"]) > $sameCount ){

                                                                                                #代表 $veVal 跟 $valAdded[$veKey] 是有差異的陣列

                                                                                                #設置有相異
                                                                                                $varExistAndValAddedIsDiff="true";

                                                                                                #跳出 foreach
                                                                                                break;

                                                                                                }#if end

                                                                                        }#if end

                                                                                #反之
                                                                                else{

                                                                                        #若 key 相同的地方,其 val 有相異
                                                                                        if($veVal!==$valAdded[$veKey]){

                                                                                                #設置有相異
                                                                                                $varExistAndValAddedIsDiff="true";

                                                                                                #跳出 foreach
                                                                                                break;

                                                                                                }#if end

                                                                                        }#else end

                                                                                }#if end

                                                                        #反之沒有  key 相同的地方
                                                                        else{

                                                                                #設置有相異
                                                                                $varExistAndValAddedIsDiff="true";

                                                                                #跳出 foreach
                                                                                break;

                                                                                }#else end

                                                                        }#foreach end

                                                                #如果沒有找到有相異的
                                                                if($varExistAndValAddedIsDiff==="?"){

                                                                        #設置無相異
                                                                        $varExistAndValAddedIsDiff="false";

                                                                        }#if end

                                                                #如果無相異
                                                                if($varExistAndValAddedIsDiff==="false"){

                                                                        #跳到下一個
                                                                        continue 3 ;

                                                                        }#if end

                                                                }#if end

                                                        #反之不是都為陣列,
                                                        else{

                                                                #若為同形態,且數值相同
                                                                if($valExist===$valAdded){

                                                                        #跳到下一個
                                                                        continue 2;

                                                                        }#if end

                                                                }#else end

                                                        }#foreach end

                                                #執行到這邊代表既有的元素與要新增的元素是相異的

                                                #將之合併到 $result 陣列裡面
                                                $result["content"][]=$arrayAdded;

                                                }#else end

                                        }#if end

                                #反之
                                else{

                                        #將之合併到 $result 陣列裡面
                                        $result["content"][]=$arrayAdded;

                                        }#else end

                                }#foreach end

                        }#foreach end

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

                #回傳結果
                return $result;

                }#function mergeArray end

        /*
        #函式說明:
        #將陣列中重複的元素剔除
        #回傳的結果：
        #$result["status"],"true"表執行正常,"false"代表執行不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數.
        #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
        #$result["content"],合併好的陣列.
        #必填參數
        #$conf["inputArray"],陣列,要合併的陣列變數.
        $conf["inputArray"]=array();
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function unique(&$conf){

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

                #初始話要回傳的陣列
                $result["content"]=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["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("inputArray");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                #$conf["canBeEmptyString"]="false";
                #$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
                #$conf["canNotBeEmpty"]=array();
                #$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
                #$conf["canBeEmpty"]=array();
                #$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
                #$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("logPath");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                #$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("allowRepeat","looseDiff");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true","false");
                #$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

                #初始化給 arrays::mergeArray 用的 inputArray 參數
                $paramsOfInputArrayOfArraysMergeArray=array();

                #針對每個元素
                foreach($conf["inputArray"] as $ele){

                        #包成陣列並儲存起來
                        $paramsOfInputArrayOfArraysMergeArray[]=array($ele);

                        }#foreach end

                #函式說明:
                #將多個一維陣列串聯起來,key從0開始排序.
                #回傳的結果：
                #$result["status"],"true"表執行正常,"false"代表執行不正常.
                #$result["error"],錯誤訊息陣列.
                #$result["function"],當前執行的函數.
                #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
                #$result["content"],合併好的一維陣列.
                #必填參數
                #$conf["inputArray"],陣列,要合併的一維陣列變數，例如：=array($array1,$array2);
                $conf["arrays::mergeArray"]["inputArray"]=$paramsOfInputArrayOfArraysMergeArray;
                #可省略參數:
                #$conf["allowRepeat"],字串,預設為"true",允許重複的結果;若為"false"則不會出現重複的元素內容.
                $conf["arrays::mergeArray"]["allowRepeat"]="false";
                #$conf["looseDiff"],字串,預設為"false",代表要嚴謹判斷為有相異,例如陣列中元素的key順序不同(整數)就代表有相異;反之為"true",例如陣列中元素的key順序不同(非整數),但value有相同,則視為無相異.
                #$conf["arrays::mergeArray"]["looseDiff"]="false";
                #參考資料:
                #無.
                #備註:
                #無.
                $mergeArray=arrays::mergeArray($conf["arrays::mergeArray"]);
                unset($conf["arrays::mergeArray"]);

                #debug
                #var_dump(__LINE__,$mergeArray);

                #如果執行失敗
                if($mergeArray["status"]==="false"){

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

                        #設置錯誤訊息
                        $result["error"]=$mergeArray;

                        #回傳結果
                        return $result;

                        }#if end

                #設置執行後得到的不重複陣列結果
                $result["content"]=$mergeArray["content"];

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

                #回傳結果
                return $result;

                }#function unique end

        /*
        #函式說明:
        #將多個多維陣列串聯起來,key從0開始排序.
        #回傳的結果：
        #$result["status"],"true"表執行正常,"false"代表執行不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數.
        #$result["argu"],使用的參數.
        #$result["content"],合併好的一維陣列.
        #必填參數
        #$conf["inputArray"],陣列,要合併的一維陣列變數，例如：=array($array1,$array2);
        $conf["inputArray"]=array();
        #可省略參數:
        #$conf["allowRepeat"],字串,預設為"false",不允許重複的結果;反之為"true".
        #$conf["allowRepeat"]="true";
        #$conf["equalKeyStruc"],字串陣列，若 allowRepeat 參數為 "false", 這該參數生效.該參數為用來判斷每個陣列的哪個鍵值路徑底下的數值相同時要進行取代,後者會取代前者.
        #$conf["equalKeyStruc"]=array();
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function mergeMultiDimensionArray(&$conf){

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

                #初始話要回傳的陣列
                $result["content"]=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["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("inputArray");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                #$conf["canBeEmptyString"]="false";
                #$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
                #$conf["canNotBeEmpty"]=array();
                #$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
                #$conf["canBeEmpty"]=array();
                #$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
                #$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("logPath");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("allowRepeat","equalKeyStruc");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","array");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("false",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

                #針對每組一維陣列
                foreach($conf["inputArray"] as $array){

                        #如果是空陣列
                        if(empty($array)){

                                #跳過之
                                continue;

                                }#if end

                        #針對該一維陣列中的每個元素
                        foreach($array as $arrayAdded){

                                #如果不允許重複的內容
                                if($conf["allowRepeat"]==="false"){

                                        #如果有指定 key 階層
                                        if(isset($conf["equalKeyStruc"])){

                                                #初始化儲存用來比對是否相符的變數
                                                $valInArray=$arrayAdded;

                                                #debug
                                                #var_dump(__LINE__,$valInArray);

                                                #針對每個 key 階層
                                                foreach($conf["equalKeyStruc"] as $keyLayer){

                                                        #如果沒有該階層
                                                        if(!isset($valInArray[$keyLayer])){

                                                                #換看下個元素
                                                                continue 2;

                                                                }#if end

                                                        #取得對應key的內容
                                                        $valInArray=$valInArray[$keyLayer];

                                                        }#foreach end

                                                #預設要新增
                                                $add=true;

                                                #針對已經合併好的陣列中的每個元素
                                                foreach($result["content"] as $index => $val){

                                                        #針對每個 key 階層
                                                        foreach($conf["equalKeyStruc"] as $keyLayer){

                                                                #取得對應key的內容
                                                                $val=$val[$keyLayer];

                                                                }#foreach end

                                                        #如果遇到新的相同內容
                                                        if($val===$valInArray){

                                                                #用新的取代舊的
                                                                $result["content"][$index]=$array;

                                                                #設置不用新增
                                                                $add=false;

                                                                }#if end

                                                        }#foreach end

                                                #如果要新增
                                                if($add){

                                                        #新增之
                                                        $result["content"][]=$arrayAdded;

                                                        #debug
                                                        #var_dump(__LINE__,$result["content"]);

                                                        #跳到下一個
                                                        continue;

                                                        }#if end

                                                }#if end

                                        #反之如果有重複了
                                        else if(in_array($arrayAdded,$result["content"])){

                                                #跳到下一個
                                                continue;

                                                }#if end

                                        }#if end

                                #將之合併到 $result 陣列裡面
                                $result["content"][]=$arrayAdded;

                                }#foreach end

                        }#foreach end

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

                #回傳結果
                return $result;

                }#function mergeMultiDimensionArray end

        /*
        #函式說明:
        #透過多個擁有一樣數量元素的一維陣列,透過指定的連接字串,組成一組同樣數量的一維陣列。
        #回傳結果：
        #$result["status"],執行是否正常，"true"代表正常，"false"代表不正常。
        #$result["error"],錯誤訊息。
        #$result["content"],組合成新值的一維陣列。
        #$result["function"],當前執行的函數名稱。
        #$result["argu"],使用的參數.
        #必填參數：
        #$conf["arrays"],二維陣列,爲要依序由哪些陣列變數來進行組合
        $conf["arrays"]=array();
        #可省略參數：
        #$conf["combineSymbolArray"],陣列字串，數量爲$conf["arrays"]減一，爲用於連結各一維陣列變數的連接字串，預設皆爲"<=>"。
        #$conf["combineSymbolArray"]=array();
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function combineToNewArray(&$conf){

                #初始化要回傳的變數
                $result=array();

                #初始化儲存合併好的一維陣列
                $result["content"]=array();

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

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

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

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

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

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

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

                                }#if end

                        #回傳結果
                        return $result;

                        }#if end

                #函式說明:
                #檢查陣列裡面的特定元素是否存在以及其變數型態是否正確，如果沒有設定則回傳提示訊息。
                #回傳的結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息
                #必填寫的參數：
                $conf["variableCheck.isexistMulti"]["varInput"]=$conf;#要檢查的陣列變數
                $conf["variableCheck.isexistMulti"]["variableCheck"]=array("arrays");#要檢查的變數名稱陣列，形態爲陣列變數，例如: $conf["variableCheck"] = array("id","account","password");
                #可以省略的參數：
                $conf["variableCheck.isexistMulti"]["variableType"]=array("array");#要檢查的陣列變數內的元素應該爲何種變數形態，形態爲陣列 例如: $conf[variableType] = array("string","int","double");
                $conf["variableCheck.isexistMulti"]["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話，請設為"false",預設為也算是有設置。
                $checkResult=variableCheck::isexistMulti($conf["variableCheck.isexistMulti"]);
                unset($conf["variableCheck.isexistMulti"]);

                #如果檢查出錯
                if($checkResult["status"]=="false"){

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

                        #設置錯誤訊息
                        $result["erorr"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #如果檢查不通過
                if($checkResult["passed"]=="false"){

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

                        #設置錯誤訊息
                        $result["erorr"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #函式說明:
                #檢查一包含數個可省略變數的陣列變數,其型態是否正確,省略掉的陣列變數可以直接給定預設值。
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["error"],錯誤訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["passed"],參數是否都通過檢查,"true",代表有通過檢查,"false"代表沒有通過檢查。
                #必填參數:
                #$conf["variableCheck.checkSkipableVarType"]["checkedVar"],陣列,要檢查的變數陣列名稱為？
                $conf["variableCheck.checkSkipableVarType"]["checkedVar"]=$conf;
                #$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"],字串陣列,要檢查型態是否設定正確的變數名稱陣列.
                $conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"]=array("arrays");
                #$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"],字串陣列,要檢查的每個變數,其型態應該要為何?
                $conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"]=array("array");
                #$argu,要直接存取的陣列變數名稱,變數前面加上「&」,如果要在別的函式裡面使用本函式,請記得將變動過結果($argu)給使用該函式的設定變數(通常是$conf=$argu).
                $argu=&$conf;
                #可省略參數:
                #$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"],字串陣列,每個不存的變數要初始化為什麼,"null"代表不指定.
                #$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"]=array("",);
                #無
                $checkResult=variableCheck::checkSkipableVarType($conf["variableCheck.checkSkipableVarType"],$argu);
                unset($conf["variableCheck.checkSkipableVarType"]);

                #如果檢查出錯
                if($checkResult["status"]=="false"){

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

                        #設置錯誤訊息
                        $result["erorr"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #如果檢查不通過
                if($checkResult["passed"]=="false"){

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

                        #設置錯誤訊息
                        $result["erorr"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #如果 $conf["combineSymbolArray"] 沒有設定
                if(!isset($conf["combineSymbolArray"])){

                        #執行迴圈 count($conf["arrays"]) 次
                        for($i=0;$i<count($conf["arrays"]);$i++){

                                #預設爲 "<=>"
                                $conf["combineSymbolArray"][]="<=>";

                                }#for end

                        }#if end

                #執行 count($conf["arrays"][0]) 次迴圈
                for($i=0;$i<count($conf["arrays"][0]);$i++){

                        #執行迴圈 count($conf["arrays"]) 次
                        for($j=0;$j<count($conf["arrays"]);$j++){

                                #如果不是第一個陣列
                                if($j!=0){

                                        #取得新陣列的元素與連接字串
                                        $result["content"][$i]=$result["content"][$i].$conf["combineSymbolArray"][$j-1].$conf["arrays"][$j][$i];

                                        }#if end

                                #反之是第一個陣列
                                else{

                                        #取得新陣列的元素
                                        $result["content"][$i]=$conf["arrays"][$j][$i];

                                        }#else end

                                }#for end

                        }#for end

                #執行到這邊代表執行正常
                $result["status"]="true";

                #回傳結果
                return $result;

                }#function combineToNewArray end

        /*
        #函式說明:
        #將陣列倒置.
        #回傳的結果：
        #$result["status"],執行是否成功，"true"為執行成功；"false"為執行失敗.
        #$result["error"]，錯誤訊息陣列.
        #$result["function"],當前執行的函數名稱.
        #$result["convertArray"],轉置後的陣列內容.
        #必填參數：
        #$conf["inputArray"],陣列,要倒置的陣列.
        $conf["inputArray"]=array();
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #參考資料來源 http://tw2.php.net/array_reverse => 陣列倒置的內建涵式.
        */
        public static function convertArray(&$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["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #必填寫的參數：
                $conf["variableCheck"]["isexistMuti"]["varInput"]=$conf;#要檢查的陣列變數
                $conf["variableCheck"]["isexistMuti"]["variableCheck"]=array("inputArray");#要檢查的變數名稱陣列，形態爲陣列變數，例如: $conf["variableCheck"] = array("id","account","password");
                #可以省略的參數：
                #$conf["variableType"]=array();#要檢查的陣列變數內的元素應該爲何種變數形態，形態爲陣列 例如: $conf[variableType] = array("string","int","double");
                #$conf["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話，請設為"false",預設為也算是有設置。
                $checkResult=variableCheck::isexistMulti($conf["variableCheck"]["isexistMuti"]);
                unset($conf["variableCheck"]["isexistMuti"]);

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

                #取得轉置後的內容
                $result["convertArray"]=array_reverse($conf["inputArray"]);

                #值行到這邊執行成功
                $result["status"]="true";

                #回傳節果
                return $result;

                }#function convertArray end

        /*
        #函式說明:
        #將一陣列每個元素間插入一個特定的元素
        #回傳的結果:
        #$result["status"],執行是否成功，"true"為執行成功；"false"為執行失敗
        #$result["error"]，錯誤訊息陣列.
        #$result["function"],當前執行的函數
        #$result["content"],插入完元素的新陣列.
        #必填參數:
        #$conf["inputArray"],陣列,要處理的陣列變數.
        $conf["inputArray"]=array();
        #$conf["insertElement"],字串,要加入的元素.
        $conf["insertElement"]="";
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function insertElementBetweenElements(&$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["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #必填寫的參數：
                $conf["variableCheck"]["isexistMuti"]["varInput"]=$conf;#要檢查的陣列變數
                $conf["variableCheck"]["isexistMuti"]["variableCheck"]=array("inputArray","insertElement");#要檢查的變數名稱陣列，形態爲陣列變數，例如: $conf["variableCheck"] = array("id","account","password");
                #可以省略的參數：
                $conf["variableType"]=array("array","string");#要檢查的陣列變數內的元素應該爲何種變數形態，形態爲陣列 例如: $conf[variableType] = array("string","int","double");
                $conf["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話，請設為"false",預設為也算是有設置。
                $checkResult=variableCheck::isexistMulti($conf["variableCheck"]["isexistMuti"]);
                unset($conf["variableCheck"]["isexistMuti"]);

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

                #複製原始的陣列
                $oriArray=$conf["inputArray"];

                #初始化暫存和合併後的新陣列變數
                $newCombinedArray=array();

                #執行 count($oriArray) 次迴圈
                for($j=0;$j<count($oriArray);$j++){

                        #取得原始陣列的一個元素
                        $newCombinedArray[]=$oriArray[$j];

                        #如果 不是最後一個原始陣列的元素
                        if($j!=count($oriArray)-1){

                                #放置一個元素到陣列裡面
                                $newCombinedArray[]=$conf["insertElement"];

                                }#if end

                        }#for end

                #取得插入完元素的陣列
                $result["content"]=$newCombinedArray;

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

                #回傳結果
                return $result;

                }#function insertElementBetweenElements end

        /*
        #函式說明:
        #將特定符號間隔的字串"a,b,c"變成陣列.
        #回傳的結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$result["function"],當前執行的function名稱.
        #$result["argu"],使用的參數.
        #$result["error"],錯誤訊息陣列.
        #$result["content"],處理好的內容.
        #必填參數:
        #$conf["inputStr"],字串,要轉一維陣列的字串
        $conf["inputStr"]="";
        #可省略參數:
        #$conf["spiltSymbol"],字串,用來區隔字串的符號,預設為","
        #$conf["spiltSymbol"]=",";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function stringToArray(&$conf){

                #初始化要回傳的變數
                $result=array();

                #初始化當前執行的函數名稱
                $result["funciton"]=__FUNCTION__;

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

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

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

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

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

                                }#if end

                        #回傳結果
                        return $result;

                        }#if end

                #取得使用的參數
                $result["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("inputStr");
                #$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["canBeEmptyString"]="false";
                #$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("spiltSymbol");
                #$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(",");
                #$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["arrayCountEqualCheck"][]=array();
                #參考資料來源:
                #array_keys=>http://php.net/manual/en/function.array-keys.php
                $checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);

                #如果檢查有誤
                if($checkResult["status"]=="false"){

                        #設置錯誤識別
                        $result["status"]="false";

                        #設置錯誤訊息
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #如果檢查不通過
                if($checkResult["passed"]=="false"){

                        #設置錯誤識別
                        $result["status"]="false";

                        #設置錯誤訊息
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #函式說明:
                #將固定格式的字串分開，並回傳分開的結果。
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["error"],錯誤訊息陣列
                #$result["function"],當前執行的函數名稱.
                #$result["argu"],使用的參數.
                #$result["oriStr"],要分割的原始字串內容
                #$result["dataArray"],爲分割好字串的陣列內容,$result["dataArray"][$i]爲第($i+1)段的內容。
                #$result["dataCounts"],爲總共分成幾段
                #$result["found"],是否有在$conf["stringIn"]找到$conf["spiltSymbol"],"true"代表有找到,"false"代表沒有找到.
                #必填參數:
                $conf["stringProcess::spiltString"]["stringIn"]=$conf["inputStr"];#要處理的字串。
                $conf["stringProcess::spiltString"]["spiltSymbol"]=$conf["spiltSymbol"];#爲以哪個符號作爲分割
                #可省略參數:
                #$conf["allowEmptyStr"],是否允許分割出來空字串,預設為"false"不允許;"true"代表允許.
                $conf["stringProcess::spiltString"]["allowEmptyStr"]="false";
                $spiltString=stringProcess::spiltString($conf["stringProcess::spiltString"]);
                unset($conf["stringProcess::spiltString"]);

                #如果分割字串失敗
                if($spiltString["status"]==="false"){

                        #設置錯誤識別
                        $result["status"]="false";

                        #設置錯誤訊息
                        $result["error"]=$spiltString;

                        #回傳結果
                        return $result;

                        }#if end

                #取得分割好的字串陣列
                $result["content"]=$spiltString["dataArray"];

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

                #回傳結果
                return $result;

                }#function stringToArray end

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

                #初始化要回傳的變數
                $result=array();

                #初始化當前執行的函數名稱
                $result["funciton"]=__FUNCTION__;

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

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

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

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

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

                                }#if end

                        #回傳結果
                        return $result;

                        }#if end

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

                #函式說明:
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["error"],執行不正常結束的錯訊息陣列.
                #$result["simpleError"],簡單表示的錯誤訊息.
                #$result["function"],當前執行的函式名稱.
                #$result["argu"],設置給予的參數.
                #$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
                #$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
                #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
                #$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
                #$result["notNeedVar"],字串陣列,多餘的參數名稱.
                #必填參數:
                #$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可省略參數:
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("inputArray");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                $conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
                #$conf["canNotBeEmpty"]=array();
                #$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
                #$conf["canBeEmpty"]=array();
                #$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
                $conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("skipEnd","spiltSymbolAtStart");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("spiltSymbol","skipEnd","spiltSymbolAtStart");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(";","false","false");
                #$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
                #$conf["variadbleCheck::checkArguments"]["disallowAllSkipableVarIsEmpty"]="";
                #$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".
                #$conf["disallowAllSkipableVarIsEmptyArray"]="";
                #$conf["disallowAllSkipableVarNotExist"],字串,是否不允許每個可省略參數都不存在,預設為"false"代表允許,反之為"true".
                #$conf["disallowAllSkipableVarNotExist"]="";
                #$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["arrayCountEqualCheck"][]=array();
                #參考資料:
                #array_keys=>http://php.net/manual/en/function.array-keys.php
                #備註:
                #無.
                $checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);

                #如果執行失敗
                if($checkArguments["status"]==="false"){

                        #設置執行錯誤的識別
                        $result["status"]="false";

                        #設置錯誤訊息
                        $result["error"]=$checkArguments;

                        #回傳結果
                        return $result;

                        }#if end

                #如果檢查不通過
                if($checkArguments["passed"]==="false"){

                        #設置執行錯誤的識別
                        $result["status"]="false";

                        #設置錯誤訊息
                        $result["error"]=$checkArguments;

                        #回傳結果
                        return $result;

                        }#if end

                #初始化 $result["content"]
                $result["content"]="";

                #如果開頭就要放置分割的字串
                if($conf["spiltSymbolAtStart"]==="true"){

                        #串接分割的字串
                        $result["content"]=$result["content"].$conf["spiltSymbol"];

                        }#if end

                #紀錄總共有幾個變數
                $Tcount=count($conf["inputArray"]);

                #暫存計數的變數
                $count=0;

                #$conf["inputArray"]陣列有幾個元素就執行幾次
                foreach($conf["inputArray"] as $elementValue){

                        #計數
                        $count++;

                        #如果要串接的內容不為字串
                        if(gettype($elementValue)!=="string"){

                                #設置錯誤識別
                                $result["status"]="false";

                                #設置錯誤訊息
                                $result["error"][]="要串接的內容須為字串";

                                #設置錯誤訊息
                                $result["error"][]=$elementValue;

                                #設置錯誤訊息
                                $result["error"][]="wrong type is ".gettype($elementValue);

                                #回傳結果
                                return $result;

                                }#if end

                        #如果是最後一個
                        if($count===$Tcount && $conf["skipEnd"]==="true"){

                                #組合字串
                                $result["content"]=$result["content"].$elementValue;

                                }#if end

                        #反之
                        else{

                                #組合字串
                                $result["content"]=$result["content"].$elementValue.$conf["spiltSymbol"];

                                }#else

                        }#foreach end

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

                #回傳結果
                return $result;

                }#funciton arrayToString

        /*
        #函式說明:
        #傳參考來交換兩變數
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$result["function"],當前執行的function名稱
        #$result["error"],錯誤訊息陣列.
        #必填參數:
        #$conf["num1"],參考變數，要交換的變數1。
        $conf["num1"]=&;
        #$conf["num2"],參考變數，要交換的變數2。
        $conf["num2"]=&;
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function swapByReference(&$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["variableCheck.isexistMulti"]["varInput"]=$conf;#要檢查的陣列變數
                $conf["variableCheck.isexistMulti"]["variableCheck"]=array("num1","num2");#要檢查的變數名稱陣列，形態爲陣列變數，例如: $conf["variableCheck"] = array("id","account","password");
                #可以省略的參數：
                #$conf["variableCheck.isexistMulti"]["variableType"]=array("array","string");#要檢查的陣列變數內的元素應該爲何種變數形態，形態爲陣列 例如: $conf[variableType] = array("string","int","double");
                $conf["variableCheck.isexistMulti"]["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話，請設為"false",預設為也算是有設置。
                $checkResult=variableCheck::isexistMulti($conf["variableCheck.isexistMulti"]);
                unset($conf["variableCheck.isexistMulti"]);

                #如果 $checkResult["status"] 為 "false"
                if($checkResult["status"]=="false"){

                        #設置錯誤識別
                        $result["status"]="false";

                        #設置發生錯誤的函式
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #如果 $checkResult["passed"] 為 "false"
                if($checkResult["passed"]=="false"){

                        #設置錯誤識別
                        $result["status"]="false";

                        #設置發生錯誤的函式
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #將第一個變數存在 $tmp 裡面
                $tmp=$conf["num1"];

                #將第一個變數用第二個變數取代
                $conf["num1"]=$conf["num2"];

                #將第二個變數用第一個變數取代
                $conf["num2"]=$tmp;

                #執行到這邊代表正常
                $result["status"]="true";

                #回傳結果
                return $result;

                }#function swapByReference end

        /*
        #函式說明:
        #排序含有多資訊的二維陣列
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$result["function"],當前執行的function名稱
        #$result["error"],錯誤訊息陣列.
        #$result["content"],處理好的字串.
        #必填參數：
        #$conf["unArrangeArray"],參考二維陣列,要的排序二維陣列。
        $conf["unArrangeArray"]=&;
        #$conf["compareKey"],字串,儲存用來比較大小的一維陣列key名稱。
        $conf["compareKey"]=;
        #可省參數：
        #$conf["type"],字串，排序的類型,"asc"代表遞增,"desc"代表遞減,預設為"desc"。
        $conf["type"]="desc";
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #排序有錯.
        */
        public static function arrangeTwoDmensionArray(&$conf){

                #初始化要回傳的變數
                $result=array();

                #初始化當前執行的函數名稱
                $result["funciton"]=__FUNCTION__;

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

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

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

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

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

                                }#if end

                        #回傳結果
                        return $result;

                        }#if end

                #檢查參數
                #函式說明:
                #檢查陣列裡面的特定元素是否存在以及其變數型態是否正確，如果沒有設定則回傳提示訊息。
                #回傳的結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息
                #必填寫的參數：
                $conf["variableCheck.isexistMulti"]["varInput"]=$conf;#要檢查的陣列變數
                $conf["variableCheck.isexistMulti"]["variableCheck"]=array("unArrangeArray","compareKey");#要檢查的變數名稱陣列，形態爲陣列變數，例如: $conf["variableCheck"] = array("id","account","password");
                #可以省略的參數：
                $conf["variableCheck.isexistMulti"]["variableType"]=array("array","string");#要檢查的陣列變數內的元素應該爲何種變數形態，形態爲陣列 例如: $conf[variableType] = array("string","int","double");
                $conf["variableCheck.isexistMulti"]["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話，請設為"false",預設為也算是有設置。
                $checkResult=variableCheck::isexistMulti($conf["variableCheck.isexistMulti"]);
                unset($conf["variableCheck.isexistMulti"]);

                #如果 $checkResult["status"] 為 "false"
                if($checkResult["status"]=="false"){

                        #設置錯誤識別
                        $result["status"]="false";

                        #設置發生錯誤的函式
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #如果 $checkResult["passed"] 為 "false"
                if($checkResult["passed"]=="false"){

                        #設置錯誤識別
                        $result["status"]="false";

                        #設置發生錯誤的函式
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #檢查可省略的參數
                #函式說明:
                #檢查一包含數個可省略變數的陣列變數,其型態是否正確,省略掉的陣列變數可以直接給定預設值。
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["error"],錯誤訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["passed"],參數是否都通過檢查,"true",代表有通過檢查,"false"代表沒有通過檢查。
                #必填參數:
                #$conf["checkedVar"],陣列,要檢查的變數陣列名稱為？
                $conf["variableCheck.checkSkipableVarType"]["checkedVar"]=$conf;
                #$conf["sikpableVarNameArray"],字串陣列,要檢查型態是否設定正確的變數名稱陣列.
                $conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"]=array("type");
                #$conf["skipableVarTypeArray"],字串陣列,要檢查的每個變數,其型態應該要為何?
                $conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"]=array("string");
                #$argu,要直接存取的陣列變數名稱,變數前面加上「&」,如果要在別的函式裡面使用本函式,請記得將變動過結果($argu)給使用該函式的設定變數(通常是$conf=$argu).
                $argu=&$conf;
                #可省略參數:
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存的變數要初始化為什麼,"null"代表不指定.
                $conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"]=array("desc");
                #無
                $checkResult=variableCheck::checkSkipableVarType($conf["variableCheck.checkSkipableVarType"],$argu);
                unset($conf["variableCheck.checkSkipableVarType"]);

                #var_dump($checkResult);

                #如果 $checkResult["status"] 為 "false"
                if($checkResult["status"]=="false"){

                        #設置錯誤識別
                        $result["status"]="false";

                        #設置發生錯誤的函式
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #如果 $checkResult["passed"] 為 "false"
                if($checkResult["passed"]=="false"){

                        #設置錯誤識別
                        $result["status"]="false";

                        #設置發生錯誤的函式
                        $result["error"]=$checkResult;

                        #回傳結果
                        return $result;

                        }#if end

                #取得要排序的數目有多少
                $count=count($conf["unArrangeArray"]);

                #debug
                #var_dump($count);

                #debug
                #var_dump($conf["unArrangeArray"]);

                #/*

                #判斷 $conf["type"]
                switch($conf["type"]){

                        #如果是 "desc"
                        case "desc":

                                #迴圈，執行 $count 次
                                for($i=0;$i<$count;$i++){

                                        #迴圈 執行 $count-$i-1 次
                                        for($j=$i+1;$j<$count;$j++){

                                                #debug
                                                #echo $conf["unArrangeArray"][0][$conf["compareKey"]]." ".$conf["unArrangeArray"][1][$conf["compareKey"]]." ".$conf["unArrangeArray"][2][$conf["compareKey"]]."<p>";

                                                #debug
                                                #echo "<p>max=".$max." \$i=".$i." \$j=".$j." ".$max."<".$conf["unArrangeArray"][$j][$conf["compareKey"]]."<p>";

                                                #如過資料不存在
                                                if(!isset($conf["unArrangeArray"][$i])){

                                                        #跳到下一輪
                                                        continue;

                                                        }#if end

                                                #如果當前數值大於當前的$max
                                                if($conf["unArrangeArray"][$i][$conf["compareKey"]]<$conf["unArrangeArray"][$j][$conf["compareKey"]]){

                                                        #debug
                                                        #echo "<p>".$max."<".$conf["unArrangeArray"][$j][$conf["compareKey"]]."<p>";

                                                        #函式說明:
                                                        #傳參考來交換兩變數
                                                        #回傳結果:
                                                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                                                        #$result["function"],當前執行的function名稱
                                                        #$result["error"],錯誤訊息陣列.
                                                        #必填參數:
                                                        #$conf["arrays.swap"]["num1"],要交換的變數1。
                                                        $conf["arrays.swap"]["num1"]=&$conf["unArrangeArray"][$i];
                                                        #$conf["arrays.swap"]["num2"],要交換的變數2。
                                                        $conf["arrays.swap"]["num2"]=&$conf["unArrangeArray"][$j];
                                                        $swapResult=arrays::swapByReference($conf["arrays.swap"]);
                                                        unset($conf["arrays.swap"]);

                                                        #如果 $swapResult["status"] 等於 "false"
                                                        if($swapResult["status"]=="false"){

                                                                #設置執行錯誤
                                                                $result["status"]="false";

                                                                #設置錯誤訊息
                                                                $result["error"]=$swapResult;

                                                                #回傳結果
                                                                return $result;

                                                                }#if end

                                                        }#if end

                                                #debug
                                                #echo $conf["unArrangeArray"][0][$conf["compareKey"]]." ".$conf["unArrangeArray"][1][$conf["compareKey"]]." ".$conf["unArrangeArray"][2][$conf["compareKey"]]."<p>";

                                                }#for end

                                        }#for end

                                #跳出switch
                                break;

                        #如果是 "asc"
                        case "asc":

                                #迴圈，執行 $count 次
                                for($i=0;$i<$count;$i++){

                                        #迴圈 執行 $count-$i-1 次
                                        for($j=$i+1;$j<$count;$j++){

                                                #如果當前數值小於當前的$min
                                                if($conf["unArrangeArray"][$i][$conf["compareKey"]]>$conf["unArrangeArray"][$j][$conf["compareKey"]]){

                                                        #debug
                                                        #echo "<p>當前數值小於當前的$min<p>";

                                                        #函式說明:
                                                        #傳參考來交換兩變數
                                                        #回傳結果:
                                                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                                                        #$result["function"],當前執行的function名稱
                                                        #$result["error"],錯誤訊息陣列.
                                                        #必填參數:
                                                        #$conf["arrays.swap"]["num1"],要交換的變數1。
                                                        $conf["arrays.swap"]["num1"]=&$conf["unArrangeArray"][$i];
                                                        #$conf["arrays.swap"]["num2"],要交換的變數2。
                                                        $conf["arrays.swap"]["num2"]=&$conf["unArrangeArray"][$j];
                                                        $swapResult=arrays::swapByReference($conf["arrays.swap"]);
                                                        unset($conf["arrays.swap"]);

                                                        #如果 $swapResult["status"] 等於 "false"
                                                        if($swapResult["status"]=="false"){

                                                                #設置執行錯誤
                                                                $result["status"]="false";

                                                                #設置錯誤訊息
                                                                $result["error"]=$swapResult;

                                                                #回傳結果
                                                                return $result;

                                                                }#if end

                                                        }#if end

                                                }#for end

                                        }#for end

                                #跳出switch
                                break;

                        }#switch end

                #*/

                #執行到這邊代表執行正常
                $result["status"]="true";

                #回傳結果
                return $result;

                }#function arrangeTwoDmensionArray end

        /*
        #函式說明:
        #將一陣列數值內容加上前置與後置字串
        #回傳結果:
        #$result["status"],執行正常與否,"true"代表執行正常,"false"代表執行不正常.
        #$result["error"],錯誤訊息陣列.
        #$result["function"],當前執行的函數名稱.
        #$result["content"],加上前置與後置字串後的一維陣列
        #必填參數:
        #$conf["inputArray"],一維陣列變數,要增加前置與後置字串的陣列變數.
        $conf["inputArray"]=array();
        #$conf["headStr"],字串,$conf["inputArray"]中每個元素數值內容的前面都要加上的字串.
        $conf["headStr"]="";
        #$conf["tailStr"],字串,$conf["inputArray"]中每個元素數值內容的後面都要加上的字串.
        $conf["tailStr"]="";
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function addStrToHeadAndTail(&$conf){

                #初始化要回傳的變數
                $result=array();

                #初始化當前執行的函數名稱
                $result["funciton"]=__FUNCTION__;

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

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

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

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

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

                                }#if end

                        #回傳結果
                        return $result;

                        }#if end

                #檢查參數
                #函式說明:
                #檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息
                #必填寫的參數：
                #$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("inputArray","headStr","tailStr");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","string","string");
                #$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"false"。
                $conf["variableCheck::checkArguments"]["canBeEmptyString"]="true";
                #$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();
                $checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);

                #如果檢查變數失敗
                if($checkArguments["status"]=="false"){

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

                        #設置執行錯誤
                        $result["error"]=$checkArguments;

                        #回傳結果
                        return $result;

                        }#if end

                #如果檢查變數失敗
                if($checkArguments["passed"]=="false"){

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

                        #設置執行錯誤
                        $result["error"]=$checkArguments;

                        #回傳結果
                        return $result;

                        }#if end

                #初始化要回傳一維陣列變數
                $result["content"]=array();

                #有幾個元素就執行幾次迴圈
                foreach($conf["inputArray"] as $key => $value){

                        #合成新元素
                        $result["content"][$key]=$conf["headStr"].$value.$conf["tailStr"];

                        }#for end

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

                #回傳結果
                return $result;

                }#function addStrToHeadAndTail end

        /*
        #函式說明:
        #將陣列字串處理成一個個"[index] 元素內容"的格式,且[index]的寬度會依造陣列的長度而固定。
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$reuslt["error"],執行不正常結束的錯訊息陣列.
        #$result["function"],當前執行的函式名稱.
        #$result["content"],處理好的陣列.
        #必填參數:
        #$conf["inputArray"],陣列字串,要轉換陣列.
        $conf["inputArray"]=array();
        #可省略參數:
        #$conf["newLine"],字串,組合的內容是否要加換行符號,"true"代表要,"false"代表不要,預設為"ture".
        #$conf["newLine"]="false";
        #$conf["print"],字串,是否要直接印出來,"true"代表要,"false"代表不要,預設為"false".
        #$conf["print"]="ture";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function toPrintableIndex(&$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["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數:
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("inputArray");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                #$conf["canBeEmptyString"]="false";
                #$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
                #$conf["canNotBeEmpty"]=array();
                #$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
                #$conf["canBeEmpty"]=array();
                #$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
                $conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("newLine","print");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("newLine","print");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true","false");
                #$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["error"]=$checkArguments;

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

                        #回傳結果
                        return $result;

                        }#if end

                #如果檢查不通過
                if($checkArguments["passed"]==="false"){

                        #設置錯誤訊息
                        $result["error"]=$checkArguments;

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

                        #回傳結果
                        return $result;

                        }#if end

                #取得陣列計數長度
                $arrayCountLen=strlen(count($conf["inputArray"]));

                #初始化換行符號
                $newLine="\n";

                #如果不要換行符號
                if($conf["newLine"]==="false"){

                        #設置為空字串
                        $newLine="";

                        }#if end

                #針對每個要處理的陣列
                foreach($conf["inputArray"] as $key=>$val){

                        #如果列數長度加3小於要移除檔案之計數長度
                        while(strlen($key)<$arrayCountLen){

                                #在前面加上空格
                                $key=" ".$key;

                                }#if end

                        #組合內容
                        $result["content"][]="[".$key."] ".$val.$newLine;

                        #如果要印出來
                        if($conf["print"]==="true"){

                                #印出來
                                echo "[".$key."] ".$val.$newLine;

                                }#if end

                        }#foreach end

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

                #回傳結果
                return $result;

                }#function toPrintableIndex end

        /*
        #函式說明:
        #將陣列進行切割
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$reuslt["error"],執行不正常結束的錯訊息陣列.
        #$result["function"],當前執行的函式名稱.
        #$result["content"]["get"],切割出來的陣列.
        #$result["content"]["leftL"],遺留下來的陣列,左邊.
        #$result["content"]["leftR"],遺留下來的陣列,右邊.
        #$result["content"]["ori"],原始的陣列.
        #$result["argu"],使用的參數.
        #必填參數:
        #$conf["array"],要進行分割的陣列.
        $conf["array"]=array();
        #$conf["length"],整數,要切幾個元素.
        $conf["length"]=;
        #可省略參數:
        #$conf["offset"],整數,要從第幾個元素開始切,預設為0
        #$conf["offset"]=0;
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function split(&$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["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數:
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("array","length");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","integer");
                #$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("offset");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("offset");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("integer");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(0);
                #$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["error"]=$checkArguments;

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

                        #回傳結果
                        return $result;

                        }#if end

                #如果檢查不通過
                if($checkArguments["passed"]==="false"){

                        #設置錯誤訊息
                        $result["error"]=$checkArguments;

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

                        #回傳結果
                        return $result;

                        }#if end

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

                #初始化儲存切割出來的陣列內容
                $result["content"]["get"]=array();

                #初始化儲存剩下來的左方陣列
                $result["content"]["leftL"]=array();

                #初始化儲存剩下來的右方陣列
                $result["content"]["leftR"]=array();

                #設置原始的陣列
                $result["content"]["ori"]=$conf["array"];

                #計數
                $count=-1;

                #針對每個元素
                foreach($conf["array"] as $key=>$val){

                        #計數加0
                        ++$count;

                        #如果是開始要切割的位置
                        if($conf["offset"]<=$count){

                                #如果切出的長度還不足
                                if($conf["length"]>count($result["content"]["get"])){

                                        #儲存切割出來的元素
                                        $result["content"]["get"][]=$val;

                                        }#if end

                                #反之切割出來的長度已經足夠了
                                else{

                                        #儲存剩下來的右方陣列
                                        $result["content"]["leftR"][]=$val;

                                        }#else end

                                }#if end

                        #反之沒到要切割的位置
                        else{

                                #儲存剩下來的右方陣列
                                $result["content"]["leftL"][]=$val;

                                }#else end

                        }#foreach end

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

                #回傳結果
                return $result;

                }#function split end

        /*
        #函式說明:
        #將既有的一維陣列變成二維陣列，新增指定或相同的欄位資訊.
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$reuslt["error"],執行不正常結束的錯訊息陣列.
        #$result["function"],當前執行的函式名稱.
        #$result["content"],合併好的2維陣列.
        #$result["argu"],使用的參數.
        #必填參數:
        #$conf["array"],陣列,要進行合併的一維陣列.
        $conf["array"]=array();
        #$conf["newArray"],陣列,要新增的欄位陣列,若資料筆數不等同於count($conf["array"])，則代表產生相同的欄位元素.
        $conf["newArray"]=array();
        #可省略參數:
        #無.
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function addColumn(&$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["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數:
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("array","newArray");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","array");
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                $conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
                #$conf["canNotBeEmpty"]=array();
                #$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
                #$conf["canBeEmpty"]=array();
                #$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
                #$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("offset");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                #$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("offset");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("integer");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(0);
                #$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["error"]=$checkArguments;

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

                        #回傳結果
                        return $result;

                        }#if end

                #如果檢查不通過
                if($checkArguments["passed"]==="false"){

                        #設置錯誤訊息
                        $result["error"]=$checkArguments;

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

                        #回傳結果
                        return $result;

                        }#if end

                #初始化要回傳的二維陣列內容
                $result["content"]=array(array());

                #針對每個要處理的既有一維陣列變數
                foreach($conf["array"] as $index => $firstEle){

                        #如果存在新的欄位指定內容
                        if(isset($conf["newArray"][$index])){

                                #設置新的欄位內容
                                $secondEle=$conf["newArray"][$index];

                                }#if end

                        #反之
                        else{

                                #設置新的欄位內容為第一個新的元素
                                $secondEle=$conf["newArray"][0];

                                }#else end

                        #設置新的欄位內容
                        $row=array($firstEle,$secondEle);

                        #儲存新的欄位內容
                        $result["content"][]=$row;

                        }#foreach end

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

                #回傳結果
                return $result;

                }#function addColumn end

                /*
                #函式說明:
                #將陣列的key資訊取出,以方便使用.
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["argu"],使用的參數.
                #$result["content"],結果陣列.
                #$result["content"]["key"],陣列key數值的陣列.
                #$result["content"]["val"],陣列value的陣列.
                #必填參數:
                #$conf["array"],陣列,要讀取的一維陣列.
                $conf["array"]=array();
                #可省略參數:
                #無.
                #參考資料:
                #無.
                #備註:
                #無.
                */
                public static function inspectKey(&$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"代表不正常.
                        #$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("array");
                        #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null、any代表不指定變數形態.其中 resource也包含"resource (closed)".
                        $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");
                        #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                        $conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                        #$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
                        #$conf["canNotBeEmpty"]=array();
                        #$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
                        #$conf["canBeEmpty"]=array();
                        #$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
                        #$conf["skipableVariableCanNotBeEmpty"]=array();
                        #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                        #$conf["skipableVariableName"]=array();
                        #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                        #$conf["skipableVariableType"]=array();
                        #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                        #$conf["skipableVarDefaultValue"]=array("");
                        #$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
                        #$conf["disallowAllSkipableVarIsEmpty"]="";
                        #$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".
                        #$conf["disallowAllSkipableVarIsEmptyArray"]="";
                        #$conf["disallowAllSkipableVarNotExist"],字串,是否不允許每個可省略參數都不存在,預設為"false"代表允許,反之為"true".
                        #$conf["disallowAllSkipableVarNotExist"]="";
                        #$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                        #$conf["arrayCountEqualCheck"][]=array();
                        #參考資料:
                        #array_keys=>http://php.net/manual/en/function.array-keys.php
                        #備註:
                        #無.
                        $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

                        #針對每個元素
                        foreach($conf["array"] as $arrayKey => $arrayVal){

                                #儲存 array key
                                $result["content"]["key"][]=$arrayKey;

                                #儲存 array value
                                $result["content"]["val"][]=$arrayVal;

                                }#foreach end

                        #取得陣列的元素數量
                        $result["count"]=count($result["content"]["key"]);

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

                        #回傳結果
                        return $result;

                        }#function inspectKey end

        }#class arrays end

?>
Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/arrays.php – Rev 226
