pcntl_exec

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pcntl_exec — Executa o programa especificado no espaço do processo atual

Descrição

pcntl_exec(string $path, array $args = [], array $env_vars = []): bool

Executa o programa com os argumentos fornecidos.

Parâmetros

path: path deve ser o caminho para um executável binário ou um script com um caminho válido apontando para um executável no shebang ( #!/usr/local/bin/perl por exemplo) como a primeira linha. Consulte a página man execve(2) do seu sistema para obter informações adicionais.
args: args é um array de strings de argumentos passadas ao programa.
env_vars: env_vars é um array de strings que são passadas como ambiente para o programa. O array está no formato nome => valor, a chave sendo o nome da variável de ambiente e o valor sendo o valor dessa variável.

Valor Retornado

Retorna false.

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

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

down

eric kilfoil ¶

18 years ago

The pcntl_exec() function works exactly like the standard (unix-style) exec() function.  It differs from the regular PHP exec() function in that the process calling the pcntl_exec() is replaced with the process that gets called.  This is the ideal method for creating children.  In a simple example (that does no error checking):

switch (pcntl_fork()) {
  case 0:
    $cmd = "/path/to/command";
    $args = array("arg1", "arg2");
    pcntl_exec($cmd, $args);
    // the child will only reach this point on exec failure,
    // because execution shifts to the pcntl_exec()ed command
    exit(0);
  default:
    break;
}

// parent continues
echo "I am the parent";

--

since this is not being executed through a shell, you must provide the exact path from the filesystem root.  Look at the execve() man page for more information.

down

agodong at verizon dot net ¶

18 years ago

Some people might find it useful to run other program using the same process as a different user. This is very usefull if the script is running under root. Here is a simple code to achieve that under *nix PHP CLI:

#!/usr/bin/php -q
<?php
//Enter run-as user below (argument needed to be passed when the script is called), otherwise it will run as the caller user process.

$username = $_SERVER['argv'][1];

$user = posix_getpwnam($username);
posix_setuid($user['uid']);
posix_setgid($user['gid']);
pcntl_exec('/path/to/cmd');
?>

I use this as a part of socket program so that a program can be run under different user from remote location.

down

rbemrose at vgmusic dot com ¶

17 years ago

As a side note, if I'm reading the comments below correctly, you should not run this if you're using a PHP webserver module, as it will replace the webserver's process with whatever process you're telling it to run.

＋adicione uma nota