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_zerossl::updateDnsRecordFile_20260206";

#複製一份既有的檔案到要更新的檔案

#函式說明:

#複製檔案、資料夾,只要符合權限就會執行並覆蓋既有內容.

#回傳結果:

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

#$result["error"],錯誤訊息.

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

#$result["content"],複製好的檔案路徑與名稱.

#必填參數:

#$conf["file"],字串,檔案的位置與名稱.

$conf["file"]=$assetsDir."/db.qbpwcf.org-ori";

#$conf["to"],字串,檔案要複製到哪裡.

$conf["to"]=$assetsDir."/db.qbpwcf.org";

#$conf["fileArgu"],字串,__FILE__的內容,預設為當前檔案的位置.

$conf["fileArgu"]=__FILE__;

#可省略參數:

#無.

#參考資料:

#無.

#備註:

#等同於cmd::cp的應用.

$cp=fileAccess::cp($conf);

unset($conf);

#如果執行失敗

if($cp["status"]==="false"){

	#debug

	var_dump($cp);

	}#if end

#要新增的一筆RR

$paramsOfAdd=array();

$paramsOfAdd["query"]="_3FE7CA1D6DA057FB40FDD333B4C105F9.qbpwcf.org";

$paramsOfAdd["type"]="CNAME";

$paramsOfAdd["value"]="7B29341B7148276F5025CE90FC113803.7871040E5B7FBDB8E7EEF7CC8DAA4A56.2e85598b7f1b864.comodoca.com";

$paramsOfAdd["comment"]="for zerossl valid doma in qbpwcf.org";

#函式說明:

#新增DNS記錄到檔案裡面.

#回傳結果:

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

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

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

#$result["argu"],所使用的參數.

#$result["content"],字串陣列,更新後的檔案RR(DNS記錄).

#$result["content"]["domain"],字串,RR所屬domain.

#$result["content"]["defaultTTL"],字串,預設的RR更新時間.

#必填參數:

#$conf["add"],多維陣列,每個元素有為有三個元素的陣列,key有"query"跟"update"跟"type"跟"value"以及"comment",分別代表要查詢的數值、更新周期、類型、答案、註解.

$conf["zerossl::updateDnsRecordFile"]["add"][]=$paramsOfAdd;

#$conf["dnsRecordFile"],字串,該ZONE檔案位置與名稱.

$conf["zerossl::updateDnsRecordFile"]["dnsRecordFile"]=$assetsDir."/db.qbpwcf.org";

#可省略參數:

#$conf["writeNow"],字串,是否要直接寫入既有ZONE檔案,預設為"false",不寫入;"true"為直接覆寫內容.

$conf["zerossl::updateDnsRecordFile"]["writeNow"]="true";

#$conf["debug"],字串,是否要開啟debug模式,預設為"false"不開啟;反之為"true"要開啟,會在/tmp/建立debug檔案zerossl\:\:updateDnsRecordFile.

$conf["zerossl::updateDnsRecordFile"]["debug"]="true";

#參考資料:

#無.

#備註:

#目前支援的DNS記錄檔案是給bind(Berkeley Internet Name Domain)套件使用的.

#通常qbpwcf使用者沒有權限存取RR(dns記錄檔案),本套件是透過sshfs掛載來繞過該問題.

#php-pear上的Net_DNS2也可以解析RR.

$updateDnsRecordFile=zerossl::updateDnsRecordFile($conf["zerossl::updateDnsRecordFile"]);

unset($conf["zerossl::updateDnsRecordFile"]);

#debug

var_dump($updateDnsRecordFile);