萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 內存監控利器:memory_get_usage() 實戰指南與性能調優

前言

`memory_get_usage()` 與 `memory_get_peak_usage()` 是 PHP 內建的內存檢測函數,無需擴展,隨時可用。善用它們能幫助定位內存洩漏、優化數據結構、對比算法內存佔用,是性能調優的「聽診器」。

函數簽名與參數

memory_get_usage(bool $real_usage = false): int
memory_get_peak_usage(bool $real_usage = false): int

// $real_usage = true  : 返回系統分配的真實物理內存 (含分配器開銷)
// $real_usage = false : 返回 Zend 內存管理器 (emalloc) 管理的內存 (默認,較小)
// 返回值單位:字節 (bytes)

基礎用法範例

<?php
echo "啟動內存: " . formatBytes(memory_get_usage()) . "\n"; // ~350 KB

$arr = [];
for ($i = 0; $i < 100000; $i++) {
    $arr[] = "item_$i";
}
echo "填充 10 萬字符串後: " . formatBytes(memory_get_usage()) . "\n"; // ~14 MB
echo "峰值內存: " . formatBytes(memory_get_peak_usage()) . "\n";

unset($arr); // 釋放變量
echo "unset 後: " . formatBytes(memory_get_usage()) . "\n"; // 回落至 ~350 KB
// 注意:PHP 內存管理器可能不立即歸還給 OS,但對腳本可用內存已釋放

function formatBytes(int $bytes, int $precision = 2): string {
    $units = ['B', 'KB', 'MB', 'GB', 'TB'];
    $pow = floor(($bytes ? log($bytes) : 0) / log(1024));
    $pow = min($pow, count($units) - 1);
    return round($bytes / (1024 ** $pow), $precision) . ' ' . $units[$pow];
}

實戰場景 1:對比數據結構內存佔用

<?php
function memTest(callable $fn, string $label): void {
    gc_collect_cycles(); // 清理干擾
    $start = memory_get_usage();
    $result = $fn();
    $current = memory_get_usage();
    $peak = memory_get_peak_usage();
    echo "$label: 當前=" . formatBytes($current - $start) . " 峰值=" . formatBytes($peak - $start) . "\n";
    return $result;
}

// 測試 10 萬整數存儲
$n = 100000;

memTest(fn() => range(1, $n), 'range() 連續數組');
memTest(fn() => array_flip(range(1, $n)), 'array_flip 鍵值互換');
memTest(fn() => array_fill(0, $n, true), 'array_fill 固定值');
memTest(function() use ($n) {
    $s = [];
    for ($i=0;$i<$n;$i++) $s[] = $i;
    return $s;
}, 'for 循環 push');

/*
典型輸出 (PHP 8.2 64位):
range() 連續數組: 當前=4.00 MB 峰值=4.00 MB
array_flip 鍵值互換: 當前=8.00 MB 峰值=8.00 MB  (HashTable 開銷大)
array_fill 固定值: 當前=4.00 MB 峰值=4.00 MB
for 循環 push: 當前=4.00 MB 峰值=4.00 MB
*/

實戰場景 2:檢測內存洩漏 (長時間運行腳本/Worker)

<?php
// Worker 主循環
while (true) {
    $task = fetchTask();
    processTask($task);
    
    // 每 100 次任務檢查一次內存增長趨勢
    static $count = 0;
    if (++$count % 100 === 0) {
        $mem = memory_get_usage();
        $peak = memory_get_peak_usage();
        $logger->info('Worker memory', ['current' => $mem, 'peak' => $peak, 'tasks' => $count]);
        
        // 閾值報警 (如超過 200MB)
        if ($mem > 200 * 1024 * 1024) {
            $logger->alert('Memory leak suspected', ['mem' => $mem]);
            // 可選:優雅重啟 worker (發送 SIGTERM 給自己)
            posix_kill(getmypid(), SIGTERM);
        }
    }
}

實戰場景 3:優化大數據導出/導入

問題:`$data = $db->query('SELECT * FROM huge_table')->fetchAll()` 一次性載入百萬行 → OOM。

優化:游標流式處理 + 定期檢查內存:

<?php
$stmt = $pdo->query('SELECT * FROM huge_table');
$fp = fopen('php://output', 'w');
fputcsv($fp, ['id', 'name', 'email']); // CSV Header

$batch = 0;
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    fputcsv($fp, $row);
    if (++$batch % 1000 === 0) {
        // 檢查內存,若過高可暫停/刷新緩衝
        if (memory_get_usage() > 50 * 1024 * 1024) { // 50MB
            // 可選:sleep(1) 讓 GC 喘口氣
        }
    }
}
fclose($fp);

實戰場景 4:Composer 依賴包體積分析

<?php
// 掃描 vendor 目錄,統計各包佔用內存 (需在獨立腳本運行)
$vendorDir = __DIR__ . '/vendor';
$packages = [];

foreach (new RecursiveIteratorIterator(new RecursiveDirectoryIterator($vendorDir)) as $file) {
    if ($file->isFile() && $file->getExtension() === 'php') {
        $code = file_get_contents($file->getPathname());
        // 簡易估算:文件大小 ≈ 解析後 AST 節點數相關
        $size = strlen($code);
        $pkg = extractPackageName($file->getPathname()); // 解析 composer.json name
        $packages[$pkg] = ($packages[$pkg] ?? 0) + $size;
    }
}
arsort($packages);
foreach (array_slice($packages, 0, 20) as $pkg => $size) {
    echo "$pkg: " . formatBytes($size) . "\n";
}

進階:Xdebug Profiler 內存分析

開啟 Xdebug `xdebug.mode=profile`,生成 `cachegrind.out.*`,用 KCacheGrind / QCacheGrind / PHPStorm 打開,切換到「Memory」面板,可視化每個函數的內存分配/釋放曲線,精準定位洩漏函數。

最佳實踐清單

  1. 開發環境常駐: 在基礎框架/入口文件註冊 `register_shutdown_function` 記錄峰值內存,超過閾值報警。
  2. 單元測試斷言內存: `$this->assertLessThan(10*1024*1024, memory_get_peak_usage() - $startMem);`
  3. 避免在循環中 `array_merge`/`array_push` 大數組:預分配 `array_fill` 或用生成器流式處理。
  4. 大對象及時 `unset` / 置 null:釋放引用計數,讓 GC 回收 (特別是循環引用對象)。
  5. 關注 `memory_limit`: 腳本啟動時檢查 `ini_get('memory_limit')`,動態調整或拆分任務。
  6. 使用 PHP 8.1+ `readonly` 屬性、類型屬性:減少動態屬性哈希表開銷。

結語

`memory_get_usage()` 看似簡單,卻是洞察 PHP 內存行為的關鍵窗口。將其融入開發習慣 (調試輸出、單元測試、長運行監控、導出優化),配合 Xdebug Profiler 深度分析,能讓你在內存受限環境 (容器、Serverless、嵌入式) 也能從容應對。記住:內存不僅要「夠用」,更要「可控、可觀測」。

copyright © 萬盛學電腦網 all rights reserved