getrusage()

(PHP 4, PHP 5, PHP 7)

获取当前资源使用状况

说明

getrusage([int $who= 0]): array

这是getrusage(2)的接口。它返回了调用自系统的数据。

参数

$who

如果$who是 1，getrusage 会使用RUSAGE_CHILDREN来调用。

返回值

返回了一个包含系统返回数据的关联数组。所以条目均可通过文档中字段的名称来访问。

范例

Example #1getrusage()例子

<?php
$dat = getrusage();
echo $dat["ru_nswap"];         // number of swaps
echo $dat["ru_majflt"];        // number of page faults
echo $dat["ru_utime.tv_sec"];  // user time used (seconds)
echo $dat["ru_utime.tv_usec"]; // user time used (microseconds)
?>

更新日志

注释

Note:

在 Windows 上getrusage()仅会返回以下类型：

• "ru_stime.tv_sec"
• "ru_stime.tv_usec"
• "ru_utime.tv_sec"
• "ru_utime.tv_usec"
• "ru_majflt"(only if$whoisRUSAGE_SELF)
• "ru_maxrss"(only if$whoisRUSAGE_SELF)

Ifgetrusage()is called with$whoset to1(RUSAGE_CHILDREN), then resource usage for threads are collected (meaning that internally the function is called withRUSAGE_THREAD).

Note:

在 BeOS 2000，仅会返回以下类型：

• "ru_stime.tv_sec"
• "ru_stime.tv_usec"
• "ru_utime.tv_sec"
• "ru_utime.tv_usec"

参见

• 你系统上getrusage(2)的 man page

Note that this function returns rusage of the current process. In a web environment where you have long running apache processes that serve several requests with PHP executions, this will return cumulative timings and is therefore not suitable for telling how much user time your used. The best you could do is to call getrusage() once at the beginning and once at the end and calculate the difference.

getrusage() reports kernel counters that are updated only once application loses context and a switch to kernel space happens. For example on modern Linux server kernels that would mean that getrusage() calls would return information rounded at 10ms, desktop kernels - at 1ms.
getrusage() isn't usable for micro-measurements at all - and getmicrotime(true) might be much more valuable resource.

BeOS support is removed in PHP 7.3:
https://github.com/php/php-src/blob/php-7.3.0alpha1/NEWS