PHP 5, PHP 7, PHP 8
proc_nice - Change the priority of the current process
Code Examples

proc_nice( int$priority ): bool

proc_nice changes the priority of the current process by the amount specified in priority. A positive priority will lower the priority of the current process, whereas a negative priority will raise the priority.

proc_nice is not related to proc_open and its associated functions in any way.



The 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 priority parameter have the following meanings:

Priority class Possible values High prioritypriority < -9 Above normal prioritypriority < -4 Normal prioritypriority < 5 & priority > -5 Below normal prioritypriority > 5 Idle prioritypriority > 9

Return Values

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.



proc_nice will only exist if your system has 'nice' capabilities. 'nice' conforms to: SVr4, SVID EXT, AT&T, X/OPEN, BSD 4.3.

Windows only

proc_nice will change the current process priority, even if PHP was compiled using thread safety.


Version Description
7.2.0 This function is now available on Windows.

Example of proc_nice

Show all examples for proc_nice

PHP Version:

Function proc_nice:

System program execution Functions

Most used PHP functions