WebSVN – php-qbpwcf – Diff – /trunk/usr/lib64/qbpwcf/bigbluebutton.php

 <?php
 /*
 	QBPWCF, Quick Build PHP website Component base on Fedora Linux.
-    Copyright (C) 2015~2025 Min-Jhin,Chen
+    Copyright (C) 2014~2025 MIN ZHI, CHEN
     This file is part of QBPWCF.
     QBPWCF is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
 		#回傳結果
 		return $result;
 		}#function __callStatic end
 	/*
 	#函式說明:
 	#計算checksum
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		$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"],變數的解析結果.
 			#無.
 			#備註:
 			#目前不支援物件.
 			$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"]);
 		#無.
 		#備註:
 		#目前不支援物件.
 		$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"代表不正常.
 	*/
 	public static function listRooms(&$conf){
 		#取得當前執行的函式
 		$result["function"]=__FUNCTION__;
 		#取得使用的參數
 		$result["argu"]=$conf;
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		$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"],變數的解析結果.
 			#無.
 			#備註:
 			#目前不支援物件.
 			$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"],執行不正常結束的錯訊息陣列.
 		#取得checksum
 		$checkSum=$getCheckSum["content"];
 		#取得目標url
 		$targetUrl=$headUrl."?checksum=".$checkSum;
 		#函式說明:
 		#運行curl cmd
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		$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"代表不正常.
 	#https://docs.bigbluebutton.org/dev/api.html#getmeetings
 	#備註:
 	#無.
 	*/
 	public static function createRoom(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 			#回傳結果
 			return $result;
 			}#if end
 		#base url
 		$baseUrl=$conf["bbbUrl"]."/bigbluebutton/api/";
 		#api name
 		$apiName="create";
 		#建立 $meetingID
 		#涵式說明:
 		#呼叫shell執行系統命令,並取得回傳的內容.
 		#回傳的結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#參考資料：
 		#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"],執行不正常結束的錯訊息陣列.
 		$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"],錯誤訊息陣列.
 		$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字串.
 		#回傳結果:
 		$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"代表不正常.
 	#https://docs.bigbluebutton.org/dev/api.html#join
 	#備註:
 	#無.
 	*/
 	public static function enterRoom(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 			#回傳結果
 			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"],執行不正常結束的錯訊息陣列.
 		$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"代表不正常.
 	#https://docs.bigbluebutton.org/dev/api.html#getrecordings
 	#備註:
 	#建構中.
 	*/
 	public static function getRecord(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 			#回傳結果
 			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"],執行不正常結束的錯訊息陣列.
 		$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"],錯誤訊息陣列.
 		$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字串.
 		#回傳結果:
 		$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
 ?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/bigbluebutton.php – Rev 3 → 226