WebSVN – php-qbpwcf – Diff – /trunk/usr/lib64/qbpwcf/mail.php

 <?php
 /*
 	QBPWCF, Quick Build PHP website Component base on Fedora Linux.
-    Copyright (C) 2014~2025 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
 	/*
 	#函式說明:
 	#登入 imap 信箱
 	#回傳結果:
 	#$result["status"],寄信的情況,若爲"true"，則十之八九沒有問題.
 		#儲存當前執行的函數
 		$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["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("username","password");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("mailServerPositionAndPort");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("imap.gmail.com:993");
 		#$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
 		#To connect to an SSL IMAP or POP3 server, add /ssl after the protocol
 		#specification:
 		$mbox = \imap_open("{".$conf["mailServerPositionAndPort"]."/imap/ssl}INBOX",$conf["username"],$conf["password"]) or die("Cannot connect to mail server:".imap_last_error());
 		#如果 imap_open() 執行失敗
 		if($mbox["status"]==false){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=\imap_last_error();
 			}#if end
 		#儲存執行 imap_open() 後的 resource
 		$result["content"]=$mbox;
 		#儲存當前執行的函數
 		$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["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("mailConnection");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("resource");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("mailServerPositionAndPort");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("imap.gmail.com:993");
 		#$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
 		#如果中斷與mailServer的連線失敗
 		if(\imap_close($conf["mailConnection"])==false){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]="中斷與 imap Server 的連線失敗";
 			#回傳結果
 			return $result;
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function imapLogout end
 	#http://www.php.net/manual/en/function.imap-last-error.php
 	#http://wiki.dreamhost.com/PHP_IMAP#Verify_PHP_INI_Settings
 	#備註:
 	#需要php-imap套件
 	#無法寄送成功?
 	*/
 	public static function mailTo(&$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["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("username","password","receiver","subject","body");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string","string","string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("mailServerPositionAndPort","headerInfo","cc","bcc");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,null,null,"\$conf[\"username\"]");
 		#$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
 		#函式說明:
 		#登入信箱
 		#回傳結果:
 		$conf["mail"]["login"]["password"]=$conf["password"];#使用者密碼
 		#可省略參數:
 		#若 $conf["mail"]["login"]["mailServerPositionAndPort"] 沒有設置，則預設爲gmail信箱
 		if(!isset($conf["mail"]["login"]["mailServerPositionAndPort"])){
 			$conf["mail"]["login"]["mailServerPositionAndPort"]="imap.gmail.com:993";
 			}#if end
 		#反之有設定，則採用指定值
 		$mailConnection=mail::imapLogin($conf["mail"]["login"]);
 		unset($conf["mail"]["login"]);
 		#如果登入imap伺服器失敗
 		if($mailConnection["status"]=="false"){
 			#設置錯誤訊息
 			$result["error"]=$mailConnection;
 			#設置執行失敗
 			$result["status"]="false";
 			#回傳結果
 			return $result;
 			}#if end
 		#如果 $conf["headerInfo"] 沒有指定
 		if(!isset($conf["headerInfo"])){
 			}#if end
 		#用imap寄出信件
 		$result["mailToStatus"]=\imap_mail($conf["receiver"],imap_utf8($conf["subject"]),imap_utf8($conf["body"]),imap_utf8($conf["headerInfo"]),imap_utf8($conf["cc"]),imap_utf8($conf["bcc"]),imap_utf8($conf["username"]));
 		#取得使用imap服務與到的警示訊息
 		$result["imapAlerts"]=\imap_alerts();
 		#取得使用imap服務與到的錯誤訊息
 		$result["imapErrors"]=\imap_errors();
 		$imapLogout=mail::imapLogout($conf["mail"]["logout"]);
 		unset($conf["mail"]["logout"]);
 		#如果登出imap伺服器失敗
 		if($imapLogout["status"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$imapLogout;
 			#回傳結果
 			return $result;
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 		#儲存當前執行的函數
 		$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["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("username","password","receiverMail","subject","plainBody","htmlBody","fileArgu");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","array","string","string","string","string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("attachment","attachmentName","attachmentMimeType","mailServer","mailerMailDisplay","mailerNameDisplay","receiverMailDisplay","receiverNameDisplay","levelForCheckSSL");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","array","array","string","string","string","string","string","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,null,null,"smtps://smtp.gmail.com:465","\$conf[\"username\"]","\$conf[\"username\"]","\$conf[\"receiverMail\"]","\$conf[\"receiverMail\"]","force");
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("receiverMail","receiverMailDisplay","receiverNameDisplay");
 		#參考資料來源:
 		#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
 		#檢查 curlSmtp 資料夾是否存在
 		#函式說明:檢查多個檔案是否存在
 		#回傳的結果:
 		#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#參考資料來源：
 		#http://php.net/manual/en/function.file-exists.php
 		#http://php.net/manual/en/control-structures.foreach.php
 		$checkMutiFileExist=fileAccess::checkMultiFileExist($conf["fileAccess::checkMultiFileExist"]);
 		unset($conf["fileAccess::checkMultiFileExist"]);
 		#如果檢查檔案失敗
 		if($checkMutiFileExist["status"]=="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkMutiFileExist;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果該資料夾不存在
 		if($checkMutiFileExist["varExist"][0]=="false"){
 			$conf["fileAccess::createFolderAfterCheck"]["fileArgu"]=$conf["fileArgu"];
 			#可省略參數:
 			#$conf["fileAccess::createFolderAfterCheck"]["dirPermission"]="";#新建資料夾的權限設定，預設爲0770,亦即擁有者,同群組者可以讀,寫,存取,其他人僅能存取.
 			$createFolderAfterCheck=fileAccess::createFolderAfterCheck($conf["fileAccess::createFolderAfterCheck"]);
 			unset($conf["fileAccess::createFolderAfterCheck"]);
 			#如果 建立資料夾失敗
 			if($createFolderAfterCheck["status"]=="false"){
 				#設置錯誤識別
 				$result["status"]="false";
 				return $result;
 				}#if end
 			}#if end
 		#取得 $systemTime
 		$systemTime=time::getMicrotime();
 		#要傳送的信件資訊
 		$mailFileHeader="From: ".$conf["mailerNameDisplay"]." <".$conf["mailerMailDisplay"].">\r\n";
 		#第一個人主要收件人
 		$mailFileHeader=$mailFileHeader."To: ".$conf["receiverNameDisplay"][0]." "."<".$conf["receiverMailDisplay"][0].">\r\n";
 		#如果有其餘收件人
 		if(count($conf["receiverNameDisplay"])>1){
 			#副本寄送處的資訊開始
 			$mailFileHeader=$mailFileHeader."Cc: ";
 			}#if end
 		#針對其餘收件人的地址
 		for($i=1;$i<count($conf["receiverNameDisplay"]);$i++){
 			#如果不是最後一筆
 			if($i!=count($conf["receiverNameDisplay"])-1){
 				$mailFileHeader=$mailFileHeader.$conf["receiverNameDisplay"][$i]." <".$conf["receiverMailDisplay"][$i].">,";
 				}#if end
 			#反之是最後一筆
 			else{
 				$mailFileHeader=$mailFileHeader.$conf["receiverNameDisplay"][$i]." <".$conf["receiverMailDisplay"][$i].">\r\n";
 				}#else end
 			}#for end
 		$mailFileHeader=$mailFileHeader."Subject: ".$conf["subject"]."\r\n";
 		#初始化信件本文
 		$mailFileContent="";
 		#初始化 boundary
 		$boundary="001a11c30ce8aec3480533bfa9a9";
 		#初始化 boundary start
 		$boundaryS="--".$boundary;
 		#初始化 boundary end
 		$boundaryE=$boundaryS."--";
 		#設置信件本文(純文字與html兩種)
 		$mailFileContent=$mailFileContent."Content-Type: multipart/alternative; boundary=\"".$boundary."\"\r\n";
 		$mailFileContent=$mailFileContent."\r\n";
 		$mailFileContent=$mailFileContent.$boundaryS."\r\n";
 		$mailFileContent=$mailFileContent."Content-Type: text/plain; charset=UTF-8\r\n";
 		$mailFileContent=$mailFileContent."\r\n";
 		$mailFileContent=$mailFileContent."\r\n";
 		$mailFileContent=$mailFileContent.$boundaryS."\r\n";
 		$mailFileContent=$mailFileContent."Content-Type: text/html; charset=UTF-8\r\n";
 		$mailFileContent=$mailFileContent."\r\n";
 		$mailFileContent=$mailFileContent.$conf["htmlBody"]."\r\n";
 		$mailFileContent=$mailFileContent.$boundaryE."\r\n";
 		#依據規定，每列不得大於70的字元
 		$mailFileContent==wordwrap($mailFileContent,70,"\r\n",true);
 		#如果有設定要上傳附件
 		if(isset($conf["attachment"])){
 			#依據每個附件
 			for($i=0;$i<count($conf["attachment"]);$i++){
 				#初始化寄送附件的語法
 				$attachment="";
 				#確認目標檔案是否存在
 				#函式說明:檢查多個檔案是否存在
 				#回傳的結果:
 				#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
 				#$result["error"],錯誤訊息陣列.
 				#參考資料來源：
 				#http://php.net/manual/en/function.file-exists.php
 				#http://php.net/manual/en/control-structures.foreach.php
 				$checkMutiFileExist=fileAccess::checkMultiFileExist($conf["fileAccess::checkMultiFileExist"]);
 				unset($conf["fileAccess::checkMultiFileExist"]);
 				#如果檢查失敗
 				if($checkMutiFileExist["status"]=="false"){
 					#設置錯誤識別
 					$result["status"]="false";
 					#設置錯誤資訊
 					$result["error"]=$checkMutiFileExist;
 					#回傳結果
 					return $result;
 					}#if end
 				#如果檔案不存在
 				if($checkMutiFileExist["varExist"][0]=="false"){
 					#設置錯誤識別
 					$result["status"]="false";
 					#設置錯誤資訊
 					$result["error"]=$checkMutiFileExist;
 					#回傳結果
 					return $result;
 					}#if end
 				#如果是第一個附件
 				if($i==0){
 					#在前面加上 multipart/mixed 的 boundary
 					$mailFileContent="Content-Type: multipart/mixed; boundary=".$boundary."\r\n\r\n".$mailFileContent;
 					}#if end
 				#如果 $conf["attachmentName"] 不存在
 				if(!isset($conf["attachmentName"])){
 					#涵是說明:
 					#取得檔案路徑字串的路徑與檔案的名稱與檔案副檔名
 					#回傳的結果:
 					#$result["status"],執行是否正常,"true"正常,"false"代表不正常.
 					#$result["error"],錯誤訊息.
 					$conf["fileAccess::getFileAddressAndNameAndFileExtention"]["fileAddressAndName"]=$conf["attachment"][$i];
 					#可省略的參數:
 					#無.
 					$getFileAddressAndNameAndFileExtention=fileAccess::getFileAddressAndNameAndFileExtention($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 					unset($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 					#如果解析檔案資訊失敗
 					if($getFileAddressAndNameAndFileExtention["status"]=="false"){
 						#設置錯誤識別
 						$result["status"]="false";
 						#設置錯誤資訊
 						$result["error"]=$getFileAddressAndNameAndFileExtention;
 						#回傳結果
 						return $result;
 						}#if end
 					#設定附件名稱
 					$conf["attachmentName"][$i]=$getFileAddressAndNameAndFileExtention["fullFileName"];
 					}#if end
 				#反之如果 $conf["attachmentName"][$i] 不存在
 				else if(!isset($conf["attachmentName"][$i])){
 					#涵是說明:
 					#取得檔案路徑字串的路徑與檔案的名稱與檔案副檔名
 					#回傳的結果:
 					#$result["status"],執行是否正常,"true"正常,"false"代表不正常.
 					#$result["error"],錯誤訊息.
 					$conf["fileAccess::getFileAddressAndNameAndFileExtention"]["fileAddressAndName"]=$conf["attachment"][$i];
 					#可省略的參數:
 					#無.
 					$getFileAddressAndNameAndFileExtention=fileAccess::getFileAddressAndNameAndFileExtention($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 					unset($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 					#如果解析檔案資訊失敗
 					if($getFileAddressAndNameAndFileExtention["status"]=="false"){
 						#設置錯誤識別
 						$result["status"]="false";
 						#設置錯誤資訊
 						$result["error"]=$getFileAddressAndNameAndFileExtention;
 						#回傳結果
 						return $result;
 						}#if end
 					#設定附件名稱
 					$conf["attachmentName"][$i]=$getFileAddressAndNameAndFileExtention["fullFileName"];
 					}#if end
 				#如果 $conf["attachmentMimeType"] 不存在
 				if(!isset($conf["attachmentMimeType"])){
 					#設定檔案類型
 					$conf["attachmentMimeType"][$i]="application/*";
 					}#if end
 				#反之如果 $conf["attachmentMimeType"][$i] 不存在
 				if(!isset($conf["attachmentMimeType"][$i])){
 					$conf["attachmentMimeType"][$i]="application/*";
 					}#if end
 				#加上寄送附件的語法
 				$attachment=$attachment.$boundaryS."\r\n";
 				$attachment=$attachment."Content-Type: ".$conf["attachmentMimeType"][$i]."; name=".$conf["attachmentName"][$i]."\r\n";
 				$attachment=$attachment."Content-Disposition: attachment; filename=".$conf["attachmentName"][$i]."\r\n";
 				$attachment=$attachment."Content-Transfer-Encoding: base64\r\n";
 				$attachment=$attachment."X-Attachment-Id: f_io1ikfii".$i."\r\n";
 				#將檔案用base64加密
 				$base64fileStr=base64_encode(file_get_contents($conf["attachment"][$i]));
 				#依據規定，每列不得大於70的字元
 				$wordwrapedFileStr=wordwrap($base64fileStr,70,"\r\n",true);
 				#斷行後附加檔案字串
 				$attachment=$attachment."\r\n".$wordwrapedFileStr."\r\n";
 				#如果是最後一個附件
 				if($i==count($conf["attachment"])-1){
 					#混合資料結尾
 					$attachment=$attachment.$boundary."\r\n";
 					}#if end
 				#增加到信件內文的結尾
 				$mailFileContent=$mailFileContent.$attachment;
 				}#for end
 			}#if end
 		#建立要寄送的郵件檔案
 		#函式說明:
 		#建立暫存目錄與回傳暫存檔案名稱路徑
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息.
 		#$result["function"],當前執行的函數名稱.
 		#$result["content"],暫存檔案的路徑與名稱.
 		#備註:
 		#無.
 		$conf["conffileAccess::createTempFile"]=array();
 		$createTempFile=fileAccess::createTempFile($conf["conffileAccess::createTempFile"]);
 		unset($conf["conffileAccess::createTempFile"]);
 		#如果檔案建立失敗
 		if($createTempFile["status"]=="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得要寄送的郵件檔案
 		$mailFile=$createTempFile["content"];
 		#將字串寫入到檔案
 		#$result["status"],"true"表示檔案寫入成功,"false"表示檔案寫入失敗.
 		#$result["error"],錯誤訊息陣列.
 		#必填參數:
 		$conf["fileAccess::writeTextIntoFile"]["fileName"]=$mailFile;#爲要編輯的檔案名稱
 			}#if end
 		#要執行的系統命令
 		$paramArray=array();
 		#設置要用 ssl
 		$paramArray[]="--ssl-reqd";
 		#如果為 "levelForCheckSSL" 為 "none"
 		if($conf["levelForCheckSSL"]==="none"){
 			#設置不用確認ssl符合規範
 			$paramArray[]="-k";
 			}#if end
 		#設置要設定url
 		$paramArray[]="--url";
 		#設置smtp server
 		$paramArray[]=$conf["mailServer"];
 		#設置指定使用者名稱
 		$paramArray[]="-u";
 		#設置使用名稱與密碼
 		$paramArray[]=$conf["username"].":".$conf["password"];
 		#設置要指定寄信來源顯示的名稱
 		$paramArray[]="--mail-from";
 		#設置寄信來源顯示的名稱
 		$paramArray[]=$conf["mailerMailDisplay"];
 		#有幾個收件人就執行幾次
 		foreach($conf["receiverMail"] as $mailTo){
 			#指定收件人的參數
 			$paramArray[]="--mail-rcpt";
 			#串接收件人
 			$paramArray[]=$mailTo;
 			}#for end
 		#指定mail檔案
 		$paramArray[]="--upload-file";
 		$paramArray[]=$mailFile;
 		#看過程
 		$paramArray[]="-v";
 		#用curl寄送信件
 		#函式說明:
 		#呼叫shell執行系統命令,並取得回傳的內容.
 		#回傳的結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$conf["useScript"],字串,是否要啟用Linux的script指令來記錄輸出,"true"代表要;"false"代表不要,預設為"false".
 		#$conf["useScript"]="";
 		#$conf["logFilePath"],字串,當 $conf["useScript"] 為 "true" 時,輸出的內容要暫存到哪裡,預設為 ".qbpwcf_tmp/external/callShell/".
 		#$conf["logFilePath"]=".qbpwcf_tmp/external/callShell/";
 		#$conf["fileArgu"],字串,變數__FILE__的內容,預設為當前檔案的路徑與名稱.
 		#$conf["fileArgu"]="";
 		#$conf["inBackGround"],字串,是否要在背景執行,且不會等待程式執行結束再執行下一個指令,"true"代表是,"false"代表不要,預設為"false".
 		#$conf["external::callShell"]["inBackGround"]="true";
 		#參考資料：
 		#http://php.net/manual/en/function.exec.php
 		$external["callShell"]=external::callShell($conf["external::callShell"]);
 		unset($conf["external::callShell"]);
 		#如果 $external["callShell"] 等於 "false"
 		if($external["callShell"]["status"]==="false"){
 			#如果 "levelForCheckSSL" 為 "loose"
 			if($conf["levelForCheckSSL"]==="loose"){
 				#加上 "-k" 參數,這次不用符合ssl規範
 				$paramArray[]="-k";
 				#用curl寄送信件
 				#函式說明:
 				#呼叫shell執行系統命令,並取得回傳的內容.
 				#回傳的結果:
 				#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 				#$conf["useScript"],字串,是否要啟用Linux的script指令來記錄輸出,"true"代表要;"false"代表不要,預設為"false".
 				#$conf["useScript"]="";
 				#$conf["logFilePath"],字串,當 $conf["useScript"] 為 "true" 時,輸出的內容要暫存到哪裡,預設為 ".qbpwcf_tmp/external/callShell/".
 				#$conf["logFilePath"]=".qbpwcf_tmp/external/callShell/";
 				#$conf["fileArgu"],字串,變數__FILE__的內容,預設為當前檔案的路徑與名稱.
 				#$conf["fileArgu"]="";
 				#$conf["inBackGround"],字串,是否要在背景執行,且不會等待程式執行結束再執行下一個指令,"true"代表是,"false"代表不要,預設為"false".
 				#$conf["external::callShell"]["inBackGround"]="true";
 				#參考資料：
 				#http://php.net/manual/en/function.exec.php
 				$external["callShell"]=external::callShell($conf["external::callShell"]);
 				unset($conf["external::callShell"]);
 				#如果 $external["callShell"] 等於 "false"
 				if($external["callShell"]["status"]==="false"){
 					#設置錯誤識別
 					$result["status"]="false";
 					#設置錯誤訊息
 					$result["error"]=$external["callShell"];
 					#回傳結果
 					return $result;
 					}#if end
 				}#if end
 			#反之
 			else{
 				#設置錯誤識別
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$external["callShell"];
 				#回傳結果
 				return $result;
 				}#else end`
 			}#if end
 		#取得較完整的指令
 		$result["cmd"]=$external["callShell"]["cmd"];
 		#移除信件檔案
 		#函式說明:
 		#移除檔案
 		#回傳結果:
 		#$result["status"],"true"代表移除成功,"false"代表移除失敗.
 		#如果移除信件檔案失敗
 		if($delMailFile["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$delMailFile;
 			#回傳結果
 			return $result;
 			}#if end
 		#可以執行到這邊，就表示十之八九寄信成功了
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function curlSmtp end
 	/*
 	#函式說明:
 	#使用 linux 的 curl 指令來透過SMTP伺服器寄大量不同內容的信件.
 	#回傳結果:
 	#$result["status"],寄信的情況,若爲"true"，則十之八九沒有問題.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function multiCurlSmtp(&$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["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("username","password","receiverMail","subject","plainBody","htmlBody","fileArgu");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","array","array","array","array","string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("attachment","attachmentName","attachmentMimeType","mailServer","mailerMailDisplay","mailerNameDisplay","receiverMailDisplay","receiverNameDisplay","insecure","usernameOnly");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","array","array","string","string","string","array","array","string","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,null,null,"smtps://smtp.gmail.com:465","\$conf[\"username\"]","\$conf[\"username\"]","\$conf[\"receiverMail\"]","\$conf[\"receiverMail\"]","false","false");
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("subject","plainBody","htmlBody","receiverMail","receiverMailDisplay","receiverNameDisplay");
 		#參考資料來源:
 		#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
 		#檢查 .curlSmtp 資料夾是否存在
 		#函式說明:檢查多個檔案是否存在
 		#回傳的結果:
 		#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#參考資料來源：
 		#http://php.net/manual/en/function.file-exists.php
 		#http://php.net/manual/en/control-structures.foreach.php
 		$checkMutiFileExist=fileAccess::checkMultiFileExist($conf["fileAccess::checkMultiFileExist"]);
 		unset($conf["fileAccess::checkMultiFileExist"]);
 		#如果檢查檔案失敗
 		if($checkMutiFileExist["status"]=="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkMutiFileExist;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果該資料夾不存在
 		if($checkMutiFileExist["varExist"][0]=="false"){
 			$conf["fileAccess::createFolderAfterCheck"]["fileArgu"]=$conf["fileArgu"];
 			#可省略參數:
 			#$conf["fileAccess::createFolderAfterCheck"]["dirPermission"]="";#新建資料夾的權限設定，預設爲0770,亦即擁有者,同群組者可以讀,寫,存取,其他人僅能存取.
 			$createFolderAfterCheck=fileAccess::createFolderAfterCheck($conf["fileAccess::createFolderAfterCheck"]);
 			unset($conf["fileAccess::createFolderAfterCheck"]);
 			#如果 建立資料夾失敗
 			if($createFolderAfterCheck["status"]=="false"){
 				#設置錯誤識別
 				$result["status"]="false";
 				return $result;
 				}#if end
 			}#if end
 		#初始化寄信的command
 		#$mailCmd="";
 		#初始化寄信的指令
 		$mailCmdArray=array();
 		#初始化移除信件檔案的指令
 		$delMailFileCmd=array();
 		#取得 $systemTime
 		$systemTime=time::getMicrotime();
 		#要傳送的信件資訊
 		$fromInfo="From: ".$conf["mailerNameDisplay"]." <".$conf["mailerMailDisplay"].">\r\n";
 		#初始化信件的 header
 		$mailFileHeader="";
 		#依據 $conf["receiverMail"] 的數量
 		for($i=0;$i<count($conf["receiverMail"]);$i++){
 			#串接寄件人的資訊
 			$mailFileHeader=$mailFileHeader.$fromInfo;
 			#如果第$i筆信件的收件人陣列不存在
 			if(!isset($conf["receiverMail"][$i])){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"][]="第".($i+1)."筆收件人陣列不存在";
 				#回傳結果
 				return $result;
 				}#if end
 			#反之存在但形態不為陣列
 			if(gettype($conf["receiverMail"][$i])!="array"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"][]="第".($i+1)."筆收件人陣列形態不正確";
 				#回傳結果
 				return $result;
 				}#if end
 			#如果第$i筆信件的收件人名稱不存在
 			if(!isset($conf["receiverNameDisplay"][$i])){
 				#設為第$i筆信件的收件人陣列
 				$conf["receiverNameDisplay"][$i]=$conf["receiverMail"][$i];
 				}#if end
 			#第$i筆信件收件人名稱陣列的第一個元素不存在
 			else if(!isset($conf["receiverNameDisplay"][$i][0])){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"][]="第".($i+1)."筆收件人名稱陣列的第一個收件人名稱不存在";
 				#回傳結果
 				return $result;
 				}#if end
 			#如果第$i筆信件的收件人信箱名稱不存在
 			if(!isset($conf["receiverMailDisplay"][$i])){
 				#設為第$i筆信件的收件人陣列
 				$conf["receiverMailDisplay"][$i]=$conf["receiverMail"][$i];
 				}#if end
 			#第$i筆信件收件人信箱名稱陣列的第一個元素不存在
 			else if(!isset($conf["receiverNameDisplay"][$i][0])){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"][]="第".($i+1)."筆收件人信箱名稱陣列的第一個收件人信箱名稱不存在";
 				#回傳結果
 				return $result;
 				}#if end
 			#第一個人為主要收件人
 			$mailFileHeader=$mailFileHeader."To: ".$conf["receiverNameDisplay"][$i][0]." "."<".$conf["receiverMailDisplay"][$i][0].">\r\n";
 			#如果有其餘收件人
 			if(count($conf["receiverNameDisplay"][$i])>1){
 				#副本寄送處的資訊開始
 				$mailFileHeader=$mailFileHeader."Cc: ";
 				}#if end
 			#針對其餘收件人的地址
 			for($j=1;$j<count($conf["receiverNameDisplay"][$i]);$j++){
 				#如果不是最後一筆
 				if($j!=count($conf["receiverNameDisplay"][$i])-1){
 					#串接並加上逗號
 					$mailFileHeader=$mailFileHeader.$conf["receiverNameDisplay"][$i][$j]." <".$conf["receiverMailDisplay"][$i][$j].">,";
 					}#if end
 				#反之是最後一筆
 				else{
 					#串接並接上換行符號
 					$mailFileHeader=$mailFileHeader.$conf["receiverNameDisplay"][$i][$j]." <".$conf["receiverMailDisplay"][$i][$j].">\r\n";
 					}#else end
 				}#for end
 			#設置信件標題
 			$mailFileHeader=$mailFileHeader."Subject: ".$conf["subject"][$i]."\r\n";
 			#設置 MIME-Version
 			$mailFileHeader=$mailFileHeader."MIME-Version: 1.0\r\n";
 			#初始化信件本文
 			$mailFileContent="";
 			#設置信件本文(純文字與html兩種)
 			$mailFileContent=$mailFileContent."--001a11c30ce8aec3550533bfa9ab\r\n";
 			$mailFileContent=$mailFileContent."Content-Type: multipart/alternative; boundary=001a11c30ce8aec3480533bfa9a9\r\n";
 			$mailFileContent=$mailFileContent."\r\n";
 			$mailFileContent=$mailFileContent."--001a11c30ce8aec3480533bfa9a9\r\n";
 			$mailFileContent=$mailFileContent."Content-Type: text/plain; charset=UTF-8\r\n";
 			$mailFileContent=$mailFileContent."Content-Type: text/html; charset=UTF-8\r\n";
 			$mailFileContent=$mailFileContent."\r\n";
 			$mailFileContent=$mailFileContent.$conf["htmlBody"][$i]."\r\n";
 			$mailFileContent=$mailFileContent."\r\n";
 			$mailFileContent=$mailFileContent."--001a11c30ce8aec3480533bfa9a9--\r\n";
 			#如果有設定要上傳附件
 			if(isset($conf["attachment"])){
 				#如果第 $i+1 封信件有指定 附件
 				if(isset($conf["attachment"][$i])){
 					#如果類型正確
 					if(gettype($conf["attachment"][$i])=="array"){
 						#依據每個附件
 						for($j=0;$j<count($conf["attachment"][$i]);$j++){
 							#初始化寄送附件的語法
 							$attachment="";
 							#確認目標檔案是否存在 #函式說明:檢查多個檔案是否存在 #回傳的結果:
 							#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
 							#$result["error"],錯誤訊息陣列.
 							#$resutl["function"],當前執行的涵式名稱.
 							#$result["allExist"],所有檔案皆存在的識別,"true"代表皆存在,"false"代表沒有全部都存在.
 							#$result["varName"][$i]，爲第$i個資料夾或檔案的名稱。
 							#$result["varExist"][$i]，爲第$i個資料夾或檔案是否存在，"true"代表存在，"false"代表不存在。
 							#必填參數:
 							$conf["fileAccess::checkMultiFileExist"]["fileArgu"]=$conf["fileArgu"];
 							$conf["fileAccess::checkMultiFileExist"]["fileArray"]=array($conf["attachment"][$i][$j]);#要檢查書否存在的檔案有哪些，須爲一維陣列數值。
 							#參考資料來源：
 							#http://php.net/manual/en/function.file-exists.php
 							#http://php.net/manual/en/control-structures.foreach.php
 							$checkMutiFileExist=fileAccess::checkMultiFileExist($conf["fileAccess::checkMultiFileExist"]);
 							unset($conf["fileAccess::checkMultiFileExist"]);
 							#如果檢查失敗
 							if($checkMutiFileExist["status"]=="false"){
 								#設置錯誤識別
 								$result["status"]="false";
 								#設置錯誤資訊
 								$result["error"]=$checkMutiFileExist;
 								#回傳結果
 								return $result;
 								}#if end
 							#如果檔案不存在
 							if($checkMutiFileExist["varExist"][0]=="false"){
 								#設置錯誤識別
 								$result["status"]="false";
 								#設置錯誤資訊
 								$result["error"]=$checkMutiFileExist;
 								#回傳結果
 								return $result;
 								}#if end
 							#如果是第一個附件
 							if($j==0){
 								#在前面加上 multipart/mixed 的 boundary
 								$mailFileContent="Content-Type: multipart/mixed; boundary=001a11c30ce8aec3550533bfa9ab\r\n\r\n".$mailFileContent;
 								}#if end
 							#如果 $conf["attachmentName"][$i] 不存在
 							if(!isset($conf["attachmentName"][$i])){
 								#涵是說明:
 								#取得檔案路徑字串的路徑與檔案的名稱與檔案副檔名
 								#回傳的結果:
 								#$result["status"],執行是否正常,"true"正常,"false"代表不正常.
 								#$result["error"],錯誤訊息.
 								$conf["fileAccess::getFileAddressAndNameAndFileExtention"]["fileAddressAndName"]=$conf["attachment"][$i][$j];
 								#可省略的參數:
 								#無.
 								$getFileAddressAndNameAndFileExtention=fileAccess::getFileAddressAndNameAndFileExtention($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 								unset($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 								#如果解析檔案資訊失敗
 								if($getFileAddressAndNameAndFileExtention["status"]=="false"){
 									#設置錯誤識別
 									$result["status"]="false";
 									#設置錯誤資訊
 									$result["error"]=$getFileAddressAndNameAndFileExtention;
 									#回傳結果
 									return $result;
 									}#if end
 								#設定附件名稱
 								$conf["attachmentName"][$i][$j]=$getFileAddressAndNameAndFileExtention["fullFileName"];
 								}#if end
 							#反之如果 $conf["attachmentName"][$i][$j] 不存在
 							else if(!isset($conf["attachmentName"][$i][$j])){
 								#涵是說明:
 								#取得檔案路徑字串的路徑與檔案的名稱與檔案副檔名
 								#回傳的結果:
 								#$result["status"],執行是否正常,"true"正常,"false"代表不正常.
 								#$result["error"],錯誤訊息.
 								$conf["fileAccess::getFileAddressAndNameAndFileExtention"]["fileAddressAndName"]=$conf["attachment"][$i][$j];
 								#可省略的參數:
 								#無.
 								$getFileAddressAndNameAndFileExtention=fileAccess::getFileAddressAndNameAndFileExtention($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 								unset($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 								#如果解析檔案資訊失敗
 								if($getFileAddressAndNameAndFileExtention["status"]=="false"){
 									#設置錯誤識別
 									$result["status"]="false";
 									#設置錯誤資訊
 									$result["error"]=$getFileAddressAndNameAndFileExtention;
 									#回傳結果
 									return $result;
 									}#if end
 								#設定附件名稱
 								$conf["attachmentName"][$i][$j]=$getFileAddressAndNameAndFileExtention["fullFileName"];
 								}#if end
 							#如果 $conf["attachmentMimeType"][$i][$j] 不存在
 							if(!isset($conf["attachmentMimeType"][$i])){
 								#設定檔案類型
 								$conf["attachmentMimeType"][$i][$j]="application/*";
 								}#if end
 							#反之如果 $conf["attachmentMimeType"][$i][$j] 不存在
 							else if(!isset($conf["attachmentMimeType"][$i][$j])){
 								$conf["attachmentMimeType"][$i][$j]="application/*";
 								}#if end
 							#加上寄送附件的語法
 							$attachment=$attachment."--001a11c30ce8aec3550533bfa9ab\r\n";
 							$attachment=$attachment."Content-Type: ".$conf["attachmentMimeType"][$i][$j]."; name=".$conf["attachmentName"][$i][$j]."\r\n";
 							$attachment=$attachment."Content-Disposition: attachment; filename=".$conf["attachmentName"][$i][$j]."\r\n";
 							$attachment=$attachment."Content-Transfer-Encoding: base64\r\n";
 							$attachment=$attachment."X-Attachment-Id: f_io1ikfii".$i."_".$j."\r\n";
 							#將檔案用base64加密
 							$base64fileStr=base64_encode(file_get_contents($conf["attachment"][$i][$j]));
 							#依據規定，每列不得大於70的字元
 							$wordwrapedFileStr=wordwrap($base64fileStr,70,"\r\n",true);
 							#斷行後附加檔案字串
 							$attachment=$attachment."\r\n".$wordwrapedFileStr."\r\n";
 							#如果是最後一個附件
 							if($j==count($conf["attachment"][$i])-1){
 								#混合資料結尾
 								$attachment=$attachment."--001a11c30ce8aec3550533bfa9ab--\r\n";
 								}#if end
 							#增加到信件內文的結尾
 							$mailFileContent=$mailFileContent.$attachment;
 							}#for end
 						}#if end
 					}#if end
 				}#if end
 			#要寄送的郵件檔案路徑與名稱
 			$mailFile=".curlSmtp/mail_at_".$systemTime.".mail";
 			#建立要寄送的郵件檔案
 			#將字串寫入到檔案
 			#回傳結果:
 			#$result["status"],"true"表示檔案寫入成功,"false"表示檔案寫入失敗.
 			#$result["error"],錯誤訊息陣列.
 			#$conf["filenameExtensionStartPoint"]="";
 			#$conf["repeatNameRule"],字串,遇到相同名稱的檔案要如何加上識別的編號,編號用「\$i」表示,預設為"(\$i)"
 			$conf["fileAccess::writeTextIntoFile"]["repeatNameRule"]="_\$i";
 			$writeTextIntoFile=fileAccess::writeTextIntoFile($conf["fileAccess::writeTextIntoFile"]);
 			unset($conf["fileAccess::writeTextIntoFile"]);
 			#如果檔案建立失敗
 			if($writeTextIntoFile["status"]=="false"){
 				#設置錯誤識別
 				$result["status"]="false";
 				#回傳結果
 				return $result;
 				}#if end
 			#取得建立好的檔案名稱
 			$mailFile=$writeTextIntoFile["fileInfo"]["createdFilePathAndName"];
 			#初始化收件人字串
 			$rcptStr="";
 			#有幾個收件人就執行幾次
 			foreach($conf["receiverMail"][$i] as $mailTo){
 				#串接收件人
 				$rcptStr=$rcptStr." --mail-rcpt \"".$mailTo."\"";
 				}#for end
 			#初始化允許不安全連線的字串
 			$insecure="";
 			#如果允許不安全的連線
 			if($conf["insecure"]==="true"){
 				#設置允許不安全連線
 				$insecure="--insecure";
 				}#if end
 			#如果登入帳號不用@
 			if($conf["usernameOnly"]==="true"){
 				#尋找有無 "@"
 				$at=strpos($conf["username"],"@");
 				#如果有找到
 				if($at!==false){
 					#取得不含 @... 的帳戶名稱
 					$conf["username"]=substr($conf["username"],0,$at);
 					}#if end
 				}#if end
 			#設置要執行的系統命令(寄信)
 			$cmdString="curl --ssl --anyauth -1 ".$insecure." --url \"".$conf["mailServer"]."\" -u \"".$conf["username"].":".$conf["password"]."\" --mail-from \"".$conf["mailerMailDisplay"]."\" $rcptStr --upload-file \"".$mailFile."\" -v";
 			#取得寄信的指令
 			$mailCmdArray[]=$cmdString;
 			#取得移除信件檔案的指令
 			$delMailFileCmd[]="rm \"".$mailFile."\"";
 			#清空 $mailFileHeader
 			$mailFileHeader="";
 			}#for end
 		#用curl寄送信件
 		#函式說明:
 		#運用nohup與&來達到雖依序執行但不等待前一個指令執行完再執行下一個指令,形成假多工的執行每個指令.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#$result["function"],當前執行的函數名稱.
 		#$result["cmd"],執行的指令內容.
 		#$result["output"],爲執行完二元碼後的輸出陣列.
 		#必填參數:
 		#$conf["command"],字串陣列,要執行的指令與.
 		$conf["external::multiThreadsShell"]["command"]=$mailCmdArray;
 		#$conf["fileArgu"],字串,變數__FILE__的內容.
 		$conf["external::multiThreadsShell"]["fileArgu"]=$conf["fileArgu"];
 		#可省略參數:
 		#$conf["argu"],二維陣列字串,每個指令搭配的參數,預設為空陣列.
 		#$conf["argu"]=array(array());
 		#$conf["enablePrintDescription"],字串,是否要印出$conf["printDescription"]的內容,"true"代表要,"false"代表不要,預設為"false".
 		#$conf["enablePrintDescription"]="true";
 		#$conf["username"]=array("");
 		#$conf["password"],字串陣列,與$conf["username"]搭配的使用者密碼,預設不使用密碼,該參數不適用於apache環境.
 		#$conf["password"]=array("");
 		$multiThreadsShell=external::multiThreadsShell($conf["external::multiThreadsShell"]);
 		unset($conf["external::multiThreadsShell"]);
 		#如果寄信失敗
 		if($multiThreadsShell["status"]=="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤資訊
 			$result["error"]=$multiThreadsShell;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得執行的指令
 		$result["cmd"]=$multiThreadsShell["cmd"];
 		/*
 		#移除信件檔案
 		#函式說明:
 		#運用nohup與&來達到雖依序執行但不等待前一個指令執行完再執行下一個指令,形成假多工的執行每個指令.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#$result["function"],當前執行的函數名稱.
 		#$result["cmd"],執行的指令內容.
 		#$result["output"],爲執行完二元碼後的輸出陣列.
 		#必填參數:
 		#$conf["command"],字串陣列,要執行的指令與.
 		$conf["external::multiThreadsShell"]["command"]=$delMailFileCmd;
 		#$conf["fileArgu"],字串,變數__FILE__的內容.
 		$conf["external::multiThreadsShell"]["fileArgu"]=$conf["fileArgu"];
 		#可省略參數:
 		#$conf["argu"],二維陣列字串,每個指令搭配的參數,預設為空陣列.
 		#$conf["argu"]=array(array());
 		#$conf["enablePrintDescription"],字串,是否要印出$conf["printDescription"]的內容,"true"代表要,"false"代表不要,預設為"false".
 		#$conf["enablePrintDescription"]="true";
 		#$conf["username"]=array("");
 		#$conf["password"],字串陣列,與$conf["username"]搭配的使用者密碼,預設不使用密碼,該參數不適用於apache環境.
 		#$conf["password"]=array("");
 		$multiThreadsShell=external::multiThreadsShell($conf["external::multiThreadsShell"]);
 		unset($conf["external::multiThreadsShell"]);
 		#如果移除信件檔案失敗
 		if($multiThreadsShell["status"]=="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤資訊
 			$result["error"]=$multiThreadsShell;
 			#回傳結果
 			return $result;
+			}
 		*/
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function multiCurlSmtp end
 	/*
 	#函式說明:
 	#透過php的mail函數寄信
 	#回傳結果:
 	#$result["status"],寄信的情況,若爲"true"，則十之八九沒有問題.
 	$conf["to"]=array();
 	#$conf["subject"],字串,郵件標題.
 	$conf["subject"]="";
 	#$conf["content"],字串,要寄送的訊息內容.
 	$conf["content"]="";
 	#可省略參數:
 	#$conf["mailerEmail"],字串,顯示的寄件人.
 	#$conf["mailerEmail"]="";
 	#參考資料:
 	#mail=>https://www.php.net/manual/en/function.mail.php
 	#Internet Message Format=>http://www.faqs.org/rfcs/rfc2822
 	#備註:
 	#無.
 	*/
 	public static function sendMail(&$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["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("to","subject","content");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","string","string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("mailerEmail");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null);
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("subject","plainBody","htmlBody","receiverMail","receiverMailDisplay","receiverNameDisplay");
 		#參考資料來源:
 		#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
 		#函式說明:
 		#將一維陣列轉換為用特定符號間隔的字串,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
 		$to = $arrayToString["content"];
 		$subject = $conf["subject"];
 		$message = $conf["content"];
 		# In case any of our lines are larger than 70 characters, we should use wordwrap()
 		$message = wordwrap($message, 70, "\r\n");
 		#初始化mail header為空
 		$headers = "";
 		#如果有設置寄件人資訊
 		if(isset($conf["mailerEmail"])){
 			#設置寄件人資訊
 			$headers = "From: ".$conf["mailerEmail"];
 			}#if end
 		#寄信
 		$mailResult=mail($to, $subject, $message, $headers);
 		#初始化執行正常
 		$result["status"]="true";
 		#如果寄信失敗
 		if(!$mailResult){
 			#設置執行不正常
 			$result["status"]="false";
 			#回傳結果
 			return $result;
 			}#if end
 		#回傳結果
 		return $result;
 		}#function sendMail end
 	/*
 	#函式說明:
 	#使用 php-pear-smtp 來透過SMTP伺服器寄信.
 	#回傳結果:
 	#$result["status"],執行正常與否,"true"代表正常;反之為"false".
 	#mail body boundary=>https://www.w3.org/Protocols/rfc1341/7_2_Multipart.html
 	#備註:
 	#需要php-pear-Net-SMTP
 	*/
 	public static function pear_smtp_send(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#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
 		#設置pear套件Net SMTP的位置
 		$locationOfPearNetSmtp="/usr/share/pear/Net/SMTP.php";
 		#檢查需要的pear套件是否存在
 		#函式說明:
 		#檢查多個檔案與資料夾是否存在.
 		#回傳的結果:
 		#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
 		#備註:
 		#函數file_exists檢查的路徑為檔案系統的路徑
 		#$result["varName"][$i]結果未實作
 		$checkMultiFileExist=fileAccess::checkMultiFileExist($conf["filAccess::checkMultiFileExist"]);
 		unset($conf["filAccess::checkMultiFileExist"]);
 		#如果檢查失敗
 		if($checkMultiFileExist["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkMultiFileExist;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果不存在
 		if($checkMultiFileExist["allExist"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]=$checkMultiFileExist;
 			#設置錯誤訊息
 			$result["error"][]="請確認 ".$locationOfPearNetSmtp." 可被存取";
 			#回傳結果
 			return $result;
 			}#if end
 		#匯入需要的pear套件
 		require_once($locationOfPearNetSmtp);
 		#create smtp object
 		$smtp = new \Net_SMTP($conf["mailServer"], $conf["mailServerPort"]);
 		#如果有錯誤
 		if(\PEAR::isError($error = $smtp->connect())){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$error->getMessage();
 			#回傳結果
 			return $result;
 			}#if end
 		#嘗試進行登入認證,方式目前都用"PLAIN"
 		$smtp->auth($conf["username"],$conf["password"],"PLAIN");
 		# smtp command "MAIL FROM:"
 		$smtp->mailFrom($conf["mailerNameDisplay"]." <".$conf["mailerMailDisplay"].">");
 		#初始化儲存 email head 的變數
 		$head="";
 		#初始化儲存 email data 的變數
 		$data="";
 		#設置收件人
 		foreach($conf["receiverMail"] as $index => $receiverMail){
 			#若無顯示名稱參數
 			if(!isset($conf["receiverNameDisplay"][$index])){
 				#若無顯示名稱參數,則預設採email來顯示.
 				$conf["receiverNameDisplay"][$index]=$receiverMail;
 				}#if end
 			#設置收件人的email與顯示名稱
 			$receiverMail=$conf["receiverNameDisplay"][$index]." <".$receiverMail.">";
 			#設置To:資訊
 			$head=$head."To: ".$receiverMail."\r\n";
 			#如果新增收件人失敗
 			if(\PEAR::isError($res=$smtp->rcptTo($receiverMail))){
 				#設置錯誤識別
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]="Unable to add recipient <".$receiverMail.">: ".$res->getMessage();
 				#回傳結果
 				return $result;
 				}#if end
 			}#foreach end
 		#設置sender資訊
 		$head=$head."From: ".$conf["mailerNameDisplay"]." <".$conf["mailerMailDisplay"].">"."\r\n";
 		#設置Replay-to資訊
 		$head=$head."Reply-To: ".$conf["mailerNameDisplay"]." <".$conf["mailerMailDisplay"].">"."\r\n";
 		#如果有設置回報已讀通知
 		if($conf["notifyReceived"]==="true"){
 			#Disposition-Notification-To: liveuser@qbpwcf.org
 			$head=$head."Disposition-Notification-To: ".$conf["mailerMailDisplay"]."\r\n";
 			}#if end
 		#建立body中的Subject
 		$head=$head."Subject: ".$conf["subject"]."\r\n";
 		#函式說明:
 		#使用 linux 的 uuid 指令來產生 uuid 字串
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息.
 		#參考資料:
 		#無.
 		#備註:
 		#無.
 		$uuid=cmd::uuid();
 		#如果取得uuid失敗
 		if($uuid["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]="Unable to create Message-ID";
 			#設置錯誤訊息
 			$result["error"][]=$uuid;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#將字串特定關鍵字與其前面的內容剔除
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#無.
 		#備註:
 		#無.
 		$delStrBeforeKeyWord=stringProcess::delStrBeforeKeyWord($conf["stringProcess::delStrBeforeKeyWord"]);
 		unset($conf["stringProcess::delStrBeforeKeyWord"]);
 		#如果取得Message-ID的domain失敗
 		if($delStrBeforeKeyWord["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]="Unable to create domain of Message-ID";
 			#設置錯誤訊息
 			$result["error"][]=$delStrBeforeKeyWord;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得Message-ID對應的domain
 		$MessageIdDomain=$delStrBeforeKeyWord["content"];
 		#建立Message-ID
 		$head=$head."Message-ID: <".$uuid["content"]."@".$MessageIdDomain.">"."\r\n";;
 		#設置User-Agent
 		$head=$head."User-Agent: ".$conf["userAgent"]."\r\n";
 		#設置Date:
 		$head=$head."Date: ".gmdate("Y-m-d H:i:s")."\r\n";
 		#如果有設置 org
 		if(isset($conf["org"])){
 			#設置 Organization
 			$head=$head."Organization: ".$conf["org"]."\r\n";
 			}#if end
 		#函式說明:
 		#建立以圖片(PNG格式)呈現的驗證碼.
 		#回傳的解果：
 		#$result["status"],執行是否正常,"true"代表執行成功,"false"代表執行失敗.
 		#$result["error"],錯誤訊息.
 		#無.
 		#備註:
 		#無.
 		$validationCode=authenticate::validationCode($conf["authenticate::validationCode"]);
 		unset($conf["authenticate::validationCode"]);
 		#如果檢查失敗
 		if($validationCode["status"]==="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$validationCode;
 			#回傳結果
 			return $result;
 			}#if end
 		#初始化 boundary
 		$boundary=$validationCode["randNumberWord"];
 		#初始化 boundary start
 		$boundaryS="--".$boundary;
 		#初始化 boundary end
 		$boundaryE=$boundaryS."--";
 		#取得放置於head的Contet-Type描述
 		$contentDescInHead="Content-Type: multipart/alternative; boundary=\"".$boundary."\"\r\n";
 		#設置信件本文(純文字與html兩種)
 		$data=$data.$boundaryS."\r\n";
 		$data=$data."Content-Type: text/plain; charset=UTF-8\r\n";
 		$data=$data."\r\n";
 		$data=$data.$conf["plainBody"]."\r\n";
 		$data=$data.$boundaryS."\r\n";
 		$data=$data."Content-Type: text/html; charset=UTF-8\r\n";
 		$data=$data."\r\n";
 		$data=$data.$conf["htmlBody"]."\r\n";
 		$data=$data.$boundaryE."\r\n";
 		#如果有設定要上傳附件
 		if(isset($conf["attachment"])){
 			#依據每個附件
 			for($i=0;$i<count($conf["attachment"]);$i++){
 				#初始化寄送附件的語法
 				$attachment="";
 				#確認目標檔案是否存在
 				#函式說明:檢查多個檔案是否存在
 				#回傳的結果:
 				#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
 				#$result["error"],錯誤訊息陣列.
 				#參考資料來源：
 				#http://php.net/manual/en/function.file-exists.php
 				#http://php.net/manual/en/control-structures.foreach.php
 				$checkMutiFileExist=fileAccess::checkMultiFileExist($conf["fileAccess::checkMultiFileExist"]);
 				unset($conf["fileAccess::checkMultiFileExist"]);
 				#如果檢查失敗
 				if($checkMutiFileExist["status"]=="false"){
 					#設置錯誤識別
 					$result["status"]="false";
 					#設置錯誤資訊
 					$result["error"]=$checkMutiFileExist;
 					#回傳結果
 					return $result;
 					}#if end
 				#如果檔案不存在
 				if($checkMutiFileExist["varExist"][0]=="false"){
 					#設置錯誤識別
 					$result["status"]="false";
 					#設置錯誤資訊
 					$result["error"]=$checkMutiFileExist;
 					#回傳結果
 					return $result;
 					}#if end
 				#如果是第一個附件
 				if($i===0){
 					#在前面加上 multipart/mixed 的 boundary
 					$data="Content-Type: multipart/mixed; boundary=".$boundary."\r\n\r\n".$data;
 					}#if end
 				#如果 $conf["attachmentName"] 不存在
 				if(!isset($conf["attachmentName"])){
 					#涵是說明:
 					#取得檔案路徑字串的路徑與檔案的名稱與檔案副檔名
 					#回傳的結果:
 					#$result["status"],執行是否正常,"true"正常,"false"代表不正常.
 					#$result["error"],錯誤訊息.
 					$conf["fileAccess::getFileAddressAndNameAndFileExtention"]["fileAddressAndName"]=$conf["attachment"][$i];
 					#可省略的參數:
 					#無.
 					$getFileAddressAndNameAndFileExtention=fileAccess::getFileAddressAndNameAndFileExtention($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 					unset($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 					#如果解析檔案資訊失敗
 					if($getFileAddressAndNameAndFileExtention["status"]==="false"){
 						#設置錯誤識別
 						$result["status"]="false";
 						#設置錯誤資訊
 						$result["error"]=$getFileAddressAndNameAndFileExtention;
 						#回傳結果
 						return $result;
 						}#if end
 					#設定附件名稱
 					$conf["attachmentName"][$i]=$getFileAddressAndNameAndFileExtention["fullFileName"];
 					}#if end
 				#反之如果 $conf["attachmentName"][$i] 不存在
 				else if(!isset($conf["attachmentName"][$i])){
 					#涵是說明:
 					#取得檔案路徑字串的路徑與檔案的名稱與檔案副檔名
 					#回傳的結果:
 					#$result["status"],執行是否正常,"true"正常,"false"代表不正常.
 					#$result["error"],錯誤訊息.
 					$conf["fileAccess::getFileAddressAndNameAndFileExtention"]["fileAddressAndName"]=$conf["attachment"][$i];
 					#可省略的參數:
 					#無.
 					$getFileAddressAndNameAndFileExtention=fileAccess::getFileAddressAndNameAndFileExtention($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 					unset($conf["fileAccess::getFileAddressAndNameAndFileExtention"]);
 					#如果解析檔案資訊失敗
 					if($getFileAddressAndNameAndFileExtention["status"]=="false"){
 						#設置錯誤識別
 						$result["status"]="false";
 						#設置錯誤資訊
 						$result["error"]=$getFileAddressAndNameAndFileExtention;
 						#回傳結果
 						return $result;
 						}#if end
 					#設定附件名稱
 					$conf["attachmentName"][$i]=$getFileAddressAndNameAndFileExtention["fullFileName"];
 					}#if end
 				#如果 $conf["attachmentMimeType"] 不存在
 				if(!isset($conf["attachmentMimeType"])){
 					#設定檔案類型
 					$conf["attachmentMimeType"][$i]="application/*";
 					}#if end
 				#反之如果 $conf["attachmentMimeType"][$i] 不存在
 				if(!isset($conf["attachmentMimeType"][$i])){
 					$conf["attachmentMimeType"][$i]="application/*";
 					}#if end
 				#加上寄送附件的語法
 				$attachment=$attachment.$boundaryS."\r\n";
 				$attachment=$attachment."Content-Type: ".$conf["attachmentMimeType"][$i]."; name=".$conf["attachmentName"][$i]."\r\n";
 				$attachment=$attachment."Content-Disposition: attachment; filename=".$conf["attachmentName"][$i]."\r\n";
 				$attachment=$attachment."Content-Transfer-Encoding: base64\r\n";
 				$attachment=$attachment."X-Attachment-Id: f_io1ikfii".$i."\r\n";
 				#將檔案用base64加密
 				$base64fileStr=base64_encode(file_get_contents($conf["attachment"][$i]));
 				#斷行後附加檔案字串
 				$attachment=$attachment."\r\n".$base64fileStr."\r\n";
 				#如果是最後一個附件
 				if($i===count($conf["attachment"])-1){
 					#混合資料結尾
 					$attachment=$attachment.$boundary."\r\n";
 					}#if end
 				#增加到信件內文的結尾
 				$data=$data.$attachment;
 				}#for end
 			}#if end
 		#body end
 		#如果有指定 signWithGPGid
 		if(isset($conf["signWithGPGid"])){
 			#將原本的 Content-Type 放到 data 前面.
 			$data=$contentDescInHead.$data;
 			#sign之前的內容,要先符合每列不得大於70的字元的規定
 			$data=wordwrap($data,70,"\r\n",true);
 			#用gpg指令簽署body
 			#函式說明:
 			#呼叫shell執行系統命令,並取得回傳的內容.
 			#回傳結果:
 			#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 			#備註:
 			#不是所有指令都能用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
 			#如果輸出的內容有異常
 			if($callShell["output"][0]!=="-----BEGIN PGP SIGNED MESSAGE-----"){
 				#設置錯誤識別
 				$result["status"]="false";
 				#設置錯誤資訊
 				$result["error"]=$callShell;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果簽署所用的方式不是SHA512
 			if($callShell["output"][1]!=="Hash: SHA512"){
 				#設置錯誤識別
 				$result["status"]="false";
 				#設置錯誤資訊
 				$result["error"]=$callShell;
 				#回傳結果
 				return $result;
 				}#if end
 			#預設的 pgp 簽署方式
 			$micalg="micalg=\"pgp-sha512\"";
 			#如果輸出結尾不是 "-----END PGP SIGNATURE-----"
 			if($callShell["output"][count($callShell["output"])-1]!=="-----END PGP SIGNATURE-----"){
 				#設置錯誤識別
 				$result["status"]="false";
 				#設置錯誤資訊
 				$result["error"]=$callShell;
 				#回傳結果
 				return $result;
 				}#if end
 			#初始化儲存  PGP SIGNATURE 字串
 			$signDataOfGPG="";
 			#尚未到開始 PGP SIGNATURE 部分時
 			while($callShell["output"][count($callShell["output"])-1]!=="-----BEGIN PGP SIGNATURE-----"){
 				#如果有資料了
 				if(!empty($signDataOfGPG)){
 					#前面加上換行字元
 					$signDataOfGPG="\r\n".$signDataOfGPG;
 					}#if end
 				#取得 PGP SIGNATURE 部分
 				$signDataOfGPG=$callShell["output"][count($callShell["output"])-1].$signDataOfGPG;
 				#移除已經抓好的資料
 				unset($callShell["output"][count($callShell["output"])-1]);
 				}#while end
 			#取得 PGP SIGNATURE 部分
 			$signDataOfGPG="\r\n".$callShell["output"][count($callShell["output"])-1]."\r\n".$signDataOfGPG;
 			#head 增加表示有 GPG 簽署
 			$head=$head."Security: GPG signed"."\r\n";
 			#函式說明:
 			#建立以圖片(PNG格式)呈現的驗證碼.
 			#回傳的解果：
 			#$result["status"],執行是否正常,"true"代表執行成功,"false"代表執行失敗.
 			#$result["error"],錯誤訊息.
 			#無.
 			#備註:
 			#無.
 			$validationCode=authenticate::validationCode($conf["authenticate::validationCode"]);
 			unset($conf["authenticate::validationCode"]);
 			#如果檢查失敗
 			if($validationCode["status"]==="false"){
 				#設置錯誤識別
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$validationCode;
 				#回傳結果
 				return $result;
 				}#if end
 			#初始化 boundary
 			$boundary=$validationCode["randNumberWord"];
 			#初始化 boundary start
 			$boundaryS="--".$boundary;
 			#初始化 boundary end
 			$boundaryE=$boundaryS."--";
 			#將 data 用新的 boundary 包起來
 			$data=$boundaryS."\r\n".$data."\r\n";
 			#8個空格
 			$eightSpace="        ";
 			#描述內容為 gpg key 簽署的 head 資訊,"protocol"要空8格
 			$gpgData="Content-Type: multipart/signed; ".$micalg.";"."\r\n".$eightSpace."protocol=\"application/pgp-signature\"; boundary=\"".$boundary."\"\r\n";
 			#增加描述用於 sign 的 gpg pub key
 			$signDataOfGPG="Content-Type: application/pgp-signature; name=\"signature.asc\""."\r\n"."Content-Description: This is a digitally signed message part"."\r\n".$signDataOfGPG."\r\n";
 			#設置gpg key簽署的資訊
 			$data=$data.$boundaryS."\r\n".$signDataOfGPG."\r\n".$boundaryE."\r\n";
 			#取得放置於head的Contet-Type描述
 			$contentDescInHead=&$gpgData;
 			}#if end
 		#組合head與body,依據規定，每列不得大於70的字元
 		$data=wordwrap($head.$contentDescInHead.$data,70,"\r\n",true);
 		#Send the DATA command to start message body
 		if(\PEAR::isError($smtp->data($data))){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]="Unable to send data:".$data;
 			#回傳結果
 			return $result;
 			}#if end
 		#使用完畢後要關閉連線
 		$smtp->disconnect();
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function pear_smtp_send end
 	}#class mail end
-?>
+?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/mail.php – Rev 58 → 226