`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];
}
<?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
*/
<?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);
}
}
}
問題:`$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);
<?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 `xdebug.mode=profile`,生成 `cachegrind.out.*`,用 KCacheGrind / QCacheGrind / PHPStorm 打開,切換到「Memory」面板,可視化每個函數的內存分配/釋放曲線,精準定位洩漏函數。
`memory_get_usage()` 看似簡單,卻是洞察 PHP 內存行為的關鍵窗口。將其融入開發習慣 (調試輸出、單元測試、長運行監控、導出優化),配合 Xdebug Profiler 深度分析,能讓你在內存受限環境 (容器、Serverless、嵌入式) 也能從容應對。記住:內存不僅要「夠用」,更要「可控、可觀測」。