Subversion Repositories php-qbpwcf

<?php

/*

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

    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

    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/>.

*/

#使用命名空間qbpwcf

namespace qbpwcf;

#assets dir

$assetsDir="assets_of_phpLib::updateCopyRightYear_20250213";

#函式說明:

#使用 linux 的 uuid 指令來產生 uuid 字串

#回傳結果:

#$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

#函式說明:

#更新程式檔案開頭版權宣告的年份,以及作者清單,取得更新過後的檔案路徑.

#回傳結果:

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

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

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

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

#$result["content"],有更新的檔案清單,其元素有被取代的檔案路徑與名稱跟replacedInfo,其中replacedInfo為陣列,其key為要變動的行號(從0開始算),其數值有"from"代表要被取代的原始內容,"to"代表要置換成的新內容.

#$result["scannedFile"],陣列,有檢查過的檔案清單其完整路徑與檔案名稱.

#必填參數:

#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑

$conf["fileArgu"]=__FILE__;

#可省略參數:

#$conf["replaceFrom"],陣列,目標關鍵字,每個元素代表一行的內容,預設內容可參照本檔案開頭的版權宣告文字.

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

#$conf["yearFrom],字串,起始年份,預設為西元"2014"年.

#$conf["yearFrom"]="2014";

#$conf["yearTo],字串,結束年份,預設為西元"gmdate('Y')"年.

#$conf["yearTo"]=gmdate('Y');

#$conf["Authors"],陣列,該套件的參與者,預設為array("MIN-ZHI, CHEN");

#$conf["Authors"]=array("MIN-ZHI, CHEN");

#$conf["searchPath"],陣列,要搜尋哪些地方的檔案要更新版權宣告年份,預設為使用中的本套件位置.

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

#$conf["skipHiddenFolder"],字串,要略過隱藏的資料夾,預設為"true";反之為"false";

#$conf["skipHiddenFolder"]="true";

#$conf["includeHiddenFolder"],陣列,符合名稱的隱藏資料夾會存取,預設不指定;

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

#$conf["excludeDirName"],陣列,哪些目錄名稱要忽略,預設有"free-lib"、"no-free-lib"、"composer".

#$conf["excludeDirName"]=array("free-lib","no-free-lib","composer");

#$conf["excludeMineType"],陣列,哪些檔案類型要忽略,預設有"image/*"、"video/*"、"audio/*"、"media/*"、"application/*".

#$conf["excludeMineType"]=array("image/*","video/*","audio/*","media/*","application/*");

#$conf["excludeSecondName"],陣列,哪些附檔名的檔案要忽略,預設有"log"、"csv"、"sql"、"js"、"css"、"html".

#$conf["excludeSecondName"]=array("log"、,"csv","sql","js","css","html");

#$conf["multiThread"],字串,是否要啟用多執行序,預設為"false",反之為"true".

$conf["multiThread"]="true";

#$conf["threadType"],字串,當"multiThread"參數為"true"時,要使用的threas類型,預設為"socket",其他可能有"proc".

#$conf["threadType"]="socket";

#$conf["socket"],字串,unix domain socket 的位置與名稱,預設為 qbpwcf_usock_path;

$conf["socket"]="assets of sock::unixDomainSockServer_20250228/unixDomainSockServer.sock";

#$conf["log"],字串,log的檔案位置與名稱,預設不使用.

$conf["log"]="/tmp/phpLib::updateCopyRightYear:20250213-".$uuid["content"].".log";

#$conf["outputPath"],字串,更新後的檔案內容要存放到哪個路徑低下,預設為 /tmp 底下.

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

#參考資料:

#無.

#備註:

#目前尚未支援參數 multiThread 為 true 的設置.

$updateCopyRightYear=phpLib::updateCopyRightYear($conf);

unset($conf);

#debug

var_dump($updateCopyRightYear);