array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.getrusage.php', 1 => 'getrusage', 2 => 'Retourne le niveau d\'utilisation des ressources', ), 'up' => array ( 0 => 'ref.info.php', 1 => 'Fonctions sur les options et les informations de PHP', ), 'prev' => array ( 0 => 'function.getopt.php', 1 => 'getopt', ), 'next' => array ( 0 => 'function.ini-alter.php', 1 => 'ini_alter', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/info/functions/getrusage.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

getrusage

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

getrusage — Retourne le niveau d'utilisation des ressources

Description

getrusage(int $mode = 0): array|false

C'est une interface à la fonction système getrusage(2). Elle retourne un tableau associatif contenant les informations renvoyées par cet appel système.

Liste de paramètres

mode

Si mode est égal à 1, getrusage() sera appelé avec le paramètre RUSAGE_CHILDREN.

Valeurs de retour

Retourne un tableau associatif contenant les données retournées depuis l'appel système. Toutes les entrées sont accessibles en utilisant leurs noms de champs documentés. Retourne false en cas d'échec.

Exemples

Exemple #1 Exemple avec getrusage()

<?php
$dat = getrusage();
echo $dat["ru_oublock"]; // nombre d'opérations de bloc de sortie
echo $dat["ru_inblock"]; // nombre d'opérations de bloc d'entrée
echo $dat["ru_msgsnd"]; // nombre de messages IPC envoyés
echo $dat["ru_msgrcv"]; // nombre de messages IPC reçus
echo $dat["ru_maxrss"]; // taille maximale du groupe de résidents
echo $dat["ru_ixrss"]; // taille de la mémoire partagée intégrale
echo $dat["ru_idrss"]; // taille intégrale des données non partagées
echo $dat["ru_minflt"]; // nombre de pages récupérées (faute de page mineure)
echo $dat["ru_majflt"]; // nombre de défauts de page (faute de page majeure)
echo $dat["ru_nsignals"]; // nombre de signaux reçus
echo $dat["ru_nvcsw"]; // nombre de changements de contexte volontaires
echo $dat["ru_nivcsw"]; // nombre de changements de contexte involontaires
echo $dat["ru_nswap"]; // taille de la mémoire swap
echo $dat["ru_utime.tv_usec"]; // temps utilisateur utilisé (en microsecondes)
echo $dat["ru_utime.tv_sec"]; // temps utilisateur utilisé (en secondes)
echo $dat["ru_stime.tv_usec"]; // temps système utilisé (en microsecondes)
echo $dat["ru_stime.tv_sec"]; // temps système utilisé (en secondes)
?>

Notes

Note:

Sous Windows, la fonction getrusage() ne va retourner que les membres suivants :

  • "ru_stime.tv_sec"
  • "ru_stime.tv_usec"
  • "ru_utime.tv_sec"
  • "ru_utime.tv_usec"
  • "ru_majflt" (seulement si mode vaut RUSAGE_SELF)
  • "ru_maxrss" (seulement si mode vaut RUSAGE_SELF)

Si getrusage() est appelé avec le paramètre mode valant 1 (RUSAGE_CHILDREN), alors l'utilisation de la ressource pour les threads est collectée (ce qui signifie que, en interne, la fonction est appelée avec RUSAGE_THREAD).

Note:

Sous BeOS 2000, seuls les membres suivants sont retournés :

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

Voir aussi