Subversion Repositories php-qbpwcf

<?php

/*

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

/*
類別說明:
提供bigbluebutton應用的類別.
備註:
無.
*/
class bigbluebutton{

        /*
        #函式說明:
        #當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
        #回傳結果:
        #$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
        
        /*
        #函式說明:
        #計算checksum
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$reuslt["error"],執行不正常結束的錯訊息陣列.
        #$result["function"],當前執行的函式名稱.
        #$result["argu"],使用的參數.
        #$result["content"],內容.
        #必填參數:
        #$conf["input"],字串,要計算checksum的內容.
        $conf["input"]="";
        #$conf["SharedSecret"],字串,SharedSecret.
        $conf["SharedSecret"]="";
        #可省略參數:
        #$conf["hideSecret"],字串,預設為"true",代表要隱藏使用的 SharedSecret 參數內容;"false"代表不用隱藏.
        #$conf["hideSecret"]="false";
        #參考資料:
        #無.
        #備註:
        #無.
        */
        public static function getCheckSum(&$conf){

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

                #取得使用的參數
                $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("input","SharedSecret");
                #$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string");
                #$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
                $conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
                #$conf["canNotBeEmpty"]=array();
                #$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
                #$conf["canBeEmpty"]=array();
                #$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
                $conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("hideSecret");
                #$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("hideSecret");
                #$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
                #$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true");
                #$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
                #$conf["disallowAllSkipableVarIsEmpty"]="";
                #$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".
                #$conf["disallowAllSkipableVarIsEmptyArray"]="";
                #$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["arrayCountEqualCheck"][]=array();
                #參考資料:
                #array_keys=>http://php.net/manual/en/function.array-keys.php
                #備註:
                #無.
                $checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);

                #若執行失敗
                if($checkArguments["status"]==="false"){
                
                        #設置執行失敗
                        $result["status"]="false";
                
                        #設置錯誤訊息
                        $result["error"]=$checkArguments;
                
                        #函式說明:
                        #隱藏元素中可能含有機密的內容.
                        #回傳結果:
                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                        #$result["content"],變數的解析結果.
                        #$result["function"],當前執行的函數
                        #$result["error"],涵式錯誤訊息陣列
                        #必填參數:
                        #$conf["params"],陣列,要處理的變數.
                        $conf["variableCheck::hideParams"]["params"]=$result["error"];
                        #可省略參數:
                        #$conf["keyWords"],字串陣列,針對params中每一個的key，若擁有該陣列中任一元素的數值(關鍵字),則要將其內容隱藏,預設為array("password","key","secret").
                        #$conf["keyWords"]=array("password","key","secret");
                        #$conf["changeTo"],字串,將要隱藏的參數內容置換為什麼字串內容,預設為"[classified content]".
                        #$conf["changeTo"]="[classified content]";
                        #參考資料:
                        #無.
                        #備註:
                        #目前不支援物件.
                        $hideParams=variableCheck::hideParams($conf["variableCheck::hideParams"]);
                        unset($conf["variableCheck::hideParams"]);
                
                        #若執行失敗
                        if($hideParams["status"]==="false"){
                        
                                #設置執行失敗
                                $result["status"]="false";
                        
                                #設置錯誤訊息
                                $result["error"]=$hideParams;
                                
                                #回傳結果
                                return $result;
                                
                                }#if end
                
                        #取得隱藏後的結果
                        $reuslt["error"]=$hideParams["content"];
                
                        #回傳內容
                        return $reuslt;
                
                        }#if end

                #設置回傳內容
                $result["content"]=sha1($conf["input"].$conf["SharedSecret"]);

                #函式說明:
                #隱藏元素中可能含有機密的內容.
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["content"],變數的解析結果.
                #$result["function"],當前執行的函數
                #$result["error"],涵式錯誤訊息陣列
                #必填參數:
                #$conf["params"],陣列,要處理的變數.
                $conf["variableCheck::hideParams"]["params"]=$result;
                #可省略參數:
                #$conf["keyWords"],字串陣列,針對params中每一個的key，若擁有該陣列中任一元素的數值(關鍵字),則要將其內容隱藏,預設為array("password","key","secret").
                #$conf["keyWords"]=array("password","key","secret");
                #$conf["changeTo"],字串,將要隱藏的參數內容置換為什麼字串內容,預設為"[classified content]".
                #$conf["changeTo"]="[classified content]";
                #參考資料:
                #無.
                #備註:
                #目前不支援物件.
                $hideParams=variableCheck::hideParams($conf["variableCheck::hideParams"]);
                unset($conf["variableCheck::hideParams"]);
        
