早期 PHP 缺乏統一資料庫抽象層,調試手段原始。本文提供一套經典的**通用函數庫**,涵蓋資料庫統一操作、結構化變量輸出、分級日誌記錄、代碼性能計時、SQL 執行審計,雖屬舊時代產物,思想仍具參考價值。
封裝 query(), next_record() 等統一介面,屏蔽 MySQL/SQL Server 差異。核心思想:工廠模式返回具體驅動對象,上層調用統一 API。
代碼略,現代開發請直接使用 PDO / Doctrine DBAL / Laravel Eloquent / Medoo 等成熟 ORM/DBAL。
ss_as_string()遞歸將變量 (標量/陣列/對象) 轉為可讀字符串,支援縮進層級:
function ss_as_string(&$thing, $column = 0) {
if (is_object($thing)) return ss_object_as_string($thing, $column);
elseif (is_array($thing)) return ss_array_as_string($thing, $column);
elseif (is_double($thing)) return "Double($thing)";
elseif (is_long($thing)) return "Long($thing)";
elseif (is_string($thing)) return 'String("'.$thing.'")';
else return "Unknown($thing)";
}
function ss_array_as_string(&$array, $column = 0) {
$str = "Array(\n";
foreach ($array as $k => $v) {
$str .= str_repeat(" ", $column+1) . "$k => " . ss_as_string($v, $column+1) . "\n";
}
$str .= str_repeat(" ", $column) . ")";
return $str;
}
// 使用:echo ss_as_string($myVar); 或 echo ss_as_string($GLOBALS); // 看所有全局變量
四級別:NONE(0) < ERROR(1) < INFO(2) < DEBUG(3)。設置級別後,僅記錄 ≤ 該級別的日誌。
$ss_log_level = 2; // INFO 級
$ss_log_filename = '/tmp/app.log';
$ss_log_levels = ['NONE'=>0, 'ERROR'=>1, 'INFO'=>2, 'DEBUG'=>3];
function ss_log_set_level($level = 'ERROR') {
global $ss_log_level; $ss_log_level = $ss_log_levels[$level];
}
function ss_log($level, $message) {
global $ss_log_level, $ss_log_filename, $ss_log_levels;
if ($ss_log_levels[$level] > $ss_log_level) return false; // 級別過高不記
$fd = fopen($ss_log_filename, 'a');
fwrite($fd, "$level - [" . date('Y-m-d H:i:s') . "] - $message\n");
fclose($fd);
return true;
}
function ss_log_reset() { global $ss_log_filename; @unlink($ss_log_filename); }
// 使用
ss_log_set_level('INFO');
ss_log('ERROR', 'DB connection failed');
ss_log('DEBUG', 'SQL: SELECT * FROM users'); // 不會記錄
ss_log_reset(); // 清空
$ss_timing_start = []; $ss_timing_stop = [];
function ss_timing_start($name = 'default') {
global $ss_timing_start;
$ss_timing_start[$name] = explode(' ', microtime());
}
function ss_timing_stop($name = 'default') {
global $ss_timing_stop;
$ss_timing_stop[$name] = explode(' ', microtime());
}
function ss_timing_current($name = 'default') {
global $ss_timing_start, $ss_timing_stop;
if (!isset($ss_timing_start[$name])) return 0;
$stop = isset($ss_timing_stop[$name]) ? $ss_timing_stop[$name] : explode(' ', microtime());
$start = $ss_timing_start[$name];
return ($stop[1] - $start[1]) + ($stop[0] - $start[0]); // 秒.微秒
}
// 使用:支持多計時器並行
ss_timing_start('sql');
$query();
ss_timing_stop('sql');
echo "Query took: " . ss_timing_current('sql') . "s";
query()結合計時器與日誌,自動記錄每條 SQL 耗時與語句:
function query($sql, $haltOnError = true) {
$this->connect();
ss_timing_start();
$this->Query_ID = @mysql_query($sql, $this->Link_ID); // 舊 mysql_* 函數, 僅示意
ss_timing_stop();
ss_log('INFO', ss_timing_current() . " Secs - $sql"); // 關鍵:慢查詢自動暴露
$this->Row = 0;
$this->Errno = mysql_errno();
$this->Error = mysql_error();
if ($haltOnError && !$this->Query_ID) $this->halt("Invalid SQL: $sql");
return $this->Query_ID;
}
| 功能 | 現代最佳實踐 |
|---|---|
| 資料庫抽象 | PDO / Doctrine DBAL / Eloquent / Medoo |
| 變量調試 | VarDumper (Symfony), dd() (Laravel), Xdebug + IDE |
| 日誌分級 | Monolog (PSR-3), Laravel Log, log4php |
| 性能分析 | Xdebug Profiler, Blackfire, Tideways, hrtime() |
| SQL 審計 | DBAL SQLLogger, Laravel Query Log, MySQL Slow Log, pt-query-digest |
理解這些基礎工具的實現原理,有助於更深入地掌握現代框架的內部機制。