萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

PHP 通用工具函數庫:資料庫抽象、變量調試、日誌分級、性能計時、SQL 審計

早期 PHP 缺乏統一資料庫抽象層,調試手段原始。本文提供一套經典的**通用函數庫**,涵蓋資料庫統一操作、結構化變量輸出、分級日誌記錄、代碼性能計時、SQL 執行審計,雖屬舊時代產物,思想仍具參考價值。

1. 通用資料庫處理函數 (DB 抽象層雛形)

封裝 query(), next_record() 等統一介面,屏蔽 MySQL/SQL Server 差異。核心思想:工廠模式返回具體驅動對象,上層調用統一 API。

代碼略,現代開發請直接使用 PDO / Doctrine DBAL / Laravel Eloquent / Medoo 等成熟 ORM/DBAL。

2. 結構化變量調試函數 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); // 看所有全局變量

3. 分級日誌控制函數

四級別: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(); // 清空

4. 微秒級性能計時器

$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";

5. SQL 執行審計增強版 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

理解這些基礎工具的實現原理,有助於更深入地掌握現代框架的內部機制。

copyright © 萬盛學電腦網 all rights reserved