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

 		}#function classDiagramsMaker end
 	/*
 	#函式說明:
-	#更新程式檔案開頭版權宣告的年份,以及作者清單.
+	#更新程式檔案開頭版權宣告的年份,以及作者清單,取得更新過後的檔案路徑.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$reuslt["error"],執行不正常結束的錯訊息陣列.
 	#$result["function"],當前執行的函式名稱.
 	#$result["argu"],本函式使用的參數.
 	#$conf["threadType"]="socket";
 	#$conf["socket"],字串,unix domain socket 的位置與名稱,預設為 qbpwcf_usock_path;
 	#$conf["socket"]=qbpwcf_usock_path;
 	#$conf["log"],字串,log的檔案位置與名稱,預設不使用.
 	#$conf["log"]="";
+	#$conf["outputPath"],字串,更新後的檔案內容要存放到哪個路徑低下,預設為 /tmp 底下.
+	#$conf["outputPath"]="";
 	#參考資料:
 	#無.
 	#備註:
 	#建構中...
 	*/
 			#回傳結果
 			return $result;
 			}#if end
+		#設置要取代的內容關鍵字陣列 - start
+		$replaceFromArray=array();
+		$replaceFromArray[]="        QBPWCF, Quick Build PHP website Component base on Fedora Linux.";
+		$replaceFromArray[]="    Copyright (C) \${yearFrom}~\${yearTo} \${Authors}";
+		$replaceFromArray[]="";
+		$replaceFromArray[]="    This file is part of QBPWCF.";
+		$replaceFromArray[]="";
+		$replaceFromArray[]="    QBPWCF is free software: you can redistribute it and/or modify";
+		$replaceFromArray[]="    it under the terms of the GNU General Public License as published by";
+		$replaceFromArray[]="    the Free Software Foundation, either version 3 of the License, or";
+		$replaceFromArray[]="    (at your option) any later version.";
+		$replaceFromArray[]="";
+		$replaceFromArray[]="    QBPWCF is distributed in the hope that it will be useful,";
+		$replaceFromArray[]="    but WITHOUT ANY WARRANTY; without even the implied warranty of";
+		$replaceFromArray[]="    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the";
+		$replaceFromArray[]="    GNU General Public License for more details.";
+		$replaceFromArray[]="";
+		$replaceFromArray[]="    You should have received a copy of the GNU General Public License";
+		$replaceFromArray[]="    along with QBPWCF.  If not, see <http://www.gnu.org/licenses/>.";
+		#設置要取代的內容關鍵字陣列 - end
 		#函式說明:
 		#取得檔案路徑字串的路徑與檔案的名稱與檔案副檔名
 		#回傳的結果:
 		#$result["status"],執行是否正常,"true"正常,"false"代表不正常.
 		#$result["error"],錯誤訊息.
 		#備註:
 		#無.
 		$getFileAddressAndNameAndFileExtention=fileAccess::getFileAddressAndNameAndFileExtention($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 		unset($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
-		#debug,break point.
-		#var_dump(__LINE__,$getFileAddressAndNameAndFileExtention);exit;
 		#如果執行失敗
 		if($getFileAddressAndNameAndFileExtention["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#回傳結果
 			return $result;
 			}#if end
-		#初始化有異動的檔案清單
-		$result["content"]=array();
 		#取得當前使用套件的路徑
 		$libPath=$getFileAddressAndNameAndFileExtention["filePath"]."../../../";
 		#debug,break point.
 		#var_dump(__LINE__,$libPath);exit(1);
 			return $result;
 			}#if end
 		#取得直觀的絕對路徑
-		$libPath=$changeDirByDotDotSolidus["changedPath"];
+		$libRootPath=$changeDirByDotDotSolidus["changedPath"];
-		#debug
-		#var_dump(__LINE__,$libPath);exit(1);
-		#設置要取代的內容關鍵字陣列 - start
-		$replaceFromArray=array();
-		$replaceFromArray[]="        QBPWCF, Quick Build PHP website Component base on Fedora Linux.";
-		$replaceFromArray[]="    Copyright (C) \${yearFrom}~\${yearTo} \${Authors}";
-		$replaceFromArray[]="";
-		$replaceFromArray[]="    This file is part of QBPWCF.";
-		$replaceFromArray[]="";
-		$replaceFromArray[]="    QBPWCF is free software: you can redistribute it and/or modify";
-		$replaceFromArray[]="    it under the terms of the GNU General Public License as published by";
-		$replaceFromArray[]="    the Free Software Foundation, either version 3 of the License, or";
+		#取得 lib folder
-		$replaceFromArray[]="    (at your option) any later version.";
+		exec("php -f ".escapeshellarg(pathinfo(__FILE__)["dirname"]."/../../bin/libexec/folderOfUsrLib.php"),$output,$status);
-		$replaceFromArray[]="";
+		#如果執行失敗
+		if($status!==0){
-		$replaceFromArray[]="    QBPWCF is distributed in the hope that it will be useful,";
-		$replaceFromArray[]="    but WITHOUT ANY WARRANTY; without even the implied warranty of";
-		$replaceFromArray[]="    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the";
+			#debug
+			var_dump(__LINE__,$output);
+			#結束執行,回傳shell 1.
+			exit(1);
+			}#if end
+		#儲存 lib folder
-		$replaceFromArray[]="    GNU General Public License for more details.";
+		$folderOfUsrLib=$output[0];
-		$replaceFromArray[]="";
+		#儲存 lib path
+		$libPath=$libRootPath."/usr/".$folderOfUsrLib;
+		#debug
-		$replaceFromArray[]="    You should have received a copy of the GNU General Public License";
+		#var_dump(__LINE__,$libPath);exit(1);
+		#函式說明:
+		#使用 linux 的 uuid 指令來產生 uuid 字串
+		#回傳結果:
-		$replaceFromArray[]="    along with QBPWCF.  If not, see <http://www.gnu.org/licenses/>.";
+		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+		#$result["error"],錯誤訊息.
+		#$result["function"],當前執行的函式名稱.
+		#$result["content"],uuid.
+		#必填參數:
+		#無.
+		#可省略參數:
+		#無.
+		#參考資料:
+		#無.
+		#備註:
+		#無.
+		$uuid=cmd::uuid();
+		#如果執行失敗
+		if($uuid["status"]==="false"){
+			#debug
+			var_dump($uuid);
+			#結束執行回傳代碼1給shell
+			exit(1);
+			}#if end
-		#設置要取代的內容關鍵字陣列 - end
+		#預設的輸出目錄
+		$outputPath="/tmp/".$uuid["content"]."-phpLib::updateCopyRightYear/";
+		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],執行不正常結束的錯訊息陣列.
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("fileArgu");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null、any代表不指定變數形態.其中 resource也包含"resource (closed)".
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
 		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
-		#$conf["canBeEmptyString"]="false";
+		$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();
+		#$conf["skipableVariableCanNotBeEmpty"]=array();
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
-		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("replaceFrom","yearFrom","yearTo","Authors","searchPath","skipHiddenFolder","includeHiddenFolder","excludeDirName","excludeMineType","excludeSecondName","multiThread","log","threadType","socket");
+		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("replaceFrom","yearFrom","yearTo","Authors","searchPath","skipHiddenFolder","includeHiddenFolder","excludeDirName","excludeMineType","excludeSecondName","multiThread","threadType","socket","log","outputPath");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
-		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","string","string","array","array","string","array","array","array","array","string","string","string","string");
+		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","string","string","array","array","string","array","array","array","array","string","string","string","string","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
-		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array($replaceFromArray,"2014",gmdate("Y"),array("MIN-ZHI, CHEN"),array($libPath),"true",null,array("free-lib","non-free-lib","composer"),array("image/*","video/*","audio/*","media/*","application/*"),array("log","csv","sql","js","css","html"),"false",null,"socket",qbpwcf_usock_path);
+		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array($replaceFromArray,"2014",gmdate("Y"),array("MIN ZHI, CHEN"),array($libPath),"true",null,array("free-lib","no-free-lib","composer"),array("image/*","video/*","audio/*","media/*","application/*"),array("log","csv","sql","js","css","html"),"false","socket",qbpwcf_usock_path,null,$outputPath);
 		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
-		#$conf["variableCheck::checkArguments"]["disallowAllSkipableVarIsEmpty"]="true";
+		#$conf["disallowAllSkipableVarIsEmpty"]="";
 		#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".
-		#$conf["variableCheck::checkArguments"]["disallowAllSkipableVarIsEmptyArray"]="true";
+		#$conf["disallowAllSkipableVarIsEmptyArray"]="";
 		#$conf["disallowAllSkipableVarNotExist"],字串,是否不允許每個可省略參數都不存在,預設為"false"代表允許,反之為"true".
 		#$conf["disallowAllSkipableVarNotExist"]="";
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料:
 		#備註:
 		#無.
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
-		#如果執行失敗
+		#如果執行異常
 		if($checkArguments["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
-		#如果檢查不通過
+		#如果參數檢查不通過
 		if($checkArguments["passed"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
+			}#if end
+		#函式說明:
+		#取得檔案路徑字串的路徑與檔案的名稱與檔案副檔名
+		#回傳的結果:
+		#$result["status"],執行是否正常,"true"正常,"false"代表不正常.
+		#$result["error"],錯誤訊息.
+		#$result["function"],當前執行的函式名稱.
+		#$result["filePath"],路徑字串.
+		#$result["fileName"],檔案名稱字串.
+		#$result["fileExtention"],檔案的副檔名.
+		#$result["fullFileName"],含副檔名的檔案名稱.
+		#$result["fullFilePathAndName"],完整的檔案路徑(含副檔名).
+		#必填參數:
+		#$conf["fileAddressAndName"],字串,檔案名稱與其路徑.
+		$conf["fileAccess::getFileAddressAndNameAndFileExtention"]["fileAddressAndName"]=__FILE__;
+		#可省略參數:
+		#無.
+		#參考資料:
+		#無.
+		#備註:
+		#無.
+		$getFileAddressAndNameAndFileExtention=fileAccess::getFileAddressAndNameAndFileExtention($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
+		unset($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
+		#debug,break point.
+		#var_dump(__LINE__,$getFileAddressAndNameAndFileExtention);exit;
+		#如果執行失敗
+		if($getFileAddressAndNameAndFileExtention["status"]==="false"){
+			#設置錯誤識別
+			$result["status"]="false";
+			#設置錯誤訊息
+			$result["error"]=$getFileAddressAndNameAndFileExtention;
+			#回傳結果
+			return $result;
 			}#if end
+		#初始化有異動的檔案清單
+		$result["content"]=array();
 		#函式說明:
 		#使用 linux 的 uuid 指令來產生 uuid 字串
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息.
 		#針對 $conf["searchPath"] 的每個路徑
 		foreach($conf["searchPath"] as $path){
 			#debug
-			var_dump(__LINE__,"searching path:".$path);
+			#var_dump(__LINE__,"searching path:".$path);
 			#取得 $path 底下的所有檔案.
 			#函式說明:
 			#取得目錄底下的詳細資訊.
 			#回傳結果:
 						#記錄有掃描的資料夾路徑與名稱
 						$result["scannedFile"][]=$NodePathAndName;
 						#debug
-						var_dump(__LINE__,"seartched node:".$NodePathAndName);
+						#var_dump(__LINE__,"seartched node:".$NodePathAndName);
 						#合併 content - start
 						#函式說明:
 						#將多個一維陣列串聯起來,key從0開始排序.
 						#要執行的php程式內容
 						$cmdString=<<<'PHP'
 /*
         QBPWCF, Quick Build PHP website Component base on Fedora Linux.
-    Copyright (C) 2014~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
 #$conf["replaceFrom"]=array();
 #$conf["yearFrom],字串,起始年份,預設為西元"2014"年.
 #$conf["yearFrom"]="2014";
 #$conf["yearTo],字串,結束年份,預設為西元"gmdate('Y')"年.
 #$conf["yearTo"]=gmdate('Y');
-#$conf["Authors"],陣列,該套件的參與者,預設為array("Min-Jhin,Chen");
+#$conf["Authors"],陣列,該套件的參與者,預設為array("MIN-ZHI, CHEN");
-#$conf["Authors"]=array("Min-Jhin,Chen");
+#$conf["Authors"]=array("MIN-ZHI, CHEN");
 #$conf["searchPath"],陣列,要搜尋哪些地方的檔案要更新版權宣告年份,預設為使用中的本套件位置.
 #$conf["searchPath"]=array("");
 #$conf["skipHiddenFolder"],字串,要略過隱藏的資料夾,預設為"true";反之為"false";
 #$conf["skipHiddenFolder"]="true";
 #$conf["includeHiddenFolder"],陣列,符合名稱的隱藏資料夾會存取,預設不指定;
 						#設置多執行序的類型
 						$threadType=$conf["threadType"];
 						#debug,break point
-						var_dump(__LINE__,$threadType);exit(1);
+						#var_dump(__LINE__,$threadType);exit(1);
 						#判斷多執行序的類型
 						switch($threadType){
 							#若是直接用 proc
 					#記錄有掃描的檔案路徑與名稱
 					$result["scannedFile"][]=$NodePathAndName;
 					#debug
-					var_dump(__LINE__,"found file:".$NodePathAndName." mimeType:".$node["mimeType"]);
+					#var_dump(__LINE__,"found file:".$NodePathAndName." mimeType:".$node["mimeType"]);
 					#如果沒有用多執行序
 					if($conf["multiThread"]==="false"){
+						#設置起始年份
+						$replaceTo[1]["yearFrom"]=$conf["yearFrom"];
+						#設置到的年份
+						$replaceTo[1]["yearTo"]=$conf["yearTo"];
+						#將作者陣列變成字串.
+						#函式說明:
+						#將一維陣列轉換為用特定符號間隔的字串,ex:array("1","2","3") to "a;b;c;".
+						#回傳的結果:
+						#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+						#$result["function"],當前執行的function名稱
+						#$result["error"],錯誤訊息陣列.
+						#$result["content"],處理好的字串.
+						#$result["argu"],使用的參數.
+						#必填參數:
+						#$conf["inputArray"],字串陣列,要轉成字串的一維陣列.
+						$conf["arrays::arrayToString"]["inputArray"]=$conf["Authors"];
+						#可省略參數:
+						#$conf["spiltSymbol"],字串,用來區隔字串的符號,預設為;
+						$conf["arrays::arrayToString"]["spiltSymbol"]=", ";
+						#$conf["skipEnd"],字串,結尾是否不要加上符號,預設為"false",要加上符號,"true"代表不要加上符號.
+						$conf["arrays::arrayToString"]["skipEnd"]="true";
+						#$conf["spiltSymbolAtStart"],字串,是否要在開頭加上spiltSymbol,預設為"false",代表不要;反之為“true”.
+						#$conf["spiltSymbolAtStart"]="";
+						#參考資料:
+						#無.
+						#備註:
+						#無.
+						$arrayToString=arrays::arrayToString($conf["arrays::arrayToString"]);
+						unset($conf["arrays::arrayToString"]);
+						#如果執行異常
+						if($arrayToString["status"]==="false"){
+							#設置執行異常的識別
+							$result["status"]="false";
+							#設置執行錯誤訊息
+							$result["error"]=$arrayToString;
+							#回傳結果
+							return $result;
+							}#if end
+						#設置作者清單字串
+						$replaceTo[1]["Authors"]=$arrayToString["content"];
+						#函式說明:
+						#置換檔案內容中符合的內容.
+						#回傳結果:
+						#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+						#$reuslt["error"],執行不正常結束的錯訊息陣列.
+						#$result["function"],當前執行的函式名稱.
+						#$result["argu"],本函式使用的參數.
+						#$result["content"],更新後的檔案內容陣列.每個元素代表一行的內容.
+						#$result["found"],字串,是否有找到符合條件需要置換的內容.
+						#$result["relaceInfo"],陣列,記錄需要置換的行資訊,元素的key為需要置換的行號,第 $i 行用 $i+1 表示.
+						#$result["relaceInfo"][$i]["ori"],字串,第 $i+1 行原始的內容.
+						#$result["relaceInfo"][$i]["new"],字串,第 $i+1 行要置換成的內容.
+						#$result["content"],陣列,替換完後的每行內容.
+						#必填參數:
+						#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
+						$conf["phpLib::replaceMatchContent"]["fileArgu"]=__FILE__;
+						#$conf["file"],字串,要置換內容的檔案路徑與名稱.
+						$conf["phpLib::replaceMatchContent"]["file"]=$NodePathAndName;
+						#$conf["formats"],陣列,連續的關鍵字字串.
+						$conf["phpLib::replaceMatchContent"]["formats"]=$conf["replaceFrom"];
+						#$conf["replaceTo"],陣列,原始內容要如何置換,每個元素的索引對應到formats參數的每個元素,若其索引不存在則代表對應的行不異動.
+						$conf["phpLib::replaceMatchContent"]["replaceTo"]=$replaceTo;
+						#可省略參數:
+						#無.
+						#參考資料:
+						#無.
+						#備註:
+						#參數設定 $conf["replaceTo"][$i]=$replaceStr; 代表符合格式的連續字串中的 $i+1 行內容要置換成 $replaceStr.
+						#參數設定 $conf["replaceTo"][$i]=array("varName1"=>$replaceStr1,"varName2"=>$replaceStr2); 代表符合格式的連續字串中的 $i+1 行內容中的變數 varName1 要置換成 $replaceStr1;變數 varName2 要置換成 $replaceStr2.
+						$replaceMatchContent=phpLib::replaceMatchContent($conf["phpLib::replaceMatchContent"]);
+						unset($conf["phpLib::replaceMatchContent"]);
+						#如果執行異常
+						if($replaceMatchContent["status"]==="false"){
+							#設置執行異常的識別
+							$result["status"]="false";
+							#設置執行錯誤訊息
+							$result["error"]=$replaceMatchContent;
+							#回傳結果
+							return $result;
+							}#if end
+						/*
 						#取得檔案的內容
 						#函式說明:
 						#依據行號分隔抓取檔案的內容,結果會回傳一個陣列
 						#回傳的變數說明:
 						#$result["status"],執行是否成功，"true"代表成功；"fasle"代表失敗.
 										}#else end
 									#換找下個行內容有無符合關鍵字
 									continue 2;
 									}#else end
 								}#for end
 							}#for end
+						*/
+						#如果有需要更新檔案內容的識別
+						if($replaceMatchContent["found"]==="true"){
+							#$replaceMatchContent["relaceInfo"][$i]["new"],第 $i+1 行的新內容.
+							#初始化給予 fileAccess::updateFile 的參數
+							$replaceSpecifyLine=array();
+							#針對每個要更新的行
+							foreach($replaceMatchContent["relaceInfo"] as $lineIndex => $info){
+								#設置給予 fileAccess::updateFile 的參數
+								$replaceSpecifyLine[$lineIndex]=$info["new"];
-						}#if end
+								}#foreach end
+							#更新檔案內容
+							#函式說明:
+							#更新檔案的內容.
+							#回傳結果:
+							#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
+							#$result["error"],錯誤訊息.
+							#$result["function"],當前執行的函數名稱.
+							#$result["content"],更新的資訊.
+							#必填參數:
+							#$conf["fileArgu"],字串,變數__FILE__的內容.
+							$conf["fileAccess::updateFile"]["fileArgu"]=__FILE__;
+							#$conf["file"],字串,要更新的檔案位置與名稱.
+							$conf["fileAccess::updateFile"]["file"]=$NodePathAndName;
+							#可省略參數:
+							#$conf["overWriteWith"],字串陣列,要置換成什麼樣的內容,每個元素代表一行內容.
+							$conf["fileAccess::updateFile"]["overWriteWith"]=$replaceMatchContent["content"];
+							#$conf["replaceWith"],字串陣列,要將什麼內容置換成什麼內容.
+							#$conf["replaceWith"]=array(array("ori content","new content"),array("ori content","new content"),...);
+							#$conf["replaceLike"],字串,預設為"false",代表要完全符合關鍵字才能進行整行替換;反之為"true".
+							#$conf["replaceLike"]="false";
+							#$conf["addToTailWhenNoMatch"],字串,預設為"false"不做事;若為"true",則代表若使用 "replaceWith" 參數但沒有符合條件的內容出現,則新增到檔案的尾端.
+							#$conf["addToTailWhenNoMatch"]="false";
-					#如果有需要更新檔案內容的識別
+							#$conf["addToTailBeforeThat"],字串,當 "replaceWith" 參數有使用,且 "addToTailWhenNoMatch" 為 "true" 時,若有使用該參數,則會從尾端尋找符合條件的行內容,然後將 沒有符合 "replaceWith" 條件的內容新增在此之前.
+							#$conf["addToTailBeforeThat"]="?\>";
+							#$conf["replaceSpecifyLine"],字串陣列,將指定的行取代成指定的內容,元素的key為原始檔案的行索引,若key為$i+1,則代表第$i行;元素的數值就為該行的新內容.
+							#$conf["fileAccess::updateFile"]["replaceSpecifyLine"]=$replaceSpecifyLine;
+							#$conf["outputPath"],字串,檔案要輸出到哪個位置,預設不指定,直接取代原始檔案的內容.
+							$conf["fileAccess::updateFile"]["outputPath"]=$outputPath;
+							#參考資料:
+							#無.
+							#備註:
+							#無.
+							$updateFile=fileAccess::updateFile($conf["fileAccess::updateFile"]);
+							unset($conf["fileAccess::updateFile"]);
+							#如果出錯
-					if($shouldReplace==="true"){
+							if($updateFile["status"]==="false"){
-						#更新檔案內容
+								#設置錯誤識別
+								$result["status"]="false";
+								#設置錯誤訊息
+								$result["error"]=$updateFile;
-						#...
+								#回傳結果
+								return $result;
+								}#if end
+							#如果沒有既有的記錄
+							if(!isset($result["content"][$NodePathAndName])){
+								#記錄有更新的檔案路徑與名稱與其次數為1
+								$result["content"][$NodePathAndName]["time"]=1;
+								}#if end
+							#反之
+							else{
+								#記錄有更新的檔案路徑與名稱與的次數+1
+								$result["content"][$NodePathAndName]["time"]++;
+								}#else end
+							#記錄更新的相關資訊,用太多記憶體.
+							#$result["content"][$NodePathAndName]["replacedInfo"]=$updateFile["content"];
-						}#if end
+							}#if end
 						}#if end
 					#反之為多執行序
 					else{
 						#...
 						#待實作
 						}#else end
+					}#if end
 				}#foreach end
 			}#foreach end
 								break;
 							#如果是透過socket
 							case "socket":
-								#取得  proc 的 uuid
+								#取得 proc 的 uuid
 								$procUuid=$procValue["content"][0]["content"];
 								#函式說明:
 								#詢問透過 sock::unixDomainSockServer 執行的程序狀況
 								#回傳結果:
 										echo json_encode($result);
 										#卸除異常的程序
 										unset($procs[$procIndex]);
-										#結束執行,回傳1給shell,代表異常,
+										#結束執行,回傳1給shell,代表異常.
 										exit(1);
 										}#if end
 									#取得合併好的有異動檔案結果
 									$result["content"]=$mergeArray["content"];
 									#合併 content - end
 	#$result["function"],當前執行的函式名稱.
 	#$result["argu"],本函式使用的參數.
 	#$result["content"],更新後的檔案內容陣列.每個元素代表一行的內容.
 	#$result["found"],字串,是否有找到符合條件需要置換的內容.
 	#$result["relaceInfo"],陣列,記錄需要置換的行資訊,元素的key為需要置換的行號,第 $i 行用 $i+1 表示.
-	#$result["relaceInfo"][$i]["ori"],字串,第 $i+1 行原始的內容.
+	#$result["relaceInfo"][$i]["deletedOriHead"],字串,第 $i+1 行原始的內容,前面的空白或tab.
+	#$result["relaceInfo"][$i]["ori"],字串,第 $i+1 行剔除前面的空白或tab後的原始內容.
-	#$result["relaceInfo"][$i]["new"],字串,第 $i+1 行要置換成的內容.
+	#$result["relaceInfo"][$i]["new"],字串,第 $i+1 行剔除前面的空白或tab後的要置換成的內容.
 	#$result["content"],陣列,替換完後的每行內容.
 	#必填參數:
 	#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
 	$conf["fileArgu"]=__FILE__;
 	#$conf["file"],字串,要置換內容的檔案路徑與名稱.
 			$newLine=$info["new"];
 			#儲存被剔除的開頭字串
 			$deletedOriHead=$info["deletedOriHead"];
+			#debug
+			#var_dump(__FILE__,__LINE__,$lineIndex,$deletedOriHead,$newLine);
 			#儲存置換好的行
 			$result["content"][$lineIndex]=$deletedOriHead.$newLine;
 			}#foreach end
+		#設置有找到要取代的內容
+		$result["found"]="true";
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/phpLib.php – Rev 218 → 220