Subversion Repositories php-qbpwcf

	#產生亂數

	#函式說明:

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

	#回傳的解果：

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

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

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

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

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

	#$result["imgSrcVal"],放在src裏面的圖片位置與名稱.

	#必填參數:

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

	$conf["imgAddressAndName"]="/tmp/notExsit.img";

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

	$conf["fileArgu"]=__FILE__;

	#可省略參數：

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

	#$conf["num"]="8";

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

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

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

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

	#$conf["class"],字串,圖片要套用的css樣式類別.

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

	#$conf["content"],字串陣列,允許的亂數陣列內容,預設爲(1~9 and A~Z).

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

	#參考資料:

	#無.

	#備註:

	#無.

	$validationCode=authenticate::validationCode($conf);

	unset($conf);

	#如果執行失敗

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

		#函式說明:

		#撰寫log

		#回傳結果:

		#$result["status"],狀態,"true"或"false".

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

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

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

		#必填參數:

		#$conf["path"],字串,log檔案的路徑與名稱.

		$conf["path"]=$logFile;

		#$conf["content"],any,要寫的內容,若內容不為字串則會用var_dump的格式寫入.

		$conf["content"]=$validationCode;

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

		$conf["fileArgu"]=__FILE__;

		#可省略參數:

		#$conf["rewrite"],預設為"false",接續寫入;反之"true"代表重新寫入.

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

		#參考資料:

		#無.

		#備註:

		#無.

		$record=logs::record($conf);

		unset($conf);

		#如果寫log失敗

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

			#印出json結果

			echo json_encode($record);

			}#if end

		#結束執行,回傳錯誤代碼1

		exit(1);

		}#if end

	#隨機產生get變數名稱

	$getVarName=$validationCode["randNumberWord"];

	#儲存含有亂數get名稱的from數值

	$from=$getVarName."=server";

	#加密要傳遞的訊息內容

	#函式說明:

	#加密或編碼字串,可以用的方法有sha1,md5,password_sha,qbpwcf,bin2hex,hex2bin,gpg,sha1可以回傳20或40的數值字串,md5可以回傳32個數值字串,password_hash可以回傳60~255個字元.

	#回傳結果:

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

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

	#$result["content"],加密後的結果.

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

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

	#必填參數:

	#$conf["enCodeStr"],any,要加密的字串,陣列,物件.

	$conf["enCodeStr"]=$from;

	#$conf["enCodeType"],"字串",加密或編碼的類型,有"sha1"與"md5"與"p_hash"與"aes256"與"qbpwcf"與"bin2hex"與"hex2bin"與"gpg",8種,"sha1"較耗時;"md5"較快;"p_hash"適用於密碼加密;"aes256"是對稱式加解密;"qbpwcf"是透過先json_encdoe後再urlencode最後再base64_encode後bin2hex的結果;"bin2hex"是依照每個byte的整數數值轉成"00"~"FF"後的結果,反之為"hex2bin";"gpg"是應用gpg進行加解密,需要先有ID對應的key.

	$conf["enCodeType"]="gpg";

	#可省略參數:

	#$conf["sha1Raw"],字串,sha1加密的結果要用20個0與1組合還是要用40位數的16進位數值,"true"代表前者,"false"代表後者,預設為"false".

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

	#$conf["p_hash"],字串,p_hash加密過後的字串,該參數若存在且$conf["enCodeType"]為"p_hash",則代表是要檢查$conf["enCodeStr"]是否為符合$conf["p_hash"]的密碼.

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

	#$conf["keyForAes256"],字串,用來 AES256 加解密的金鑰.

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

	#$conf["aes256Encode"],字串,"true"代表是要加密,"false"代表是要解密.

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

	#$conf["qbpwcfDecode"],字串,若"enCodeType"為"qbpwcf",則預設為"false",代表加密;反之為"true",代表解密.

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

	#$conf["gpgDecrypt"],字串,若"enCodeType"為"gpg",則預設為"false",代表加密;反之為"true",代表解密.

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

	#$conf["gpgId"],字串,若"enCodeType"為"gpg"時,要使用的gpg id,預設為gnupgId.

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

	#參考資料:

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

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

	#password_hash=>http://php.net/manual/en/function.password-hash.php

	#password_verify=>http://php.net/manual/en/function.password-verify.php

	#json_decode=>https://www.php.net/manual/en/function.json-decode.php

	#備註:

	#無.

	$enCodeStr=authenticate::enCodeStr($conf);

	unset($conf);

	#如果執行失敗

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

		#函式說明:

		#撰寫log

		#回傳結果:

		#$result["status"],狀態,"true"或"false".

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

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

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

		#必填參數:

		#$conf["path"],字串,log檔案的路徑與名稱.

		$conf["path"]=$logFile;

		#$conf["content"],any,要寫的內容,若內容不為字串則會用var_dump的格式寫入.

		$conf["content"]=$enCodeStr;

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

		$conf["fileArgu"]=__FILE__;

		#可省略參數:

		#$conf["rewrite"],預設為"false",接續寫入;反之"true"代表重新寫入.

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

		#參考資料:

		#無.

		#備註:

		#無.

		$record=logs::record($conf);

		unset($conf);

		#如果寫log失敗

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

			#印出json結果

			echo json_encode($record);

			}#if end

		#結束執行,回傳錯誤代碼1

		exit(1);

		}#if end

	#取得加密後的from

	$from=$enCodeStr["content"];

	#設置傳送訊息的來源

	$json["from"]=base64_encode($from);