Edit Report a Bug

    getrusage

    (PHP 4, PHP 5, PHP 7, PHP 8)

    getrusage — Obtiene el uso de los recursos actuales

    Descripción

    getrusage(int $who = 0): array

    Esta es una interfaz de getrusage(2). Obtiene datos devueltos de la llamada al sistema.

    Parámetros

    who

    Si el parámetro who es 1, getrusage será llamado con RUSAGE_CHILDREN.

    Valores devueltos

    Devuelve un array asociativo que contiene los datos devueltos por la llamada al sistema. Todas las entradas son accesibles mediante el uso de sus nombres de campo documentado.

    Ejemplos

    Ejemplo #1 getrusage() ejemplo

    <?php
    $dat     = getrusage();
    echo     $dat["ru_oublock"]; // número de operaciones de salida en bloque
    echo $dat["ru_inblock"]; // número de operaciones de entrada de bloques
    echo $dat["ru_msgsnd"]; // número de mensajes de IPC enviados
    echo $dat["ru_msgrcv"]; // número de mensajes de IPC recibidos
    echo $dat["ru_maxrss"]; // tamaño máximo de los conjuntos de residentes
    echo $dat["ru_ixrss"]; // tamaño de memoria integral compartida
    echo $dat["ru_idrss"]; // tamaño integral de los datos no compartidos
    echo $dat["ru_minflt"]; // número de reivindicaciones de página (fallos suaves de página)
    echo $dat["ru_majflt"]; // número de fallos de página (fallos duros de página)
    echo $dat["ru_nsignals"]; // número de señales recibidas
    echo $dat["ru_nvcsw"]; // número de cambios de contexto voluntarios
    echo $dat["ru_nivcsw"]; // número de cambios de contexto involuntarios
    echo $dat["ru_nswap"]; // número de intercambios
    echo $dat["ru_utime.tv_usec"]; // tiempo de usuario utilizado (microsegundos)
    echo $dat["ru_utime.tv_sec"]; // tiempo de usuario utilizado (segundos)
    echo $dat["ru_stime.tv_usec"]; // tiempo del sistema utilizado (microsegundos)
    ?>

    Historial de cambios

    Versión Descripción
    7.0.0 Esta función ahora está soportada en Windows

    Notas

    Nota:

    En Windows, getrusage() solamente devolverá los siguientes miembros:

    • "ru_stime.tv_sec"
    • "ru_stime.tv_usec"
    • "ru_utime.tv_sec"
    • "ru_utime.tv_usec"
    • "ru_majflt" (solo si who es RUSAGE_SELF)
    • "ru_maxrss" (solo si who es RUSAGE_SELF)

    Si a getrusage() se le llama con who establecido a 1 (RUSAGE_CHILDREN), se recopilan los usos de recursos para los hilos (lo que significa que la función es llamada internamente con RUSAGE_THREAD).

    Nota:

    En BeOS 2000, solamente se devuelven los siguientes miembros:

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

    Ver también

    • Página principal de sistema sobre getrusage(2)

    add a note add a note

    User Contributed Notes 3 notes

    up
    6
    jlh at gmx dot ch
    7 years 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
    5
    Domas Mituzas
    16 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.
    up
    1
    Anonymous
    6 years ago
    BeOS support is removed in PHP 7.3:
    https://github.com/php/php-src/blob/php-7.3.0alpha1/NEWS
    add a note add a note
    To Top