Subversion Repositories php-qbpwcf

<?php

/*

	QBPWCF, Quick Build PHP website Component base on Fedora Linux.

    Copyright (C) 2014~2026 MIN ZHI, CHEN

    This file is part of QBPWCF.

    QBPWCF is free software: you can redistribute it and/or modify

    it under the terms of the GNU General Public License as published by

    the Free Software Foundation, either version 3 of the License, or

    (at your option) any later version.

    QBPWCF is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License

    along with QBPWCF.  If not, see <http://www.gnu.org/licenses/>.

*/

namespace qbpwcf;

/*

類別說明:

檔案存取應用的類別.

備註:

無.

*/

class fileAccess{

	/*

	#函式說明:

	#當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.

	#回傳結果:

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

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

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

	#必填參數:

	#$method,物件,為物件實體或類別名稱,會自動置入該參數.

	#$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"代表不正常.

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

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

	#必填參數:

	#$method,物件,為物件實體或類別名稱,會自動置入該參數.

	#$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

	/*

	#函式說明:

	#將字串寫入到檔案

	#回傳結果:

	#$result["status"],"true"表示檔案寫入成功,"false"表示檔案寫入失敗.

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

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

	#$result["fileInfo"],實際上寫入的檔案資訊陣列.

	#$result["fileInfo"]["createdFileName"],建立好的檔案名稱.

	#$result["fileInfo"]["createdFilePath"],檔案建立的路徑.

	#$result["fileInfo"]["createdFilePathAndName"].建立好的檔案名稱與路徑.

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

	#必填參數:

	#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑

	$conf["fileArgu"]=__FILE__;

	#可省略參數:

	#$conf["fileName"],字串,爲要編輯的檔案名稱,預設為隨機產生的檔案名稱.

	#$conf["fileName"]="";

	#$conf["inputString"],字串,爲要寫入到裏面的內容，若要每筆資料寫入後換行，則可以在字串內容後面加上 \r\n 即可,預設為"".

	#$conf["inputString"]="";

	#$conf["writeMethod"],字串,爲檔案撰寫的方式,可省略,是複寫'a'還是,重新寫入'w',預設爲'w',重新寫入.

	#$conf["writeMethod"]="a";

	#$conf["checkRepeat"],字串,"true"代表建立檔案之前要先檢查檔案是否存在,若存在則在原名稱後面加上從(1)開始的編號.

	#$conf["checkRepeat"]="";

	#$conf["filenameExtensionStartPoint"],字串,檔案的副檔名是從倒數第幾個小數點(dot)開始,預設為"1",最後一個小數點,必須與$conf["checkRepeat"]搭配才會生效.

	#$conf["filenameExtensionStartPoint"]="";

	#$conf["repeatNameRule"],字串,遇到相同名稱的檔案要如何加上識別的編號,編號用「\$i」表示,預設為"(\$i)",必須與$conf["checkRepeat"]搭配才會生效.

	#$conf["repeatNameRule"]="";

	#$conf["web"],檔案是否位於網站上"true",若是在檔案系統則為"false",預設為"true".

	#$conf["web"]="true";

	#參考資料:

	#無.

	#備註:

	#無.

	*/

	public static function writeTextIntoFile(&$conf){

		#初始化要回傳的變數

		$result=array();

		#初始化當前執行的函數名稱

		$result["function"]=__FUNCTION__;

		#如果 $conf 不為陣列

		if(gettype($conf)!="array"){

			#設置執行失敗

			$result["status"]="false";

			#設置執行錯誤訊息

			$result["error"][]="\$conf變數須為陣列形態";

			#如果傳入的參數為 null

			if($conf==null){

				#設置執行錯誤訊息

				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";

				}#if end

			#回傳結果

			return $result;

			}#if end

		#取得使用的參數

		$result["argu"]=$conf;

		#檢查參數

		#函式說明:

		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。

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

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

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

		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過

		#$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在

		#$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確

		#$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息

		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.

		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.

		#$result["notNeedVar"],字串陣列,多餘的參數名稱.

		#必填寫的參數：

		#$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。

		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;

		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");

		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("fileArgu");

		#$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"]="true";

		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");

		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("fileName","inputString","writeMethod","checkRepeat","filenameExtensionStartPoint","repeatNameRule","web");

		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");

		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","string","string","string","string");

		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".

		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,"","w","false",null,null,"true");

