(PHP 4, PHP 5, PHP 7, PHP 8)
getrusage — Liefert den aktuellen Wert der Ressourcenauslastung
Dies ist eine Schnittstelle zu getrusage(2). Sie gibt die Daten des Systemaufrufs zurück.
mode
Ist mode 1, wird getrusage mit
RUSAGE_CHILDREN aufgerufen.
Gibt ein assoziatives Array mit den Daten zurück, die der Systemaufruf ausgibt. Alle Elemente sind unter Verwendung ihres dokumentierten Feldnamens zugreifbar.
| Version | Beschreibung |
|---|---|
| 7.0.0 | Diese Funktion wird nun unter Windows unterstützt. |
Beispiel #1 getrusage()-Beispiel
<?php
$dat = getrusage();
echo $dat["ru_oublock"]; // Anzahl der Blockausgabeoperationen
echo $dat["ru_inblock"]; // Anzahl der Blockeingabeoperationen
echo $dat["ru_msgsnd"]; // Anzahl der gesendeten IPC-Nachrichten
echo $dat["ru_msgrcv"]; // Anzahl der empfangenen IPC-Nachrichten
echo $dat["ru_maxrss"]; // maximale Größe des residenten Speichers im RAM
echo $dat["ru_ixrss"]; // Gesamtgröße des gemeinsam genutzen Speichers
echo $dat["ru_idrss"]; // Gesamtgröße der nicht gemeinsam genutzten Daten
echo $dat["ru_minflt"]; // Anzahl der wiederhergestellten Seiten (Soft Page Faults)
echo $dat["ru_majflt"]; // Anzahl der Seitenfehler (Hard Page Faults)
echo $dat["ru_nsignals"]; // Anzahl der empfangenen Signale
echo $dat["ru_nvcsw"]; // Anzahl der freiwilligen Kontextwechsel
echo $dat["ru_nivcsw"]; // Anzahl der unfreiwilligen Kontextwechsel
echo $dat["ru_nswap"]; // Anzahl der Auslagerungen (Swaps)
echo $dat["ru_utime.tv_usec"]; // verwendete Benutzerzeit (Mikrosekunden)
echo $dat["ru_utime.tv_sec"]; // verwendete Benutzerzeit (Sekunden)
echo $dat["ru_stime.tv_usec"]; // verwendete Systemzeit (Mikrosekunden)
echo $dat["ru_stime.tv_sec"]; // verwendete Systemzeit (Sekunden)
?>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 wennmodeRUSAGE_SELFist)."ru_maxrss"(nur wennmodeRUSAGE_SELFist).Wird getrusage() mit
modeals1(RUSAGE_CHILDREN) aufgerufen, dann wird der Ressourcenverbrauch der Threads zusammengefasst (was bedeutet, dass die Funktion intern mitRUSAGE_THREADaufgerufen 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"
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.BeOS support is removed in PHP 7.3:
https://github.com/php/php-src/blob/php-7.3.0alpha1/NEWSgetrusage() 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.