Subversion Repositories php-qbpwcf

Rev

Rev 226 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

<?php

/*

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

    This file is part of QBPWCF.

    QBPWCF is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    QBPWCF is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

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

*/
namespace qbpwcf;

/*
類別說明:
管理QBPWCFW適用套件的類別.
備註:
無.
*/
class lib{

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

        /*
        #函式說明:
        #取得多個js,css等套件,該套件必須存放在同目錄的lib目錄底下.
        #回傳結果:
        #$result["status"],執行正確與否,"true"代表執行正確,"false"代表執行失敗.
        #$result["error"],錯誤訊息陣列.
        #$result["content"],取得好的Jquery檔案路徑.
        #$result["function"],當前執行的函數名稱.
        #必填參數:
        #無
        #可省略參數:
        #$conf["libAddr"],字串陣列,套件的本機位置預設為 array("lib/jquery-2.2.2.js","lib/notify.js","lib/bootstrap-3.3.6-dist/js/bootstrap","lib/Chart.js")
        #$conf["libAddr"]=array("");
        #$conf["libWebAddr"],字串陣列,套件的網路位置,預設為 array("https://code.jquery.com/jquery-2.2.2.js","https://rawgit.com/notifyjs/notifyjs/master/dist/notify.js","https://github.com/twbs/bootstrap/archive/v3.3.6.zip","https://github.com/chartjs/Chart.js/releases/download/v2.6.0/Chart.js.zip")
        #$conf["libWebAddr"]=array("");
        #參考資料來源:
        #https://code.jquery.com/jquery-2.2.2.js
        #https://rawgit.com/notifyjs/notifyjs/master/dist/notify.js
        #https://github.com/twbs/bootstrap/archive/v3.3.6.zip
        #https://github.com/chartjs/Chart.js/releases/tag/v2.6.0
        #備註:
        #尚未增加的套件 ckeditor ods-php-0.1rc1 phpodt-0.3.3 webrtc apache-hive amchart tcpdf
        #建構中...
        */
        public static function getLib(&$conf=array()){

                #初始化要回傳的結果
                $result=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["argu"],設置給予的參數.
                #$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
                #$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
                #$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
                #$result["argu"],字串陣列,目前輸入的參數名稱陣列.
                #$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
                #$result["notNeedVar"],字串陣列,多餘的參數名稱.
                #必填寫的參數:
                #$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數:
                #$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列,形態爲陣列變數,元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                #$conf["mustBeFilledVariableName"]=array();
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                #$conf["mustBeFilledVariableType"]=array();
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"true",可以為空字串.
                #$conf["canBeEmptyString"]="false";
                #$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
                #$conf["canNotBeEmpty"]=array();
                #$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
                #$conf["canBeEmpty"]=array();
                #$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
                $conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("libAddr","libWebAddr");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("libAddr","libWebAddr");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","array");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一,請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(array("lib/jquery-2.2.2.js","lib/notify.js","lib/bootstrap-3.3.6-dist","lib/Chart.js"),array("https://code.jquery.com/jquery-2.2.2.js","https://rawgit.com/notifyjs/notifyjs/master/dist/notify.js","https://github.com/twbs/bootstrap/archive/v3.3.6.zip","https://github.com/chartjs/Chart.js/releases/download/v2.6.0/Chart.js.zip"));
                #$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

                #針對每個 js lib
                foreach($libAddr as $index => $lib){

                        #js套件應該要存放的地方
                        $jsAddr=&$lib;

                        #js套件的網路位置
                        $jsWebAddr=&$libWebAddr[$index];

                        #檢查jqery套件是否存在
                        #涵式說明:檢查多個檔案與資料夾是否存在.
                        #回傳的結果:
                        #$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
                        #$result["error"],錯誤訊息陣列.
                        #$resutl["function"],當前執行的涵式名稱.
                        #$result["argu"],使用的參數.
                        #$result["allExist"],所有檔案皆存在的識別,"true"代表皆存在,"false"代表沒有全部都存在.
                        #$result["varName"][$i],爲第$i個資料夾或檔案的路徑與名稱。
                        #$result["varNameFullPath"][$i],爲第$i個資料夾或檔案的完整檔案系統路徑與名稱,如果不存在則代表路徑是網址.
                        #$result["varNameWebPath"][$i],為第$i個資料夾或檔案的網址
                        #$result["varExist"][$i],爲第$i個資料夾或檔案是否存在,"true"代表存在,"false"代表不存在。
                        #必填參數:
                        #$conf["fileArray"],陣列字串,要檢查是否存在的檔案有哪些,須爲一維陣列數值。
                        $conf["fileAccess::checkMultiFileExist"]["fileArray"]=array($jsAddr);
                        #$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
                        $conf["fileAccess::checkMultiFileExist"]["fileArgu"]=$conf["fileArgu"];
                        #可省略參數
                        #$conf["disableWebSearch"],"字串",是否取消「當檔案找不到時,改用catchWebContent類別的wget函數來檢查檔案是否存在於網路上」的功能,"false"不取消,若要取消該功能請設為"true",若抓到的內容為空字串則會視為檔案不存在,預設為"true".
                        #$conf["disableWebSearch"]="false";
                        #參考資料來源:
                        #http://php.net/manual/en/function.file-exists.php
                        #http://php.net/manual/en/control-structures.foreach.php
                        #備註:
                        #函數file_exists檢查的路徑為檔案系統的路徑
                        $checkMultiFileExist=fileAccess::checkMultiFileExist($conf["fileAccess::checkMultiFileExist"]);
                        unset($conf["fileAccess::checkMultiFileExist"]);

                        #如果檢查js套件失敗
                        if($checkMultiFileExist["status"]==="false"){

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

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

                                #回傳結果
                                return $result;

                                }#if end

                        #如果檢查js套件不存在
                        if($checkMultiFileExist["varExist"][0]==="false"){

                                #函式說明:
                                #依據行號分隔抓取檔案的內容,結果會回傳一個陣列
                                #回傳的變數說明:
                                #$result["status"],執行是否成功,"true"代表成功;"fasle"代表失敗.
                                #$result["error"],錯誤訊息提示.
                                #$result["warning"],警告訊息.
                                #$result["function"],當前執行的函數名稱.
                                #$result["fileContent"],爲檔案的內容陣列.
                                #$result["lineCount"],爲檔案內容總共的行數.
                                #$result["fullContent"],為檔案的完整內容.
                                #必填的參數:
                                #$conf["filePositionAndName"],字串,爲檔案的位置以及名稱.
                                $conf["fileAccess::getFileContent"]["filePositionAndName"]=$jsWebAddr;
                                #$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
                                $conf["fileAccess::getFileContent"]["fileArgu"]=$conf["fileArgu"];
                                #參考資料:
                                #file(),取得檔案內容的行數.
                                #file=>http:#php.net/manual/en/function.file.php
                                #rtrim(),剔除透過file()取得每行內容結尾的換行符號.
                                #filesize=>http://php.net/manual/en/function.filesize.php
                                $getFileContent=fileAccess::getFileContent($conf["fileAccess::getFileContent"]);
                                unset($conf["fileAccess::getFileContent"]);

                                #如果取得套件失敗
                                if($getFileContent["status"]==="false"){

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

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

                                        #回傳結果
                                        return $result;

                                        }#if end

                                #如果是js檔案
                                if(strpos($jsWebAddr,".js")!==false && ){

                                        #寫入js套件的內容
                                        #涵式說明:
                                        #將字串寫入到檔案
                                        #回傳的結果:
                                        #$result["status"],"true"表示檔案寫入成功,"false"表示檔案寫入失敗.
                                        #$result["error"],錯誤訊息陣列.
                                        #$result["function"],當前執行的函數名稱.
                                        #$result["fileInfo"],實際上寫入的檔案資訊陣列.
                                        #$result["fileInfo"]["createdFileName"],建立好的檔案名稱.
                                        #$result["fileInfo"]["createdFilePath"],檔案建立的路徑.
                                        #$result["fileInfo"]["createdFilePathAndName"].建立好的檔案名稱與路徑.
                                        #必填的參數:
                                        #$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
                                        $conf["fileAccess::writeTextIntoFile"]["fileArgu"]=$conf["fileArgu"];
                                        #可省略的參數:
                                        #$conf["fileName"],字串,爲要編輯的檔案名稱,預設為隨機產生的檔案名稱.
                                        $conf["fileAccess::writeTextIntoFile"]["fileName"]=$jsAddr;
                                        #$conf["inputString"],字串,爲要寫入到裏面的內容,若要每筆資料寫入後換行,則可以在字串內容後面加上 \r\n 即可,預設為"".
                                        $conf["fileAccess::writeTextIntoFile"]["inputString"]=$getFileContent["fullContent"];
                                        #$conf["writeMethod"],字串,爲檔案撰寫的方式,可省略,是複寫'a'還是,重新寫入'w',預設爲'w',重新寫入.
                                        #$conf["writeMethod"]="a";
                                        #$conf["checkRepeat"],字串,"true"代表建立檔案之前要先檢查檔案是否存在,若存在則在原名稱後面加上從(1)開始的編號.
                                        #$conf["checkRepeat"]="";
                                        #$conf["filenameExtensionStartPoint"],字串,檔案的副檔名是從倒數第幾個小數點(dot)開始,預設為"1",最後一個小數點,必須與$conf["checkRepeat"]搭配才會生效.
                                        #$conf["filenameExtensionStartPoint"]="";
                                        #$conf["repeatNameRule"],字串,遇到相同名稱的檔案要如何加上識別的編號,編號用「\$i」表示,預設為"(\$i)",必須與$conf["checkRepeat"]搭配才會生效.
                                        #$conf["repeatNameRule"]="";
                                        $writeTextIntoFile=fileAccess::writeTextIntoFile($conf["fileAccess::writeTextIntoFile"]);
                                        unset($conf["fileAccess::writeTextIntoFile"]);

                                        #如果建立js lib檔案失敗
                                        if($writeTextIntoFile["status"]="false"){

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

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

                                                #回傳結果
                                                return $result;

                                                }#if end

                                        #轉換js lib檔案路徑為相對路徑
                                        #函數說明:
                                        #將多個路徑字串變成相對於當前路徑的相對路徑字串
                                        #回傳結果:
                                        #$result["status"],"true"爲建立成功,"false"爲建立失敗.
                                        #$result["error"],錯誤訊息陣列.
                                        #$result["function"],函數名稱.
                                        #$result["argu"],使用的參數.
                                        #$result["content"],字串陣列,多個轉換好的相對路徑字串.
                                        #必填參數:
                                        #$conf["path"],陣列字串,要轉換成相對路徑的字串.;
                                        $conf["fileAccess::getRelativePath"]["path"]=array($writeTextIntoFile["fileInfo"]["createdFilePathAndName"]);
                                        #$conf["fileArgu"],字串,當前路徑.
                                        $conf["fileAccess::getRelativePath"]["fileArgu"]=$conf["fileArgu"];
                                        $getRelativePath=fileAccess::getRelativePath($conf["fileAccess::getRelativePath"]);
                                        unset($conf["fileAccess::getRelativePath"]);

                                        #如果轉換成相對位置失敗
                                        if($getRelativePath["status"]==="false"){

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

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

                                                #回傳結果
                                                return $result;

                                                }#if end

                                        #取得 js 套件的相對路徑
                                        $result["content"][]=$getRelativePath["content"];

                                        }#if end

                                #反之為 zip 檔案
                                else if(strpos($jsWebAddr,".zip")){

                                        #取得zip檔案的名稱
                                        $zipFile=basename($jsAddr).".zip";

                                        #取得zip檔案的內容
                                        $zipFileContent=&$getFileContent["fullContent"];

                                        #打開要建立的zip檔案
                                        $jsLibZipFile=fopen($jsAddr.".zip","w");

                                        #寫入zip檔案的內容
                                        fwrite($jsLibZipFile,$zipFileContent);

                                        #關閉檔案
                                        fclose($jsLibZipFile);

                                        #取得要解壓縮的目錄
                                        #涵式說明:
                                        #將固定格式的字串分開,並回傳分開的結果。
                                        #回傳結果:
                                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                                        #$result["error"],錯誤訊息陣列
                                        #$result["function"],當前執行的函數名稱.
                                        #$result["oriStr"],要分割的原始字串內容
                                        #$result["dataArray"],爲分割好字串的陣列內容,$result["dataArray"][$i]爲第($i+1)段的內容。
                                        #$result["dataCounts"],爲總共分成幾段
                                        #$result["found"],是否有在$conf["stringIn"]找到$conf["spiltSymbol"],"true"代表有找到,"false"代表沒有找到.
                                        #必填的參數:
                                        $conf["stringProcess::spiltString"]["stringIn"]=$zipFile;#要處理的字串。
                                        $conf["stringProcess::spiltString"]["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

                                        #如果沒有分割用的符號 /
                                        if($spiltString["found"]==="false"){

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

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

                                                #回傳結果
                                                return $result;

                                                }#if end

                                        #要進入的目錄
                                        $libPath=&$spiltString["dataArray"][0];

                                        #進入要解壓縮的目錄
                                        $cmd[]="cd";
                                        $argu[]=array($libPath);

                                        #解壓縮lib
                                        $cmd[]="unzip ".$libPath;
                                        $argu[]=array($libPath);

                                        #移除lib
                                        $cmd[]="rm";
                                        $argu[]=array($libPath);

                                        #離開要解壓縮的目錄
                                        $cmd[]="cd";
                                        $argu[]=array("..");

                                        #涵式說明:
                                        #呼叫shell依序執行系統命令,並取得回傳的內容.
                                        #回傳的結果:
                                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                                        #$result["error"],錯誤訊息陣列.
                                        #$result["function"],當前執行的函數名稱.
                                        #$result["cmd"],執行的指令內容.
                                        #$result["output"],爲執行完每個指令後的輸出陣列.
                                        #必填的參數
                                        #$conf["command"],字串陣列,要執行的指令.
                                        $conf["external::callShellMulti"]["command"]=&$cmd;
                                        #$conf["fileArgu"],字串,變數__FILE__的內容,預設為當前檔案的路徑與名稱.
                                        $conf["external::callShellMulti"]["fileArgu"]=$conf["fileArgu"];
                                        #可省略參數:
                                        #$conf["argu"],陣字串列,執行各個$conf["command"]時指令搭配的參數,預設為空陣列.
                                        $conf["external::callShellMulti"]=&$argu;
                                        #$conf["enablePrintDescription"],字串陣列,執行各個$conf["command"]時是否要印出$conf["printDescription"]的內容,"true"代表要,"false"代表不要,其數量須與$conf["command"]的元素數量相同,若只有一個元素,則代表是每個$conf["command"]執行時都用此參數.
                                        #$conf["enablePrintDescription"]=array("false");
                                        #$conf["printDescription"],字串陣列,執行各個$conf["command"]前要印出來的的文字,預設為$conf["command"]的內容,其數量須與$conf["command"]的元素數量相同,若只有一個元素,則代表是每個$conf["command"]執行時都用此參數.
                                        #$conf["printDescription"]=array("");
                                        #$conf["escapeshellarg"],字串陣列,執行各個$conf["command"]時是否要啟用過濾參數,用了比較安全,但可能會出錯,"true"為啟用,"false"為不啟用,預設為"false",其數量須與$conf["command"]的元素數量相同,若只有一個元素,則代表是每個$conf["command"]執行時都用此參數.
                                        $conf["external::callShellMulti"]["escapeshellarg"]=array("true");
                                        #$conf["username"],陣列字串,每個指令要用什麼使用者來執行,預設為執行php的使用者,該參數不適用於apache環境.
                                        #$conf["username"]=array("");
                                        #$conf["password"],陣列字串,每個指令與$conf["username"]搭配的使用者密碼,預設不使用密碼,該參數不適用於apache環境.
                                        #$conf["password"]=array("");
                                        #$conf["useScript"],字串,每個指令的執行是否要啟用Linux的script指令來記錄輸出,"true"代表要;"false"代表不要,預設為"false".
                                        #$conf["useScript"]="";
                                        #$conf["logFilePath"],字串,當 $conf["useScript"] 為 "true" 時,輸出的內容要暫存到哪裡,預設為 ".qbpwcf_tmp/external/callShell/".
                                        #$conf["logFilePath"]=".qbpwcf_tmp/external/callShell/";
                                        #$conf["inBackGround"],字串,每個指令的執行是否要在背景執行,且不會等待程式執行結束再執行下一個指令,"true"代表是,"false"代表不要,預設為"false",如果$conf["command"]有用「;」區隔的多個指令將會出錯.
                                        #$conf["inBackGround"]="";
                                        #備註:
                                        #不是所有指令都能用apache的身份執行,目前已知java,javac指令無法執行.
                                        #參考資料:
                                        #exec=>http://php.net/manual/en/function.exec.php
                                        #escapeshellcmd=>http://php.net/manual/en/function.escapeshellcmd.php
                                        #escapeshellarg=>http://php.net/manual/en/function.escapeshellarg.php
                                        $callShellMulti=external::callShellMulti($conf["external::callShellMulti"]);
                                        unset($conf["external::callShellMulti"]);

                                        #如果運行指令失敗
                                        if($callShellMulti["status"]==="false"){

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

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

                                                #回傳結果
                                                return $result;

                                                }#if end

                                        #如果就壓縮好的 js 套件目錄不存在
                                        if(!file_exists($jsAddr)){

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

                                                #設置錯誤訊息
                                                $result["error"][]=$jsAddr." 不存在";

                                                #回傳結果
                                                return $result;

                                                }#if end

                                        #如果解壓縮好的 js 套件最外層不是目錄
                                        if(!is_dir($jsAddr)){

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

                                                #設置錯誤訊息
                                                $result["error"][]=$jsAddr." 應該為目錄";

                                                #回傳結果
                                                return $result;

                                                }#if end

                                        #取得 js 套件的相對路徑
                                        $result["content"][]=$jsAddr;

                                        }#else end

                                #反之
                                else{

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

                                        #設置錯誤訊息
                                        $result["error"][]=$jsAddr."為不支援的js套件格式.";

                                        #回傳結果
                                        return $result;

                                        }#else end

                                }#if end

                        #反之存在
                        else if($checkMultiFileExist["varExist"][0]==="true"){

                                #轉換 js 套件的位置為相對位置
                                #函數說明:
                                #將多個路徑字串變成相對於當前路徑的相對路徑字串
                                #回傳結果:
                                #$result["status"],"true"爲建立成功,"false"爲建立失敗.
                                #$result["error"],錯誤訊息陣列.
                                #$result["function"],函數名稱.
                                #$result["argu"],使用的參數.
                                #$result["content"],字串陣列,多個轉換好的相對路徑字串.
                                #必填參數:
                                #$conf["path"],陣列字串,要轉換成相對路徑的字串.;
                                $conf["fileAccess::getRelativePath"]["path"]=array($checkMultiFileExist["varNameFullPath"][0]);
                                #$conf["fileArgu"],字串,當前路徑.
                                $conf["fileAccess::getRelativePath"]["fileArgu"]=$conf["fileArgu"];
                                $getRelativePath=fileAccess::getRelativePath($conf["fileAccess::getRelativePath"]);
                                unset($conf["fileAccess::getRelativePath"]);

                                #如果轉換成相對位置失敗
                                if($getRelativePath["status"]==="false"){

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

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

                                        #回傳結果
                                        return $result;

                                        }#if end

                                #取得 js 套件的相對路徑
                                $result["content"]=$getRelativePath["content"];

                                }#if end

                        }#foreach end

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

                #回傳結果
                return $result;

                }#function getLib end

        }#class lib end

?>