		#$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"]);

		#如果 $checkArguments["status"] 等於 "false"

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

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$checkArguments;

			#回傳結果

			return $result;

			}#if end

		#如果 $checkArguments["passed"] 等於 "false"

		if($checkArguments["passed"]=="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$checkArguments;

			#回傳結果

			return $result;

			}#if end

		#如果沒有設置 $conf["fileName"]

		if(!isset($conf["fileName"])){

			#設定要檢查是否有重複的檔案名稱

			$conf["checkRepeat"]="true";

			#亂數產生檔案名稱

			#函式說明:

			#建立以圖片(PNG格式)呈現的驗證碼.

			#回傳的解果：

			#$result["status"],執行是否正常,"true"代表執行成功,"false"代表執行失敗.

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

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

			#$result["randNumberWord"],傳驗證碼的內容.

			#$result["imgAddress"],圖片的位置與名稱.

			#必填參數:

			#$conf["imgAddressAndName"],字串,爲驗證碼圖片儲存的位置與名稱，副檔名程式會自動產生

			$conf["authenticate::validationCode"]["imgAddressAndName"]="don't need!";

			#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑

			$conf["authenticate::validationCode"]["fileArgu"]=$conf["fileArgu"];

			#可省略參數:

			#$conf["num"],字串,爲驗證碼的位數,請輸入阿拉伯數字,預設為"8"位數.

			$conf["authenticate::validationCode"]["num"]="10";

			#$conf["disableImg"],字串,是否要取消驗證碼圖片的輸出,"true"為要取消,預設為"false"為不取消

			$conf["authenticate::validationCode"]["disableImg"]="true";

			#$conf["imgToData"],字串,預設為"true"代表將圖片轉存成base64圖片,並將原始圖片移除;反之為"false"

			#$conf["imgToData"]="true";

			$validationCode=authenticate::validationCode($conf["authenticate::validationCode"]);

			unset($conf["authenticate::validationCode"]);

			#如果亂數產生錯誤

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

				#設置錯誤識別

				$result["status"]="false";

				#設置錯誤訊息

				$result["error"]=$validationCode;

				#回傳結果

				return $result;

				}#if end

			#取得產生的檔案名稱

			$conf["fileName"]=$validationCode["randNumberWord"];

			}#if end

		#剃除 $conf["fileName"] 開頭的 "./"

		#函式說明:

		#移除字串開頭的特定內容

		#回傳的接結果：

		#$result["status"],寄信的情況,若爲"true"，則十之八九沒有問題.

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

		#$result["function"],當前執行的函數.

		#$result["content"],處理好的字串.

		#必填參數:

		#$conf["inputStr"],字串,要檢查並移除開頭有 $conf["keyWords"] 的字串.

		$conf["stringProcess::delKeyWordsInStrHead"]["inputStr"]=$conf["fileName"];

		#$conf["keyWord"],字串,要移除的字串開頭關鍵字.

		$conf["stringProcess::delKeyWordsInStrHead"]["keyWord"]="./";

		#可省略參數:

		#無.

		$delKeyWordsInStrHead=stringProcess::delKeyWordsInStrHead($conf["stringProcess::delKeyWordsInStrHead"]);

		unset($conf["stringProcess::delKeyWordsInStrHead"]);

		#如果處理失敗

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

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$delKeyWordsInStrHead;

			#回傳結果

			return $result;

			}#if end

		#取得處理好的檔案名稱

		$conf["fileName"]=$delKeyWordsInStrHead["content"];

		#函式說明:

		#確保路徑存在.

		#回傳結果:

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

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

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

		#必填參數:

		#$conf["path"],要檢查的路徑

		$conf["fileAccess::validatePath"]["path"]=$conf["fileName"];

		#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑

		$conf["fileAccess::validatePath"]["fileArgu"]=$conf["fileArgu"];

		#可省略參數：

		#$conf["haveFileName"],字串,"true"代表有$conf["path"]檔案名稱,"false"代表$conf["path"]為純路徑,預設為"false".

		$conf["fileAccess::validatePath"]["haveFileName"]="true";

		#$conf["dirPermission"],字串,新建資料夾的權限設定，預設爲0770,亦即擁有者,同群組者可以讀,寫,存取,其他人僅能存取.

		#$conf["dirPermission"]="";

		$conf["fileAccess::validatePath"]["web"]=$conf["web"];

		$validatePath=fileAccess::validatePath($conf["fileAccess::validatePath"]);

		unset($conf["fileAccess::validatePath"]);

		#debug

		#var_dump($validatePath);exit;

		#如果確保路徑失敗

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

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$validatePath;

			#回傳結果

			return $result;

			}#if end

		#如果要檢查是否有同名的檔案

		if($conf["checkRepeat"]=="true"){

			#函式說明:

			#檢查要建立的檔案路徑是否存在，若不存在則建立新檔案,若檔案已存在則會在原檔名後面加上從(1)開始的編號,再度嘗試建立檔案,以避免資料異常.

			#回傳的結果:

			#$result["status"],執行狀態,"true"代表執行正常,"false"代表執行失敗.

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

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

			#$result["createdFileName"],建立好的檔案名稱.

			#$result["createdFilePath"],檔案建立的路徑.

			#$result["createdFilePathAndName"].建立好的檔案名稱與路徑.

			#必填參數:

			#$conf["checkedFileAndPath"],字串陣列,要建立的檔案路徑

			$conf["fileAccess::createFileAfterCheck"]["checkedFileAndPath"]=$conf["fileName"];

			#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑

			$conf["fileAccess::createFileAfterCheck"]["fileArgu"]=$conf["fileArgu"];

			#可省略參數:

			#如果有設定 $conf["filenameExtensionStartPoint"]

			if(isset($conf["filenameExtensionStartPoint"])){

				#$conf["filenameExtensionStartPoint"],字串,檔案的副檔名是從倒數第幾個小數點(dot)開始,預設為"1",最後一個小數點.

				$conf["fileAccess::createFileAfterCheck"]["filenameExtensionStartPoint"]=$conf["filenameExtensionStartPoint"];

				}#if end

			#如果有設定 $conf["repeatNameRule"]

			if(isset($conf["repeatNameRule"])){

				#$conf["repeatNameRule"],字串,遇到相同名稱的檔案要如何加上識別的編號,編號用「\$i」表示,預設為"(\$i)".

				$conf["fileAccess::createFileAfterCheck"]["repeatNameRule"]=$conf["repeatNameRule"];

				}#if end

			#如果有設定 $conf["web"] 參數

			if(isset($conf["web"])){

				$conf["fileAccess::createFileAfterCheck"]["web"]=$conf["web"];

				}#if end

			$createFileAfterCheck=fileAccess::createFileAfterCheck($conf["fileAccess::createFileAfterCheck"]);

			unset($conf["fileAccess::createFileAfterCheck"]);

			#debug

			#var_dump($createFileAfterCheck);

			#exit;

			#如果嘗試建立檔案失敗

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

				#設置執行不正常

				$result["status"]="false";

				#設置錯誤訊息

				$result["error"]=$createFileAfterCheck;

				#回傳結果

				return $result;

				}#if end

			#取得建立的檔案資訊

			$result["fileInfo"]["createdFilePathAndName"]=$createFileAfterCheck["createdFilePathAndName"];

			$result["fileInfo"]["createdFilePath"]=$createFileAfterCheck["createdFilePath"];

			$result["fileInfo"]["createdFileName"]=$createFileAfterCheck["createdFileName"];

			#取得建立好的檔案路徑與名稱

			$conf["fileName"]=$createFileAfterCheck["createdFilePathAndName"];

			}#if end

		#反之沒有要檢查檔案是否存在

		else{

			#取得建立的檔案資訊

			$result["fileInfo"]["createdFilePathAndName"]=$conf["fileName"];

			$result["fileInfo"]["createdFilePath"]=$validatePath["path"];

			$result["fileInfo"]["createdFileName"]=$validatePath["fileName"];

			}#else end

		#設定要寫入或複寫的檔案

		$fileopenResult=fopen($conf["fileName"],$conf["writeMethod"]);

		#如果 $fileopenResult 等於 FALSE

		if($fileopenResult==FALSE){

			#設置錯誤識別

			$result["status"]="false";

			#代表打開檔案失敗

			$result["error"][]="檔案".$conf["fileName"]."開啟失敗";

			#回傳結果

			return $result;

			}#if end

		#將資料寫入到檔案裡面

		$fwriteResult=fwrite($fileopenResult,$conf["inputString"]);

		#如果 $fwriteResult 等於 FALSE

		if($fwriteResult!=0 && $fwriteResult==FALSE){

			#設置錯誤識別

			$result["status"]="false";

			#代表檔案寫入失敗

			$result["error"][]="檔案".$conf["fileName"]."寫入失敗";

			#回傳結果

			return $result;

			}#if end

		#存檔並關閉檔案

		$fcloseResult=fclose($fileopenResult);

		#如果 $fcloseResult 等於 FALSE

		if($fcloseResult==FALSE){

			#設置錯誤識別

			$result["status"]="false";

			#代表檔案寫入失敗

			$result["error"][]="檔案".$conf["fileName"]."儲存失敗";

			#回傳結果

			return $result;

			}#if end

		#檢查用來寫入的檔案是否存在

		#函式說明:檢查多個檔案與資料夾是否存在

		#回傳的結果:

		#$result["varName"][$i]，爲第$i個變數的名稱。

		#$result["varExist"][$i]，爲第$i個變數是否存在，true代表存在，false代表不存在。

		#必填參數:

		$conf["fileAccess::checkMutiFileExist"]["fileArray"]=array($conf["fileName"]);#要檢查書否存在的檔案有哪些，須爲一維陣列數值。

		#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑

		$conf["fileAccess::checkMutiFileExist"]["fileArgu"]=$conf["fileArgu"];

		#$conf["web"],字串,檔案是放在web就是"true",反之為檔案系統"false".

		$conf["fileAccess::checkMutiFileExist"]["web"]=$conf["web"];

		#參考資料來源：

		#http:#php.net/manual/en/function.file-exists.php

		#http:#php.net/manual/en/control-structures.foreach.php

		$fileAccess["checkMutiFileExist"]=fileAccess::checkMultiFileExist($conf["fileAccess::checkMutiFileExist"]);

		unset($conf["fileAccess::checkMutiFileExist"]);

		#如果檢查檔案是否存在失敗

		if($fileAccess["checkMutiFileExist"]["status"]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息陣列

			$result["error"]=$fileAccess["checkMutiFileExist"];

			#回傳結果

			return $result;

			}#if end

		#如果$fileAccess["checkMutiFileExist"]["varExist"][0] 等於 "false"

		if($fileAccess["checkMutiFileExist"]["varExist"][0]==="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$fileAccess["checkMutiFileExist"];

			#設置錯誤訊息陣列

			$result["error"][]="愈建立的檔案不存在";

			#回傳結果

			return $result;

			}#if end

		#函式說明:

		#依據取得檔案的擁有着資訊

		#回傳結果:

		#$result["status"],"true"爲建立成功,"false"爲建立失敗.

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

		#$result["function"],函數名稱.

		#$result["content"],檔案擁有着資訊.

		#$result["content"],檔案資訊陣列.

		#$result["content"]["is_folder"],是否為目錄,"true"代表是,"false"代表不是.

		#$result["content"]["ownerPerm"],檔案擁有者權限資訊.

		#$result["content"]["groupPerm"],檔案歸屬群組權限資訊.

		#$result["content"]["otherPerm"],檔案對於其他身份使用者的權限資訊.

		#$result["content"]["subElementCount"],目錄底下的檔案目錄數量.

		#$result["content"]["ownerName"],檔案擁有着資訊.

		#$result["content"]["groupName"],檔案所屬擁有着資訊.

		#$result["content"]["size"],檔案大小.

		#$result["content"]["modifyDate"],檔案變更年月日.

		#$result["content"]["modifyTime"],檔案變更時分秒.

		#$result["content"]["modifyTimeFloat"],檔案變更時間秒的float數值.

		#$result["content"]["timezone"],檔案變更時間的時區與UTC的差距.

		#必填參數:

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

		$conf["fileAccess::fileInfo"]["fileArgu"]=$conf["fileArgu"];

		#$conf["file"],字串,要查看擁有者資訊的檔案.

		$conf["fileAccess::fileInfo"]["file"]=$conf["fileName"];

		#可省略參數:

		#$conf["fileToRead"],字串,要讀取的檔案名稱為何?預設為"help".

		#$conf["fileToRead"]="help";

		#$conf["output"],字串,輸出的網頁檔案位置與名稱,副檔名html會自動補上,預設為"help".

		#$conf["output"]="help.html";

		#$conf["web"],字串,檔案是放在web就是"true",反之為檔案系統"false".

		$conf["fileAccess::fileInfo"]["web"]=$conf["web"];

		#參考資料:

		#fileowner=>http://php.net/manual/en/function.fileowner.php

		#posix_getpwuid=>http://php.net/manual/en/function.posix-getpwuid.php

		$fileInfo=fileAccess::fileInfo($conf["fileAccess::fileInfo"]);

		unset($conf["fileAccess::fileInfo"]);

		#如果取得檔案資訊失敗

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

			#設置執行失敗

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$fileInfo;

			#回傳結果

			return $result;

			}#if end

		#取得檔案的擁有者名稱

		$fileOwner=$fileInfo["content"]["ownerName"];

		#執行php的帳戶

		$runner=csInformation::runner();

		#如果執行php的使用者等於檔案的擁有者名稱或為root

		if($runner===$fileOwner || $runner==="root"){

			#改變檔案的權限為0770

			chmod($conf["fileName"],0770);

			}#if end

		#執行到這邊代表執行正常

		$result["status"]="true";

		#回傳結果

		return $result;

		}#function writeTextIntoFile end

	/*

	#函式說明:

	#一次建立多個檔案,並寫入內容.

	#回傳結果:

	#$result["status"],"true"表示檔案寫入成功,"false"表示檔案寫入失敗.

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

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

	#$result["content"][i],實際上寫入的第$i+1個檔案資訊陣列.

	#$result["content"][i]["createdFileName"],第$i+1個建立好的檔案名稱.

	#$result["content"][i]["createdFilePath"],第$i+1個檔案建立的路徑.

	#$result["content"][i]["createdFilePathAndName"].第$i+1個建立好的檔案名稱與路徑.

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

	#必填參數:

	#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑

	$conf["fileArgu"]=__FILE__;

	#$conf["fileName"],字串陣列,爲要寫入的多個檔案名稱

	$conf["fileName"]=array("");

	#可省略參數:

	#$conf["inputString"],字串陣列,爲要寫入到各別檔案裏面的內容,預設每個元素為空字串.

	#$conf["inputString"]=array("");

	#參考資料:

	#無.

	#備註:

	#無.

	*/

	public static function writeMultiFile(&$conf){

		#初始化要回傳的變數

		$result=array();

		#初始化當前執行的函數名稱

		$result["function"]=__FUNCTION__;

		#如果 $conf 不為陣列

		if(gettype($conf)!="array"){

			#設置執行失敗

			$result["status"]="false";

			#設置執行錯誤訊息

			$result["error"][]="\$conf變數須為陣列形態";

			#如果傳入的參數為 null

			if($conf==null){

				#設置執行錯誤訊息

				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";

				}#if end

			#回傳結果

			return $result;

			}#if end

		#取得使用的參數

		$result["argu"]=$conf;

		#檢查參數

		#函式說明:

		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。

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

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

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

		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過

		#$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在

		#$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確

		#$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息

		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.

		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.

		#$result["notNeedVar"],字串陣列,多餘的參數名稱.

		#必填寫的參數：

		#$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。

		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;

		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");

		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("fileArgu","fileName");

		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");

		$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"]="true";

		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");

		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("inputString");

		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");

		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array");

		#$conf["variableCheck::checkArguments"]["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("fileName","inputString");

		#參考資料來源:

		#array_keys=>http://php.net/manual/en/function.array-keys.php

		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);

		unset($conf["variableCheck::checkArguments"]);

		#如果 $checkArguments["status"] 等於 "false"

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

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$checkArguments;

			#回傳結果

			return $result;

			}#if end

		#如果 $checkArguments["passed"] 等於 "false"

		if($checkArguments["passed"]=="false"){

			#設置錯誤識別

			$result["status"]="false";

			#設置錯誤訊息

			$result["error"]=$checkArguments;

			#回傳結果

			return $result;

			}#if end

		#如果沒有設定要個別寫入的內容

		if(!isset($conf["inputString"])){

			#針對每個檔案名稱

			for($i=0;$i<count($conf["fileName"]);$i++){

				#建立空的 $conf["inputString"]

				$conf["inputString"][$i]="";

				}#for end

			}#if end

		#針對每個要寫入的檔案

		foreach($conf["fileName"] as $index => $file2writre){

			#取得要寫入的內容

			$content2writre=$conf["inputString"][$index];

			#函式說明:

			#將字串寫入到檔案

			#回傳結果:

			#$result["status"],"true"表示檔案寫入成功,"false"表示檔案寫入失敗.

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

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

			#$result["fileInfo"],實際上寫入的檔案資訊陣列.

			#$result["fileInfo"]["createdFileName"],建立好的檔案名稱.

			#$result["fileInfo"]["createdFilePath"],檔案建立的路徑.

			#$result["fileInfo"]["createdFilePathAndName"].建立好的檔案名稱與路徑.

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

			#必填參數:

			#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑

			$conf["fileAccess::writeTextIntoFile"]["fileArgu"]=$conf["fileArgu"];

			#可省略參數:

			#$conf["fileName"],字串,爲要編輯的檔案名稱,預設為隨機產生的檔案名稱.

			$conf["fileAccess::writeTextIntoFile"]["fileName"]=$file2writre;

			#$conf["inputString"],字串,爲要寫入到裏面的內容，若要每筆資料寫入後換行，則可以在字串內容後面加上 \r\n 即可,預設為"".

			$conf["fileAccess::writeTextIntoFile"]["inputString"]=$content2writre;

			#$conf["writeMethod"],字串,爲檔案撰寫的方式,可省略,是複寫'a'還是,重新寫入'w',預設爲'w',重新寫入.

			#$conf["writeMethod"]="a";

			#$conf["checkRepeat"],字串,"true"代表建立檔案之前要先檢查檔案是否存在,若存在則在原名稱後面加上從(1)開始的編號.

			#$conf["checkRepeat"]="";

			#$conf["filenameExtensionStartPoint"],字串,檔案的副檔名是從倒數第幾個小數點(dot)開始,預設為"1",最後一個小數點,必須與$conf["checkRepeat"]搭配才會生效.

			#$conf["filenameExtensionStartPoint"]="";

			#$conf["repeatNameRule"],字串,遇到相同名稱的檔案要如何加上識別的編號,編號用「\$i」表示,預設為"(\$i)",必須與$conf["checkRepeat"]搭配才會生效.

			#$conf["repeatNameRule"]="";

			#$conf["web"],檔案是否位於網站上"true",若是在檔案系統則為"false",預設為"true".

			$conf["fileAccess::writeTextIntoFile"]["web"]="false";

			#備註:

			#無.

			$writeTextIntoFile=fileAccess::writeTextIntoFile($conf["fileAccess::writeTextIntoFile"]);

			unset($conf["fileAccess::writeTextIntoFile"]);

			#如果建立檔案失敗

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

				#設置錯誤識別

				$result["status"]="false";

				#設置錯誤訊息

				$result["error"]=$writeTextIntoFile;

				#回傳結果

				return $result;

				}#if end

			#設置建立好的檔案資訊

			$result["content"][]=$writeTextIntoFile["fileInfo"];

			}#foreach end

			#設置執行正常

			$result["status"]="true";

			#回傳結果

			return $result;

		}#function writeMultiFile end

	/*

	#函式說明:

	#將多行字串寫入到檔案

	#回傳結果:

	#$result["status"],"true"表示檔案寫入成功,"false"表示檔案寫入失敗.

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

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

	#必填參數:

	#$conf["fileName"],字串,爲要編輯的檔案名稱

	$conf["fileName"]="";

	#$conf["inputString"],字串陣列,爲要寫入到 $conf["fileName"] 裏面的內容. $conf["inputString"][$i] 代表第 $i+1 行。

	$conf["inputString"]=array("");

	#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑

	$conf["fileArgu"]=__FILE__;

	#可省略參數:

	#$conf["writeMethod"],字串,爲檔案撰寫的方式，可省略,是複寫'a'還是，重新寫入'w'，預設爲'w',重新寫入。

	#$conf["writeMethod"]="a";

	#$conf["fastWrite"],字串,“true”代表要一次寫入多行內容;預設為"false"代表一次寫入一行,比較安全,但行數一多會需要等待多時.

	#$conf["fastWrite"]="false";

	#參考資料:

	#無.

	#備註:

	#無.

	*/

	public static function writeMultiLine(&$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"],執行不正常結束的錯訊息陣列.

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

		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過

		#$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在

		#$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確

		#$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息

		#必填寫的參數：

		$conf["variableCheck.isexistMulti"]["varInput"]=$conf;#要檢查的陣列變數

		$conf["variableCheck.isexistMulti"]["variableCheck"]=array("fileName","inputString","fileArgu");#要檢查的變數名稱陣列，形態爲陣列變數，例如: $conf["variableCheck"] = array("id","account","password");

		#可以省略的參數：

		$conf["variableCheck.isexistMulti"]["variableType"]=array("string","array","string");#要檢查的陣列變數內的元素應該爲何種變數形態，形態爲陣列 例如: $conf[variableType] = array("string","int","double");

		$conf["variableCheck.isexistMulti"]["canBeEmptyString"]="false";#變數內容如果是空字串就不能算是有設置的話，請設為"false",預設為也算是有設置。

		$checkResult=variableCheck::isexistMulti($conf["variableCheck.isexistMulti"]);

		unset($conf["variableCheck.isexistMulti"]);

		#如果檢查失敗

		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

		#檢查可省略參數

		#函式說明:

		#檢查一包含數個可省略變數的陣列變數,其型態是否正確,省略掉的陣列變數可以直接給定預設值。

		#回傳結果:

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

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

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

		#$result["passed"],參數是否都通過檢查,"true",代表有通過檢查,"false"代表沒有通過檢查。

		#必填參數:

		#$conf["variableCheck.checkSkipableVarType"]["checkedVar"],陣列,要檢查的變數陣列名稱為？

		$conf["variableCheck.checkSkipableVarType"]["checkedVar"]=$conf;

		#$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"],字串陣列,要檢查型態是否設定正確的變數名稱陣列.

		$conf["variableCheck.checkSkipableVarType"]["sikpableVarNameArray"]=array("writeMethod","fastWrite");

		#$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"],字串陣列,要檢查的每個變數,其型態應該要為何?

		$conf["variableCheck.checkSkipableVarType"]["skipableVarTypeArray"]=array("string","string");

		#$argu,要直接存取的陣列變數名稱,變數前面加上「&」,如果要在別的函式裡面使用本函式,請記得將變動過結果($argu)給使用該函式的設定變數(通常是$conf=$argu).

		$argu=&$conf;

		#可省略參數:

		#$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"],字串陣列,每個不存的變數要初始化為什麼,"null"代表不指定.

		$conf["variableCheck.checkSkipableVarType"]["skipableVarDefaultValue"]=array("w","false");

		#無

		$checkResult=variableCheck::checkSkipableVarType($conf["variableCheck.checkSkipableVarType"],$argu);

		unset($conf["variableCheck.checkSkipableVarType"]);

		#如果檢查不通過

		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