Subversion Repositories php-qbpwcf

<?php

/*

	QBPWCF, Quick Build PHP website Component base on Fedora Linux.

    Copyright (C) 2014~2026 MIN ZHI, CHEN

    This file is part of QBPWCF.

    QBPWCF is free software: you can redistribute it and/or modify

    it under the terms of the GNU General Public License as published by

    the Free Software Foundation, either version 3 of the License, or

    (at your option) any later version.

    QBPWCF is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License

    along with QBPWCF.  If not, see <http://www.gnu.org/licenses/>.

*/

namespace qbpwcf;

/*

類別說明:

提供多執行序應用的類別.

參考資料:

https://www.php.net/manual/en/book.parallel.php

備註:

建構中

*/

class threads{

	/*

	#函式說明:

	#當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.

	#回傳結果:

	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

	#$reuslt["error"],執行不正常結束的錯訊息陣列.

	#$result["function"],當前執行的函式名稱.

	#必填參數:

	#$method,物件,為物件實體或類別名稱,會自動置入該參數.

	#$arguments,陣列,為呼叫方法時所用的參數.

	#可省略參數:

	#無.

	#參考資料:

	#__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic

	#備註:

	#無.

	*/

	public function __call($method,$arguments){

		#取得當前執行的函式

		$result["function"]=__FUNCTION__;

		#設置執行不正常

		$result["status"]="false";

		#設置執行錯誤

		$result["error"][]=__NAMESPACE__ ."/".$method."() 不存在!";

		#設置所丟入的參數

		$result["error"][]=$arguments;

		#回傳結果

		return $result;

		}#function __call end

	/*

	#函式說明:

	#當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.

	#回傳結果:

	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

	#$reuslt["error"],執行不正常結束的錯訊息陣列.

	#$result["function"],當前執行的函式名稱.

	#必填參數:

	#$method,物件,為物件實體或類別名稱,會自動置入該參數.

	#$arguments,陣列,為呼叫方法時所用的參數.

	#可省略參數:

	#無.

	#參考資料:

	#__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic

	#備註:

	#無.

	*/

	public static function __callStatic($method,$arguments){

		#取得當前執行的函式

		$result["function"]=__FUNCTION__;

		#設置執行不正常

		$result["status"]="false";

		#設置執行錯誤

		$result["error"][]="欲呼叫的". __NAMESPACE__ ."/".$method."() 不存在!";

		#設置所丟入的參數

		$result["error"][]=$arguments;

		#回傳結果

		return $result;

		}#function __callStatic end

	/*

	#函式說明:

	#展示多執行序運作.

	#回傳結果:

	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

	#$reuslt["error"],執行不正常結束的錯訊息陣列.

	#$result["function"],當前執行的函式名稱.

	#必填參數:

	#無.

	#可省略參數:

	#無.

	#參考資料:

	#無.

	#備註:

	#無.

	改用 proc 試試 https://www.php.net/manual/en/function.proc-open.php

	*/

	public static function demo(){

		#執行demo

		var_dump(self::proc_demo());

		}#function demo end

	/*

	#函式說明:

	#透過proc展示多執行序運作.

	#回傳結果:

	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

	#$reuslt["error"],執行不正常結束的錯訊息陣列.

	#$result["function"],當前執行的函式名稱.

	#必填參數:

	#無.

	#可省略參數:

	#無.

	#參考資料:

	#https://www.php.net/manual/en/function.proc-open.php

	#備註:

	#無.

	*/

