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

 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$callShell;
 			#回傳結果
 			return $result;
 			}#if end
 	#$result["tmpFileOutput"],儲存輸出的暫存檔案名稱,若 $conf["inBackGround"] 為 "true" 則會回傳該值.
 	#$result["running"],是否還在執行.
 	#$result["pid"],pid.
 	#$result["statusCode"],執行結束後的代碼.
 	#$result["escape"],陣列,儲存重新排序過且已經escape過的指令(key為"cmd")與參數(key為"argu")與兩者組合的一維陣列(key為"array").
+	#$result["noEcaped"],陣列,儲存重新排序過未經過escape過的指令(key為"cmd")與參數(key為"argu")與兩者組合的一維陣列(key為"array").
 	#必填參數:
 	#$conf["command"],字串,要執行的指令.
 	$conf["command"]="";
 	#$conf["fileArgu"],字串,變數__FILE__的內容.
 	$conf["fileArgu"]=__FILE__;
 	#$conf["thereIsShellVar"],陣列字串,指令搭配的參數"argu",若含有「\'」,則取代為「"」.每個argu參數都要有對應的元素."true"代表要置換.
 	#$conf["thereIsShellVar"]=array();
 	#$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["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("pre","enablePrintDescription","printDescription","argu","escapeshellarg","username","password","useScript","logFilePath","inBackGround","arguIsAddr","getErr","plainArgu","useApostrophe","doNotRun","thereIsShellVar");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("pre","enablePrintDescription","printDescription","argu","escapeshellarg","username","password","useScript","logFilePath","inBackGround","arguIsAddr","getErr","doNotRun","thereIsShellVar");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
