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

*/

#使用命名空間qbpwcf

namespace qbpwcf;

#assets dir

$assetsDir="assets_of_threads::20250203";

#要運行的php程式

$cmd=<<<'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/>.

*/

#使用命名空間qbpwcf

namespace qbpwcf;

#設置第一優先的 include path

set_include_path("

PHP;

#串接要優先匯入的路徑

$cmd=$cmd.$phpIncludeFirstPath;

#串接要運行的php程式

$cmd=$cmd.<<<'PHP'

".PATH_SEPARATOR.get_include_path());

#匯入套件

require_once("allInOne.php");

#建議的log位置

$logFile=

PHP;

#串接要使用的log路徑與檔案名稱

$cmd=$cmd."\"".$logFile."\";".PHP_EOL;

#串接要運行的php程式

$cmd=$cmd.<<<'PHP'

#函式說明:

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

#回傳結果:

#$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"]="false";

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

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

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

#$conf["socket"]=qbpwcf_usock_path;

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

$conf["log"]=$logFile;

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

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

#參考資料:

#無.

#備註:

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

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

unset($conf);

#debug

var_dump($updateCopyRightYear);

PHP;

#透過 php -r 來運行 php程式

$cmd="php -r ".escapeshellarg($cmd);

#函式說明:

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

#回傳結果:

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

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

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

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

#必填參數:

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

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

#可省略參數:

#$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("php");

#參考資料:

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

#備註:

#無.

$proc=threads::proc($conf);

unset($conf);

#debug

var_dump($proc);