Submit a Pull Request Report a Bug

pcntl_setpriority

(PHP 5, PHP 7, PHP 8)

pcntl_setpriority — 修改任意进程的优先级

说明

pcntl_setpriority(int $priority, ?int $process_id = null, int $mode = PRIO_PROCESS): bool

pcntl_setpriority() 设置进程号为 process_id 的进程的优先级。

参数

priority: priority 通常时 -20 至 20 这个范围内的值。默认优先级是 0,值越小代表优先级越高。由于不同的系统类型以及内核版本下优先级可能不同，因此请参考系统的 setpriority（2）手册以获取详细的规范。
process_id: 如果为 null，默认是当前进程的进程号。
mode: PRIO_PGRP（译注：获取进程组优先级）、PRIO_USER（译注：获取用户进程优先级）或 PRIO_PROCESS（译注：默认值;获取进程优先级）、PRIO_DARWIN_BG 或 PRIO_DARWIN_THREAD 之一。

返回值

成功时返回 true，或者在失败时返回 false。

更新日志

版本	说明
8.0.0	`process_id` 可以为 null。

参见

pcntl_getpriority() - 获取任意进程的优先级
pcntl_setpriority()

＋add a note

User Contributed Notes 2 notes

down

t dot stobbe at blackdogdev dot com ¶

17 years ago

As for the renice function by leandro dot pereira at gmail dot com, this isn't true.  pcntl_setpriority() doesn't set the nice level of a process, but instead sets the base priority of it.  At first glance this might seem like the same thing, but on a system level, they are actually quite different.

In fact, if you're looking to use pcntl_setpriority() to prioritize your process (a tool or a daemon or what-not), I wouldn't recomend using setpriority at all, but renice it instead.  Let the system manage priorities and you'll end up with the results you were looking for.

This applies only to POSIX based systems only (as does the function presented by leandro dot pereira at gmail dot com as well).

down

-1

leandro dot pereira at gmail dot com ¶

18 years ago

The following snippet may be used under older versions of PHP to provide similar functionality.  Tested only under Linux.

<?php
function _pcntl_setpriority($priority, $pid = 0)
{ 
        $priority = (int)$priority;
        $pid = (int)$pid;

        if ($priority > 20 && $priority < -20) {
                return False;
        }
        if ($pid == 0) {
                $pid = getmypid();
        }

        return system("renice  $priority -p $pid") != false;
}

?>

＋add a note