cli_set_process_title

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

cli_set_process_title — Define o título do processo

Descrição

function cli_set_process_title(string $title): bool

Define o título do processo, visível em ferramentas como top e ps. Esta função está disponível apenas no modo CLI.

Parâmetros

title
O novo título.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

Um E_WARNING será gerado se o sistema operacional não for compatível.

Registro de Alterações

Versão Descrição
8.5.0 cli_set_process_title() agora emite um E_WARNING ao definir um título muito longo para um processo; anteriormente o título seria truncado.

Exemplos

<?php
$title = "Meu Super Script PHP";
$pid = getmypid(); // pode-se usar isto para ver o título do processo no comando "ps"

if (!cli_set_process_title($title)) {
echo "Não foi possível definir o título do processo para o PID $pid...\n";
exit(1);
} else {
echo "O título '$title' para o PID $pid foi definido para o seu processo!\n";
sleep(5);
}
?>

Veja Também