Subversion Repositories php-qbpwcf

Rev

Rev 3 | Rev 226 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 3 Rev 218
Line 3608... Line 3608...
3608
		#設置執行成功
3608
		#設置執行成功
3609
		$result["status"]="true";
3609
		$result["status"]="true";
3610
		
3610
		
3611
		#回傳結果
3611
		#回傳結果
3612
		return $result;
3612
		return $result;
3613
					
3613
		
3614
		}#function randomFromArray end
3614
		}#function randomFromArray end
3615
 
3615
 
3616
	/*
3616
	/*
3617
	#函式說明: 
3617
	#函式說明: 
-
 
3618
	#亂數產生特定陣列裡面的內容,可以多次產生並回傳結果.
-
 
3619
	#回傳結果:
-
 
3620
	#$result["status"],執行正常與否,"true"為正常,"false"為不正常.
-
 
3621
	#$result["function"],當前執行的函數名稱.
-
 
3622
	#$result["error"],錯誤訊息陣列.
-
 
3623
	#$result["argu"],使用的參數.
-
 
3624
	#$result["content"]["name"][$i],陣列,產生的第$n+1個元素在$conf["randomArray"]裡面的key是?
-
 
3625
	#$result["content"]["value"][$i],陣列,產生的第$n+1個元素內容.
-
 
3626
	#$result["content"]["str"],字串,產生的內容透過字串方式串接的結果.
-
 
3627
	#必填參數:
-
 
3628
	#$conf["randomArray"],字串陣列,要隨機產生的元素.
-
 
3629
	$conf["randomArray"]=array();
-
 
3630
	#可省略參數:
-
 
3631
	#$conf["repeatTime"],字串整數,要產生幾次,預設為"1"次.
-
 
3632
	#$conf["repeatTime"]="1";
-
 
3633
	#參考資料:
-
 
3634
	#無.
-
 
3635
	#備註:
-
 
3636
	#無.
-
 
3637
	*/
-
 