	public static function proc_demo(){

		#初始化 descriptorspec

		$descriptorspec = array();

		#stdin is a pipe that the child will read from

		$descriptorspec[]=array("pipe", "r");

		#stdout is a pipe that the child will write to

		$descriptorspec[]=array("pipe", "w");

		#stderr is a pipe that the child will write to

		$descriptorspec[]=array("pipe", "w");

		#The initial working dir for the command. This must be an absolute directory path, or null if you want to use the default value (the working dir of the current PHP process)

		$cwd = null;

		#An array with the environment variables for the command that will be run, or null to use the same environment as the current PHP process

		$env = array("QBPWCF" => "Quick Build PHP Website Componment base on Fedora Linux");

		#初始化儲存要多執行序執行的程式

		$codes=array();

		#初始化要demo用的url

		$demoUrl="https://qbpwc.sourceforge.io/";

		#要多執行序執行的程式1

		$codes[]=array("bash","curl -v -L --ssl-reqd ".$demoUrl);

		#要多執行序執行的程式2

		$codes[]=array("bash","curl -v -L --ssl-reqd ".$demoUrl);

		#要多執行序執行的程式3

		$codes[]=array("bash","curl -v -L --ssl-reqd ".$demoUrl);

		#debug

		#var_dump(__LINE__,$codes);

		#儲存每個要執行的程式資訊

		$process=array();

		#針對每個要執行的程式內容

		foreach($codes as $index=>$code){

			#取得要用什麼程式執行

			$executeBy=$code[0];

			#取得要執行的程式內容

			$code=$code[1];

			#運行 php 程式,並儲存 resource

			$process[$index]["resource"] = proc_open($executeBy, $descriptorspec, $pipes, $cwd, $env);

			#儲存對應的 pipes

			$process[$index]["pipes"]=$pipes;

			#debug

			#var_dump(__LINE__,$process[$index]);

			#如果有成功執行

			if(is_resource($process[$index]["resource"])){

				#$pipes now looks like this:

				#0 => writeable handle connected to child stdin

				#1 => readable handle connected to child stdout

				#2 => readable handle connected to child stdin

				#寫入內容作為 $executeBy 的輸入

				$bytes2write=fwrite($process[$index]["pipes"][0], $code);

				#debug

				#var_dump(__LINE__,$bytes2write);

				#結束輸入

				fclose($process[$index]["pipes"][0]);

				}#if end

			#反之,代表運行 php 失敗

			else{

				#初始化暫存執行結果的變數

				$cmdRes=array();

				#設置執行失敗

				$cmdRes["status"]="false";

				#設置執行錯誤訊息

				$cmdRes["error"]="execute program by \"".$executeBy."\" failed!";

				#設置執行結果

				$result["content"][]=$cmdRes;

				}#else end

			}#foreach end

		#debug

		#var_dump(__LINE__,$process);

		#針對每個回饋

		foreach($process as $index => $ps){

			#取得 proc resource

			$resource=$ps["resource"];

			#取得標準輸出

			$stdout=stream_get_contents($process[$index]["pipes"][1]);

			#取得錯誤輸出

			$stderr=stream_get_contents($process[$index]["pipes"][2]);

			#debug

			#var_dump($stdout);

			#初始化暫存執行狀況的變數

			$cmdRes=array();

			#設置執行失敗訊息

			$cmdRes["error"]=$stderr;

			#設置執行結果

			$cmdRes["content"]=$stdout;

			#debug

			#var_dump($cmdRes);

			#結束讀取標準輸出

			fclose($process[$index]["pipes"][1]);

			#結束讀取錯誤輸出

			fclose($process[$index]["pipes"][2]);

			#It is important that you close any pipes before calling proc_close in order to avoid a deadlock

			$cmdRes["statusCode"] = proc_close($resource);

			#debug

			#var_dump($cmdRes["statusCode"]);

			#預設執行不正常

			$cmdRes["status"]="false";

			#如果執行正常

			if($cmdRes["statusCode"]===0){

				#設置執行正常

				$cmdRes["status"]="true";

				}#if end

			#保存結果

			$result["content"][]=$cmdRes;

			#debug

			#var_dump($result);

			}#foreach end

		#設置執行正常

		$result["status"]="true";

		#debug

		#var_dump($result);

		#回傳結果

		return $result;

		}#function proc_demo end

