You should use cli_set_process_title() ( http://php.net/manual/en/function.cli-set-process-title.php ) instead; it's less dangerous and less buggy, and part of PHP itself as of 5.5.
setproctitle
(PECL proctitle >= 0.1.0)
setproctitle — Set the process title
Description
setproctitle
( string
$title
) : voidSets the process title of the current process.
Parameters
-
title -
The title to use as the process title.
Return Values
No value is returned.
Examples
Example #1 setproctitle() example
Running the example below will change the process title (visible with
ps a for example).
<?php
setproctitle("myscript");
?>
The above example will output something similar to:
$ ps a PID TTY STAT TIME COMMAND 1168 pts/3 S 0:00 myscript
See Also
- cli_set_process_title() - Sets the process title
- pcntl_fork() - Forks the currently running process
- setthreadtitle() - Set the thread title
add a note
User Contributed Notes 2 notes
james at ifixit dot com ¶
10 years ago
zodbd421 at gmail dot com ¶
11 years ago
Note that this extension is considered buggy. See https://wiki.php.net/rfc/cli_process_title, which says:
"...but it is incomplete and might lead to memory corruption on Linux (or any OS which does not support setproctitle.
The reason is the extension only has access to original argv[0] (that comes from main()). argv and environ(7) are in contiguous memory space on Linux. The extension presumes that argv[0] can accomodate 128 characters, but usually that is not possible because argv[0] is “php”. When this happens, the extension will scribble on argv[1], argv[2], etc., and maybe even environ and this can have destructive side effects on the running program."
