proc_nice

(PHP 5, PHP 7, PHP 8)

proc_nice — Muda a prioridade do processo atual

Descrição

proc_nice(int $priority): bool

proc_nice() muda a prioridade do processo atual para o valor especificado em priority. Um priority positivo irá diminuir a prioridade do processo atual, enquanto que um priority negativo irá aumentar a prioridade.

proc_nice() não é relacionada com proc_open() e suas funções associadas de qualquer maneira.

Parâmetros

priority

O novo valor de prioridade, pode ser diferente dependendo da plataforma.

No Unix, um valor baixo, como -20 significa alta prioridade enquanto que valores positivos têm uma prioridade menor.

Para Windows, o argumento priority tem o seguinte significado:

Classe de prioridade Valores possíveis
Alta prioridade priority < -9
Prioridade acima do normal priority < -4
Prioridade normal priority < 5 & priority > -5
Prioridade abaixo do normal priority > 5
Prioridade de inativo priority > 9

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha. Se ocorrer um erro, como o usuário não ter permissões suficientes para mudar a prioridade, um erro de nível E_WARNING também é gerado.

Registro de Alterações

Versão Descrição
7.2.0 Esta função agora está disponível no Windows.

Exemplos

Example #1 Usando proc_nice() para definir a prioridade do processo para alta

<?php
// A mais alta prioridade
proc_nice(-20);
?>

Notas

Note: Disponibilidade

proc_nice() irá existir apenas se o sistema tiver capacidades para 'nice', que é 'nice' conforme: SVr4, SVID EXT, AT&T, X/OPEN e BSD 4.3.

Note: Somente para Windows

proc_nice() irá alterar a prioridade do processo atual, mesmo que o PHP tenha sido compilado com 'thread safety'.

Veja Também