proc_nice

(PHP 5, PHP 7, PHP 8)

proc_niceChange la priorité d'exécution du processus courant

Description

proc_nice(int $priority): bool

proc_nice() modifie la priorité du processus courant par le paramètre spécifié priority. Un paramètre priority positif atténuera la priorité du processus courant, tandis qu'une valeur négative priority augmentera la priorité.

proc_nice() n'est pas lié à proc_open() et ses fonctions associées d'aucune façon.

Liste de paramètres

priority

La nouvelle valeur de priorité, la valeur de ceci peut différer sur des plates-formes.

Sur Unix, une valeur faible, telle que -20 indique une priorité élevée alors qu'une valeur positive ont une priorité basse.

Pour Windows le paramètre priority a les significations suivantes :

Classe de priorité Valeurs possible
Priorité élevée priority < -9
Au-dessus de la priorité normale priority < -4
Priorité normale priority < 5 & priority > -5
Au-dessous de la priorité normale priority > 5
Priorité inactive priority > 9

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient. Si une erreur survient, par exemple, si l'utilisateur qui tente de changer la priorité d'un processus n'a pas suffisamment de droit pour le faire, une erreur de niveau E_WARNING est générée et false est retourné.

Historique

Version Description
7.2.0 Cette fonction est maintenant disponible sur Windows.

Exemples

Exemple #1 Utilisation de proc_nice() pour définir la priorité de processus à haute

<?php
// Priorité la plus élevée
proc_nice(-20);
?>

Notes

Note: Disponibilité

proc_nice() n'est disponible que sur les systèmes qui disposent de capacités NICE. NICE est compatible avec : SVr4, SVID EXT, AT&T, X/OPEN, BSD 4.3.

Note: Windows seulement

proc_nice() va changé la priorité du processus courent même si PHP a été compilé en utilisant la sécurité des threads.

Voir aussi