WebSVN – php-qbpwcf – Diff – /trunk/usr/lib64/qbpwcf/header.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
 	#$arguments,陣列,為呼叫方法時所用的參數.
 	#參考資料:
 	#__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"代表不正常.
 	#$arguments,陣列,為呼叫方法時所用的參數.
 	#參考資料:
 	#__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
 	/*
 	#函式說明:
 	#設定檢視該網頁時預設的編碼
 	*/
 	public static function htmlEncoding($conf){
 		#設定網頁顯示的編碼
 		header("Content-Type: text/html; charset='".$conf["encodingName"]."'");
 		#避免header指定的檔案內容形態被修改
 		#https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Content-Type-Options
 		header("X-Content-Type-Options: text/html");
 		#讓網頁本文也能識別是UTF-8編碼
 		$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
 		#設定 $interval 秒後，轉向至 $redirectionLocation
 		header("Refresh: ".$conf["interval"]."; url=".$conf["redirctionLocation"]);
 		#如果要立即結束執行
 		if($conf["exitNow"]==="true"){
 			#停止執行後面的程式，因爲要馬上進行轉址.
 			exit;
 			}#if end
 		#設置執行失敗
 		$result["status"]="true";
 		#設置錯誤訊息
 		return $result;
 		}#function redirection end
 	#$conf["sessionValue"]=array("");
 	#參考資料:
 	#http://php.net/manual/en/reserved.variables.server.php
 	#備註:
 	#無.
 	*/
 	public static function redirectionNow(&$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
 		#初始化ifrmae語法內容
 		$result["content"]="";
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明：
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#必填寫的參數：
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("headerLocation");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="true";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("sessionName","sessionValue");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","array");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,null);
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查失敗
 		if($checkResult["status"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkResult["passed"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果 $conf["sessionName"] 與 $conf["sessionValue"] 皆為 true 代表皆有設置.
 		if( isset($conf["sessionName"])==true && isset($conf["sessionValue"])==true ){
 			#有幾個 $conf["sessionName"] 就執行幾次.
 			for($i=0;$i<count($conf["sessionName"]);$i++){
 				#函式說明:
 				#建立session變數，並指派其內容
 				#$result["status"],執行狀態，"true"代表執行成功；"false"代表執行失敗.
 				#$result["error"],錯誤訊息陣列.
 				#$result["function"],當前執行的函數名稱.
 				#必填參數:
 				$conf["session"]["create"]["sessionName"]=$conf["sessionName"][$i];#要建立的session變數名稱，建議可採用name1.name2.name3的格式。
 				#可省略的參數：
 				$conf["session"]["create"]["sessionValue"]=$conf["sessionValue"][$i];#session變數的內容要存放什麼呢？
 				$sessionCreatedResult=session::create($conf["session"]["create"]);
 				unset($conf["session"]["create"]);
 				#如果建立session變數失敗
 				if($sessionCreatedResult["status"]=="false"){
 					#設置執行不正常
 					$result["status"]="false";
 					#設置錯誤訊息
 					$result["error"]=$sessionCreatedResult;
 					#回傳結果
 					return $result;
 					}#if end
 				}#for end
 			}#if end
 		#立即轉址到特定網址.
 		#header("Refresh: 0; url=".$conf["headerLocation"]);
 		header("location:".$conf["headerLocation"]);
 		#停止執行後面的程式，因爲要馬上進行轉址.
 		exit;
 		}#function redirectionNow end.
 	/*
 	#函式說明:
 	#用data:mimeType;base64,fileVar的形式來提供檔案的連結,亦即檔案儲存在變數裡面.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$result["error"],錯誤訊息
 	#$result["content"],檔案變數的內容
 	#$result["fileTypeName"],副檔名,ex:「.tar.xz」.
 	#$result["function"],當前執行的函數名稱
 	#必填參數:
 	#$conf["filePosition"],要轉存成2元碼的圖片檔案位置與名稱
 	$conf["filePosition"]="";
 	#$conf["mimeType"],2元碼的內容是什麼
 	$conf["mimeType"]="";
 	#壓縮2元碼=>http://php.net/manual/en/function.base64-encode.php
 	#備註:
 	#無.
 	*/
 	public static function data(&$conf){
 		#與fileAccess類別的data函數一樣
 		return fileAccess::data($conf);
 		}#function data end
 	/*
 	#函式說明:
 	#透過轉址的方式來下載檔案.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$result["error"],錯誤訊息
 	#$result["function"],當前執行的函數名稱
 	#必填參數:
 	#$conf["filePosition"],字串,爲要下載的檔案位置
 	$conf["filePosition"]="";
 	#$conf["fileType"],字串,檔案類型
 	$conf["fileType"]="";
 	#$conf["fileTypeName"]="";
 	#參考資料:
 	#header=>http://php.net/manual/en/function.header.php
 	#備註:
 	#請在沒有任何html輸出的頁面使用
 	*/
 	public static function downloadFile($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
 		#檢查參數
 		#函式說明：
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#必填寫的參數：
 		#$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("filePosition","fileType","fileName");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("fileTypeName");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null);
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array();
 		#var_dump($checkResult);
 		#exit;
 		#如果檢查失敗
 		if($checkResult["status"]=="false"){
 			#設置錯誤狀態
 			$result["status"]="false";
 			#設置錯誤提示
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkResult["passed"]=="false"){
 			#設置錯誤狀態
 			$result["status"]="false";
 			#設置錯誤提示
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#描述內容為檔案傳輸
 		header("Content-Description: File Transfer");
 		#設定檔案的類型
 		header("Content-Type:".$conf["fileType"]);
 		#如果 $conf["fileTypeName"] 存在
 		if(isset($conf["fileTypeName"])){
 			#加上副檔名
 			$conf["fileName"]=$conf["fileName"].$conf["fileTypeName"];
 			}#if end
 		#提示下載檔案與其資訊
 		header("Content-Disposition: attachment; filename=\"".$conf["fileName"]."\"");
 	#http:#php.net/manual/en/function.readfile.php
 	#備註:
 	#建議改用data與downloadFile函數
 	*/
 	public static function askUserDownloadFile(&$conf){
 		#初始化要回傳的變數
 		$result=array();
 		#初始化當前執行的函數名稱
 		$result["funciton"]=__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["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("filePositionAndName");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("fileDisplayName","mimeType");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string");
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,"application/octet-stream");
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查失敗
 		if($checkResult["status"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkResult["passed"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果 $conf["fileDisplayName"] 不存在
 		if(!isset($conf["fileDisplayName"])){
 			#回傳西元的目前時間,格式為2010年07月24日15時30分33秒
 			#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 			#$result["content"],西元的目前時間.
 			#必填參數:
 			$conf["time"]["getFullDateAndTime"]["timeZone"]="Asia/Taipei";#時區代號,可以設定的時區列表:http:#www.php.net/manual/en/timezones.php
 				#ex:"Asia/Taipei"
 			#可省略的參數：
 			$conf["time"]["getFullDateAndTime"]["showSecond"]="true";#若爲"true"則會顯示秒數
 			$systemTime=time::getFullDateAndTime($conf["time"]["getFullDateAndTime"]);
 			unset($conf["time"]["getFullDateAndTime"]);
 			#如果取得系統時間失敗
 			if($systemTime["status"]=="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$systemTime;
 				#回傳結果
 				return $result;
 				}#if end
 			#函式說明:
 			#將固定格式的字串分開，並回傳分開的結果。
 			#回傳的參數:
 			#$result["dataCounts"],爲總共分成幾段
 			#必填參數:
 			$conf["stringPross"]["spiltString"]["stringIn"]=basename($conf["filePositionAndName"]);#要處理的字串。
 			$conf["stringPross"]["spiltString"]["spiltSymbol"]=".";#爲以哪個符號作爲分割
 			$fileNameString=stringProcess::spiltString($conf["stringPross"]["spiltString"]);
 			unset($conf["stringPross"]["spiltString"]);
 			#如果分割字串失敗
 			if($fileNameString["status"]=="false"){
 				#設置錯誤識別
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$fileNameString;
 				#回傳結果
 				return $result;
 				}#if end
 			#檔案名稱為 / 後面的內容
 			$conf["fileDisplayName"]="(".$fileNameString["dataArray"][0]." date:".$systemTime["content"].")";
 			#若原始檔案名稱有副檔名
 			for($i=1;$i<$fileNameString["dataCounts"];$i++){
 				#組合副檔名
 				$conf["fileDisplayName"]=$conf["fileDisplayName"].".".$fileNameString["dataArray"][$i];
 				}#for end
 			}#if end
 		#如果檔案存在
 			header("Pragma: public");
 			header("Content-Length:".filesize($conf["filePositionAndName"]));#headr的大小等於檔案的大小
 			ob_clean();#清除物件
 			flush();#清除記憶題
 			readfile($conf["filePositionAndName"]);#讀取檔案
 			#設置執行正常
 			$result["status"]="true";
 			#回傳結果
 			return $result;
 		#如果檔案不存在則回傳錯誤訊息
 		else{
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]="要下載的檔案不存在";
 			#回傳結果
 			return $result;
 			}#else end
 		#照理說不應該執行到這邊
 		#設置錯誤識別
 		$result["status"]="false";
 		#設置錯誤訊息
 		$result["error"][]="下載檔案失敗";
 		#回傳結果
 		return $result;
 		}#function end
 	*/
 	public static function setPageInfo($conf){
 		#初始化要回傳的變數
 		$result=array();
 		#初始化當前執行的函數名稱
 		$result["funciton"]=__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["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("title");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("desc");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("\$conf[\"title\"]");
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查失敗
 		if($checkResult["status"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkResult["passed"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#設置 title
 		$title="<title>".$conf["title"]."</title>";
 		#設置 meta desc
 		$meta="<meta name=\"description\" content=\"".$conf["desc"]."\" ></meta>";
 		#設定資訊字串
 		$result["content"]="<head>".$title.$meta."</head>";
 		#設置執行正常
 		$result["status"]="true";
 		#回傳設定資訊
 		return $result;
 		}#function setPageInfo end
 	/*
 	#函式說明:
 	#用彈出式視窗顯示訊息，接著設置seesion變數,最後進行轉址.
 	#回傳的結果:
 	#$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
 	#$conf["sessionValue"]=array("");
 	#參考資料:
 	#http://php.net/manual/en/reserved.variables.server.php
 	#備註:
 	#無.
 	*/
 	public static function redirectionAfterAlertWindows(&$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["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("headerLocation","alertMessage");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","array");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("sessionName","sessionValue");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","array");
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,null);
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("sessionName","sessionValue");
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果 檢查出錯
 		if($checkResult["status"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果 檢查 不通過
 		if($checkResult["passed"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#初始化要顯示的彈出式視窗內容
 		$msg="";
 		#將 $conf["alertMessage"] 中 每個元素視為 $lineContent
 		foreach($conf["alertMessage"] as $lineContent){
 			#結尾加換行符號
 			$msg=$msg.$lineContent."\\n";
 			}#foreach end
 		#函式說明:
 		#彈出視窗
 		#回傳的結果：
 		#$result["status"],執行正確與否,"true"為執行正確,"false"為執行失敗.
 		#$result["error"],錯誤訊息陣列.
 		#$result["content"],avaScript語法.
 		#必填的參數
 		$conf["javaScript"]["alertWindow"]["alertSentence"]=$msg;#爲要彈出式視窗的內容。
 		$javaScript=javaScript::alertWindow($conf["javaScript"]["alertWindow"]);
 		unset($conf["javaScript"]);
 		#如果 $javaScript["status"] 等於 "false"
 		if($javaScript["status"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$javaScript;
 			#回傳結果
 			return $result;
 			}#if end
 		#印出javaScript
 		echo $javaScript["content"];
 		#如果 $conf["sessionName"] 參數存在
 		if(isset($conf["sessionName"])){
 			#$conf["sessionName"]有幾個元素就執行幾次
 			for($i=0;$i<count($conf["sessionName"]);$i++){
 				#設置session變數
 				#函式說明:
 				#建立session變數，並指派其內容
 				#回傳的結果：
 				#$result["status"]，執行狀態，"true"代表執行成功；"false"代表執行失敗。
 				#$result["error"]，錯誤訊息陣列
 				#必填參數:
 				$conf["session"]["create"]["sessionName"]=$conf["sessionName"][$i];#要建立的session變數名稱，建議可採用name1.name2.name3的格式。
 				#可省略的參數：
 				$conf["session"]["create"]["sessionValue"]=$conf["sessionValue"][$i];#session變數的內容要存放什麼呢？
 				$createSessionResult=session::create($conf["session"]["create"]);
 				unset($conf["session"]);
 				#如果 $createSessionResult["status"] 等於 "false"
 				if($createSessionResult["status"]=="false"){
 					#設置執行失敗
 					$result["status"]="false";
 					#設置錯誤訊息
 					$result["error"]=$createSessionResult;
 					#回傳結果
 					return $result;
 					}#if end
 				}#for end
 			}#if end
 		#函式說明:
 		#設定網頁n秒後轉址
 		#必填參數:
 		$conf["header"]["redirection"]["redirctionLocation"]=$conf["headerLocation"];#為要轉址到的地方
 			#若爲 $SERVER["PHP_SELF"],則爲回到目前頁面。
 		$conf["header"]["redirection"]["interval"]="0";#幾秒後轉向,"0"為等待javacript程式執行完後再立即轉址。
 		header::redirection($conf["header"]["redirection"]);
 		unset($conf["header"]);
 		#執行到這邊代表不正常
 		#設置執行失敗
 		$result["status"]="false";
 		#設置錯誤訊息
 		$result["error"][]="非預期的錯誤";
 		#回傳結果
 		return $result;
 		}#function redirectionAfterAlertWindows end
 	/*
 	#函式說明:
 	#接收表單變數後,轉存成session變數後,立即轉址.
 	#回傳的結果:
 	$conf["redirectionTo"]="";
 	#可省略參數:
 	#$conf["receiveFormMethod"],字串,傳送過來的資料是用"post/POST"還是"get/GET",預設為"post"
 	#$conf["receiveFormMethod"]="post";
 	#$conf["additionSessionName"]字串陣列,額外指派的session變數名稱.
 	#$conf["additionSessionName"]=array("");
 	#$conf["additionSessionValue"]字串陣列,可額外指派的session變數的內容.
 	#$conf["additionSessionValue"]=array("");
 	#參考資料:
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function formVarToSessionThenRedirection(&$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["content"]="";
 		#檢查參數
 		#函式說明：
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#必填寫的參數：
 		#$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("receivedVarName","limitPrePage","sessionName","redirectionTo");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","array","array","string",);
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("receiveFormMethod","additionSessionName","additionSessionValue");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","array","array");
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("post",null,null);
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("sessionName","sessionValue");
 		$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("additionSessionName","additionSessionValue");
 		#參考資料來源:
 		#array_keys=>http://php.net/manual/en/function.array-keys.php
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果 檢查出錯
 		if($checkResult["status"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果 檢查 不通過
 		if($checkResult["passed"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#可以處理多個透過GET、POST而來的資訊，儲存成變數，同時限定傳送的方法、來源，來增加安全性，檢查有沒有皆收到必須要接收到的變數
 		#回傳的結果：
 		#$result["status"],執行是否成功，"true"代表執行成功；"false"代表執行失敗.
 		#$result["function"],當前執行的函數.
 		#伺服器端的變數 -> http://php.net/manual/en/reserved.variables.server.php
 		#備註：
 		#表單變數的名稱若含有「.」，則會變成「-」。
 		$receiveVar=form::responseMultiInputDataSecurityEnhance($conf["form.responseMultiInputDataSecurityEnhance"]);
 		unset($conf["form.responseMultiInputDataSecurityEnhance"]);
 		#如果接收變數失敗
 		if($receiveVar["status"]=="false"){
 			#設置錯誤
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$receiveVar;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果變數有缺
 		if($receiveVar["passed"]=="false"){
 			#設置錯誤
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$receiveVar;
 			#回傳結果
 			return $result;
 			}#if end
 		#$conf["additionSessionName"]字串陣列,額外指派的session變數名稱.
 		#$conf["additionsessionName"]=array("");
 		#$conf["additionSessionValue"]字串陣列,可額外指派的session變數的內容.
 		#$conf["additionSessionValue"]=array("");
 		#如果有設置要另外設置的seesion變數
 		if(isset($conf["additionSessionName"]) && isset($conf["additionSessionValue"])){
 			#函式說明:
 			#建立多個session變數
 			#回傳結果:
 			#$result["status"],執行狀態,"true"代表執行成功；"false"代表執行失敗.
 			#$reuslt["function"],當前執行的函數.
 			$conf["session.createMulti"]["sessionArrayValue"]=$conf["additionSessionValue"];
 			#可省略參數:
 			#無
 			$additionSessionCreateResult=session::createMulti($conf["session.createMulti"]);
 			unset($conf["session.createMulti"]);
 			#如果建立session變數失敗
 			if($additionSessionCreateResult["status"]=="false"){
 				#設置錯誤
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$additionSessionCreateResult;
 				#回傳結果
 				return $result;
 				}#if end
 			}#if end
 		#初始化要轉存成session的表單變數內容
 		$formToSessionVarValue=array();
 		#針對每個要接收的變數
 		for($i=0;$i<count($conf["receivedVarName"]);$i++){
 			#取得要轉存成session變數的數值
 			$formToSessionVarValue[]=$receiveVar["inputDataContent"][$conf["receivedVarName"][$i]];
 			}#for end
 		#設置session變數並轉址
 		#函式說明:
 		#設定session變數後,立即轉址.
 		#回傳的結果:
 		#$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
 		$conf["header.redirectionNow"]["sessionValue"]=$formToSessionVarValue;
 		#參靠資料來源:
 		#http://php.net/manual/en/reserved.variables.server.php
 		$redirectionResult=header::redirectionNow($conf["header.redirectionNow"]);
 		unset($conf["header.redirectionNow"]);
 		#如果轉址失敗
 		if($redirectionResult["status"]=="false"){
 			#設置錯誤
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$redirectionResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#執行到這邊代表執行不正常
 		$result["status"]="false";
 		#設置錯誤訊息
 		$result["error"][]="不可預期的錯誤";
 		#回傳結果
 		return $result;
 		}#function formVarToSessionThenRedirection end
 	/*
 	#函式說明:
 	#取得apache接收到的header
 	#回傳結果:
 	#$result["status"],執行成功與否,"true"代表成功,"false"代表失敗.
 	#$result["content"],取得的header陣列.
 	#$result["function"],當前執行的函數名稱.
 	#必填參數:
 	#無
 	#可省略參數:
 	#無
 	#參考資料:
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function getReceivedHeaders(){
 		#設置要回傳的結果
 		$result=array();
 		#設置當前執行的函數
 		$result["function"]=__FUNCTION__;
 		#存放 header 的變數
 		$result["content"]=array();
 		#fix centos8 stream with php56
 		#如果沒有 apache_request_headers 函式
 		if(!function_exists("apache_request_headers"))
+		{
 			#針對每個 $_SERVER 變數
 			foreach($_SERVER as $name => $val)
+			{
 				#設置關鍵字
 				$keyWord="HTTP";
 				#如果 key 是 HTTP 開頭
 				if(strpos($name,$keyWord)===0)
 				{
 					#將 HTTP 開頭字串剔除
 					#函式說明:
 					#將字串特定關鍵字與其前面的內容剔除
 					#回傳結果:
 					#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 					#$result["error"],錯誤訊息陣列.
 					#$result["warning"],警告訊息鎮列.
 					#$result["founded"],有無找到定字串"true"代表有,"false"代表沒有.
 					#$result["function"],當前執行的函數名稱.
 					#$result["oriStr"],要處理的原始字串內容.
 					#$result["content"],處理好的的字串內容.
 					#必填參數:
 					#$conf["stringIn"],字串,要處理的字串.
 					$conf["stringProcess::delStrBeforeKeyWord"]["stringIn"]=$name;
 					#$conf["keyWord"],字串,特定字串.
 					$conf["stringProcess::delStrBeforeKeyWord"]["keyWord"]=$keyWord;
 					$delStrBeforeKeyWord=stringProcess::delStrBeforeKeyWord($conf["stringProcess::delStrBeforeKeyWord"]);
 					unset($conf["stringProcess::delStrBeforeKeyWord"]);
 					#如果處理失敗
 					if($delStrBeforeKeyWord["status"]==="false")
+					{
 						#執行到這邊代表執行不正常
 						$result["status"]="false";
 						#設置錯誤訊息
 						$result["error"]=$delStrBeforeKeyWord;
 						#回傳結果
 						return $result;
 					}#if end
 					#取得 header
 					$result["content"][$delStrBeforeKeyWord["content"]]=$val;
 				}#if end
 			}#foreach end
 		}#if end
 		else
+		{
 			#取得 header
 			$result["content"]=@apache_request_headers();
 		}#else end
 		#如果取得 header 失敗
 		if($result["content"]===FALSE){
 			#執行到這邊代表執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"][]="不可預期的錯誤";
 			#回傳結果
 			return $result;
 			}#if end
 		#執行到這邊代表執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function getReceivedHeaders end
 	/*
 	#函式說明:
 	#依根接收到的表單變數內容,轉址到特定地方.
 	#回傳結果:
 	#$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function transferByFormVar(&$conf=array()){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $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"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("varName","condition","headerLocation");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","array","array");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="true";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("limitPrePage");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array");
 		#$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();
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查失敗
 		if($checkResult["status"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkResult["passed"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#可以處理多個透過GET、POST而來的資訊，儲存成變數，同時限定傳送的方法、來源，來增加安全性，檢查有沒有皆收到必須要接收到的變數,沒有接收到的變數可以指定從session變數中取得.
 		#回傳的結果：
 		#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
 		#$result["error"],錯誤訊息陣列.
 		#$conf["method"],字串,傳送過來的資料是用"post/POST"還是"get/GET"?
 		$conf["form::responseMultiInputDataSecurityEnhance"]["method"]="post";
 		#可省略的參數：
 		#$conf["allowGet"],字串,是否要允許 get 傳值，"true"，代表允許；"false" ，代表不允許，預設爲不允許.
 		#$conf["allowGet"]="true";
 		#如果有設置 limitPrePage
 		if(isset($conf["limitPrePage"])){
 			#$conf["limitPrePage"],字串陣列,是否要限定前一頁的網址為哪些，才能接收內容，不符合則轉址.
 			$conf["form::responseMultiInputDataSecurityEnhance"]["limitPrePage"]=$conf["limitPrePage"];
 			}#if end
 		#$conf["transferLocation"],字串,遇到get傳值，或前一個頁面不符合要求時要轉址到的頁面，預設爲資安素養網"https://isafe.moe.edu.tw/"
 		#$conf["transferLocation"]="";
 		#$conf["ignore"]=字串陣列,如果要接收的變數名稱與該陣列其一元素一樣,則不放進要回傳的變數裏面.
 		#$conf["ignore"]=array();
 		#$conf["correctCharacter"]=,字串,如果爲"false"，則不處理可能導致網頁出問題的字串，預設爲要進行處理.
 		#$conf["correctCharacter"]="false";
 		#$conf["checkedVarName"],字串陣列,為檢查是否有接收到哪些變數.
 		$conf["form::responseMultiInputDataSecurityEnhance"]["checkedVarName"]=array($conf["varName"]);
 		#$conf["canBeEmptyString"],字串,用$conf["checkedVarName"]指定接收的變數名稱陣列,若接收到的內容為空字串是否算有接收到內容,預設為"false","true"代表接收到的內容可以為空字串,"false"代表接收到的內容不可以為空字串.
 		#$conf["canBeEmptyString"]="false";
 		#$conf["sessionNameArray"],陣列,若存在則代表若沒有從表單取得變數,則從session變數中取得內容,每個元素代表每個表單變數對應的session名稱,若不是要改用session方式取得變數內容的變數,請輸入null,數量請跟$conf["checkedVarName"]參數一致.
 		#$conf["sessionNameArray"]=array();
 		#$conf["unsetSessionArray"],陣列,與$conf["sessionNameArray"]對應的元素,是否要接收到變數後就卸除,"true"代表要卸除,"false"代表不要卸除.
 		#$conf["unsetSessionArray"]=array();
 		#伺服器端的變數 -> http://php.net/manual/en/reserved.variables.server.php
 		#備註：
 		#表單變數的名稱若含有「.」，則會變成「-」。
 		$responseMultiInputDataSecurityEnhance=form::responseMultiInputDataSecurityEnhance($conf["form::responseMultiInputDataSecurityEnhance"]);
 		unset($conf["form::responseMultiInputDataSecurityEnhance"]);
 		#如果接收表單變數失敗
 		if($responseMultiInputDataSecurityEnhance["status"]==="false"){
 			#執行到這邊代表執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$responseMultiInputDataSecurityEnhance;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果接收表單變數不通過
 		if($responseMultiInputDataSecurityEnhance["passed"]==="false"){
 			#執行到這邊代表執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$responseMultiInputDataSecurityEnhance;
 			#回傳結果
 			return $result;
 			}#if end
 		#依照每個 condition
 		for($i=0;$i<count($conf["condition"]);$i++){
 			#如果接收到的表單變數對應到 condition 元素
 			if($responseMultiInputDataSecurityEnhance["inputDataContent"][$conf["varName"]]===$conf["condition"][$i]){
 				#轉址到對應的地方
 				#函式說明:
 				#設定session變數後,立即轉址.
 				#回傳的結果:
 				#$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
 				#$conf["sessionValue"]=array("");
 				#參靠資料來源:
 				#http://php.net/manual/en/reserved.variables.server.php
 				$redirectionNow=header::redirectionNow($conf["header::redirectionNow"]);
 				unset($conf["header::redirectionNow"]);
 				#如果轉址失敗
 				if($redirectionNow["status"]==="false"){
 					#執行到這邊代表執行不正常
 					$result["status"]="false";
 					#設置錯誤訊息
 					$result["error"]=$redirectionNow;
 					#回傳結果
 					return $result;
 					}#if end
 				#設置執行正常
 				$result["status"]="true";
 				#回傳結果
 				return $result;
 				}#if end
 			}#for end
 		#停止執行
 		exit;
 		}#function transferByFormVar end
 	/*
 	#函式說明:
 	#設置header的函式
 	#回傳結果:
 	#$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $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["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
 		#如果要先清除掉 header
 		if($conf["clearFirst"]==="true"){
 			#移除所有 header
 			header_remove();
 			}#if end
 		#針對每個要設置的 header
 		foreach($conf["header"] as $name => $value){
 			#將 $name 中的空格變更為 "-"
 			#函式說明:
 			#處理字串避免網頁出錯
 			#回傳的結果：
 			#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 			#$result["function"],當前執行的函數.
 			#$result["content"],爲處理好的字串.
 			#$result["error"],錯誤訊息陣列.
 			#$result["argu"],使用的參數.
 			#必填參數:
 			$conf["stringProcess::correctCharacter"]["stringIn"]=$name;#爲要處理的字串
 			#可省略參數:
 			#$conf["selectedCharacter"]=array("");#爲被選擇要處理的字串/字元，須爲陣列值。
 				#若不設定則預設爲要將這些字串作替換 ("<",">","=","//","'","$","%","&","|","/*","*","#","\"").
 			#$conf["changeTo"]=array();#爲被選擇的字元要換成什麼字串/字元，須爲陣列值。若不設定，則預設爲更換成""(空字串).
 			#備註:
 			#無.
 			$correctCharacter=stringProcess::correctCharacter($conf["stringProcess::correctCharacter"]);
 			unset($conf["stringProcess::correctCharacter"]);
 			#如果檢查失敗
 			if($correctCharacter["status"]=="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$correctCharacter;
 				#回傳結果
 				return $result;
 				}#if end
 			#取得處理好的name
 			$name=$correctCharacter["content"];
 			#設置header
 			header($name.": ".$value);
 			}#foreach end
 		#設置 staus code
 		http_response_code($conf["statusCode"]);
 		#設置執行正常
 		$result["status"]="true";
 		#初始化執行回應
 		$result["content"]=array();
 		#取得設置好的header清單
 		$result["content"]["header"]=headers_list();
 		#設置回應的http response code humber
 		$result["content"]["http_response_code"]=http_response_code();
 		#回傳結果
 		return $result;
 		}#function set end
 	/*
 	#函式說明:
 	#依照OPTIONS的要求，判斷條件，給予允許呼叫的header,預設是全允許.
 	#回傳結果:
 	#$result["status"],執行是否成功,"true"代表成功,"false"代表不成功.
 	#https://www.php.net/manual/en/function.http-response-code.php
 	#備註:
 	#無.
 	*/
 	public static function accessControl(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#$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=array();
 			#設置執行正常
 			$result["status"]="false";
 			#設置未執行的結果
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#初始化結果
 			$result=array();
 			#設置執行正常
 			$result["status"]="false";
 			#設置未執行的結果
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		/*
 		#函式說明:
 		#取得apache接收到的header
 		#回傳結果:
 		#$result["status"],執行成功與否,"true"代表成功,"false"代表失敗.
 		#$result["content"],取得的header陣列.
 		#$result["function"],當前執行的函數名稱.
 		#必填參數:
 		#無
 		#可省略參數:
 		#無
 		*/
 		$getReceivedHeaders=header::getReceivedHeaders();
 		#如果取得Header失敗
 		if($getReceivedHeaders["status"]==="false"){
 			#初始化結果
 			$result=array();
 			#設置執行正常
 			$result["status"]="false";
 			#設置未執行的結果
 			$result["error"]=$getReceivedHeaders;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得接收到header
 		$result["content"]["receivedHeader"]=$getReceivedHeaders["content"];
 		#如果沒有必備的 Origin header
 		if(!isset($getReceivedHeaders["content"]["Origin"])){
 			#設置允許所有Origin
 			$conf["allowDomain"]=array("*");
 			}#if end
 		#如果不是允許所有Origin
 		if($conf["allowDomain"]!==array("*")){
 			#涵式說明:
 			#檢查一個數值是否與陣列裏面的元素相同,找到一個相符合的元素後就會停止搜尋.
 			#回傳的結果:
 			#$result["status"],"true"表示執行正確，"false"表示執行錯誤.
 			#$result["founded"],"true"表示有找到相同的，"false"表示沒有找到相同的.
 			$getEqualVar=search::getEqualVar($conf["search::getEqualVar"]);
 			unset($conf["search::getEqualVar"]);
 			#如果檢查失敗
 			if($getEqualVar["status"]==="false"){
 				#初始化結果
 				$result=array();
 				#設置執行正常
 				$result["status"]="false";
 				#設置未執行的結果
 				$result["error"]=$getEqualVar;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果沒有符合的項目
 			if($getEqualVar["founded"]==="false"){
 				#初始化結果
 				$result=array();
 				#設置執行正常
 				$result["status"]="false";
 				#設置未執行的結果
 				$result["error"]=$getEqualVar;
 				#回傳結果
 				return $result;
 				}#if end
 			#設置要允許的Origin
 			$allowDomainString=$getEqualVar["equalVarValue"];
 		}#if end
 		#反之
 		else{
 			#設置為 "*"
 			$allowDomainString=$conf["allowDomain"][0];
+			}
 		#將陣列轉變成字串
 		#函式說明:
 		#將一維陣列轉換為用特定符號間隔的字串,ex:array("1","2","3") to "a;b;c;".
 		#回傳的結果:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		$arrayToString=arrays::arrayToString($conf["arrays::arrayToString"]);
 		unset($conf["arrays::arrayToString"]);
 		#如果取得Header失敗
 		if($arrayToString["status"]==="false"){
 			#初始化結果
 			$result=array();
 			#設置執行正常
 			$result["status"]="false";
 			#設置未執行的結果
 			$result["error"]=$arrayToString;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得允許的domain name字串
 		$allowMethodString=$arrayToString["content"];
 		#將陣列轉變成字串
 		#函式說明:
 		$arrayToString=arrays::arrayToString($conf["arrays::arrayToString"]);
 		unset($conf["arrays::arrayToString"]);
 		#如果取得Header失敗
 		if($arrayToString["status"]==="false"){
 			#初始化結果
 			$result=array();
 			#設置執行正常
 			$result["status"]="false";
 			#設置未執行的結果
 			$result["error"]=$arrayToString;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得允許的domain name字串
 		$allowHeaderString=$arrayToString["content"];
 		#設置header
 		#函式說明:
 		$set=header::set($conf["header::set"]);
 		unset($conf["header::set"]);
 		#如果設置Header失敗
 		if($set["status"]==="false"){
 			#初始化結果
 			$result=array();
 			#設置執行正常
 			$result["status"]="false";
 			#設置未執行的結果
 			$result["error"]=$set;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#撰寫log
 		#回傳結果:
 		#$result["status"],狀態,"true"或"false".
 		#$result["error"],錯誤訊息陣列.
 		#可省略參數:
 		#$conf["rewrite"],預設為"false",接續寫入;反之"true"代表重新寫入.
 		#$conf["rewrite"]="true";
 		$record=logs::record($conf["logs::record"]);
 		unset($conf["logs::record"]);
 		#取得要傳送的header
 		$result["content"]["sendedHeader"]=$set["content"]["header"];
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function accessControl end
 	}#clsss header end
 ?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/header.php – Rev 175 → 226