	/*

	#函式說明:

	#透過proc來多執行序運作.

	#回傳結果:

	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

	#$reuslt["error"],執行不正常結束的錯訊息陣列.

	#$result["function"],當前執行的函式名稱.

	#$result["argu"],使用的參數.

	#$result["content"],陣列,每個元素為其指令執行的結果訊息陣列,key為"status"代表執行是否正常的識別;key為"statusCode"代表程式結束後回傳給對應executeBy程式的數值,若為"?"則代表程序尚未結束,若為整數0,則代表順利執行結束,可透過proc_update函式進行資訊的更新與取得;key為"content"代表標準輸出,若為resource,則代表為pipe;key為"error"代表非標準輸出,若為resource,則代表為pipe;key為"input"代表成功輸入的指令;key為"process"代表該程序經proc_open後的process source;key為"proc_get_status"代表程序的資訊.

	#必填參數:

	#$conf["cmds"],字串陣列,每個元素代表單一程序要執行的指令與參數.

	#$conf["cmds"]=array();

	#可省略參數:

	#$conf["wait"],字串,是否需要等待所有程序結束,預設為"true"要等待;反之為"false"不要等待.

	#$conf["wait"]="false";

	#$conf["timeout"],字串陣列,每個元素代表單一程序執行的最大等待秒數,超過後將會強迫停止執行,僅當wait參數為"true"時生效.

	#$conf["timeout"]=array("10");

	#$conf["workingDir"],字串陣列,個別程式執行時的家目錄,預設不指定.

	#$conf["workingDir"]=array("path");

	#$conf["envs"],2維字串陣列,每個元素代表個別程式執行時的指定環境變數,key變數名稱;value為變數內容.預設為array("QBPWCF" => "Quick Build PHP Website Componment base on Fedora Linux");

	#$conf["envs"]=array(array("key"=>"value"));

	#$conf["executeBy"],字串陣列,每個元素代表個別指令要用什麼程式執行,預設為"bash".

	#$conf["executeBy"]=array("bash");

	#參考資料:

	#https://www.php.net/manual/en/function.proc-open.php

	#https://www.php.net/manual/en/function.proc-get-status.php

	#https://www.php.net/manual/en/function.proc-terminate.php

	#備註:

	#當wait參數為"true"時,會自動解析stdout與stderr,因此不用再透過 self::proc_update 來更新.

	#當wait參數不為"true"時,若需要取得當下的執行狀況,請使用 self::proc_update 來更新.

	*/

	public static function proc(&$conf){

		#初始化要回傳的變數

		$result=array();

		#初始化當前執行的函數名稱

		$result["function"]=__FUNCTION__;

		#如果 $conf 不為陣列

		if(gettype($conf)!=="array"){

			#設置執行失敗

			$result["status"]="false";

			#設置執行錯誤訊息

			$result["error"][]="\$conf變數須為陣列形態";

			#如果傳入的參數為 null

			if($conf===null){

				#設置執行錯誤訊息

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

				}#if end

			#回傳結果

			return $result;

			}#if end

		#取得使用的參數

		$result["argu"]=$conf;

		#函式說明:

		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.

		#回傳結果:

		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

		#$result["error"],執行不正常結束的錯訊息陣列.

		#$result["simpleError"],簡單表示的錯誤訊息.

		#$result["function"],當前執行的函式名稱.

		#$result["argu"],設置給予的參數.

		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過

		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在

		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確

		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息

		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.

		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.

		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.

		#$result["notNeedVar"],字串陣列,多餘的參數名稱.

		#必填參數:

		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。

		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;

		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.

		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";

		#可省略參數:

		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");

		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("cmds");

		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.

		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");

		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.

		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";

		#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.

		#$conf["canNotBeEmpty"]=array();

		#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.

		#$conf["canBeEmpty"]=array();

		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.

		$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("wait","workingDir","envs","executeBy","timeout");

		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");

		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("wait","workingDir","envs","executeBy","timeout");

		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");

		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","array","array","array","array");

		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".

		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("true",null,null,null,null);

		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".

		#$conf["disallowAllSkipableVarIsEmpty"]="";

		#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".

		#$conf["disallowAllSkipableVarIsEmptyArray"]="";

		#$conf["disallowAllSkipableVarNotExist"],字串,是否不允許每個可省略參數都不存在,預設為"false"代表允許,反之為"true".

		#$conf["disallowAllSkipableVarNotExist"]="";

		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.

		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("");

		#參考資料:

		#array_keys=>http://php.net/manual/en/function.array-keys.php

		#備註:

		#無.

		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);

		unset($conf["variableCheck::checkArguments"]);

		#如果 $checkArguments["status"] 等於 "false"

