PHP 7.1.18 Released

getrusage

(PHP 4, PHP 5, PHP 7)

getrusageErmittelt den aktuellen Ressourcenverbrauch

Beschreibung

array getrusage ([ int $who = 0 ] )

Dies ist eine Schnittstelle zu getrusage(2), das Daten des Systemaufrufs liefert.

Parameter-Liste

who

Ist who 1, wird getrusage mit RUSAGE_CHILDREN aufgerufen.

Rückgabewerte

Gibt ein assoziatives Array mit den Daten zurück, die der Systemaufruf ausgibt. Alle Elemente sind unter Verwendung ihres dokumentierten Feldnamens zugreifbar.

Beispiele

Beispiel #1 getrusage() Beispiel

<?php
$dat 
getrusage();
echo 
$dat["ru_oublock"];       // number of block output operations
echo $dat["ru_inblock"];       // number of block input operations
echo $dat["ru_msgsnd"];        // number of IPC messages sent
echo $dat["ru_msgrcv"];        // number of IPC messages received
echo $dat["ru_maxrss"];        // maximum resident set size
echo $dat["ru_ixrss"];         // integral shared memory size
echo $dat["ru_idrss"];         // integral unshared data size
echo $dat["ru_minflt"];        // number of page reclaims (soft page faults)
echo $dat["ru_majflt"];        // number of page faults (hard page faults)
echo $dat["ru_nsignals"];      // number of signals received
echo $dat["ru_nvcsw"];         // number of voluntary context switches
echo $dat["ru_nivcsw"];        // number of involuntary context switches
echo $dat["ru_nswap"];         // number of swaps
echo $dat["ru_utime.tv_usec"]; // user time used (microseconds)
echo $dat["ru_utime.tv_sec"];  // user time used (seconds)
echo $dat["ru_stime.tv_usec"]; // system time used (microseconds)
?>

Changelog

Version Beschreibung
7.0.0 Diese Funktion wird nun unter Windows unterstützt.

Anmerkungen

Hinweis:

Unter Windows gibt getrusage() nur folgende Elemente zurück:

  • "ru_stime.tv_sec"
  • "ru_stime.tv_usec"
  • "ru_utime.tv_sec"
  • "ru_utime.tv_usec"
  • "ru_majflt" (nur wenn who RUSAGE_SELF ist)
  • "ru_maxrss" (nur wenn who RUSAGE_SELF ist)

Wird getrusage() mit who als 1 (RUSAGE_CHILDREN) aufgerufen, dann wird der Ressourcenverbrauch der Threads zusammengefasst (was bedeutet, dass die Funktion intern mit RUSAGE_THREAD aufgerufen wird).

Hinweis:

Unter BeOS 2000 werden nur folgende Element zurückgegeben:

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

Siehe auch

  • Die Seite ihres Handbuchs zu getrusage(2)

add a note add a note

User Contributed Notes 2 notes

up
3
jlh at gmx dot ch
1 year ago
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.
up
3
Domas Mituzas
10 years ago
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.
To Top