proc_nice

    (PHP 5, PHP 7, PHP 8)

    proc_nice — Ändert die Priorität des aktuellen Prozesses

    Beschreibung

    proc_nice(int$priority): bool

    proc_nice() ändert die Priorität des aktuellen Prozesses um den in priority angegebenen Betrag. Ein positives priority vermindert die Priorität des aktuellen Prozesses, während ein negatives priority die Priorität erhöht.

    proc_nice() ist in keiner Weise verwandt mit proc_open() und der dazugehörigen Funktionen.

    Parameter-Liste

    priority

    Der neue Prioritätswert; dieser Wert ist plattformabhängig.

    Unter Unix bedeutet ein niedriger Wert, wie beispielsweise -20, eine hohe Priorität, wohingegen ein positiver Wert eine niedrigere Priorität hat.

    Unter Windows hat der Parameter priority die folgende Bedeutung:

    PrioritätsklasseMögliche Werte
    Hochpriority< -9
    Höher als normalpriority< -4
    Normalpriority< 5 & priority> -5
    Niedriger als normalpriority> 5
    Leerlauf (Idle)priority> 9

    Rückgabewerte

    Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben. Wenn ein Fehler auftritt, zum Beispiel weil der User keine Berechtigung hat, die Priorität eines Prozesses zu ändern, wird ein Fehler der Stufe E_WARNING erzeugt.

    Changelog

    VersionBeschreibung
    7.2.0 Diese Funktion steht nun unter Windows zur Verfügung.

    Beispiele

    Beispiel #1 Verwendung von proc_nice(), um die Prozesspriorität auf hoch zu setzen

    <?php
    // höchste Priorität
    proc_nice(-20);
    ?>

    Anmerkungen

    Hinweis: Verfügbarkeit

    proc_nice() existiert nur, wenn Ihr System mit 'nice' umgehen kann. 'nice' ist verfügbar unter: SVr4, SVID EXT, AT&T, X/OPEN und BSD 4.3.

    Hinweis: Nur für Windows

    proc_nice() ändert die aktuelle Prozesspriorität, selbst wenn PHP mit Threadsicherheit kompiliert wurde.

    Siehe auch

    To Top