3638
	public static function randomFromArrayManyTimes(&$conf){
-
 
3639
	
-
 
3640
		#初始化要回傳的內容
-
 
3641
		$result=array();
-
 
3642
		
-
 
3643
		#記錄當前執行的函數名稱
-
 
3644
		$result["function"]=__FUNCTION__;
-
 
3645
 
-
 
3646
		#如果 $conf 不為陣列
-
 
3647
		if(gettype($conf)!="array"){
-
 
3648
			
-
 
3649
			#設置執行失敗
-
 
3650
			$result["status"]="false";
-
 
3651
			
-
 
3652
			#設置執行錯誤訊息
-
 
3653
			$result["error"][]="\$conf變數須為陣列形態";
-
 
3654
 
-
 
3655
			#如果傳入的參數為 null
-
 
3656
			if($conf==null){
-
 
3657
				
-
 
3658
				#設置執行錯誤訊息
-
 
3659
				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
-
 
3660
				
-
 
3661
				}#if end
-
 
3662
 
-
 
3663
			#回傳結果
-
 
3664
			return $result;
-
 
3665
			
-
 
3666
			}#if end
-
 
3667
			
-
 
3668
		#取得使用的參數
-
 
3669
		$result["argu"]=$conf;
-
 
3670
		
-
 
3671
		#初始化記錄字串串接後的結果
-
 
3672
		$result["content"]["str"]="";
-
 
3673
	
-
 
3674
		#函式說明:
-
 
3675
		#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容.
-
 
3676
		#回傳結果:
-
 
3677
		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
-
 
3678
		#$result["error"],執行不正常結束的錯訊息陣列.
-
 
3679
		#$result["simpleError"],簡單表示的錯誤訊息.
-
 
3680
		#$result["function"],當前執行的函式名稱.
-
 
3681
		#$result["argu"],設置給予的參數.
-
 
3682
		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
-
 
3683
		#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
-
 
3684
		#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
-
 
3685
		#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
-
 
3686
		#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
-
 
3687
		#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
-
 
3688
		#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
-
 
3689
		#$result["notNeedVar"],字串陣列,多餘的參數名稱.
-
 
3690
		#必填參數:
-
 
3691
		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。
-
 
3692
		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
-
 
3693
		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
-
 
3694
		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
-
 
3695
		#可省略參數:
-
 
3696
		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列,形態爲陣列變數,元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
-
 
3697
		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("randomArray");
-
 
3698
		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null、any代表不指定變數形態.其中 resource也包含"resource (closed)".
-
 
3699
		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
-
 
3700
		#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"true",可以為空字串.
-
 
3701
		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
-
 
3702
		#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
-
 
3703
		#$conf["canNotBeEmpty"]=array();
-
 
3704
		#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
-
 
3705
		#$conf["canBeEmpty"]=array();
-
 
3706
		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
-
 
3707
		$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("repeatTime");
-
 
3708
		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");
-
 
3709
		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("repeatTime");
-
 
3710
		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableType"] = array("string",integer,"double");
-
 
3711
		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string");
-
 
3712
		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一,請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
-
 
3713
		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("1");
-
 
3714
		#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
-
 
3715
		#$conf["disallowAllSkipableVarIsEmpty"]="";
-
 
3716
		#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".
-
 
3717
		#$conf["disallowAllSkipableVarIsEmptyArray"]="";
-
 
3718
		#$conf["disallowAllSkipableVarNotExist"],字串,是否不允許每個可省略參數都不存在,預設為"false"代表允許,反之為"true".
-
 
3719
		#$conf["disallowAllSkipableVarNotExist"]="";
-
 
3720
		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
-
 
3721
		#$conf["arrayCountEqualCheck"][]=array();
-
 
3722
		#參考資料:
-
 
3723
		#array_keys=>http://php.net/manual/en/function.array-keys.php
-
 
3724
		#備註:
-
 
3725
		#無.
-
 
3726
		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
-
 
3727
		unset($conf["variableCheck::checkArguments"]);
-
 
3728
	
-
 
3729
		#如果檢查參數失敗
-
 
3730
		if($checkArguments["status"]=="false"){
-
 
3731
			
-
 
3732
			#設置執行失敗
-
 
3733
			$result["status"]="false";
-
 
3734
			
-
 
3735
			#設置執行錯誤訊息
-
 
3736
			$result["error"]=$checkArguments;
-
 
3737
 
-
 
3738
			#回傳結果
-
 
3739
			return $result;
-
 
3740
			
-
 
3741
			}#if end
-
 
3742
 
-
 
3743
		#如果檢查不通過
-
 
3744
		if($checkArguments["passed"]=="false"){
-
 
3745
			
-
 
3746
			#設置執行失敗
-
 
3747
			$result["status"]="false";
-
 
3748
			
-
 
3749
			#設置執行錯誤訊息
-
 
3750
			$result["error"]=$checkArguments;
-
 
3751
 
-
 
3752
			#回傳結果
-
 
3753
			return $result;
-
 
3754
			
-
 
3755
			}#if end
-
 
3756
		
-
 
3757
		#執行 $conf["repeatTime"] 數
-
 
3758
		for($i=0;$i<$conf["repeatTime"];$i++){
-
 
3759
		
-
 
3760
			#函式說明: 
-
 
3761
			#亂數產生特定陣列裡面的內容
-
 
3762
			#回傳結果:
-
 
3763
			#$result["status"],執行正常與否,"true"為正常,"false"為不正常.
-
 
3764
			#$result["function"],當前執行的函數名稱.
-
 
3765
			#$result["error"],錯誤訊息陣列.
-
 
3766
			#$result["content"]["name"],產生的元素在$conf["randomArray"]裡面的key是?
-
 
3767
			#$result["content"]["value"],產生的元素內容.
-
 
3768
			#必填參數:
-
 
3769
			#$conf["randomArray"],字串陣列,要隨機產生的元素.
-
 
3770
			$conf["math::randomFromArray"]["randomArray"]=$conf["randomArray"];
-
 
3771
			#可省略參數:
-
 
3772
			#無
-
 
3773
			#參考資料:
-
 
3774
			#無.
-
 
3775
			#備註:
-
 
3776
			#無.
-
 
3777
			$randomFromArray=math::randomFromArray($conf["math::randomFromArray"]);
-
 
3778
			unset($conf["math::randomFromArray"]);
-
 
3779
			
-
 
3780
			#如果執行異常
-
 
3781
			if($randomFromArray["status"]=="false"){
-
 
3782
				
-
 
3783
				#設置執行失敗
-
 
3784
				$result["status"]="false";
-
 
3785
				
-
 
3786
				#設置執行錯誤訊息
-
 
3787
				$result["error"]=$randomFromArray;
-
 
3788
 
-
 
3789
				#回傳結果
-
 
3790
				return $result;
-
 
3791
				
-
 
3792
				}#if end
-
 
3793
				
-
 
3794
			#取得該次產生元素的key
-
 
3795
			$result["content"]["name"][]=$randomFromArray["content"]["name"];
-
 
3796
			
-
 
3797
			#取得該次產生元素的value
-
 
3798
			$result["content"]["value"][]=$randomFromArray["content"]["value"];
-
 
3799
		
-
 
3800
			#串接該次產生元素的value
-
 
3801
			$result["content"]["str"]=$result["content"]["str"].$randomFromArray["content"]["value"];
-
 
3802
		
-
 
3803
			}#for end
-
 
3804
		
-
 
3805
		#設置結果正常
-
 
3806
		$result["status"]="true";
-
 
3807
	
-
 
3808
		#回傳結果
-
 
3809
		return $result;
-
 
3810
	
-
 
3811
		}#function randomFromArrayManyTimes end
-
 
3812
 
-
 
3813
	/*
-
 
3814
	#函式說明: 
3618
	#左方數值範圍要對應的右方數值範圍
3815
	#左方數值範圍要對應的右方數值範圍
3619
	#回傳結果:
3816
	#回傳結果:
3620
	#$result["status"],執行正常與否,"true"為正常,"false"為不正常.
3817
	#$result["status"],執行正常與否,"true"為正常,"false"為不正常.
3621
	#$result["function"],當前執行的函數名稱.
3818
	#$result["function"],當前執行的函數名稱.
3622
	#$result["error"],錯誤訊息陣列.
3819
	#$result["error"],錯誤訊息陣列.