Subversion Repositories qbpwcf-lib(archive)

Rev

Rev 915 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
1 liveuser 1
<?php
2
 
3
/*
4
 
5
	QBPWCF, Quick Build PHP website Component base on Fedora Linux.
625 liveuser 6
    Copyright (C) 2015~2024 Min-Jhin,Chen
1 liveuser 7
 
8
    This file is part of QBPWCF.
9
 
10
    QBPWCF is free software: you can redistribute it and/or modify
11
    it under the terms of the GNU General Public License as published by
12
    the Free Software Foundation, either version 3 of the License, or
13
    (at your option) any later version.
14
 
15
    QBPWCF is distributed in the hope that it will be useful,
16
    but WITHOUT ANY WARRANTY; without even the implied warranty of
17
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18
    GNU General Public License for more details.
19
 
20
    You should have received a copy of the GNU General Public License
21
    along with QBPWCF.  If not, see <http://www.gnu.org/licenses/>.
22
 
23
*/
24
 
25
#宣告指派命名空間
26
namespace qbpwcf;
27
 
329 liveuser 28
#記錄使用者動作、程式輸出的類別
1 liveuser 29
class record{
30
 
31
	/*
32
	#函式說明:
33
	#當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
34
	#回傳結果:
35
	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
36
	#$reuslt["error"],執行不正常結束的錯訊息陣列.
37
	#$result["function"],當前執行的函式名稱.
38
	#必填參數:
39
	#$method,物件,為物件實體或類別名稱,會自動置入該參數.
40
	#$arguments,陣列,為呼叫方法時所用的參數.
204 liveuser 41
	#可省略參數:
42
	#無.
1 liveuser 43
	#參考資料:
44
	#__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
45
	#備註:
46
	#無
47
	*/
48
	public function __call($method,$arguments){
49
 
50
		#取得當前執行的函式
51
		$result["function"]=__FUNCTION__;
52
 
53
		#設置執行不正常
54
		$result["status"]="false";
55
 
56
		#設置執行錯誤
57
		$result["error"][]=__NAMESPACE__ ."/".$method."() 不存在!";
58
 
59
		#設置所丟入的參數
60
		$result["error"][]=$arguments;
61
 
62
		#回傳結果
63
		return $result;
64
 
65
		}#function __call end
66
 
67
	/*
68
	#函式說明:
69
	#當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
70
	#回傳結果:
71
	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
72
	#$reuslt["error"],執行不正常結束的錯訊息陣列.
73
	#$result["function"],當前執行的函式名稱.
74
	#必填參數:
75
	#$method,物件,為物件實體或類別名稱,會自動置入該參數.
76
	#$arguments,陣列,為呼叫方法時所用的參數.
204 liveuser 77
	#可省略參數:
78
	#無.
1 liveuser 79
	#參考資料:
204 liveuser 80
	#__callStatic=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
1 liveuser 81
	#備註:
82
	#無
83
	*/
84
	public static function __callStatic($method,$arguments){
85
 
86
		#取得當前執行的函式
87
		$result["function"]=__FUNCTION__;
88
 
89
		#設置執行不正常
90
		$result["status"]="false";
91
 
92
		#設置執行錯誤
93
		$result["error"][]="欲呼叫的". __NAMESPACE__ ."/".$method."() 不存在!";
94
 
95
		#設置所丟入的參數
96
		$result["error"][]=$arguments;
97
 
98
		#回傳結果
99
		return $result;
100
 
101
		}#function __callStatic end
102
 
103
	/*
104
	#函式說明:
105
	#記錄當下用戶的瀏覽器與地理位置與時間點等資訊
106
	#回傳結果:
107
	#$result["status"],爲查詢是否成功,若爲"true"則成功,若爲"false"則表示失敗了.
108
	#$result["error"],錯誤訊息.
109
	#$result["sql"],執行的sql語法.
110
	#$result["lastInsertId"],新增資料的id.
111
	#$result["content"],記錄的資訊.
112
	#$result["function"],當前執行的涵式
113
	#必填參數:
114
	#$conf["dbAddress"],字串,爲mysql/mariadb server的位置
115
	$conf["dbAddress"]=$dbAddress;
116
	#$conf["dbAccount"],字串,爲用於連入mysql/mariadb server時要使用的帳號
117
	$conf["dbAccount"]=$dbAccount;
118
	#$conf["fileArgu"],字串,__FILE__的內容.
119
	$conf["fileArgu"]=__FILE__;
120
	#可省略參數:
121
	#$conf["dbName"],字串,存放資料表的資料庫名稱,預設為 "qbpwcf".
122
	#$conf["dbName"]="qbpwcf";
123
	#$conf["dbPassword"],字串,爲連線到mariadb server時要使用的密碼,可省略,若省略則代表不使用密碼
124
	#$conf["dbPassword"]=$dbPassword;#
204 liveuser 125
	#參考資料:
126
	#無.
57 liveuser 127
	#備註:
128
	#無.
1 liveuser 129
	*/
130
	public static function recordUserInfo(&$conf){
131
 
132
		#初始化要回傳的內容
133
		$result=array();
134
 
135
		#取得當前執行的函數名稱
136
		$result["function"]=__FUNCTION__;
137
 
138
		#如果 $conf 不為陣列
139
		if(gettype($conf)!="array"){
140
 
141
			#設置執行失敗
142
			$result["status"]="false";
143
 
144
			#設置執行錯誤訊息
145
			$result["error"][]="\$conf變數須為陣列形態";
146
 
147
			#如果傳入的參數為 null
148
			if($conf==null){
149
 
150
				#設置執行錯誤訊息
151
				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
152
 
153
				}#if end
154
 
155
			#回傳結果
156
			return $result;
157
 
158
			}#if end
159
 
160
		#檢查參數
161
		#函式說明:
162
		#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容。
163
		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
164
		#$reuslt["error"],執行不正常結束的錯訊息陣列.
165
		#$result["function"],當前執行的函式名稱.
166
		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
167
		#$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
168
		#$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
169
		#$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息
170
		#必填寫的參數:
171
		#$conf["variableCheck.checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。
172
		$conf["variableCheck.checkArguments"]["varInput"]=&$conf;
173
		#$conf["variableCheck.checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列,形態爲陣列變數,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
174
		$conf["variableCheck.checkArguments"]["mustBeFilledVariableName"]=array("dbAddress","dbAccount","dbName","fileArgu");
175
		#$conf["variableCheck.checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double"); 
176
		$conf["variableCheck.checkArguments"]["mustBeFilledVariableType"]=array("string","string","string","string");
177
		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
178
		$conf["variableCheck.checkArguments"]["referenceVarKey"]="variableCheck.checkArguments";
179
		#可以省略的參數:
180
		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"false"。
181
		#$conf["canBeEmptyString"]="false";
182
		#$conf["variableCheck.checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");
183
		$conf["variableCheck.checkArguments"]["skipableVariableName"]=array("dbPassword","dbName");
184
		#$conf["variableCheck.checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
185
		$conf["variableCheck.checkArguments"]["skipableVariableType"]=array("string","string");
186
		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定,若預設值是必填參數之一,請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
187
		$conf["variableCheck.checkArguments"]["skipableVarDefaultValue"]=array(null,"qbpwcf");
188
		$checkResult=variableCheck::checkArguments($conf["variableCheck.checkArguments"]);
189
		unset($conf["variableCheck.checkArguments"]);
190
 
191
		#如果 檢查參數 失敗
192
		if($checkResult["status"]=="false"){
193
 
194
			#設置執行不正常
195
			$result["status"]="false";
196
 
197
			#設置執行錯誤
198
			$result["error"]=$checkResult;
199
 
200
			#回傳節果
201
			return $result;
202
 
203
			}#if end
204
 
205
		#如果 檢查參數 不通過
206
		if($checkResult["passed"]=="false"){
207
 
208
			#設置執行不正常
209
			$result["status"]="false";
210
 
211
			#設置執行錯誤
212
			$result["error"]=$checkResult;
213
 
214
			#回傳節果
215
			return $result;
216
 
217
			}#if end
218
 
219
		#涵式說明:
220
		#取得 dns/ip 的地理位置資訊
221
		#回傳結果:
222
		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
223
		#$result["error"],錯誤訊息陣列.
224
		#$result["function"],當前執行的函式名稱.
225
		#$result["content"],取得的回應內容.
226
		#必填參數:
227
		#$conf["fileArgu"],字串,__FILE__的內容.
228
		$conf["csInformation::getIpGeo"]["fileArgu"]=$conf["fileArgu"];
229
		#可省略參數:
230
		#$conf["addr"],字串,dns或ip.
231
		#$conf["addr"]="";
232
		#備註:
233
		#請檢查參數
234
		$getIpGeo=csInformation::getIpGeo($conf["csInformation::getIpGeo"]);
235
		unset($conf["csInformation::getIpGeo"]);
236
 
237
		#如果取得 geo 資訊失敗
238
		if($getIpGeo["status"]==="false"){
239
 
240
			#設置執行失敗
241
			$result["status"]="false";
242
 
243
			#設置執行錯誤
244
			$result["error"]=$getIpGeo;
245
 
246
			#回傳結果
247
			return $result;
248
 
249
			}#if end
250
 
251
		#取得地理位置資訊
252
		$geoJson=$getIpGeo["content"];
253
 
254
		#設置geo參數
255
		$result["content"]["geo"]=$geoJson;
256
 
257
		#取得瀏覽器的資訊
258
		#涵式說明:
259
		#取得用戶端的瀏覽器版本資訊,並回傳。
260
		#回傳結果:
261
		#$result,瀏覽器的資訊
262
		$getUserBrowserType=csInformation::getUserBrowserType();
263
 
264
		#設置瀏覽器資訊
265
		$result["content"]["agent"]=$getUserBrowserType;
266
 
267
		#記錄當下要求的頁面等資訊
268
		$result["content"]["_SERVER"]=$_SERVER;
269
 
270
		#設置當下的時間點(無時區)
271
		$result["content"]["time"]=time();
272
 
273
		#涵式說明:
274
		#插入資料到指定的資料表裡面,插入資料完畢可以選擇是否要進行轉址。
275
		#回傳的數值:	
276
		#$result["status"],爲查詢是否成功,若爲"true"則成功,若爲"false"則表示失敗了.
277
		#$result["error"],錯誤訊息.
278
		#$result["sql"],執行的sql語法.
279
		#$result["lastInsertId"],新增的資料id.
280
		#$result["function"],當前執行的涵式
281
		#必填的參數:
282
		$conf["db::insertData"]["dbAddress"]=$conf["dbAddress"];#爲mysql-Server的位置
283
		$conf["db::insertData"]["dbAccount"]=$conf["dbAccount"];#爲用於連入mysql-Server時要使用的帳號
284
		$conf["db::insertData"]["selectedDataBaseName"]=$conf["dbName"];#要選取的資料庫名稱	
285
		$conf["db::insertData"]["tableName"]="call_record";#爲要插入資料的資料表名稱
286
		$conf["db::insertData"]["columnName"]=array("json");#爲資料表的項目名稱,
287
			#例如:$conf["columnName"]=array("columnName1","columnName2","columnName3",...);
288
		$conf["db::insertData"]["insertValue"]=array(json_encode($result["content"]));#爲要插入度數值,
289
			#例如:$conf["insertValue"]=array("insertValue1","insertValue2","insertValue3",...);
290
		#可以省略的變數:
291
 
292
		#如果有設置密碼
293
		if(isset($conf["dbPassword"])){
294
 
295
			#設置密碼
296
			$conf["db::insertData"]["dbPassword"]=$conf["dbPassword"];#爲連線到mysql-Server時要使用的密碼,可省略,若省略則代表不使用密碼
297
 
298
			}#if end
299
 
300
		#參考資料來源:
301
		#http://www.javaworld.com.tw/jute/post/view?bid=21&id=173738&sty=1
302
		$insertData=db::insertData($conf["db::insertData"]);
303
		unset($conf["db::insertData"]);
304
 
305
		#如果新增資料失敗
306
		if($insertData["status"]==="false"){
307
 
308
			#設置執行失敗
309
			$result["status"]="false";
310
 
311
			#設置執行錯誤
312
			$result["error"]=$inserData;
313
 
314
			#回傳結果
315
			return $result;
316
 
317
			}#if end
318
 
319
		#新增的資料id.
320
		$result["lastInsertId"]=$insertData["lastInsertId"];
321
 
322
		#新增的資料id.
323
		$result["sql"]=$insertData["sql"];
324
 
325
		#設置執行正常
326
		$result["status"]="true";
327
 
328
		#回傳結果
329
		return $result;
330
 
331
		}#function recordUserInfo end
332
 
329 liveuser 333
	/*
334
	#函式說明:
357 liveuser 335
	#記錄程式輸出的結果.
329 liveuser 336
	#回傳結果:
337
	#$result["status"],爲查詢是否成功,若爲"true"則成功,若爲"false"則表示失敗了.
338
	#$result["error"],錯誤訊息.
339
	#$result["content"],程式的輸出.
340
	#$result["function"],當前執行的涵式
341
	#必填參數:
342
	#$conf["code2run"],字串陣列,爲要運行的程式內容,每個元素代表一段php程式.內容不必含有php tag,但結尾必須為「;」.
343
	$conf["code2run"]=array();
344
	#可省略參數:
359 liveuser 345
	#$conf["varPassed"],陣列,為要使用到的變數,在code2run參數裡面"\$varPassed[n]"代表第n+1個變數.
346
	#$conf["varPassed"]=array();
329 liveuser 347
	#參考資料:
348
	#無.
349
	#備註:
350
	#無.
351
	*/
352
	public static function getOutput(&$conf){
353
 
354
		#初始化要回傳的內容
355
		$result=array();
356
 
357
		#取得當前執行的函數名稱
358
		$result["function"]=__FUNCTION__;
359
 
360
		#如果 $conf 不為陣列
361
		if(gettype($conf)!="array"){
362
 
363
			#設置執行失敗
364
			$result["status"]="false";
365
 
366
			#設置執行錯誤訊息
367
			$result["error"][]="\$conf變數須為陣列形態";
368
 
369
			#如果傳入的參數為 null
370
			if($conf==null){
371
 
372
				#設置執行錯誤訊息
373
				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
374
 
375
				}#if end
376
 
377
			#回傳結果
378
			return $result;
379
 
380
			}#if end
381
 
382
		#檢查參數
383
		#函式說明:
384
		#檢查必填與可省略的參數,可省略參數可指定預設要給與什麼數值內容。
385
		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
386
		#$reuslt["error"],執行不正常結束的錯訊息陣列.
387
		#$result["function"],當前執行的函式名稱.
388
		#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
389
		#$result[$shouldBtCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
390
		#$result[$shouldBtCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
391
		#$result[$shouldBtCheckedVarName]["error"],每個參數設定的錯誤訊息
392
		#必填寫的參數:
393
		#$conf["variableCheck.checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&,這樣變動的結果才能被套用。
394
		$conf["variableCheck.checkArguments"]["varInput"]=&$conf;
395
		#$conf["variableCheck.checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列,形態爲陣列變數,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
396
		$conf["variableCheck.checkArguments"]["mustBeFilledVariableName"]=array("code2run");
397
		#$conf["variableCheck.checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態,形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double"); 
398
		$conf["variableCheck.checkArguments"]["mustBeFilledVariableType"]=array("array");
399
		#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
400
		$conf["variableCheck.checkArguments"]["referenceVarKey"]="variableCheck.checkArguments";
401
		#可以省略的參數:
402
		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話,請設為"false",預設爲"false"。
403
		#$conf["canBeEmptyString"]="false";
404
		#$conf["variableCheck.checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableName"] = array("id","account","password");
359 liveuser 405
		$conf["variableCheck.checkArguments"]["skipableVariableName"]=array("varPassed");
329 liveuser 406
		#$conf["variableCheck.checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列,形態爲陣列變數,例如: $conf["skipableVariableType"] = array("string",integer,"double"); 
359 liveuser 407
		$conf["variableCheck.checkArguments"]["skipableVariableType"]=array(null);
329 liveuser 408
		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,"null"代表不指定,若預設值是必填參數之一,請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
359 liveuser 409
		$conf["variableCheck.checkArguments"]["skipableVarDefaultValue"]=array(null);
329 liveuser 410
		$checkArguments=variableCheck::checkArguments($conf["variableCheck.checkArguments"]);
411
		unset($conf["variableCheck.checkArguments"]);
412
 
413
		#如果 檢查參數 失敗
414
		if($checkArguments["status"]==="false"){
415
 
416
			#設置執行不正常
417
			$result["status"]="false";
418
 
419
			#設置執行錯誤
420
			$result["error"]=$checkArguments;
421
 
422
			#回傳節果
423
			return $result;
424
 
425
			}#if end
426
 
427
		#如果 檢查參數 不通過
428
		if($checkArguments["passed"]==="false"){
429
 
430
			#設置執行不正常
431
			$result["status"]="false";
432
 
433
			#設置執行錯誤
434
			$result["error"]=$checkArguments;
435
 
436
			#回傳節果
437
			return $result;
438
 
439
			}#if end
440
 
441
		#開始將輸出存入buffer
442
		ob_start();
443
 
359 liveuser 444
		#取得要在eval中使用的變數
445
		$varPassed=&$conf["varPassed"];
446
 
329 liveuser 447
		#針對每段要執行的程式
448
		foreach($conf["code2run"] as $phpCode){
449
 
357 liveuser 450
			#如果不是字串
451
			if(gettype($phpCode)!=="string"){
452
 
453
				#設置執行不正常
454
				$result["status"]="false";
455
 
456
				#設置執行錯誤
457
				$result["error"]="element of code2run should be String";
458
 
459
				#回傳節果
460
				return $result;
461
 
462
				}#if end
463
 
464
			#若不為「;」結尾
465
			if($phpCode[strlen($phpCode)-1]!==";"){
466
 
467
				#設置執行不正常
468
				$result["status"]="false";
469
 
470
				#設置執行錯誤
471
				$result["error"]="element of code2run should be end with 「;」";
472
 
473
				#回傳節果
474
				return $result;
475
 
476
				}#if end
477
 
329 liveuser 478
			#運行php程式
479
			eval($phpCode);
480
 
481
			}#foreach end
482
 
483
		#取得buffer的內容
484
		$result["content"]=ob_get_contents();
485
 
486
		#清空buffer,結束buffer的使用
487
		ob_end_clean();
488
 
489
		#設置執行正常
490
		$result["status"]="true";
491
 
492
		#回傳結果
493
		return $result;
494
 
495
		}#function getOutput end
496
 
1 liveuser 497
	}#class record end
498
 
499
?>