(PHP 5, PHP 7)
proc_nice — Change the priority of the current process
$increment
)
proc_nice() changes the priority of the current
process by the amount specified in increment. A
positive increment will lower the priority of the
current process, whereas a negative increment
will raise the priority.
proc_nice() is not related to proc_open() and its associated functions in any way.
incrementThe new priority value, the value of this may differ on platforms.
on Unix, a low value, such as -20 means high priority wheras a positive value have a lower priority.
For Windows the increment parameter have the
following meanings:
| Priority class | Possible values |
|---|---|
| Realtime priority |
increment < -14
|
| High priority |
increment < -9
|
| Above normal priority |
increment < -4
|
| Normal priority |
increment < 5 &
increment > -5
|
| Below normal priority |
increment > 5
|
| Idle priority |
increment > 9
|
Returns TRUE on success or FALSE on failure.
If an error occurs, like the user lacks permission to change the priority,
an error of level E_WARNING is also generated.
Example #1 Using proc_open() to set the process priority to high
<?php
// Highest priority
proc_nice(-20)
?>
| Version | Description |
|---|---|
| 7.2.0 | This function is now available on Windows. |
Note: Availability
proc_nice() will only exist if your system has 'nice' capabilities. 'nice' conforms to: SVr4, SVID EXT, AT&T, X/OPEN, BSD 4.3.
Note: Windows only
The values of
incrementtries to mimic the output of the wmic.On Windows this function will only change the current process priority, even if PHP was compiled using thread safety.