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);