WebSVN – php-qbpwcf – Diff – /trunk/usr/lib64/qbpwcf/session.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
 跟 PHP session 應用相關的類別.
 備註:
 無.
 */
 class session{
 	/*
 	#函式說明:
 	#當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#__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"代表不正常.
 	#__callStatic=>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
 	/*
 	#函式說明:
 	#取得session變數裡面的數值，然後卸除該session變數
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
 	#卸除參考的原始變數=>http://stackoverflow.com/questions/6654538/php-function-to-unset-variables-passed-by-reference
 	#備註:
 	#無.
 	*/
 	public static function getSessionValue(&$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"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sessionVarName");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["canBeEmptyString"]="false";
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("unsetSessionVar","autoCreate","initVal");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","any");
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("false","false",null);
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("sessionArrayName","sessionArrayValue");
 		#參考資料來源:
 		#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
 		#確認該session變數是否存在
 		if(!isset($_SESSION[$conf["sessionVarName"]])){
 			#設置執行正常
 			$result["status"]="true";
 			#設置沒有找到session變數
 			$result["founded"]="false";
 			#如果要自動建立該 session 變數
 			if($conf["autoCreate"]==="true"){
 				#函式說明:
 				#建立session變數，並指派其內容
 				#回傳結果:
 				#$result["status"],執行狀態，"true"代表執行成功；"false"代表執行失敗.
 				#$result["error"],錯誤訊息陣列.
 				#$result["function"],當前執行的函數名稱.
 				#必填參數:
 				#$conf["sessionName"],字串,要建立的session變數名稱，建議可採用name1.name2.name3的格式.
 				$conf["session::create"]["sessionName"]=$conf["sessionVarName"];
 				#可省略參數:
 				#如果有設置 $conf["initVal"]
 				if(isset($conf["initVal"])){
 					#$conf["sessionValue"],字串,session變數的內容，預設為"".
 					$conf["session::create"]["sessionValue"]=$conf["initVal"];
 					}#if end
 				$create=session::create($conf["session::create"]);
 				unset($conf["session::create"]);
 				#遞迴執行
 				return session::getSessionValue($conf);
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#取得session變數的內容
 		$result["content"]=$_SESSION[$conf["sessionVarName"]];
 		#設置有找到session變數
 		$result["founded"]="true";
 		#如果 $conf["unsetSessionVar"] 為 "true"
 		if($conf["unsetSessionVar"]==="true"){
 			#移除session變數的內容
 			unset($_SESSION[$conf["sessionVarName"]]);
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function getSessionValue end
 	/*
 	#函式說明:
 	#取得多個指定的session變數,卸除之.
 	#回傳結果:
 	#$result["status"]，執行狀態，"true"代表執行成功；"false"代表執行失敗。
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function getMultiSessionValues(&$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"]=array();
 		#檢查參數
 		#函式說明:
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#必填寫的參數：
 		#$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sessionVarNameArray");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["canBeEmptyString"]="false";
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("keyArrayOfGotSessionValue","unsetSessionVars");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","string");
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,"true");
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("sessionArrayName","sessionArrayValue");
 		#參考資料來源:
 		#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
 		#有幾個session變數要接收就執行幾次
 		for($i=0;$i<count($conf["sessionVarNameArray"]);$i++){
 			#函式說明:
 			#取得session變數裡面的數值，然後卸除該session變數
 			#回傳結果:
 			#$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
 			#$result["error"],錯誤訊息
 			#http://stackoverflow.com/questions/8971261/php-5-4-call-time-pass-by-reference-easy-fix-available
 			#可變變數->http://emn178.pixnet.net/blog/post/80119035-php%E6%95%99%E5%AD%B8---%E8%AE%8A%E6%95%B8%28variables%29
 			#卸除參考的原始變數->http://stackoverflow.com/questions/6654538/php-function-to-unset-variables-passed-by-reference
 			$getSessionValueResult=session::getSessionValue($conf["session.getSessionValue"]);
 			unset($conf["session.getSessionValue"]);
 			#debug
 			#var_dump($getSessionValueResult);
 			#如果取得session變數失敗
 			if($getSessionValueResult["status"]=="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤的訊息
 				$result["error"]=$checkResult;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果該session變數不存在
 			if($getSessionValueResult["founded"]=="false"){
 				#設置該session變數不存在
 				$result["founded"][$i]="false";
 				}#if end
 			#反之session變數存在
 			else{
 				#設置該session變數存在
 				$result["founded"][$i]="true";
 				#取得session變數的內容
 				$result["content"][$i]=$getSessionValueResult["content"];
 				}#else end
 			}#for end
 		#如果 $conf["keyArrayOfGotSessionValue"] 有設置
 		if(isset($conf["keyArrayOfGotSessionValue"])){
 			#如果 $conf["keyArrayOfGotSessionValue"] 與 $conf["sessionVarNameArray"] 的元素數量相等
 			if(count($conf["keyArrayOfGotSessionValue"])==count($conf["sessionVarNameArray"])){
 				#$conf["keyArrayOfGotSessionValue"]有幾個元素就執行幾次
 				for($i=0;$i<count($conf["keyArrayOfGotSessionValue"]);$i++){
 					#給與新key
 					$result["founded"][$conf["keyArrayOfGotSessionValue"][$i]]=$result["founded"][$i];
 					#如果存在session變數
 					if(isset($result["content"][$i])){
 						#給與新key
 						$result["content"][$conf["keyArrayOfGotSessionValue"][$i]]=$result["content"][$i];
 						#移除舊key的變數
 						unset($result["content"][$i]);
 						}#if end
 					#移除舊key的變數
 					unset($result["founded"][$i]);
 					}#for end
 				}#if end
 			#反之 $conf["keyArrayOfGotSessionValue"] 與 $conf["sessionVarNameArray"] 的元素數量不相等
 			else{
 				#設置執行不正常
 				$result["status"]="false";
 				#設置執行錯誤的訊息
 				$result["error"][]="\$conf[\"keyArrayOfGotSessionValue\"] 與 \$conf[\"sessionVarNameArray\"] 的元素數量不相等";
 				#回傳結果
 				return $result;
 				}#else end
 			}#if end
 		#如果有一個session變數沒找到
 		foreach($result["founded"] as $value){
 			#如果等於 "false"
 			if($value=="false"){
 				#設置沒有每個session變數都抓到
 				$result["foundedAll"]="false";
 				#跳出foreach
 				break;
 				}#if end
 			}#foreach end
 		#如果 $result["foundedAll"] 沒有設置
 		if(!isset($result["foundedAll"])){
 			#設爲 "true"
 			$result["foundedAll"]="true";
 			}#if end
 		#設置執行結果爲正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#funtion getMultiSessionValues end
 	/*
 	#函式說明:
 	#建立session變數，並指派其內容
 	#回傳結果:
 	#$result["status"],執行狀態，"true"代表執行成功；"false"代表執行失敗.
 	#$result["argu"],使用的參數.
 	#$result["function"],當前執行的函數名稱.
 	#必填參數:
 	#$conf["sessionName"],字串,要建立的session變數名稱，建議可採用name1.name2.name3的格式.
 	$conf["sessionName"]="";
 	#可省略參數:
 	#$conf["sessionValue"],字串,session變數的內容，預設為"".
 	#$conf["sessionValue"]="";
 	#參考資料:
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function create(&$conf){
 		#初始化要回傳的變數
 		$result=array();
 		#儲存使用的參數
 		$result["argu"]=$conf;
 		#記錄當前執行的函數名稱
 		$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"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sessionName");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("sessionValue");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"]=array();
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("");
 		#$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
 		#建立session變數,並指派其直
 		$_SESSION[$conf["sessionName"]]=$conf["sessionValue"];
 		#設置執行成功的辨識訊息
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function create end
 	/*
 	#函式說明:
 	#記錄當前訪問的頁面,並且保存上一個訪問的頁面.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
 	*/
 	public static function getPreAndNowPosition(){
 		#初始化要回傳的變數
 		$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["function"]=__FUNCTION__;
 		#如果 $_SESSION["session"]["getPreAndNowPosition"]["prePlace"] 不存在
 		if(!isset($_SESSION["session"]["getPreAndNowPosition"]["prePlace"])){
 			#將之設為 ""
 			$_SESSION["session"]["getPreAndNowPosition"]["prePlace"]="";
 			}#if end
 		#如果 $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"] 存在
 		if(isset($_SESSION["session"]["getPreAndNowPosition"]["nowPlace"])){
 			#設置 $_SESSION["session"]["getPreAndNowPosition"]["prePlace"] 為 $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"]
 			$_SESSION["session"]["getPreAndNowPosition"]["prePlace"]=$_SESSION["session"]["getPreAndNowPosition"]["nowPlace"];
 			#設置 $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"] 為 $_SERVER["PHP_SELF"]
 			$_SESSION["session"]["getPreAndNowPosition"]["nowPlace"]=$_SERVER["PHP_SELF"];
 			}#if end
 		#反之 $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"] 沒有設置
 		else{
 			#將 $_SESSION["session"]["getPreAndNowPosition"]["nowPlace"] 設為 $_SERVER["PHP_SELF"]
 			$_SESSION["session"]["getPreAndNowPosition"]["nowPlace"]=$_SERVER["PHP_SELF"];
 			}#else end
 		#記錄要回傳的內容
 		#記錄當前瀏覽的目錄
 		#函式說明:
 		#將固定格式的字串分開，並回傳分開的結果。
 		#回傳的參數:
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#必填參數:
 		$conf["stringIn"]=$_SESSION["session"]["getPreAndNowPosition"]["nowPlace"];#要處理的字串。
 		$conf["spiltSymbol"]="/";#爲以哪個符號作爲分割
 		$processedStr=stringProcess::spiltString($conf);
 		unset($conf);
 		#如果處理字串失敗
 		if($processedStr["status"]=="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$processedStr;
 			#回傳結果
 			return $result;
 			}#if end
 		#初始化 $result["phpNowViewed"] 為 ""
 		$result["nowPosition"]="";
 		#針對 $processedStr["dataCounts"] 的數字來合併目錄
 		for($i=0;$i<$processedStr["dataCounts"]-1;$i++){
 			#合併目錄
 			$result["nowPosition"]=$result["nowPosition"].$processedStr["dataArray"][$i]."/";
 			}#for end
 		#記錄上一個瀏覽的目錄
 		#函式說明:
 		#將固定格式的字串分開，並回傳分開的結果。
 		#回傳的參數:
 		#$result["oriStr"],要分割的原始字串內容
 		#必填參數:
 		$conf["stringIn"]=$_SESSION["session"]["getPreAndNowPosition"]["prePlace"];#要處理的字串。
 		$conf["spiltSymbol"]="/";#爲以哪個符號作爲分割
 		$processedStr=stringProcess::spiltString($conf);
 		unset($conf);
 		#如果處理字串失敗
 		if($processedStr["status"]=="false"){
 			#設置錯誤識別
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$processedStr;
 			#回傳結果
 			return $result;
 			}#if end
 		#初始化 $result["prePosition"] 為 ""
 		$result["prePosition"]="";
 		#針對 $processedStr["dataCounts"] 的數字來合併目錄
 		for($i=0;$i<$processedStr["dataCounts"]-1;$i++){
 			#合併目錄
 			$result["prePosition"]=$result["prePosition"].$processedStr["dataArray"][$i]."/";
 			}#for end
 		#記錄當前瀏覽的檔案名稱
 		$result["phpNowViewed"]=basename($_SESSION["session"]["getPreAndNowPosition"]["nowPlace"]);
 		#記錄上一筆瀏覽的檔案名稱
 		$result["phpPreViewed"]=basename($_SESSION["session"]["getPreAndNowPosition"]["prePlace"]);
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function getPreAndNowPosition end
 	/*
 	#函式說明:
 	#建立多個session變數
 	#回傳結果:
 	#$result["status"],執行狀態,"true"代表執行成功；"false"代表執行失敗.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function createMulti(&$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"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("sessionArrayName","sessionArrayValue");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","array");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["canBeEmptyString"]="false";
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array();
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"]=array();
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("");
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("sessionArrayName","sessionArrayValue");
 		#參考資料來源:
 		#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
 		#執行迴圈 count($conf["sessionArrayName"]) 次
 		for($i=0;$i<count($conf["sessionArrayName"]);$i++){
 			#函式說明:
 			#建立session變數，並指派其內容
 			#回傳結果:
 			#$result["status"]，執行狀態，"true"代表執行成功；"false"代表執行失敗。
 			#$result["error"]，錯誤訊息陣列
 			#必填參數:
 			$conf["session.create"]["sessionName"]=$conf["sessionArrayName"][$i];#要建立的session變數名稱，建議可採用name1.name2.name3的格式。
 			#可省略參數:
 			$conf["session.create"]["sessionValue"]=$conf["sessionArrayValue"][$i];#session變數的內容要存放什麼呢？
 			$sessionCreateResult=session::create($conf["session.create"]);
 			unset($conf["session.create"]);
 			#如果 建立 session 變數失敗
 			if($sessionCreateResult["status"]=="false"){
 				#設置執行錯誤的識別
 				$result["status"]="false";
 				#設置執行失敗的錯誤訊息
 				$result["error"]=$sessionCreateResult;
 				#回傳結果
 				return $result;
 				}#if end
 			}#for end
 		#執行到這邊代表執行成功
 		$result["status"]="true";
 		#設置執行正常的識別
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function createMulti end
 	/*
 	#函式說明:
 	#接收post表單變數後另存成session變數
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$result["errot"],錯誤訊息陣列.
 	#$result["function"],當前的函數名稱.
 	#必填參數:
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function formVarToSession(&$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"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck.checkArguments"]["mustBeFilledVariableName"]=array("checkedVarName");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck.checkArguments"]["mustBeFilledVariableType"]=array("array");
 		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck.checkArguments"]["referenceVarKey"]="variableCheck.checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"false"。
 		$conf["variableCheck.checkArguments"]["canBeEmptyString"]="false";
 		#$conf["variableCheck.checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck.checkArguments"]["skipableVariableName"]=array("limitPrePage","transferLocation","sessionArrayName");
 		#$conf["variableCheck.checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck.checkArguments"]["skipableVariableType"]=array("array","string","array");
 		#$conf["variableCheck.checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定.
 		$conf["variableCheck.checkArguments"]["skipableVarDefaultValue"]=array(null,null,"\$conf[\"checkedVarName\"]");
 		$checkResult=variableCheck::checkArguments($conf["variableCheck.checkArguments"]);
 		unset($conf["variableCheck.checkArguments"]);
 		#如果檢查失敗
 		if($checkResult["status"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#函式說明:
 		#可以處理多個透過GET、POST而來的資訊，儲存成變數，同時限定傳送的方法、來源，來增加安全性，檢查有沒有皆收到必須要接收到的變數
 		#回傳結果:
 		#$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";
 		#如果有設定 $conf["limitPrePage"]
 		if(isset($conf["limitPrePage"])){
 			#$conf["form.responseMultiInputDataSecurityEnhance"]["limitPrePage"],字串陣列,是否要限定前一頁的網址為哪些，才能接收內容，不符合則轉址.
 			$conf["form.responseMultiInputDataSecurityEnhance"]["limitPrePage"]=$conf["limitPrePage"];
 			}#if end
 		#如果 $conf["transferLocation"] 有設定
 		if(isset($conf["transferLocation"])){
 			#$conf["form.responseMultiInputDataSecurityEnhance"]["transferLocation"],字串,遇到get傳值的時候要轉址到的頁面，預設爲資安素養網"https://isafe.moe.edu.tw/"
 			$conf["form.responseMultiInputDataSecurityEnhance"]["transferLocation"]=$conf["transferLocation"];
 			}#if end
 		#$conf["ignore"]=字串陣列,如果要接收的變數名稱與該陣列其一元素一樣,則不放進要回傳的變數裏面.
 		#$conf["ignore"]=array();
 		#$conf["correctCharacter"]=,字串,如果爲"false"，則不處理可能導致網頁出問題的字串，預設爲要進行處理.
 		#$conf["correctCharacter"]="false";
 		#如果 $conf["checkedVarName"] 有設定
 		if(isset($conf["checkedVarName"])){
 			#$conf["form.responseMultiInputDataSecurityEnhance"]["checkedVarName"],字串陣列,為檢查是否有接收到哪些變數.
 			$conf["form.responseMultiInputDataSecurityEnhance"]["checkedVarName"]=$conf["checkedVarName"];
 			}#if end
 		#參考資料來源：
 		#foreach 的用法 -> http://php.net/manual/en/control-structures.foreach.php
 		#伺服器端的變數 -> http://php.net/manual/en/reserved.variables.server.php
 		#備註：
 		#表單變數的名稱若含有「.」，則會變成「-」。
 		$receivedVar=form::responseMultiInputDataSecurityEnhance($conf["form.responseMultiInputDataSecurityEnhance"]);
 		unset($conf["form.responseMultiInputDataSecurityEnhance"]);
 		#如果接受變數失敗
 		if($receivedVar["status"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$receivedVar;
 			#回傳結果
 			return $result;
 			}#if end
 		#初始化轉好的session變數數值陣列
 		$sessionValueArray=array();
 		#建立要轉換成session變數的form變數數值陣列
 		foreach($conf["checkedVarName"] as $value){
 			#取得要轉換成session變數的form變數數值內容
 			$sessionValueArray[]=$receivedVar["inputDataContent"][$value];
 			}#foreach end
 		#函式說明:
 		#建立多個session變數
 		#回傳結果:
 		#$result["status"],執行狀態,"true"代表執行成功；"false"代表執行失敗.
 		#$reuslt["function"],當前執行的函數.
 		$conf["session.createMulti"]["sessionArrayValue"]=$sessionValueArray;
 		#可省略參數:
 		#無
 		$createSessionVarStatus=session::createMulti($conf["session.createMulti"]);
 		unset($conf["session.createMulti"]);
 		#如果建立session變數失敗
 		if($createSessionVarStatus["status"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置錯誤訊息
 			$reuslt["error"]=$createSessionVarStatus;
 			#回傳結果
 			return $result;
 			}#if end
 		#執行到這邊代表執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function formVarToSession end
 	/*
 	#函式說明:
 	#取得指定的session數值
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
 	#$result["error"],錯誤訊息.
 	#$result["founded"],是否有該session變數,"true"代表有,"false"代表沒有.
 	#$result["content"],session變數的內容
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function getVal(&$conf){
 		#初始化要回傳的結果
 		$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["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["skipableVariableCanNotBeEmpty"]=array();
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("unsetSess");
 		#$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("false");
 		#$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
 		#取得session的副本
 		$session=$_SESSION;
 		#儲存session的位址
 		$sessionAddress=&$_SESSION;
 		#針對每個key
 		foreach($conf["key"] as $keyVal){
 			#如果 key 為 $keyVal 的 session 變數不存在
 			if(!isset($session[$keyVal])){
 				#設置執行正常
 				$result["status"]="true";
 				#設置未找到session變數
 				$result["founded"]="false";
 				#取得 session 的位址
 				$result["address"]=&$sessionAddress;
 				#回傳結果
 				return $result;
 				}#if end
 			#反之
 			else{
 				#取得 session 該層的內容
 				$session=$session[$keyVal];
 				#取得 session 的位址
 				$sessionAddress=&$sessionAddress[$keyVal];
 				#如果要卸除 session 變數
 				if($conf["unsetSess"]==="true"){
 					#卸除 session 變數
 					unset($sessionAddress);
 					}#if end
 				}#else end
 			}#foreach end
 		#設置執行正常
 		$result["status"]="true";
 		#設置有找到 session 變數
 		$result["founded"]="true";
 		#設置取得的session內容
 		$result["content"]=$session;
 		#取得 session 的位址
 		$result["address"]=&$sessionAddress;
 		#回傳結果
 		return $result;
 		}#function getVal end
 	/*
 	#函式說明:
 	#設置指定的session變數
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
 	#$result["error"],錯誤訊息.
 	#$result["founded"],是否有該session變數,"true"代表有,"false"代表沒有.
 	#$result["content"],session變數的內容
 	#http://php.net/manual/en/function.end.php
 	#備註:
 	#無.
 	*/
 	public static function setVal(&$conf){
 		#初始化要回傳的結果
 		$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["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["skipableVariableCanNotBeEmpty"]=array();
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("storeAsNotRepeatArray");
 		#$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("false");
 		#$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
 		#取得seesion變數的層級數目
 		$lastLayer=count($conf["key"]);
 		#設置初始的層級
 		$layer=1;
 		#取得session變數的位址
 		$session=&$_SESSION;
 		#數化要查詢的session key階層
 		$sa=array();
 		#針對session變數的每個層級
 		foreach($conf["key"] as $keyVal){
 			#如果是最後一層
 			if($layer===$lastLayer){
 				#如果要儲存成陣列
 				if($conf["storeAsNotRepeatArray"]==="true"){
 					#如果目標變數有存在了
 					if(isset($session[$keyVal])){
 						#如果不是陣列
 						if(gettype($session[$keyVal])!=="array"){
 							#設置執行失敗
 							$result["status"]="false";
 							#設置執行錯誤訊息
 							$result["error"]=$checkArguments;
 							#設置錯誤訊息
 							$result["error"][]="變數內容不是陣列";
 							#回傳結果
 							return $result;
 							}#if end
 						#如果是新的元素
 						if(!in_array($conf["val"],$session[$keyVal])){
 							#新增元素
 							$session[$keyVal][]=$conf["val"];
 							}#if end
 						}#if end
 					#反之
 					else{
 						#新增元素
 						$session[$keyVal][]=$conf["val"];
 						}#else end
 					$keys=array_keys($session[$keyVal]);
 					#get last key
 					$lastKey=end($keys);
 					#取得當前參照的session階層位址
 					$session=&$session[$keyVal][$lastKey];
 					}#if end
 				#反之直接儲存
 				else{
 					#設置 session 變數的內容
 					$session[$keyVal]=$conf["val"];
 					#取得當前參照的session階層位址
 					$session=&$session[$keyVal];
 					}#else end
 				#跳出迴圈
 				break;
 				}#if end
 			#設置要檢查的session key階層
 			$sa[]=$keyVal;
 			#函式說明:
 			#取得指定的session數值
 			#回傳結果:
 			#$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
 			#$result["error"],錯誤訊息.
 			#$result["founded"],是否有該session變數,"true"代表有,"false"代表沒有.
 			#$result["content"],session變數的內容
 			#$result["argu"],使用的參數.
 			#必填參數:
 			#$conf["key"],字串陣列,session的key名稱與層級.
 			$conf["session::getVal"]["key"]=$sa;
 			$getVal=session::getVal($conf["session::getVal"]);
 			unset($conf["session::getVal"]);
 			#如果取得 session key 的內容失敗
 			if($getVal["status"]==="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置執行錯誤訊息
 				$result["error"]=$getVal;
 				#回傳結果
 				return $result;
 				}#if end
 			#如果 session 不存在
 			if($getVal["founded"]==="false"){
 				#建立該 session 階層並設為空陣列
 				$getVal["address"][$keyVal]=array();
 				#取得當前參照的session階層位址
 				$session=&$getVal["address"][$keyVal];
 				}#if end
 			#如果 session 存在
 			else{
 				#取得當前參照的session階層位址
 				$session=&$getVal["address"];
 				}#else end
 			#層級加一
 			$layer++;
 			}#foreach end
 		#設置執行正常
 		$result["status"]="true";
 		#設置session變數的位址
 		$result["address"]=&$session;
 		#回傳節果
 		return $result;
 		}#function setVal end
 	/*
 	#函式說明:
 	#設置多個session變數的內容
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
 	#$result["error"],錯誤訊息.
 	#$result["founded"],是否有該session變數,"true"代表有,"false"代表沒有.
 	#$result["content"],每個設置好的session變數資訊
 	#$result["function"],當前執行的函數名稱.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function setMultiVal(&$conf){
 		#初始化要回傳的結果
 		$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["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["skipableVariableCanNotBeEmpty"]=array();
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("storeAsNotRepeatArray");
 		#$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("false");
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("key","val");
 		#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["key"]
 		foreach($conf["key"] as $index=>$keyVal){
 			#設置指定的session變數
 			#回傳結果:
 			#$result["status"],執行是否正常,"true"代表正常,"false"代表有誤.
 			#$result["error"],錯誤訊息.
 			#$result["founded"],是否有該session變數,"true"代表有,"false"代表沒有.
 			#$result["content"],session變數的內容
 			$conf["session::setVal"]["key"]=$keyVal;
 			#$conf["val"],任意型態,指定的session變數內容.
 			$conf["session::setVal"]["val"]=$conf["val"][$index];
 			#可省略參數:
 			#$conf["storeAsNotRepeatArray"],字串,"true"代表要將變數內容存成陣列,預設為"false".
 			$conf["session::setVal"]["storeAsNotRepeatArray"]=$conf["storeAsNotRepeatArray"];
 			$setVal=session::setVal($conf["session::setVal"]);
 			unset($conf["session::setVal"]);
 			#如果設置 session 變數失敗
 			if($setVal["status"]==="false"){
 				#設置執行失敗
 				$result["status"]="false";
 				#設置執行錯誤訊息
 				$result["error"]=$setVal;
 				#回傳結果
 				return $result;
 				}#if end
 			#取得設置好的結果
 			$result["content"][]=$setVal;
 			}#foreach end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function setMutiVal end
 	}#session class end
 ?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/session.php – Rev 171 → 226