                #若執行失敗
                if($hideParams["status"]==="false"){
                
                        #設置執行失敗
                        $result["status"]="false";
                
                        #設置錯誤訊息
                        $result["error"]=$hideParams;
                        
                        #回傳結果
                        return $result;
                        
                        }#if end
                                
                #取得隱藏後的結果
                $result=$hideParams["content"];

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

                #回傳結果
                return $result;

                }#functino getCheckSum end
        
        /*
        #函式說明:
        #取得會議室清單
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$reuslt["error"],執行不正常結束的錯訊息陣列.
        #$result["function"],當前執行的函式名稱.
        #$result["content"],內容.
        #必填參數:
        #$conf["fileArgu"],字串,變數__FILE__的內容.
        $conf["fileArgu"]=__FILE__;
        #$conf["bbbUrl"],字串,提供bbb服務的主機名稱.
        $conf["bbbUrl"]="";
        #$conf["SharedSecret"],字串,SharedSecret.
        $conf["SharedSecret"]="";
        #可省略參數:
        #無.
        #參考資料
        #https://docs.bigbluebutton.org/dev/api.html#usage
        #https://docs.bigbluebutton.org/dev/api.html#getmeetings
        #備註:
        #無.
        */
        public static function listRooms(&$conf){

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

                #若執行失敗
                if($checkArguments["status"]==="false"){
                
                        #設置執行失敗
                        $result["status"]="false";
                
                        #設置錯誤訊息
                        $result["error"]=$checkArguments;
                
                        #函式說明:
                        #隱藏元素中可能含有機密的內容.
                        #回傳結果:
                        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                        #$result["content"],變數的解析結果.
                        #$result["function"],當前執行的函數
                        #$result["error"],涵式錯誤訊息陣列
                        #必填參數:
                        #$conf["params"],陣列,要處理的變數.
                        $conf["variableCheck::hideParams"]["params"]=$result["error"];
                        #可省略參數:
                        #$conf["keyWords"],字串陣列,針對params中每一個的key，若擁有該陣列中任一元素的數值(關鍵字),則要將其內容隱藏,預設為array("password","key","secret").
                        #$conf["keyWords"]=array("password","key","secret");
                        #$conf["changeTo"],字串,將要隱藏的參數內容置換為什麼字串內容,預設為"[classified content]".
                        #$conf["changeTo"]="[classified content]";
                        #參考資料:
                        #無.
                        #備註:
                        #目前不支援物件.
                        $hideParams=variableCheck::hideParams($conf["variableCheck::hideParams"]);
                        unset($conf["variableCheck::hideParams"]);
                
                        #若執行失敗
                        if($hideParams["status"]==="false"){
                        
                                #設置執行失敗
                                $result["status"]="false";
                        
                                #設置錯誤訊息
                                $result["error"]=$hideParams;
                                
                                #回傳結果
                                return $result;
                                
                                }#if end
                
                        #取得隱藏後的結果
                        $reuslt["error"]=$hideParams["content"];
                
                        #回傳內容
                        return $reuslt;
                
                        }#if end
        
                #base url
                $baseUrl=$conf["bbbUrl"]."/bigbluebutton/api/";
                
                #api name
                $apiName="getMeetings";
                
                #參數為空
                $getParams="";
                
                #目標網址的開頭
                $headUrl=$baseUrl.$apiName.$getParams;
                                
                #函式說明:
                #計算checksum
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["content"],內容.
                #必填參數:
                #$conf["input"],字串,要計算checksum的內容.
                $conf["bigbluebutton::getCheckSum"]["input"]=$apiName.$getParams;
                #$conf["sharedSecret"],字串,SharedSecret.
                $conf["bigbluebutton::getCheckSum"]["SharedSecret"]=$conf["SharedSecret"];
                #可省略參數:
                #無.
                #備註:
                #建構中...
                $getCheckSum=bigbluebutton::getCheckSum($conf["bigbluebutton::getCheckSum"]);
                unset($conf["bigbluebutton::getCheckSum"]);

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

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

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

                        #回傳結果
                        return $result;

                        }#if end

                #取得checksum
                $checkSum=$getCheckSum["content"];

                #取得目標url
                $targetUrl=$headUrl."?checksum=".$checkSum;
                
                #函式說明:
                #運行curl cmd
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["error"],錯誤訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["content"],取得的回應內容.
                #$result["cookie"],cookie檔案的位置與名稱.
                #$result["cmd"],執行的command.
                #$result["argu],使用的參數.
                #必填參數:
                #$conf["url"],字串,目標url.
                $conf["catchWebContent::curlCmd"]["url"]=$targetUrl;
                #$conf["fileArgu"],字串,變數__FILE__的內容.
                $conf["catchWebContent::curlCmd"]["fileArgu"]=$conf["fileArgu"];
                #可省略參數:
                #$conf["header"],字串陣列,要傳送的header.
                #$conf["header"]=array();
                #$conf["allowAnySSLcertificate"],字串,是否允許不可信任的SSL憑證,預設為"true".
                #$conf["allowAnySSLcertificate"]="";
                #$conf["postVar"],字串陣列,每個要傳送的post變數名稱(陣列的key值)與數值.
                #$conf["postVar"]=array();
                #$conf["rawPost"]="字串",要傳送的raw post內容.
                #$conf["rawPost"]="";
                #$conf["urlEncode"],字串,post的內容是否要url_encode,"true"代表要,預設為"false"代表不要.
                #$conf["urlEncode"]="false";
                #$conf["agent"],字串,user agent的名稱.
                #$conf["agent"]="";
                #$conf["cookie"],字串，cookie位置與檔案位置.
                #$conf["cookie"]="";
                #$conf["forceNewCookie"],字串,是否要重置cookie,"true"代表要,"false"代表不要,預設為"false".
                #$conf["forceNewCookie"]="";
                #備註:
                #無.
                $curlCmd=catchWebContent::curlCmd($conf["catchWebContent::curlCmd"]);
                unset($conf["catchWebContent::curlCmd"]);

                #如果執行失敗
                if($curlCmd["status"]==="false"){
                
                        #設置執行不正常
                        $result["status"]="false";

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

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

                #如果回應為 error
                if($curlCmd["content"][0]="Error"){
                
                        #設置執行不正常
                        $result ["status"]="false";

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

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

                #取得回應的內容
                $result["content"]=$curlCmd["content"];

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

                }#function listRooms end
        
        /*
        #函式說明:
        #建立會議室清單
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$reuslt["error"],執行不正常結束的錯訊息陣列.
        #$result["function"],當前執行的函式名稱.
        #$result["content"],回應的xml物件.
        #$result["res"]["returncode"],bbb server的回應,代表API的要求狀態識別.
        #$result["res"]["meetingID"],bbb server的回應,會議室識別碼.
        #$result["res"]["parentMeetingID"],bbb server的回應,父會議室識別碼
        #$result["res"]["attendeePW"],bbb server的回應,vier password.
        #$result["res"]["moderatorPW"],bbb server的回應,admin password.
        #$result["res"]["createTime"],bbb server的回應,unix建立時間戳記.
        #$result["res"]["voiceBridge"],bbb server的回應,voice id.
        #$result["res"]["dialNumber"],bbb server的回應,phone call number.
        #$result["res"]["hasUserJoined"],bbb server的回應,是否已經有使用者了.
        #$result["res"]["duration"],bbb server的回應,會議室的時間長度限制.
        #$result["res"]["hasBeenForciblyEnded"],bbb server的回應,是否已經結束會議了.
        #$result["xml"],回應的xml格式內容.
        #必填參數:
        #$conf["fileArgu"],字串,變數__FILE__的內容.
        $conf["fileArgu"]=__FILE__;
        #$conf["bbbUrl"],字串,提供bbb服務的主機名稱.
        $conf["bbbUrl"]="";
        #$conf["sharedSecret"],字串,SharedSecret.
        $conf["SharedSecret"]="";
        #$conf["meetingName"],字串,會議的名稱.
        $conf["meetingName"]="";
        #$conf["moderatorPW"],字串,管理者的密碼.
        $conf["moderatorPW"]="";
        #$conf["attendeePW"],字串,訪客的密碼.
        $conf["attendeePW"]="";
        #可省略參數:
        #$conf["autoStartRecording"],字串,預設為"true",代表要會議一開始就錄影反之為"false".
        #$conf["autoStartRecording"]="true".
        #參考資料
        #https://docs.bigbluebutton.org/dev/api.html#usage
        #https://docs.bigbluebutton.org/dev/api.html#getmeetings
        #備註:
        #無.
        */
        public static function createRoom(&$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[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息
                #必填寫的參數：
                #$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("fileArgu","bbbUrl","SharedSecret","meetingName","moderatorPW","attendeePW");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string","string","string","string");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("autoStartRecording");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true");
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array();
                $checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);

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

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

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

                        #回傳結果
                        return $result;

                        }#if end

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

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

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

                        #回傳結果
                        return $result;

                        }#if end
                        
                #base url
                $baseUrl=$conf["bbbUrl"]."/bigbluebutton/api/";
                
                #api name
                $apiName="create";
                
                #建立 $meetingID
                #涵式說明:
                #呼叫shell執行系統命令,並取得回傳的內容.
                #回傳的結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["error"],錯誤訊息陣列.
                #$result["function"],當前執行的函數名稱.
                #$result["argu"],使用的參數.
                #$result["cmd"],執行的指令內容.
                #$result["fullCmd"],如果參數 $conf["inBackGround"] 為 "true" 則會回傳該值.
                #$result["output"],爲執行完二元碼後的輸出陣列,若 $conf["inBackGround"] 為 "true",則為當下的輸出.
                #$result["tmpFileOutput"],儲存輸出的暫存檔案名稱,若 $conf["inBackGround"] 為 "true" 則會回傳該值.
                #$result["running"],是否還在執行.
                #$result["pid"],pid.
                #$result["statusCode"],執行結束後的代碼.
                #必填的參數
                #$conf["command"],字串,要執行的指令與.
                $conf["external::callShell"]["command"]="uuid";
                #$conf["fileArgu"],字串,變數__FILE__的內容.
                $conf["external::callShell"]["fileArgu"]=$conf["fileArgu"];
                #可省略參數:
                #$conf["argu"],陣列字串,指令搭配的參數,預設為空陣列.
                #$conf["argu"]=array("");
                #$conf["arguIsAddr"],陣列字串,指令搭配的哪些參數為路徑,為路徑的參數會進行轉換以便符合呼叫當前函數的位置,預設不指定,若有3個參數,其中第3個參數為路徑,則表示為array("false","false","true").
                #$conf["arguIsAddr"]=array();
                #$conf["pre"],陣列,要在本指令前執行的每個指令與參數.
                #$conf["pre"][$i]["cmd"],字串,要在本指令前執行的第$i+1個指令.
                #$conf["pre"][$i]["param"],陣列字串,要在本指令前執行的第$i+1個指令的參數.
                #$conf["enablePrintDescription"],字串,是否要印出$conf["printDescription"]的內容,"true"代表要,"false"代表不要,預設為"false".
                #$conf["enablePrintDescription"]="true";
                #$conf["printDescription"],字串,執行該外部程式前要印出來的的文字,預設為$conf["command"]的內容加上使用的$conf["argu"]參數.
                #$conf["printDescription"]="";
                #$conf["escapeshellarg"],字串,是否要啟用過濾參數,用了比較安全,但可能會出錯,"true"為啟用,"false"為不啟用,預設為"false".
                $conf["external::callShell"]["escapeshellarg"]="true";
                #$conf["username"],字串,要用什麼使用者來執行,預設為執行php的使用者,該參數不適用於apache環境.
                #$conf["username"]="";
                #$conf["password"],字串,root的使用者密碼,預設不使用密碼,該參數不適用於apache環境.
                #$conf["password"]="";
                #$conf["useScript"],字串,是否要啟用Linux的script指令來記錄輸出,"true"代表要,Fedora的selinux會擋住該操作;"false"代表不要,預設為"false".
                #$conf["useScript"]="";
                #$conf["logFilePath"],字串,當 $conf["useScript"] 為 "true" 時,輸出的內容要暫存到哪裡,預設為 "/tmp/.qbpwcf_tmp/external/callShell/".
                #$conf["logFilePath"]=".qbpwcf_tmp/external/callShell/";
                #$conf["inBackGround"],字串,是否要在背景執行,且不會等待程式執行結束再執行下一個指令,"true"代表是,"false"代表不要,預設為"false",如果$conf["command"]有用「;」區隔的多個指令將會出錯.
                #$conf["inBackGround"]="";
                #$conf["getErr"],字串,"true"代表將錯誤輸出變成標準輸出,反之"false"為不變動.
                #$conf["getErr"]="false";
                #備註:
                #不是所有指令都能用apache的身份執行,目前已知java,javac指令無法執行,使用root身份可能會被selinux阻擋.
                #參考資料：
                #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
                $callShell=external::callShell($conf["external::callShell"]);
                unset($conf["external::callShell"]);            
                
                #如果執行失敗
                if($callShell["status"]==="false"){
                
                        #設置執行不正常
                        $result ["status"]="false";

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

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

                #取得meeting id
                $meetingID=$callShell["output"][0];
                
                #參數為空
                $getParams="allowStartStopRecording=true&autoStartRecording=".$conf["autoStartRecording"]."&meetingID=".$meetingID."&name=".urlencode($conf["meetingName"])."&record=true&attendeePW=".$conf["attendeePW"]."&moderatorPW=".$conf["moderatorPW"];
                
                #目標網址的開頭
                $headUrl=$baseUrl.$apiName."?".$getParams;
                                
                #函式說明:
                #計算checksum
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["content"],內容.
                #必填參數:
                #$conf["input"],字串,要計算checksum的內容.
                $conf["bigbluebutton::getCheckSum"]["input"]=$apiName.$getParams;
                #$conf["sharedSecret"],字串,SharedSecret.
                $conf["bigbluebutton::getCheckSum"]["SharedSecret"]=$conf["SharedSecret"];
                #可省略參數:
                #無.
                #備註:
                #無.
                $getCheckSum=bigbluebutton::getCheckSum($conf["bigbluebutton::getCheckSum"]);
                unset($conf["bigbluebutton::getCheckSum"]);

                #如果執行失敗
                if($getCheckSum["status"]==="false"){
                
                        #設置執行不正常
                        $result["status"]="false";

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

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

                #取得checksum
                $checkSum=$getCheckSum["content"];

                #取得目標url
                $targetUrl=$headUrl."&checksum=".$checkSum;
                
                #函式說明:
                #運行curl cmd
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["error"],錯誤訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["content"],取得的回應內容.
                #$result["cookie"],cookie檔案的位置與名稱.
                #$result["cmd"],執行的command.
                #$result["argu],使用的參數.
                #必填參數:
                #$conf["url"],字串,目標url.
                $conf["catchWebContent::curlCmd"]["url"]=$targetUrl;
                #$conf["fileArgu"],字串,變數__FILE__的內容.
                $conf["catchWebContent::curlCmd"]["fileArgu"]=$conf["fileArgu"];
                #可省略參數:
                #$conf["header"],字串陣列,要傳送的header.
                #$conf["header"]=array();
                #$conf["allowAnySSLcertificate"],字串,是否允許不可信任的SSL憑證,預設為"true".
                #$conf["allowAnySSLcertificate"]="";
                #$conf["postVar"],字串陣列,每個要傳送的post變數名稱(陣列的key值)與數值.
                #$conf["postVar"]=array();
                #$conf["rawPost"]="字串",要傳送的raw post內容.
                #$conf["rawPost"]="";
                #$conf["urlEncode"],字串,post的內容是否要url_encode,"true"代表要,預設為"false"代表不要.
                #$conf["urlEncode"]="false";
                #$conf["agent"],字串,user agent的名稱.
                $conf["catchWebContent::curlCmd"]["agent"]="qbpwcf";
                #$conf["cookie"],字串，cookie位置與檔案位置.
                #$conf["cookie"]="";
                #$conf["forceNewCookie"],字串,是否要重置cookie,"true"代表要,"false"代表不要,預設為"false".
                #$conf["forceNewCookie"]="";
                #備註:
                #無.
                $curlCmd=catchWebContent::curlCmd($conf["catchWebContent::curlCmd"]);
                unset($conf["catchWebContent::curlCmd"]);

                #如果執行失敗
                if($curlCmd["status"]==="false"){
                
                        #設置執行不正常
                        $result["status"]="false";

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

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

                #xml字串
                $xmlStr="";

                #如果有xml內容
                if(count($curlCmd["content"])>1){
                
                        #針對每行輸出
                        for($i=0;$i<count($curlCmd["content"]);$i++){
                        
                                #傳接xml內容
                                $xmlStr=$xmlStr.$curlCmd["content"][$i];
                        
                                }#for end
                                
                        }#if end

                #涵式說明:
                #解析xml字串.
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["content"],xml物件.
                #$result["xmlStr"],xml格式的內容.
                #必填參數:
                #$conf["xmlString"],字串,要解析的xml字串.
                $conf["xml::parseXMLstring"]["xmlString"]=$xmlStr;
                #可省略參數:
                #無.
                #備註:
                #無.
                $parseXMLstring=xml::parseXMLstring($conf["xml::parseXMLstring"]);
                unset($conf["xml::parseXMLstring"]);

                #如果解析失敗
                if($parseXMLstring["status"]==="false"){
                
                        #設置執行不正常
                        $result["status"]="false";

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

                        #回傳結果
                        return $result;
                
                        }#if end
        
                #取得xml物件的內容
                $result["content"]=$parseXMLstring["content"];

                #取得回應的內容
                $result["xml"]=$parseXMLstring["xmlStr"];

                #如果有 returncode
                if(isset($result["content"]->returncode)){
                
                        #取得回應
                        $res=(array)$result["content"]->returncode;
                
                        #設置其數值內容
                        $result["res"]["returncode"]=$res[0];
                
                        }#if end
                        
                #如果有 meetingID
                if(isset($result["content"]->meetingID)){
                
                        #取得回應
                        $res=(array)$result["content"]->meetingID;
                
                        #設置其數值內容
                        $result["res"]["meetingID"]=$res[0];
                
                        }#if end
                
                #如果有 parentMeetingID
                if(isset($result["content"]->parentMeetingID)){
                
                        #取得回應
                        $res=(array)$result["content"]->parentMeetingID;
                        
                        #設置其數值內容
                        $result["res"]["parentMeetingID"]=$res[0];
                
                        }#if end
                        
                #如果有 attendeePW
                if(isset($result["content"]->attendeePW)){
                
                        #取得回應
                        $res=(array)$result["content"]->attendeePW;
                
                        #設置其數值內容
                        $result["res"]["attendeePW"]=$res[0];
                
                        }#if end

                #如果有 moderatorPW
                if(isset($result["content"]->moderatorPW)){
                
                        #取得回應
                        $res=(array)$result["content"]->moderatorPW;
                
                        #設置其數值內容
                        $result["res"]["moderatorPW"]=$res[0];
                
                        }#if end
                        
                #如果有 createTime
                if(isset($result["content"]->createTime)){
                
                        #取得回應
                        $res=(array)$result["content"]->createTime;
                
                        #設置其數值內容
                        $result["res"]["createTime"]=$res[0];
                
                        }#if end
                        
                #如果有 voiceBridge
                if(isset($result["content"]->voiceBridge)){
                
                        #取得回應
                        $res=(array)$result["content"]->voiceBridge;
                
                        #設置其數值內容
                        $result["res"]["voiceBridge"]=$res[0];
                
                        }#if end
                        
                #如果有 dialNumber
                if(isset($result["content"]->dialNumber)){
                
                        #取得回應
                        $res=(array)$result["content"]->dialNumber;
                
                        #設置其數值內容
                        $result["res"]["dialNumber"]=$res[0];
                
                        }#if end

                #如果有 hasUserJoined
                if(isset($result["content"]->hasUserJoined)){
                
                        #取得回應
                        $res=(array)$result["content"]->hasUserJoined;
                
                        #設置其數值內容
                        $result["res"]["hasUserJoined"]=$res[0];
                
                        }#if end
                        
                #如果有 duration
                if(isset($result["content"]->duration)){
                
                        #取得回應
                        $res=(array)$result["content"]->duration;
                
                        #設置其數值內容
                        $result["res"]["duration"]=$res[0];
                
                        }#if end
                        
                #如果有 hasBeenForciblyEnded
                if(isset($result["content"]->hasBeenForciblyEnded)){
                
                        #取得回應
                        $res=(array)$result["content"]->hasBeenForciblyEnded;
                
                        #設置其數值內容
                        $result["res"]["hasBeenForciblyEnded"]=$res[0];
                
                        }#if end
                        
                #設置執行正常
                $result["status"]="true";
                
                #回傳結果
                return $result;
        
                }#function createRoom end
        
        /*
        #函式說明:
        #提供加入會議室的網址.
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$reuslt["error"],執行不正常結束的錯訊息陣列.
        #$result["function"],當前執行的函式名稱.
        #$result["content"],加入會議的網址.
        #必填參數:
        #$conf["fileArgu"],字串,變數__FILE__的內容.
        $conf["fileArgu"]=__FILE__;
        #$conf["bbbUrl"],字串,提供bbb服務的主機名稱.
        $conf["bbbUrl"]="";
        #$conf["sharedSecret"],字串,SharedSecret.
        $conf["SharedSecret"]="";
        #$conf["name"],字串,你的名字.
        $conf["name"]="";
        #$conf["meetingID"],字串,會議室識別碼.
        $conf["meetingID"]="";
        #$conf["password"],字串,會議室密碼.
        $conf["password"]="";
        #可省略參數:
        #無.
        #參考資料:
        #https://docs.bigbluebutton.org/dev/api.html#join
        #備註:
        #無.
        */
        public static function enterRoom(&$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[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息
                #必填寫的參數：
                #$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("fileArgu","bbbUrl","SharedSecret","name","meetingID","password");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string","string","string","string");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                #$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("autoStartRecording");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true");
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array();
                $checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);

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

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

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

                        #回傳結果
                        return $result;

                        }#if end

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

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

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

                        #回傳結果
                        return $result;

                        }#if end
                        
                #base url
                $baseUrl=$conf["bbbUrl"]."/bigbluebutton/api/";
                
                #api name
                $apiName="join";
                
                #參數為空
                $getParams="fullName=".$conf["name"]."&meetingID=".$conf["meetingID"]."&password=".$conf["password"];
                
                #目標網址的開頭
                $headUrl=$baseUrl.$apiName."?".$getParams;
                                
                #函式說明:
                #計算checksum
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["content"],內容.
                #必填參數:
                #$conf["input"],字串,要計算checksum的內容.
                $conf["bigbluebutton::getCheckSum"]["input"]=$apiName.$getParams;
                #$conf["sharedSecret"],字串,SharedSecret.
                $conf["bigbluebutton::getCheckSum"]["SharedSecret"]=$conf["SharedSecret"];
                #可省略參數:
                #無.
                #備註:
                #無.
                $getCheckSum=bigbluebutton::getCheckSum($conf["bigbluebutton::getCheckSum"]);
                unset($conf["bigbluebutton::getCheckSum"]);

                #如果執行失敗
                if($getCheckSum["status"]==="false"){
                
                        #設置執行不正常
                        $result ["status"]="false";

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

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

                #取得checksum
                $checkSum=$getCheckSum["content"];

                #取得目標url
                $targetUrl=$headUrl."&checksum=".$checkSum;
                
                #記錄進入會議室的網址
                $result["content"]=$targetUrl;
                
                #設置執行正常
                $result["status"]="true";
                
                #回傳結果
                return $result;
                        
                }#functino enterRoom end
                
        /*
        #函式說明:
        #取得會議室的錄影資料
        #回傳結果:
        #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
        #$reuslt["error"],執行不正常結束的錯訊息陣列.
        #$result["function"],當前執行的函式名稱.
        #$result["requestUrl"],要求的網址.
        #$result["content"],回應的xml物件.
        #$result["xml"],回應的xml格式內容.
        #必填參數:
        #$conf["fileArgu"],字串,變數__FILE__的內容.
        $conf["fileArgu"]=__FILE__;
        #$conf["bbbUrl"],字串,提供bbb服務的主機名稱.
        $conf["bbbUrl"]="";
        #$conf["sharedSecret"],字串,SharedSecret.
        $conf["SharedSecret"]="";
        #可省略參數:
        #$conf["meetingID"],字串,會議室識別碼,有的話可以找特定的會議室錄影資料.
        #$conf["meetingID"]="";
        #$conf["recordID"],字串,有的話可以指定要找的特定一個錄影.
        #$conf["recordID"]="";
        #參考資料:
        #https://docs.bigbluebutton.org/dev/api.html#getrecordings
        #備註:
        #建構中.
        */
        public static function getRecord(&$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[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
                #$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
                #$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息
                #必填寫的參數：
                #$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
                $conf["variableCheck::checkArguments"]["varInput"]=&$conf;
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("fileArgu","bbbUrl","SharedSecret");
                #$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string");
                #$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
                $conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
                #可以省略的參數：
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
                #$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
                #$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
                $conf["variableCheck::checkArguments"]["skipableVariableName"]=array("meetingID","recordID");
                #$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
                $conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string");
                #$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
                $conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,null);
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
                #$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array();
                $checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
                unset($conf["variableCheck::checkArguments"]);

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

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

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

                        #回傳結果
                        return $result;

                        }#if end

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

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

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

                        #回傳結果
                        return $result;

                        }#if end
                        
                #base url
                $baseUrl=$conf["bbbUrl"]."/bigbluebutton/api/";
                
                #api name
                $apiName="getRecordings";
                
                #參數為空
                $getParamsArray=array();
                
                #如果有設定 $conf["meetingID"]
                if(isset($conf["meetingID"])){
                
                        #設定參數
                        $getParamsArray["meetingID"]=$conf["meetingID"];
                
                        }#if end
                        
                #如果有設定  recordID
                if(isset($conf["recordID"])){
                
                        #設定參數
                        $getParamsArray["recordID"]=$conf["recordID"];
                
                        }#if end
                
                #to get query string
                $getParams=http_build_query($getParamsArray);
                
                #目標網址的開頭
                $headUrl=$baseUrl.$apiName."?".$getParams;
                                
                #函式說明:
                #計算checksum
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["content"],內容.
                #必填參數:
                #$conf["input"],字串,要計算checksum的內容.
                $conf["bigbluebutton::getCheckSum"]["input"]=$apiName.$getParams;
                #$conf["sharedSecret"],字串,SharedSecret.
                $conf["bigbluebutton::getCheckSum"]["SharedSecret"]=$conf["SharedSecret"];
                #可省略參數:
                #無.
                #備註:
                #無.
                $getCheckSum=bigbluebutton::getCheckSum($conf["bigbluebutton::getCheckSum"]);
                unset($conf["bigbluebutton::getCheckSum"]);

                #如果執行失敗
                if($getCheckSum["status"]==="false"){
                
                        #設置執行不正常
                        $result ["status"]="false";

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

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

                #取得checksum
                $getParamsArray["checksum"]=$getCheckSum["content"];

                #to get query string
                $getParams=http_build_query($getParamsArray);
                
                #目標網址的開頭
                $targetUrl=$baseUrl.$apiName."?".$getParams;

                #要求的網址
                $result["requestUrl"]=$targetUrl;
                
                #函式說明:
                #運行curl cmd
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$result["error"],錯誤訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["content"],取得的回應內容.
                #$result["cookie"],cookie檔案的位置與名稱.
                #$result["cmd"],執行的command.
                #$result["argu],使用的參數.
                #必填參數:
                #$conf["url"],字串,目標url.
                $conf["catchWebContent::curlCmd"]["url"]=$targetUrl;
                #$conf["fileArgu"],字串,變數__FILE__的內容.
                $conf["catchWebContent::curlCmd"]["fileArgu"]=$conf["fileArgu"];
                #可省略參數:
                #$conf["header"],字串陣列,要傳送的header.
                #$conf["header"]=array();
                #$conf["allowAnySSLcertificate"],字串,是否允許不可信任的SSL憑證,預設為"true".
                #$conf["allowAnySSLcertificate"]="";
                #$conf["postVar"],字串陣列,每個要傳送的post變數名稱(陣列的key值)與數值.
                #$conf["postVar"]=array();
                #$conf["rawPost"]="字串",要傳送的raw post內容.
                #$conf["rawPost"]="";
                #$conf["urlEncode"],字串,post的內容是否要url_encode,"true"代表要,預設為"false"代表不要.
                #$conf["urlEncode"]="false";
                #$conf["agent"],字串,user agent的名稱.
                $conf["catchWebContent::curlCmd"]["agent"]="qbpwcf";
                #$conf["cookie"],字串，cookie位置與檔案位置.
                #$conf["cookie"]="";
                #$conf["forceNewCookie"],字串,是否要重置cookie,"true"代表要,"false"代表不要,預設為"false".
                #$conf["forceNewCookie"]="";
                #備註:
                #無.
                $curlCmd=catchWebContent::curlCmd($conf["catchWebContent::curlCmd"]);
                unset($conf["catchWebContent::curlCmd"]);

                #如果執行失敗
                if($curlCmd["status"]==="false"){
                
                        #設置執行不正常
                        $result ["status"]="false";

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

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

                #xml字串
                $xmlStr="";

                #如果有xml內容
                if(count($curlCmd["content"])>1){
                
                        #針對每行輸出
                        for($i=0;$i<count($curlCmd["content"]);$i++){
                        
                                #傳接xml內容
                                $xmlStr=$xmlStr.$curlCmd["content"][$i];
                        
                                }#for end
                                
                        }#if end

                #涵式說明:
                #解析xml字串.
                #回傳結果:
                #$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
                #$reuslt["error"],執行不正常結束的錯訊息陣列.
                #$result["function"],當前執行的函式名稱.
                #$result["content"],xml物件.
                #$result["xmlStr"],xml格式的內容.
                #必填參數:
                #$conf["xmlString"],字串,要解析的xml字串.
                $conf["xml::parseXMLstring"]["xmlString"]=$xmlStr;
                #可省略參數:
                #無.
                #備註:
                #無.
                $parseXMLstring=xml::parseXMLstring($conf["xml::parseXMLstring"]);
                unset($conf["xml::parseXMLstring"]);

                #如果解析失敗
                if($parseXMLstring["status"]==="false"){
                
                        #設置執行不正常
                        $result["status"]="false";

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

                        #回傳結果
                        return $result;
                
                        }#if end
        
                #取得xml物件的內容
                $result["content"]=$parseXMLstring["content"];

                #取得回應的xml格式內容
                $result["xml"]=$parseXMLstring["xmlStr"];

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

        }#class bigbluebutton end

?>