phpday 2025 - Call For Papers

cli_set_process_title

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

cli_set_process_titleDefine o título do processo

Descrição

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.

Exemplos

Exemplo #1 Exemplo de cli_set_process_title()

<?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

adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

up
15
code at edoceo dot com
10 years ago
Setting proc title on PHP based daemons is pretty sweet.
up
2
pitpat
3 years ago
In Linux this command changes the title for commands like 'ps -a' it doesn't seem to work with 'top' or 'pkill'

To change the short name (eg PHP) to something else you can use the below:

<?php

$strNewName
='myscript';

cli_set_process_name($strNewName);
cli_set_process_title($strNewName);

var_dump(cli_get_process_name());
var_dump(cli_get_process_title());

function
cli_set_process_name($strName)
{
file_put_contents("/proc/".getmypid()."/comm",$strName);
}

function
cli_get_process_name()
{
return(
trim(file_get_contents("/proc/".getmypid()."/comm"),"\r\n"));
}

Note: The above will NOT work in Windows and may not work in all flavours of linux (I use Debian).
To Top