		if($checkArguments["status"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$checkArguments;

			#回傳結果

			return $result;

			}#if end

		#如果 $checkArguments["passed"] 等於 "false"

		if($checkArguments["passed"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$checkArguments;

			#回傳結果

			return $result;

			}#if end

		#初始化 descriptorspec

		$descriptorspec = array();

		#stdin is a pipe that the child will read from

		$descriptorspec[]=array("pipe", "r");

		#stdout is a pipe that the child will write to

		$descriptorspec[]=array("pipe", "w");

		#stderr is a pipe that the child will write to

		$descriptorspec[]=array("pipe", "w");

		#The initial working dir for the command. This must be an absolute directory path, or null if you want to use the default value (the working dir of the current PHP process)

		$defaultCWD = null;

		#初始化儲存每個指令的working dir.

		$cwds=array();

		#有幾個指令就執行幾次

		for($i=0;$i<count($conf["cmds"]);$i++){

			#設置預設working dir

			$cwds[]=$defaultCWD;

			}#for end

		#如果有設置 workingDir

		if(isset($conf["workingDir"])){

			#如果數量符合

			if(count($conf["cmds"])===count($conf["workingDir"])){

				#有幾個指令就執行幾次

				for($i=0;$i<count($conf["cmds"]);$i++){

					#預設為指定數值

					$cwds[$i]=$conf["workingDir"][$i];

					}#for end

				}#if end

			}#if end

		#An array with the environment variables for the command that will be run, or null to use the same environment as the current PHP process

		$defaultENV = array("QBPWCF" => "Quick Build PHP Website Componment base on Fedora Linux");

		#初始化儲存每個指令的環境變數.

		$envs=array();

		#有幾個指令就執行幾次

		for($i=0;$i<count($conf["cmds"]);$i++){

			#設置預設環境變數

			$envs[]=$defaultENV;

			}#for end

		#如果有設置 envs

		if(isset($conf["envs"])){

			#如果數量符合

			if(count($conf["cmds"])===count($conf["envs"])){

				#有幾個指令就執行幾次

				for($i=0;$i<count($conf["cmds"]);$i++){

					#預設為指定數值

					$envs[]=$conf["envs"][$i];

					}#for end

				}#if end

			}#if end

		#預設程式都透過 bash 來執行

		$defaultExecBy="bash";

		#初始化儲存每個指令要透過什麼程式執行

		$executeBys=array();

		#有幾個指令就執行幾次

		for($i=0;$i<count($conf["cmds"]);$i++){

			#設置預設環境變數

			$executeBys[]=$defaultExecBy;

			}#for end

		#如果有設置 executeBy

		if(isset($conf["executeBy"])){

			#如果數量符合

			if(count($conf["cmds"])===count($conf["executeBy"])){

				#初始化儲存每個指令要透過什麼程式執行

				$executeBys=array();

				#有幾個指令就執行幾次

				for($i=0;$i<count($conf["cmds"]);$i++){

					#預設為指定數值

					$executeBys[]=$conf["executeBy"][$i];

					}#for end

				}#if end

			}#if end

		#儲存每個要執行的程式資訊

		$process=array();

		#debug

		#var_dump(__LINE__,$executeBys);

		#針對每個指令與參數字串

		foreach($conf["cmds"] as $index=>$cmdAndArguStr){

			#debug

			#var_dump(__LINE__,$executeBys[$index]);

			#debug

			#var_dump(__LINE__,$cwds[$index]);

			#運行 php 程式,並儲存 resource

			$process[$index]["resource"] = proc_open($executeBys[$index], $descriptorspec, $pipes, $cwds[$index], $envs[$index]);

			#儲存對應的 pipes

			$process[$index]["pipes"]=$pipes;

			#如果有成功執行

			if(is_resource($process[$index]["resource"])){

				#$pipes now looks like this:

				#0 => writeable handle connected to child stdin

				#1 => readable handle connected to child stdout

				#2 => readable handle connected to child stdin

				#寫入內容作為 $executeBy 的輸入

				$bytes2write=fwrite($process[$index]["pipes"][0], $cmdAndArguStr);

				#結束輸入

				fclose($process[$index]["pipes"][0]);

				#如果有完整寫入指令

				if($bytes2write===strlen($cmdAndArguStr)){

					#記錄輸入的指令

					$process[$index]["input"]=$cmdAndArguStr;

					}#if end

				#反之

				else{

					#設置錯誤識別

					$result["status"]="false";

					#設置錯誤訊息

					$result["error"][]="將指令(".$cmdAndArguStr.")輸入(".$executeBys[$index].")失敗";

					#回傳結果

					return $result;

					}#else end

				}#if end

			#反之,代表運行 $executeBys[$index] 失敗

			else{

				#初始化暫存執行結果的變數

				$cmdRes=array();

				#設置執行失敗

				$cmdRes["status"]="false";

				#設置執行錯誤訊息

				$cmdRes["error"]="execute program by \"".$executeBys[$index]."\" failed!";

				#設置執行結果

				$result["content"][]=$cmdRes;

				}#else end

			}#foreach end

		#針對每個回饋

		foreach($process as $index => $ps){

			#取得 proc resource

			$resource=&$ps["resource"];

			#取得標準輸出的pipe

			$stdout=$process[$index]["pipes"][1];

			#取得非標準輸出的pipe

			$stderr=$process[$index]["pipes"][2];

			#如果需要等待程序執行完

			if($conf["wait"]==="true"){

				#如果有設置  timeout

				if(isset($conf["timeout"])){

					#如果有設置該程序的 timeout

					if(isset($conf["timeout"][$index])){

						#避免 timeout 仍然會等待程序結束 - start

						#不讓標準輸出會阻擋程式執行

						stream_set_blocking($stdout,false);

						#不讓錯誤輸出會阻擋程式執行

						stream_set_blocking($stderr,false);

						#避免 timeout 仍然會等待程序結束 - end

						}#if end

					}#if end

				}#if end

			#反之

			else{

				#不讓標準輸出會阻擋程式執行

				stream_set_blocking($stdout,false);

				#不讓錯誤輸出會阻擋程式執行

				stream_set_blocking($stderr,false);

				}#else end

			#初始化暫存執行狀況的變數

			$cmdRes=array();

			#初始化標準輸出預設為空

			$cmdRes["content"]="";

			#初始化標準錯誤輸出預設為空

			$cmdRes["error"]="";

			#取得 proc_open 後的 process resource

			$cmdRes["process"]=$resource;

			#取得 process 的狀態,包含 pid 等資訊,若程式已經結束,則會自動將pipes關閉,再proc_close.

			$cmdRes["proc_get_status"]=proc_get_status($resource);

			#預設 statusCode 為 "?" 代表尚未 proc_close

			$cmdRes["statusCode"]="?";

			#如果執行已經結束,有回傳exitcode

			if($cmdRes["proc_get_status"]["exitcode"]!==-1){

				#設置 statusCode

				$cmdRes["statusCode"]=&$cmdRes["proc_get_status"]["exitcode"];

				#當有標準輸出時

				while(!feof($stdout)){

					#取得標準輸出

					$cmdRes["content"]=$cmdRes["content"].fread($stdout,2048);

					}#while end

				#當有錯誤輸出時

				while(!feof($stderr)){

					$cmdRes["error"]=$cmdRes["content"].fread($stderr,2048);

					}#while end

				#關閉其 proc 的運行 - start

				#關閉標準輸出的pipe

				fclose($stdout);

				#關閉標準錯誤的pipe

				fclose($stderr);

				#強制結束程序

				proc_terminate($resource);

				#結束proc.

				proc_close($resource);

				#關閉其 proc 的運行 - end

				}#if end

			#反之未執行完畢，且需要等待程序執行完

			else if($conf["wait"]==="true"){

				#預設已經執行0秒

				$runtime=0;

				#無窮迴圈

				while(true){

					#debug

					#var_dump(__LINE__,$runtime,$conf["timeout"]);

					#如果有設置  timeout

					if(isset($conf["timeout"])){

						#如果有設置該程序的 timeout

						if(isset($conf["timeout"][$index])){

							#如果執行秒數逾時了

							if( $runtime > (int)($conf["timeout"][$index]) ){

								#debug

								#var_dump(__LINE__,"timeout!");

								#關閉標準輸出的pipe

								fclose($stdout);

								#關閉標準錯誤的pipe

								fclose($stderr);

								#強制結束程序

								proc_terminate($resource);

								#結束proc.

								proc_close($resource);

								#結束無窮迴圈

								break;

								}#if end

							}#if end

						}#if end

					#取得 process 的狀態,包含 pid 等資訊,若程式已經結束,則會自動將pipes關閉,再proc_close.

					$cmdRes["proc_get_status"]=proc_get_status($resource);

					#如果執行已經結束,有回傳exitcode

					if($cmdRes["proc_get_status"]["exitcode"]!==-1){

						#設置 statusCode

						$cmdRes["statusCode"]=&$cmdRes["proc_get_status"]["exitcode"];

						#結束無窮迴圈

						break;

						}#if end

					#等待1秒鐘

					sleep(1);

					#執行秒數+1

					$runtime++;

					}#while end

				}#if end

			#設置執行失敗訊息

			$cmdRes["error"]=$stderr;

			#設置執行結果

			$cmdRes["content"]=$stdout;

			#如果有成功輸入指令

			if(isset($process[$index]["input"])){

				#設置有輸入的指令

				$cmdRes["input"]=$process[$index]["input"];

				}#if end

			#預設執行不正常

			$cmdRes["status"]="false";

			#如果執行正常 或 等於"?"(代表尚未 proc_close)

			if($cmdRes["statusCode"]===0 || $cmdRes["statusCode"]==="?"){

				#設置執行正常

				$cmdRes["status"]="true";

				}#if end

			#保存結果

			$result["content"][]=$cmdRes;

			}#foreach end

		#如果要等待程序執行結束

		if($conf["wait"]==="true"){

			#函式說明:

			#更新透過proc執行的多程序資訊.

			#回傳結果:

			#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

			#$reuslt["error"],執行不正常結束的錯訊息陣列.

			#$result["function"],當前執行的函式名稱.

			#$result["argu"],使用的參數.

			#$result["content"],陣列,每個元素為其指令執行的結果訊息陣列,key為"status"代表執行是否正常的識別;key為"statusCode"代表程式結束後回傳給對應executeBy程式的數值,若為"?"則代表程序尚未結束,可透過proc_update函式進行資訊的更新與取得;key為"output"代表標準輸出,若為resource,則代表為pipe;key為"error"代表非標準輸出,若為resource,則代表為pipe;key為"input"代表成功輸入的指令;key為"process"代表該程序經proc_open後的process source;key為"proc_get_status"代表程序的資訊.

			#必填參數:

			#$conf["procs"],陣列,運行self::proc後回傳的content.

			$conf["threads::proc_update"]["procs"]=$result["content"];

			#可省略參數:

			#無.

			#參考資料:

			#無.

			#備註:

			#無.

			$proc_update=threads::proc_update($conf["threads::proc_update"]);

			unset($conf["threads::proc_update"]);

			#如果執行異常

			if($proc_update["status"]==="false"){

				#設置錯誤識別

				$result["status"]="false";

				#設置錯誤訊息

				$result["error"]=$proc_update;

				#回傳結果

				return $result;

				}#if end

			#debug

			#var_dump(__LINE__,$proc_update);exit;

			#取得執行後的標準輸出

			$result["content"]=$proc_update["content"];

			}#if end

		#設置執行正常

		$result["status"]="true";

		#回傳結果

		return $result;

		}#function proc end

	/*

	#函式說明:

	#更新透過proc執行的多程序資訊.

	#回傳結果:

	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.

	#$reuslt["error"],執行不正常結束的錯訊息陣列.

	#$result["function"],當前執行的函式名稱.

	#$result["argu"],使用的參數.

	#$result["content"],陣列,每個元素為其指令執行的結果訊息陣列,key為"status"代表執行是否正常的識別;key為"statusCode"代表程式結束後回傳給對應executeBy程式的數值,若為"?"則代表程序尚未結束,可透過proc_update函式進行資訊的更新與取得;key為"output"代表標準輸出,若為resource,則代表為pipe;key為"error"代表非標準輸出,若為resource,則代表為pipe;key為"input"代表成功輸入的指令;key為"process"代表該程序經proc_open後的process source;key為"proc_get_status"代表程序的資訊.

	#必填參數:

	#$conf["procs"],陣列,運行self::proc後回傳的content.

	$conf["procs"]=$procs;

	#可省略參數:

	#無.

	#參考資料:

	#無.

	#備註:

	#無.

	*/

	public static function proc_update(&$conf){

		#初始化要回傳的變數

		$result=array();

		#初始化當前執行的函數名稱

		$result["function"]=__FUNCTION__;

		#如果 $conf 不為陣列

		if(gettype($conf)!="array"){

			#設置執行失敗

			$result["status"]="false";

			#設置執行錯誤訊息

			$result["error"][]="\$conf變數須為陣列形態";

			#如果傳入的參數為 null

			if($conf==null){

				#設置執行錯誤訊息

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

				}#if end

			#回傳結果

			return $result;

			}#if end

		#取得使用的參數

		$result["argu"]=$conf;

		#函式說明:

		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.

		#回傳結果: