WebSVN – php-qbpwcf – Diff – /trunk/usr/bin/backupDb.php

 #!/usr/bin/php
 <?php
 /*
 	QBPWCF, Quick Build PHP website Component base on Fedora Linux.
-    Copyright (C) 2015~2024 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
     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/>.
 */
 /*
 說明:
 每天特定時間備份Mariadb資料庫資料到指定的位置
 	#結束執行,回傳shell 1.
 	exit(1);
 	}#if end
 #設置 include path
 set_include_path($output[0].PATH_SEPARATOR.get_include_path());
 #匯入外部套件
 include("allInOne.php");
 #說明函式
 function help(){
 	#印出指令說明
 	echo "Usage of ".basename(__FILE__).":".PHP_EOL;
 	echo "--backTime HourHour:MinMin 代表當下為為HourHour:MinMin時要進行備份,若不設定代表立即執行.".PHP_EOL;
 	echo "--config addr 代表設定檔的位置,裡面寫有要備份的資料庫資訊.".PHP_EOL;
 	echo "--acctVarName name 設定檔中資料庫名稱的變數名稱.".PHP_EOL;
 	echo "--passVarName name 設定檔中資料庫密碼的變數名稱.".PHP_EOL;
 	echo "--dbVarName name 設定檔中資料庫名稱的變數名稱".PHP_EOL;
 	echo "\t".basename(__FILE__)." --backTime 09:01 --config  database.php --acctVarName \"db['default']['username']\" --passVarName \"db['default']['password']\" --dbVarName \"db['default']['database']\" --dbAddrVarName \"db['default']['hostname']\" --dbPortVarName \"db['default']['port']\" --backupAddr \"./\"".PHP_EOL;
 	echo "時間到只執行一次的範例:".PHP_EOL;
 	echo "\t".basename(__FILE__)." --backTime 09:01 --config  database.php --acctVarName \"db['default']['username']\" --passVarName \"db['default']['password']\" --dbVarName \"db['default']['database']\" --dbAddrVarName \"db['default']['hostname']\" --dbPortVarName \"db['default']['port']\" --backupAddr \"./\" --times 1".PHP_EOL;
 	echo "立即執行的範例:".PHP_EOL;
 	echo "\t".basename(__FILE__)." --config  database.php --acctVarName \"db['default']['username']\" --passVarName \"db['default']['password']\" --dbVarName \"db['default']['database']\" --dbAddrVarName \"db['default']['hostname']\" --dbPortVarName \"db['default']['port']\" --backupAddr \"./\"".PHP_EOL;
 	#結束執行
 	exit;
 	}#function help end
 #如果解析參數失敗
 if($parseArgu["status"]==="false"){
 	#印出結果
 	var_dump($parseArgu);
 	#結束執行
 	exit;
 	}#if end
 #檢查參數
 #函式說明:
 #檢查必填與可省略參數，可省略參數可指定預設要給與什麼數值內容。
 #若執行失敗
 if($checkArguments["status"]==="false"){
 	#印出結果
 	var_dump($checkArguments);
 	#結束執行
 	exit;
 	}#if end
 #若檢查不通過
 if($checkArguments["passed"]==="false"){
 	#印出結果
 	var_dump($checkArguments);
 	#提示用法
 	help();
 	#結束執行
 	exit;
 	}#if end
 	#設置 $times
 	$times=$parseArgu["content"]["times"][0];
 	}#if end
 #反之若沒有指定 backTime
 else if(!isset($backTime)){
 	#指定只跑一次
 	$times=1;
 	$spiltString=stringProcess::spiltString($conf);
 	unset($conf);
 	#如果取得小時跟分鐘失敗
 	if($spiltString["status"]==="false"){
 		#印出結果
 		var_dump($spiltString);
 		#結束執行
 		exit;
 		}#if end
 	#如果取得小時跟分鐘失敗
 	if($spiltString["found"]==="false"){
 		#印出結果
 		var_dump($spiltString);
 		#結束執行
 		exit;
 		}#if end
 #無窮迴圈
 while($continue){
 	#休息一秒
 	sleep(1);
 	#取得當前小時
 	$currentHour=gmdate("H");
 	#取得當前分鐘
 	$currentMin=gmdate("i");
 	#如果有指定執行的時間
 	if(isset($runHour) && isset($runMin)){
 		#如果不是要執行的時間
 		if($currentHour!==$runHour || $currentMin!==$runMin){
 			#下一輪
 			continue;
 			}#if end
 		}#if end
 	#如果距離上次執行沒有過了1分鐘
 	if( time()-$lastRunTime<60 ){
 		#下一輪
 		continue;
 		}#if end
 	#取得設定檔內容
 	#函式說明:
 	#解析PHP檔案裡面的變數.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$result["error"],錯誤訊息.
 	#$result["function"],當前執行的函數名稱.
 	#$result["argu"],所使用的參數.
 	#$result["content"],找到的變數內容陣列.
 	#$result["content"]["value"],依找到變數順序的數值.
 	#$result["content"]["struc"],依找到變數順序的階層結構.
 	#$result["content"]["direct"],變數名稱對應的數值內容.
 	#必填參數:
 	#https://www.php.net/manual/en/function.parse-str.php
 	#備註:
 	#無.
 	$parseVaraiableInPHPfile=fileAccess::parseVaraiableInPHPfile($conf);
 	unset($conf);
 	#如果失敗
 	if($parseVaraiableInPHPfile["status"]==="false"){
 		#印出結果
 		var_dump($parseVaraiableInPHPfile);
 		#結束執行
 		exit;
 		}#if end
 	#取得資料庫帳號
 	$dbAcct=$parseVaraiableInPHPfile["content"][$acctVarName];
 	#取得資料庫密碼
 	$dbPass=$parseVaraiableInPHPfile["content"][$passVarName];
 	#取得資料庫名稱
 	$dbName=$parseVaraiableInPHPfile["content"][$dbVarName];
 	#取得資料位置
 	$dbAddr=$parseVaraiableInPHPfile["content"][$dbAddrVarName];
 	#取得資料庫port
 	$dbPort=$parseVaraiableInPHPfile["content"][$dbPortVarName];
 	#判斷目標目錄是否可以存取
 	#函式說明:
 	#開啟特定目錄,取得底下的檔案路徑清單.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$result["error"],錯誤訊息.
 	#$result["function"],當前執行的函數名稱.
 	#$result["argu"],所使用的參數.
 	#$result["content"],讀取到的內容陣列.
 	#必填參數:
 	#$conf["path"],字串,要取得檔案資訊的所屬路徑.
 	$conf["path"]=$backupAddr;
 	#可省略參數:
 	#無.
 	#備註:
 	#無.
 	$listInfo=fileAccess::listInfo($conf);
 	unset($conf);
 	#如果失敗
 	if($listInfo["status"]==="false"){
 		#印出結果
 		var_dump($listInfo);
 		#結束執行
 		exit;
 		}#if end
 	#產生uuid
 	#涵式說明:
 	#呼叫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
 	#取得uuid
 	$uuid=$callShell["output"][0];
 	#函式說明:
 	#將 ~ 轉換為家目錄路徑
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$result["error"],錯誤訊息.
 	#無.
 	#參考資料:
 	#https://www.businessweekly.com.tw/careers/Blog/14307
 	$tildeToPath=fileAccess::tildeToPath($conf["fileAccess::tildeToPath"]);
 	unset($conf["fileAccess::tildeToPath"]);
 	#如果執行失敗
 	if($tildeToPath["status"]==="false"){
 		#設置執行不正常
 		$result	["status"]="false";
 		#設置執行錯誤
 		$result["error"]=$tildeToPath;
 		#回傳結果
 		return $result;
 		}#if end
 	#取得家目錄路徑
 	$homePath=$tildeToPath["content"];
 	#函式說明:
 	#備份資料庫
 	#回傳結果:：
 	#$result["status"],"true"代表執行正常,"false"代表執行有誤.
 	#$result["error"],錯誤訊息陣列.
 	#$conf["storePlace"],字串,要將輸出檔案儲存到哪邊，預設爲當前目錄.
 	#$conf["storePlace"]=$backupAddr;
 	$conf["storePlace"]=$homePath."/";
 	#$conf["exportFileName"],字串,要輸出的檔案名稱,預設爲其export
 	$sqlFileName=$conf["exportFileName"]=gmdate("Y-m-d_H:i:s")."_".$uuid;
 	#如果資料庫不是位於 localhost
 	if($conf["dbAddress"]!=="localhost"){
 		#$conf["dbPort"],字串,爲連線到mysql-Server時要使用的port,預設為3306.
 		$conf["dbPort"]=$dbPort;
 		}#if end
 	#備註:
 	#無.
 	$backupDatabase=db::backupDatabase($conf);
 	unset($conf);
 	#如果執行失敗
 	if($backupDatabase["status"]==="false"){
 		#印出結果
 		var_dump($backupDatabase);
 		#結束執行
 		exit;
 		}#if end
 	#函式說明:
 	#將資料夾打包成.zst檔案
 	#回傳的結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$result["error"],錯誤訊息.
 	$conf["path"]=$homePath;
 	#$conf["delAfterSuc"],字串,是否壓縮後將原始檔案移除,預設為"false"代表不要;反之為"true"代表要.
 	$conf["delAfterSuc"]="true";
 	$makeZstFile=cmd::makeZstFile($conf);
 	unset($conf);
 	#如果執行失敗
 	if($makeZstFile["status"]==="false"){
 		#印出結果
 		var_dump($makeZstFile);
 		#結束執行
 		exit;
 		}#if end
 	#移動檔案到指定的位置
 	#涵式說明:
 	#呼叫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"){
 		#印出結果
 		var_dump($callShell);
 		#結束執行
 		exit;
 		}#if end
 	#更新最後執行的時間點
 	$lastRunTime=time();
 	#增加已經執行的次數
 	$runTimes++;
 	#如果有指定次數
 	if(isset($times)){
 		#如果已經達到次數的限制
 		if($runTimes>=$times){
 			#設定停止執行
 			$continue=false;
 			}#if end
 		}#if end
 	#函式說明:
 	#取得目錄底下的詳細資訊.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$result["error"],錯誤訊息.
 	$ls=fileAccess::ls($conf);
 	unset($conf);
 	#如果執行失敗
 	if($ls["status"]==="false"){
 		#印出結果
 		var_dump($ls);
 		#結束執行
 		exit;
 		}#if end
 	#初始化儲存存在的備份檔案清單
 	$backupFiles=array();
 	#針對每個節點
 	foreach($ls["content"] as $fileInfo){
 		#如果是檔案
 		if($fileInfo["nType"]==="-"){
 			#記錄起來
 			$backupFiles[]=$backupAddr."/".$fileInfo["name"];
 			}#if end
 		}#foreach end
 	#如果節點數量大於 $backupFilesToKeep
 	if(count($backupFiles)>$backupFilesToKeep){
 		#有多少超過數量的節點就執行幾次
 		for($i=$backupFilesToKeep;$i<count($backupFiles);$i++){
 			#設置要移除的檔案
 			$file2remove=$backupFiles[$i];
 			#移除超過限制的舊資料
 			#函式說明:
 			#移除檔案
 			#回傳結果:
 			#$result["status"],"true"代表移除成功,"false"代表移除失敗.
 			#無.
 			#備註:
 			#無.
 			$delFile=fileAccess::delFile($conf);
 			unset($conf);
 			#如果執行失敗
 			if($delFile["status"]==="false"){
 				#印出結果
 				var_dump($ls);
 				#結束執行
 				exit;
 				}#if end
 			}#for end
 		}#if end
 	}#while end
-?>
 ?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/bin/backupDb.php – Rev 3 → 226