| 1 |
liveuser |
1 |
<?php
|
|
|
2 |
|
|
|
3 |
/*
|
|
|
4 |
QBPWCF, Quick Build PHP website Component base on Fedora Linux.
|
|
|
5 |
Copyright (C) 2015~2023 Min-Jhin,Chen
|
|
|
6 |
|
|
|
7 |
This file is part of QBPWCF.
|
|
|
8 |
|
|
|
9 |
QBPWCF is free software: you can redistribute it and/or modify
|
|
|
10 |
it under the terms of the GNU General Public License as published by
|
|
|
11 |
the Free Software Foundation, either version 3 of the License, or
|
|
|
12 |
(at your option) any later version.
|
|
|
13 |
|
|
|
14 |
QBPWCF is distributed in the hope that it will be useful,
|
|
|
15 |
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
16 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
17 |
GNU General Public License for more details.
|
|
|
18 |
|
|
|
19 |
You should have received a copy of the GNU General Public License
|
|
|
20 |
along with QBPWCF. If not, see <http://www.gnu.org/licenses/>.
|
|
|
21 |
|
|
|
22 |
*/
|
|
|
23 |
|
|
|
24 |
/*
|
|
|
25 |
|
|
|
26 |
抓取資料庫資料
|
|
|
27 |
|
|
|
28 |
*/
|
|
|
29 |
|
|
|
30 |
#使用命名空間qbpwcf
|
|
|
31 |
namespace qbpwcf;
|
|
|
32 |
|
|
|
33 |
#初始化輸出
|
|
|
34 |
$output=array();
|
|
|
35 |
|
|
|
36 |
#取得 lib path
|
| 106 |
liveuser |
37 |
exec("php -f ".escapeshellarg(pathinfo(__FILE__)["dirname"]."/../../../../../usr/bin/libexec/folderOfUsrLib.php"),$output,$status);
|
| 1 |
liveuser |
38 |
|
|
|
39 |
#如果執行失敗
|
|
|
40 |
if($status!==0){
|
|
|
41 |
|
|
|
42 |
#debug
|
|
|
43 |
var_dump(__LINE__,$output);
|
|
|
44 |
|
|
|
45 |
#結束執行,回傳shell 1.
|
|
|
46 |
exit(1);
|
|
|
47 |
|
|
|
48 |
}#if end
|
|
|
49 |
|
|
|
50 |
#儲存lib path
|
|
|
51 |
$folderOfUsrLib=$output[0];
|
|
|
52 |
|
|
|
53 |
#初始化輸出
|
|
|
54 |
$output=array();
|
|
|
55 |
|
|
|
56 |
#以該檔案的實際位置的 lib path 為 include path 首位
|
| 106 |
liveuser |
57 |
exec("cd ".pathinfo(__FILE__)["dirname"]."/../../../../../usr/".$folderOfUsrLib."/qbpwcf;pwd;",$output,$status);
|
| 1 |
liveuser |
58 |
set_include_path($output[0].PATH_SEPARATOR.get_include_path());
|
|
|
59 |
|
|
|
60 |
#匯入外部套件
|
|
|
61 |
include("allInOneForJson.php");
|
|
|
62 |
|
|
|
63 |
#建議的log位置
|
|
|
64 |
$logFile=$_SERVER["DOCUMENT_ROOT"].$_SERVER["PHP_SELF"].".log";
|
|
|
65 |
|
|
|
66 |
/*
|
|
|
67 |
|
|
|
68 |
# test case - 1 - start
|
|
|
69 |
|
|
|
70 |
$params=array();
|
|
|
71 |
$params["dbSecret"]="";
|
|
|
72 |
$params["dbAddr"]="localhost";
|
|
|
73 |
$params["dbPort"]="3306";
|
|
|
74 |
$params["dbName"]="test";
|
|
|
75 |
$params["dbUser"]="test";
|
|
|
76 |
$params["dbPass"]="test";
|
|
|
77 |
$params["dtName"]="member";
|
|
|
78 |
$params["cols"]=array("*");
|
|
|
79 |
#$params["WhereColumnName"];
|
|
|
80 |
#$params["WhereColumnValue"];
|
|
|
81 |
#$params["WhereColumnOperator"];
|
|
|
82 |
#$params["orderItem"];
|
|
|
83 |
#$params["ascORdesc"];
|
|
|
84 |
#$params["numLimit"];
|
|
|
85 |
#$params["numberStart"];
|
|
|
86 |
|
|
|
87 |
#設置參數
|
|
|
88 |
$_POST["params"]=base64_encode(urlencode(json_encode($params)));
|
|
|
89 |
|
|
|
90 |
# test case - 1 - end
|
|
|
91 |
|
|
|
92 |
*/
|
|
|
93 |
|
|
|
94 |
#涵式說明：
|
|
|
95 |
#可以處理多個透過GET、POST而來的資訊，儲存成變數，同時限定傳送的方法、來源，來增加安全性，檢查有沒有皆收到必須要接收到的變數,沒有接收到的變數可以指定從session變數中取得.
|
|
|
96 |
#回傳的結果：
|
|
|
97 |
#$result["status"],執行正常與否,"true"代表正常,"false"代表不正常.
|
|
|
98 |
#$result["error"],錯誤訊息陣列.
|
|
|
99 |
#$resutl["function"],當前執行的涵式名稱.
|
|
|
100 |
#$result["warning"],警告訊息陣列.
|
|
|
101 |
#$result["passed"],是否有皆收到全部該接收到的變數，若有設定$conf["checkedVarName"]的話，執行正常後會回傳該結果。
|
|
|
102 |
#$result["lostVarName"],沒有皆收到的變數名稱陣列
|
|
|
103 |
#$result["inputDataContent"],所接收的參數陣列.
|
|
|
104 |
#$result["inputDataContent"]["變數名稱"]，所接收變數的內容.
|
|
|
105 |
#$result["inputDataCount"],從表單總共接收到幾個元素.
|
|
|
106 |
#$result["HTTP_REFERER"],前一頁的網址,null代表不存在.
|
|
|
107 |
#必填的參數:
|
|
|
108 |
#$conf["method"],字串,傳送過來的資料是用"post/POST"還是"get/GET"?
|
|
|
109 |
$conf["method"]="POST";
|
|
|
110 |
#可省略的參數：
|
|
|
111 |
#$conf["allowGet"],字串,是否要允許 get 傳值，"true"，代表允許；"false" ，代表不允許，預設爲不允許.
|
|
|
112 |
#$conf["allowGet"]="true";
|
|
|
113 |
#$conf["limitPrePage"],字串陣列,是否要限定前一頁的網址為哪些，才能接收內容，不符合則轉址.
|
|
|
114 |
#$conf["limitPrePage"]=array("");
|
|
|
115 |
#$conf["transferLocation"],字串,遇到get傳值，或前一個頁面不符合要求時要轉址到的頁面，預設爲資安素養網"https://isafe.moe.edu.tw/"
|
|
|
116 |
#$conf["transferLocation"]="";
|
|
|
117 |
#$conf["ignore"]=字串陣列,如果要接收的變數名稱與該陣列其一元素一樣,則不放進要回傳的變數裏面.
|
|
|
118 |
#$conf["ignore"]=array();
|
|
|
119 |
#$conf["correctCharacter"]=,字串,如果爲"false"，則不處理可能導致網頁出問題的字串，預設爲要進行處理.
|
|
|
120 |
#$conf["correctCharacter"]="false";
|
|
|
121 |
#$conf["checkedVarName"],字串陣列,為檢查是否有接收到哪些變數.
|
|
|
122 |
$conf["checkedVarName"]=array("params");
|
|
|
123 |
#$conf["canBeEmptyString"],字串,用$conf["checkedVarName"]指定接收的變數名稱陣列,若接收到的內容為空字串是否算有接收到內容,預設為"false","true"代表接收到的內容可以為空字串,"false"代表接收到的內容不可以為空字串.
|
|
|
124 |
#$conf["canBeEmptyString"]="false";
|
|
|
125 |
#$conf["sessionNameArray"],陣列,若存在則代表若沒有從表單取得變數,則從session變數中取得內容,每個元素代表每個表單變數對應的session名稱,若不是要改用session方式取得變數內容的變數,請輸入null,數量請跟$conf["checkedVarName"]參數一致.
|
|
|
126 |
#$conf["sessionNameArray"]=array();
|
|
|
127 |
#$conf["unsetSessionArray"],陣列,與$conf["sessionNameArray"]對應的元素,是否要接收到變數後就卸除,"true"代表要卸除,"false"代表不要卸除.
|
|
|
128 |
#$conf["unsetSessionArray"]=array();
|
|
|
129 |
#$conf["recaptcha_url"],字串,有內容代表要檢查有無透過recaptcha於特定頁面網址認證過.
|
|
|
130 |
#$conf["recaptcha_url"]="";
|
|
|
131 |
#參考資料來源：
|
|
|
132 |
#foreach 的用法 -> http://php.net/manual/en/control-structures.foreach.php
|
|
|
133 |
#伺服器端的變數 -> http://php.net/manual/en/reserved.variables.server.php
|
|
|
134 |
#備註：
|
|
|
135 |
#表單變數的名稱若含有「.」，則會變成「-」。
|
|
|
136 |
$responseMultiInputDataSecurityEnhance=form::responseMultiInputDataSecurityEnhance($conf);
|
|
|
137 |
unset($conf);
|
|
|
138 |
|
|
|
139 |
#函式說明:
|
|
|
140 |
#撰寫log
|
|
|
141 |
#回傳結果:
|
|
|
142 |
#$result["status"],狀態,"true"或"false".
|
|
|
143 |
#$result["error"],錯誤訊息陣列.
|
|
|
144 |
#$result["function"],當前函式的名稱.
|
|
|
145 |
#$result["argu"],使用的參數.
|
|
|
146 |
#必填參數:
|
|
|
147 |
#$conf["path"],log檔案的路徑與名稱.
|
|
|
148 |
$conf["path"]=$logFile;
|
|
|
149 |
#$conf["content"],字串,要寫的內容.
|
|
|
150 |
$conf["content"]=json_encode($responseMultiInputDataSecurityEnhance).PHP_EOL;
|
|
|
151 |
#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
|
|
|
152 |
$conf["fileArgu"]=__FILE__;
|
|
|
153 |
#可省略參數:
|
|
|
154 |
#$conf["rewrite"],預設為"false",接續寫入;反之"true"代表重新寫入.
|
|
|
155 |
#$conf["rewrite"]="false";
|
|
|
156 |
#參考資料:
|
|
|
157 |
#無.
|
|
|
158 |
#備註:
|
|
|
159 |
#無.
|
|
|
160 |
$record=logs::record($conf);
|
|
|
161 |
unset($conf);
|
|
|
162 |
|
|
|
163 |
#如果寫log 失敗
|
|
|
164 |
if($record["status"]==="false"){
|
|
|
165 |
|
|
|
166 |
#印出訊息
|
|
|
167 |
echo json_encode($record);
|
|
|
168 |
|
|
|
169 |
#結束執行
|
|
|
170 |
exit;
|
|
|
171 |
|
|
|
172 |
}#if end
|
|
|
173 |
|
|
|
174 |
#如果執行失敗
|
|
|
175 |
if($responseMultiInputDataSecurityEnhance["status"]==="false"){
|
|
|
176 |
|
|
|
177 |
#印出訊息
|
|
|
178 |
echo json_encode($responseMultiInputDataSecurityEnhance);
|
|
|
179 |
|
|
|
180 |
#結束執行
|
|
|
181 |
exit;
|
|
|
182 |
|
|
|
183 |
}#if end
|
|
|
184 |
|
|
|
185 |
#如果邊數檢查不通過
|
|
|
186 |
if($responseMultiInputDataSecurityEnhance["passed"]==="false"){
|
|
|
187 |
|
|
|
188 |
#印出訊息
|
|
|
189 |
echo json_encode($responseMultiInputDataSecurityEnhance);
|
|
|
190 |
|
|
|
191 |
#結束執行
|
|
|
192 |
exit;
|
|
|
193 |
|
|
|
194 |
}#if end
|
|
|
195 |
|
|
|
196 |
#取得參數
|
|
|
197 |
$params=$responseMultiInputDataSecurityEnhance["inputDataContent"]["params"];
|
|
|
198 |
|
|
|
199 |
#解析變數
|
|
|
200 |
$params=json_decode(urldecode(base64_decode($params)));
|
|
|
201 |
|
|
|
202 |
#轉換為陣列
|
|
|
203 |
$params=(array)$params;
|
|
|
204 |
|
|
|
205 |
#函式說明:
|
|
|
206 |
#撰寫log
|
|
|
207 |
#回傳結果:
|
|
|
208 |
#$result["status"],狀態,"true"或"false".
|
|
|
209 |
#$result["error"],錯誤訊息陣列.
|
|
|
210 |
#$result["function"],當前函式的名稱.
|
|
|
211 |
#$result["argu"],使用的參數.
|
|
|
212 |
#必填參數:
|
|
|
213 |
#$conf["path"],log檔案的路徑與名稱.
|
|
|
214 |
$conf["path"]=$logFile;
|
|
|
215 |
#$conf["content"],字串,要寫的內容.
|
|
|
216 |
$conf["content"]=json_encode($params).PHP_EOL;
|
|
|
217 |
#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
|
|
|
218 |
$conf["fileArgu"]=__FILE__;
|
|
|
219 |
#可省略參數:
|
|
|
220 |
#$conf["rewrite"],預設為"false",接續寫入;反之"true"代表重新寫入.
|
|
|
221 |
#$conf["rewrite"]="false";
|
|
|
222 |
#參考資料:
|
|
|
223 |
#無.
|
|
|
224 |
#備註:
|
|
|
225 |
#無.
|
|
|
226 |
$record=logs::record($conf);
|
|
|
227 |
unset($conf);
|
|
|
228 |
|
|
|
229 |
#如果寫log 失敗
|
|
|
230 |
if($record["status"]==="false"){
|
|
|
231 |
|
|
|
232 |
#印出訊息
|
|
|
233 |
echo json_encode($record);
|
|
|
234 |
|
|
|
235 |
#結束執行
|
|
|
236 |
exit;
|
|
|
237 |
|
|
|
238 |
}#if end
|
|
|
239 |
|
|
|
240 |
#如果少了使用資料庫系統的dbSecret
|
|
|
241 |
if(!isset($params["dbSecret"])){
|
|
|
242 |
|
|
|
243 |
#結束執行
|
|
|
244 |
exit;
|
|
|
245 |
|
|
|
246 |
}#if end
|
|
|
247 |
|
|
|
248 |
#驗證密碼是否正確
|
|
|
249 |
else{
|
|
|
250 |
|
|
|
251 |
#若dbSecret錯誤
|
|
|
252 |
if($params["dbSecret"]!==dbSecret){
|
|
|
253 |
|
|
|
254 |
#結束執行
|
|
|
255 |
exit;
|
|
|
256 |
|
|
|
257 |
}#if end
|
|
|
258 |
|
|
|
259 |
#移除傳遞的 dbSecret
|
|
|
260 |
unset($params["dbSecret"]);
|
|
|
261 |
|
|
|
262 |
}#else end
|
|
|
263 |
|
|
|
264 |
#檢查變數
|
|
|
265 |
#函式說明:
|
|
|
266 |
#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
|
|
|
267 |
#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
|
|
|
268 |
#$reuslt["error"],執行不正常結束的錯訊息陣列.
|
|
|
269 |
#$result["function"],當前執行的函式名稱.
|
|
|
270 |
#$result["argu"],設置給予的參數.
|
|
|
271 |
#$result["passed"],識別要檢查的全體變數是否存在以及型態是否正確的變數,"true"代表檢查全部通過;"false"代表檢查不通過
|
|
|
272 |
#$result[$shouldBeCheckedVarName]["varExist"],所檢查的變數是否存在,"false"代表不存在;"true"代表存在
|
|
|
273 |
#$result[$shouldBeCheckedVarName]["varType"],所檢查的變數型態是否正確,"false"代表錯誤;"true"代表正確
|
|
|
274 |
#$result[$shouldBeCheckedVarName]["error"],每個參數設定的錯誤訊息
|
|
|
275 |
#$result["shouldNotBeEmpty"],不應該為空字串或控陣列的變數.
|
|
|
276 |
#$result["argu"],字串陣列,目前輸入的參數名稱陣列.
|
|
|
277 |
#$result["legalVarName"],字串陣列,合法可用的參數名稱陣列.
|
|
|
278 |
#$result["notNeedVar"],字串陣列,多餘的參數名稱.
|
|
|
279 |
#必填寫的參數:
|
|
|
280 |
#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
|
|
|
281 |
$conf["variableCheck::checkArguments"]["varInput"]=&$params;
|
|
|
282 |
#$conf["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
|
|
|
283 |
$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
|
|
|
284 |
#可以省略的參數:
|
|
|
285 |
#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，元素數量需要跟"mustBeFilledVariableType"參數的元素數量一致,例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
|
|
|
286 |
$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("dbAddr","dbName","dbUser","dbPass","dtName","cols");
|
|
|
287 |
#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列,元素數量需要跟"mustBeFilledVariableName"參數的元素數量一致,例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double","resource","object"); , null代表不指定變數形態.
|
|
|
288 |
$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string","string","string","array");
|
|
|
289 |
#$conf["canBeEmptyString"],字串,必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true",可以為空字串.
|
|
|
290 |
$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
|
|
|
291 |
#$conf["canNotBeEmpty"],字串陣列,哪些必填參數的內容不得為空字串或空陣列,僅當$conf["canBeEmptyString"]為"true"時會生效.
|
|
|
292 |
#$conf["canNotBeEmpty"]=array();
|
|
|
293 |
#$conf["canBeEmpty"],字串陣列,哪些必填參數的內容可為空字串或空陣列,僅當$conf["canBeEmptyString"]為"false"時會生效.
|
|
|
294 |
#$conf["canBeEmpty"]=array();
|
|
|
295 |
#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
|
|
|
296 |
$conf["variableCheck::checkArguments"]["skipableVariableCanNotBeEmpty"]=array("dbPort","orderItem","ascORdesc","numLimit","WhereColumnName","WhereColumnValue","WhereColumnOperator","numberStart");
|
|
|
297 |
#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
|
|
|
298 |
$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("dbPort","orderItem","ascORdesc","numLimit","WhereColumnName","WhereColumnValue","WhereColumnOperator","numberStart");
|
|
|
299 |
#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
|
|
|
300 |
$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string","string","array","array","array","string");
|
|
|
301 |
#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
|
|
|
302 |
$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("3306",null,null,null,null,null,null,"0");
|
|
|
303 |
#$conf["disallowAllSkipableVarIsEmpty"],字串,是否允許每個可省略參數都為空字串,預設為"true"允許,反之為"false".
|
|
|
304 |
#$conf["disallowAllSkipableVarIsEmpty"]="";
|
|
|
305 |
#$conf["disallowAllSkipableVarIsEmptyArray"],字串,是否允許每個可省略參數都為空陣列,預設為"true"允許,反之為"false".
|
|
|
306 |
#$conf["disallowAllSkipableVarIsEmptyArray"]="";
|
|
|
307 |
#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
|
|
|
308 |
$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("cols","vals");
|
|
|
309 |
#參考資料來源:
|
|
|
310 |
#array_keys=>http://php.net/manual/en/function.array-keys.php
|
|
|
311 |
$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
|
|
|
312 |
unset($conf["variableCheck::checkArguments"]);
|
|
|
313 |
|
|
|
314 |
#函式說明:
|
|
|
315 |
#撰寫log
|
|
|
316 |
#回傳結果:
|
|
|
317 |
#$result["status"],狀態,"true"或"false".
|
|
|
318 |
#$result["error"],錯誤訊息陣列.
|
|
|
319 |
#$result["function"],當前函式的名稱.
|
|
|
320 |
#$result["argu"],使用的參數.
|
|
|
321 |
#必填參數:
|
|
|
322 |
#$conf["path"],log檔案的路徑與名稱.
|
|
|
323 |
$conf["path"]=$logFile;
|
|
|
324 |
#$conf["content"],字串,要寫的內容.
|
|
|
325 |
$conf["content"]=json_encode($checkArguments).PHP_EOL;
|
|
|
326 |
#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
|
|
|
327 |
$conf["fileArgu"]=__FILE__;
|
|
|
328 |
#可省略參數:
|
|
|
329 |
#$conf["rewrite"],預設為"false",接續寫入;反之"true"代表重新寫入.
|
|
|
330 |
#$conf["rewrite"]="false";
|
|
|
331 |
#參考資料:
|
|
|
332 |
#無.
|
|
|
333 |
#備註:
|
|
|
334 |
#無.
|
|
|
335 |
$record=logs::record($conf);
|
|
|
336 |
unset($conf);
|
|
|
337 |
|
|
|
338 |
#如果寫log 失敗
|
|
|
339 |
if($record["status"]==="false"){
|
|
|
340 |
|
|
|
341 |
#印出訊息
|
|
|
342 |
echo json_encode($record);
|
|
|
343 |
|
|
|
344 |
#結束執行
|
|
|
345 |
exit;
|
|
|
346 |
|
|
|
347 |
}#if end
|
|
|
348 |
|
|
|
349 |
#如果執行失敗
|
|
|
350 |
if($checkArguments["status"]==="false"){
|
|
|
351 |
|
|
|
352 |
#印出訊息
|
|
|
353 |
echo json_encode($checkArguments);
|
|
|
354 |
|
|
|
355 |
#結束執行
|
|
|
356 |
exit;
|
|
|
357 |
|
|
|
358 |
}#if end
|
|
|
359 |
|
|
|
360 |
#如果邊數檢查不通過
|
|
|
361 |
if($checkArguments["passed"]==="false"){
|
|
|
362 |
|
|
|
363 |
#印出訊息
|
|
|
364 |
echo json_encode($checkArguments);
|
|
|
365 |
|
|
|
366 |
#結束執行
|
|
|
367 |
exit;
|
|
|
368 |
|
|
|
369 |
}#if end
|
|
|
370 |
|
|
|
371 |
/*
|
|
|
372 |
#可能存在的參數
|
|
|
373 |
$params["dbAddr"];
|
|
|
374 |
$params["dbPort"];
|
|
|
375 |
$params["dbName"];
|
|
|
376 |
$params["dbUser"];
|
|
|
377 |
$params["dbPass"];
|
|
|
378 |
$params["dtName"];
|
|
|
379 |
$params["cols"];
|
|
|
380 |
$params["WhereColumnName"];
|
|
|
381 |
$params["WhereColumnValue"];
|
|
|
382 |
$params["WhereColumnOperator"];
|
|
|
383 |
$params["orderItem"];
|
|
|
384 |
$params["ascORdesc"];
|
|
|
385 |
$params["numLimit"];
|
|
|
386 |
*/
|
|
|
387 |
|
|
|
388 |
#涵式說明：
|
|
|
389 |
#一次取得資料庫、表的資料
|
|
|
390 |
#回傳的結果
|
|
|
391 |
#$result["status"],執行結果"true"為成功；"false"為執行失敗。
|
|
|
392 |
#$result["error"],錯誤訊息陣列。
|
|
|
393 |
#$result["function"],當前執行的漢書名稱.
|
|
|
394 |
#$result["argu"],使用的參數.
|
|
|
395 |
#$result["dataColumnName"],抓取的資料欄位名稱陣列.
|
|
|
396 |
#$result["dataColumnName"][$i]代表第$i+1個欄位名稱
|
|
|
397 |
#$result["dataContent"],爲資料的內容。
|
|
|
398 |
#$result["dataContent"][$conf["WhereColumnName"][$i]][$dataSetNum]
|
|
|
399 |
#$dataSetNum 爲第$dataSetNum+1筆資料
|
|
|
400 |
#$conf["WhereColumnName"][$i] 爲第 $i+1 個欄位的名稱
|
|
|
401 |
#$result["dataCount"],爲取得的資料筆數。
|
|
|
402 |
#$result["sql"],執行的sql字串.
|
|
|
403 |
#必填的參數：
|
|
|
404 |
$conf["dbAddress"]=$params["dbAddr"];#爲dbServer的位置。
|
|
|
405 |
$conf["dbAccount"]=$params["dbUser"];#爲登入dbServer的帳號。
|
|
|
406 |
$conf["dbName"]=$params["dbName"];#爲要存取的資料庫名稱
|
|
|
407 |
$conf["tableName"]=$params["dtName"];#爲要存取的資料表名稱
|
|
|
408 |
$conf["columnYouWant"]=$params["cols"];#你想要的欄位！,若設為「array("*")」則代表全部欄位.
|
|
|
409 |
#可省略的參數：
|
|
|
410 |
$conf["dbPassword"]=$params["dbPass"];#爲要存取dbServer的密碼
|
|
|
411 |
|
|
|
412 |
#如果存在 $params["WhereColumnName"]
|
|
|
413 |
if(isset($params["WhereColumnName"])){
|
|
|
414 |
|
|
|
415 |
$conf["WhereColumnName"]=$params["WhereColumnName"];#用於判斷語句的欄位項目陣列。
|
|
|
416 |
|
|
|
417 |
}#if end
|
|
|
418 |
|
|
|
419 |
#如果存在 $params["WhereColumnName"]
|
|
|
420 |
if(isset($params["WhereColumnValue"])){
|
|
|
421 |
|
|
|
422 |
$conf["WhereColumnValue"]=$params["WhereColumnValue"];#用於判斷語句的欄位數值陣列，若與LIKE搭配，則可以在關鍵自字串的左右名加上「%」符號，這樣就可以搜尋具有該字串的內容。
|
|
|
423 |
|
|
|
424 |
}#if end
|
|
|
425 |
|
|
|
426 |
#$conf["WhereColumnCombine"]=array("");#用於判斷語句當中需要()起來的判斷式，須爲陣列值，"s"代表「(」，"e"代表「)」 ，若無則須設爲""。
|
|
|
427 |
|
|
|
428 |
#如果存在 $params["WhereColumnOperator"]
|
|
|
429 |
if(isset($params["WhereColumnOperator"])){
|
|
|
430 |
|
|
|
431 |
$conf["WhereColumnOperator"]=$params["WhereColumnOperator"];#用於判斷語句的比較符號陣列，可以用的符號有「"="、"!="、">"、"<"、"LIKE"、"NOT LIKE"」，預設都爲「=」。
|
|
|
432 |
|
|
|
433 |
}#if end
|
|
|
434 |
|
|
|
435 |
#$conf["WhereColumnAndOr"]=array("");#用於判斷語句條件之間成立的條件是AND還是OR，須爲陣列值。其數量應爲要判斷的欄位數量減一。
|
|
|
436 |
#$conf["whereIn"],二維字串陣列,為每個in語句的內容,特定欄位數值等於陣列元素之一。array(array("colName",array("a","b","c")));代表欄位colName的值為a,b,c三者之一.
|
|
|
437 |
#$conf["whereIn"]=array(array("colName",array("a","b","c")));
|
|
|
438 |
#$conf["whereNotIn"],二維字串陣列,為每個not in語句的內容,array(array("colName",array("a","b","c")));代表欄位colName的值不為a,b,c三者之一.
|
|
|
439 |
#$conf["whereNotIn"]=array(array("colName",array("a","b","c")));
|
|
|
440 |
|
|
|
441 |
#如果有設置 $params["orderItem"]
|
|
|
442 |
if(isset($params["orderItem"])){
|
|
|
443 |
|
|
|
444 |
$conf["orderItem"]=$params["orderItem"];#爲排序的項目依據,若要用隨機抽樣，可以用"rand()"，可省略。
|
|
|
445 |
|
|
|
446 |
}#if end
|
|
|
447 |
|
|
|
448 |
#如果有設置 $params["ascORdesc"]
|
|
|
449 |
if(isset($params["ascORdesc"])){
|
|
|
450 |
|
|
|
451 |
$conf["ascORdesc"]=$params["ascORdesc"];#爲要低增還是遞減排序,asc爲遞增；desc爲遞減。
|
|
|
452 |
|
|
|
453 |
}#if end
|
|
|
454 |
|
|
|
455 |
#如果有設置 $params["numLimit"]
|
|
|
456 |
if(isset($params["numLimit"])){
|
|
|
457 |
|
|
|
458 |
$conf["numLimit"]=$params["numLimit"];#為要取幾筆資料,可以省略，省略則表示不限制數目。
|
|
|
459 |
|
|
|
460 |
}#if end
|
|
|
461 |
|
|
|
462 |
#如果有設置 $params["numberStart"]
|
|
|
463 |
if(isset($params["numberStart"])){
|
|
|
464 |
|
|
|
465 |
$conf["numberStart"]=$params["numberStart"];#為從第幾筆開始讀取，預設為0，代筆第一筆。
|
|
|
466 |
|
|
|
467 |
}#if end
|
|
|
468 |
|
|
|
469 |
#$conf["groupBy"]=array("");#爲要以哪幾個欄爲作爲分羣的依據(欄位相同的數值僅會取出一筆)。
|
|
|
470 |
#$conf["dbPort"],字串,爲連線到mysql-Server時要使用的port，可省略，若省略則代表使用預設的3306 port.
|
|
|
471 |
$conf["dbPort"]=$params["dbPort"];
|
|
|
472 |
$fastGetDbData=db::fastGetDbData($conf);
|
|
|
473 |
unset($conf);
|
|
|
474 |
|
|
|
475 |
#函式說明:
|
|
|
476 |
#撰寫log
|
|
|
477 |
#回傳結果:
|
|
|
478 |
#$result["status"],狀態,"true"或"false".
|
|
|
479 |
#$result["error"],錯誤訊息陣列.
|
|
|
480 |
#$result["function"],當前函式的名稱.
|
|
|
481 |
#$result["argu"],使用的參數.
|
|
|
482 |
#必填參數:
|
|
|
483 |
#$conf["path"],log檔案的路徑與名稱.
|
|
|
484 |
$conf["path"]=$logFile;
|
|
|
485 |
#$conf["content"],字串,要寫的內容.
|
|
|
486 |
$conf["content"]=json_encode($fastGetDbData).PHP_EOL;
|
|
|
487 |
#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑
|
|
|
488 |
$conf["fileArgu"]=__FILE__;
|
|
|
489 |
#可省略參數:
|
|
|
490 |
#$conf["rewrite"],預設為"false",接續寫入;反之"true"代表重新寫入.
|
|
|
491 |
#$conf["rewrite"]="false";
|
|
|
492 |
#參考資料:
|
|
|
493 |
#無.
|
|
|
494 |
#備註:
|
|
|
495 |
#無.
|
|
|
496 |
$record=logs::record($conf);
|
|
|
497 |
unset($conf);
|
|
|
498 |
|
|
|
499 |
#如果寫log 失敗
|
|
|
500 |
if($record["status"]==="false"){
|
|
|
501 |
|
|
|
502 |
#印出訊息
|
|
|
503 |
echo json_encode($record);
|
|
|
504 |
|
|
|
505 |
#結束執行
|
|
|
506 |
exit;
|
|
|
507 |
|
|
|
508 |
}#if end
|
|
|
509 |
|
|
|
510 |
#印出訊息
|
|
|
511 |
echo json_encode($fastGetDbData);
|
|
|
512 |
|
|
|
513 |
?>
|