-		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","string","string","array","string","string","string","string","string","string","array","string","array","array","string","array");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","string","string","array","string","string","string","string","string","string","array","string","string","array");
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
-		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,"false",null,null,"false",null,null,"false",".qbpwcf_tmp/external/callShell/","false",null,"false",null,null,"false",null);
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,"false",null,null,"false",null,null,"false",".qbpwcf_tmp/external/callShell/","false",null,"false","false",null);
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("argu","arguIsAddr");
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 						#如果是位置參數
 						if($conf["arguIsAddr"][$i]==="true"){
 							#如果相對路徑就要轉換路徑
-							if(strpos($conf["argu"][$i],"/")!==0)
+							if(strpos($conf["argu"][$i],"/")!==0){
-							{
 								#函數說明:
 								#將多個路徑字串變成相對於當前路徑的相對路徑字串
 								#回傳結果:
 								#$result["status"],"true"爲建立成功,"false"爲建立失敗.
 								#$result["error"],錯誤訊息陣列.
 								#$conf["path"],陣列字串,要轉換成相對路徑的字串.;
 								$conf["fileAccess::getRelativePath"]["path"]=array($conf["argu"][$i]);
 								#$conf["fileArgu"],字串,當前路徑.
 								$conf["fileAccess::getRelativePath"]["fileArgu"]=$conf["fileArgu"];
 								$getRelativePath=fileAccess::getRelativePath($conf["fileAccess::getRelativePath"]);
 								unset($conf["fileAccess::getRelativePath"]);
 								#var_dump($getRelativePath);
 								#如果轉換路徑失敗
 								if($getRelativePath["status"]==="false"){
 									#設置執行失敗的識別
 									$result["status"]="false";
 									$result["error"]=$getRelativePath;
 									#回傳結果
 									return $result;
 									}#if end
 								#取得相對路徑
 								$conf["argu"][$i]=$getRelativePath["content"][0];
 								#取得相對路徑
 								$relativePath=$getRelativePath["content"][0];
 								#保存其相對路徑
 								$conf["argu"][$i]=$relativePath;
 								}#if end
 							}#if end
 							#儲存真正的參數
 							$result["escape"]["argu"][]=$escapeArgu;
 							}#else
 						}#else end
 					}#for end
 				}#if end
 			}#if end
 		#反之 $conf["escapeshellarg"] 為 "false"
 		else{
+			#初始化儲存未escaped後的指令與參數資訊
+			$result["noEscaped"]=array();
+			#儲存執行的指令
+			$result["noEscaped"]["cmd"]=$conf["command"];
+			#初始化儲存執行的參數
+			$result["noEscaped"]["argu"]=array();
 			#如果有參數存在
 			if(isset($conf["argu"])){
+				#儲存執行的參數
+				$result["noEscaped"]["argu"]=$conf["argu"];
 				#有幾個參數就執行幾次
 				for($i=0;$i<count($conf["argu"]);$i++){
 					#如果有指定位置參數
 					if(isset($conf["arguIsAddr"])){
 						#如果是位置參數
 						if($conf["arguIsAddr"][$i]==="true"){
 							#如果是相對路徑就要轉換路徑
-							if(strpos($conf["argu"][$i],"/")!==0)
+							if(strpos($conf["argu"][$i],"/")!==0){
-							{
 								#函數說明:
 								#將多個路徑字串變成相對於當前路徑的相對路徑字串
 								#回傳結果:
 								#$result["status"],"true"爲建立成功,"false"爲建立失敗.
 								#$result["error"],錯誤訊息陣列.
 								$conf["fileAccess::getRelativePath"]["path"]=array($conf["argu"][$i]);
 								#$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["cmd"]="su ".$conf["username"]." -c '".$result["cmd"]."'";
 					}#else end
 				}#if end
 			}#if end
 		#如果 $conf["useScript"] 為 "true"
 			#$conf["fileAccess::getInternetAddress"]["userDir"]="true";
 			#備註:
 			#在命令列執行，所得的路徑是錯誤的。
 			$getInternetAddress=fileAccess::getInternetAddress($conf["fileAccess::getInternetAddress"]);
 			unset($conf["fileAccess::getInternetAddress"]);
 			#如果轉換路徑失敗
 			if($getInternetAddress["status"]=="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#回傳結果
 				return $result;
 				}#if end
 			#取得轉換後的絕對路徑
 			$conf["logFilePath"]=$getInternetAddress["fileSystemAbsoulutePosition"];
 			#確保logFile的路徑
 			#涵式說明：
 			#確保路徑存在.
 			#回傳的結果：
 			#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
 				#回傳結果
 				return $result;
 				}#if end
 			#初始化 $conf["logFileName"]
 			$conf["logFileName"]="";
 			#無窮迴圈
 			for($i=0;$i<1;){
 					#跳出迴圈
 					break;
 					}#else end
 				}#for end
 			#用script指令抓取輸出,並存到 $conf["logFilePath"]."/".$conf["logFileName"].
 			$result["cmd"]="script -q -c \"".$result["cmd"]."\" \"".$conf["logFilePath"]."/".$conf["logFileName"]."\"";
 			}#if end
 		#反之沒有要在背景中執行
 		else{
 			#如果要將錯誤輸出導到標準輸出
 			if($conf["getErr"]==="true"){
 				#指令加上 "2>&1"
 				$result["cmd"]=$result["cmd"]." 2>&1";
 			#設置 cmd & argu 合併為一維陣列後的結果
 			$result["escape"]["array"]=&$cmdAndArguArray;
 			}#if end
+		#如果有不 Escaped 的指令資訊結果
+		if(isset($result["noEscaped"])){
+			#從 $result["noEscaped"]["cmd"] 跟 $result["noEscaped"]["argu"] 產生 $result["noEscaped"]["array"]
+			#函式說明:
+			#將多個一維陣列串聯起來,key從0開始排序.
+			#回傳的結果：
+			#$result["status"],"true"表執行正常,"false"代表執行不正常.
+			#$result["error"],錯誤訊息陣列.
+			#$result["function"],當前執行的函數.
+			#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
+			#$result["content"],合併好的一維陣列.
+			#必填參數
+			#$conf["inputArray"],陣列,要合併的一維陣列變數，例如：=array($array1,$array2);
+			$conf["arrays::mergeArray"]["inputArray"]=array(array($result["noEscaped"]["cmd"]),$result["noEscaped"]["argu"]);
+			#可省略參數:
+			#$conf["allowRepeat"],字串,預設為"true",允許重複的結果;若為"false"則不會出現重複的元素內容.
+			#$conf["allowRepeat"]="true";
+			#$conf["looseDiff"],字串,預設為"false",代表要嚴謹判斷為有相異,例如陣列中元素的key順序不同(整數)就代表有相異;反之為"true",例如陣列中元素的key順序不同(非整數),但value有相同,則視為無相異.
+			#$conf["looseDiff"]="false";
+			#參考資料:
+			#無.
+			#備註:
+			#無.
+			$mergeArray=arrays::mergeArray($conf["arrays::mergeArray"]);
+			unset($conf["arrays::mergeArray"]);
+			#如果異常
+			if($mergeArray["status"]=="false"){
+				#設置執行不正常
+				$result["status"]="false";
+				#設置執行錯誤
+				$result["error"]=$mergeArray;
+				#回傳結果
+				return $result;
+				}#if end
+			#取得未escape的指令與參數陣列
+			$result["noEscaped"]["array"]=$mergeArray["content"];
+			}#if end
 		#若執行外部式回傳的狀態不為0
 		if($execStatus!==0){
 			#代表執行外部程式不正常.
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function callShellExecInBg end
 	/*
 	#函式說明:
 	#檢查程序是否還在執行
 	#回傳結果:

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/external.php – Rev 60 → 66