WebSVN – php-qbpwcf – Diff – /trunk/usr/lib64/qbpwcf/zerossl.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
 	#__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
 	#備註:
 	#無.
 	*/
 	public function __call($method,$arguments){
 		#取得當前執行的函式
 		$result["function"]=__FUNCTION__;
 		#設置執行不正常
 		$result["status"]="false";
 		#設置執行錯誤
 		$result["error"][]=__NAMESPACE__ ."/".$method."() 不存在!";
 		#設置所丟入的參數
 		$result["error"][]=$arguments;
 		#回傳結果
 		return $result;
 		}#function __call end
 	/*
 	#函式說明:
 	#當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
 	#備註:
 	#無.
 	*/
 	public static function __callStatic($method,$arguments){
 		#取得當前執行的函式
 		$result["function"]=__FUNCTION__;
 		#設置執行不正常
 		$result["status"]="false";
 		#設置執行錯誤
 		$result["error"][]="欲呼叫的". __NAMESPACE__ ."/".$method."() 不存在!";
 		#設置所丟入的參數
 		$result["error"][]=$arguments;
 		#回傳結果
 		return $result;
 		}#function __callStatic end
 	/*
 	#函式說明:
 	#取得api的資訊
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function getApiInfo(){
 		#初始化要回傳的陣列
 		$result=array();
 		#api domain
 		$result["apiDomain"]="api.zerossl.com";
 		#create certificate path
 		$result["csrPath"]="/certificates";
 		#create certificate url
 		$result["csrUrl"]=$result["apiDomain"].$result["csrPath"];
 		#api access key
 		$result["apiKey"]=zeroSSLapiKey;
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function getApiInfo end
 	/*
 	#函式說明:
 	#產生ssl private key.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#無.
 	#備註:
 	#key generated by openssl with RSA.
 	*/
 	public static function createPrivateKey(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],執行不正常結束的錯訊息陣列.
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		#備註:
 		#無.
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果 $checkArguments["status"]等於 "false"
 		if($checkArguments["status"]==="false"){
 			#設置執行錯誤的識別
 			$result["status"]="false";
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#呼叫shell執行系統命令,並取得回傳的內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#備註:
 		#不是所有指令都能用apache的身份執行,目前已知java,javac指令無法執行,使用root身份可能會被selinux阻擋.
 		#若使用的 command、argu 參數，含有 ~ 則會被視為字串，若有需要其於 shell 中代表的家目錄位置，可用 fileAccess::tildeToPath 來進行轉換.
 		$callShell=external::callShell($conf["external::callShell"]);
 		unset($conf["external::callShell"]);
 		#如果異常
 		if($callShell["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$callShell;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#將一維陣列轉換為用特定符號間隔的字串,ex:array("1","2","3") to "a;b;c;".
 		#回傳的結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["function"],當前執行的function名稱
 		#無.
 		#備註:
 		#無.
 		$arrayToString=arrays::arrayToString($conf["arrays::arrayToString"]);
 		unset($conf["arrays::arrayToString"]);
 		#如果異常
 		if($arrayToString["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$arrayToString;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得 private key 字串
 		$result["content"]=$arrayToString["content"];
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function createPrivateKey end
 	/*
 	#函式說明:
 	#產生certificate sign request.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function csr(&$conf){
 		#break point
 		#var_dump(self::getApiInfo());exit;
 		#初始化要回傳的結果
 		$result=array();
 		#設置當其函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#檢查參數
 		#函式說明：
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#必填寫的參數：
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("fileArgu","certificate_domains","certificate_csr");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或集合.
 		#$conf["skipableVariableCanNotBeEmpty"]=array();
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("apiDomain","path","key");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(self::getApiInfo()["apiDomain"],self::getApiInfo()["csrPath"],self::getApiInfo()["apiKey"]);
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查失敗
 		if($checkArguments["status"]=="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkArguments["passed"]=="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#要傳送的 key -> value
 		$postArray=array();
 		#設置要簽署的domain
 		$postArray["certificate_domains"]=$conf["certificate_domains"];
 		#設置csr
 		$postArray["certificate_csr"]=$conf["certificate_csr"];
 		#預設為 90 天的憑證
 		$postArray["certificate_validity_days"]=90;
 		#強制讓 要簽署的domain 為 $postArray["certificate_domains"]
 		$postArray["strict_domains"]=1;
 		#設置要傳送的 json
 		$postJson=json_encode($postArray);
 		#函式說明:
 		#運行curl cmd
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#無.
 		#備註:
 		#無.
 		$curlCmd=catchWebContent::curlCmd($conf["catchWebContent::curlCmd"]);
 		unset($conf["catchWebContent::curlCmd"]);
 		#如果異常
 		if($curlCmd["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$curlCmd;
 			#回傳結果
 			return $result;
 			}#if end
 		#設置curl的詳細資訊
 		$result["curl_verbose_info"]=$curlCmd;
 		/* 範例 json content
 		"{"id":"f1448a54da0925356faec06154989452","type":"1","common_name":"test.qbpwcf.org","additional_domains":"","created":"2024-11-27 12:05:52","expires":"2025-02-25 00:00:00","status":"draft","validation_type":null,"validation_emails":null,"replacement_for":"","validation":{"email_validation":{"test.qbpwcf.org":["admin@test.qbpwcf.org","administrator@test.qbpwcf.org","hostmaster@test.qbpwcf.org","postmaster@test.qbpwcf.org","webmaster@test.qbpwcf.org","admin@qbpwcf.org","administrator@qbpwcf.org","hostmaster@qbpwcf.org","postmaster@qbpwcf.org","webmaster@qbpwcf.org"]},"other_methods":{"test.qbpwcf.org":{"file_validation_url_http":"http:\/\/test.qbpwcf.org\/.well-known\/pki-validation\/5CED79AF9CCCB7C8633875D1A7C919FA.txt","file_validation_url_https":"https:\/\/test.qbpwcf.org\/.well-known\/pki-validation\/5CED79AF9CCCB7C8633875D1A7C919FA.txt","file_validation_content":["2C2CAB7C8B941192CB6BD9345DA3806BBC9F13A3DF3109C1E1A8B9B1ECC5B5FC","comodoca.com","42f21840bf8a7a6"],"cname_validation_p1":"_5CED79AF9CCCB7C8633875D1A7C919FA.test.qbpwcf.org","cname_validation_p2":"2C2CAB7C8B941192CB6BD9345DA3806B.BC9F13A3DF3109C1E1A8B9B1ECC5B5FC.42f21840bf8a7a6.comodoca.com"}}}}"
 		*/
 		#設置結果
 		$result["content"]=$curlCmd["content"];
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function csr end
-	}#class zerossl end
 	}#class zerossl end

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/zerossl.php – Rev 3 → 226