array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'parallel.run.php', 1 => 'parallel\\run', 2 => 'Execução', ), 'up' => array ( 0 => 'functional.parallel.php', 1 => 'API funcional', ), 'prev' => array ( 0 => 'parallel.bootstrap.php', 1 => 'parallel\\bootstrap', ), 'next' => array ( 0 => 'class.parallel-runtime.php', 1 => 'parallel\\Runtime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/parallel/functions/parallel.run.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

parallel\run

(1.0.0)

parallel\run — Execução

Descrição

parallel\run(Closure $task): ?Future

Agenda a tarefa informada em task para execução em paralelo.

parallel\run(Closure $task, array $argv): ?Future

Agenda a tarefa informada em task para execução em paralelo, passando os argumentos argv no momento da execução.

Agendamento Automático

Se um \parallel\Runtime criado internamente e armazenado em cache por uma chamada anterior a parallel\run() estiver ocioso, ele será usado para executar a tarefa. Se nenhum \parallel\Runtime estiver ocioso, o parallel criará e armazenará em cache um \parallel\Runtime.

Nota: Objetos \parallel\Runtime criados pelo programador não são usados ​​para agendamento automático.

Parâmetros

task
Uma Closure com características específicas.
argv
Um array de argumentos com características específicas a ser passado para task no momento da execução.

Características da tarefa

As Closures programadas para execução paralela não devem:

As instruções proibidas em Closures destinadas à execução paralela são:

Nota: Fechamentos aninhados podem usar yield ou referências, mas não devem conter declarações de classe ou funções nomeadas.

Nota: Nenhuma instrução é proibida nos arquivos que a tarefa pode incluir.

Características dos Argumentos

Os argumentos não devem conter:

Nota: No caso de recursos de fluxo de arquivo, o recurso será convertido para o descritor de arquivo e passado como int sempre que possível. Isso não é suportado no Windows.

Notas sobre Objetos Internos

Objetos internos geralmente usam uma estrutura personalizada que não pode ser copiada por valor com segurança. Atualmente, o PHP não possui o mecanismo necessário para fazer isso (sem serialização). Portanto, apenas objetos que não usam uma estrutura personalizada podem ser compartilhados.

Alguns objetos internos não usam uma estrutura personalizada, por exemplo parallel\Events\Event e, portanto, podem ser compartilhados.

Closures são um tipo especial de objeto interno e suporte que estão sendo copiados por valor e, portanto, podem ser compartilhadas.

Os canais são essenciais para escrever código paralelo e oferecem suporte ao acesso e execução simultâneos por necessidade e, portanto, podem ser compartilhados.

Aviso

Uma classe de usuário que estende uma classe interna pode usar uma estrutura personalizada, conforme definida pela classe interna, e nesse caso não pode ser copiada por valor com segurança, e, portanto, não pode ser compartilhada.

Valor Retornado

Aviso

O parallel\Future retornado não deve ser ignorado quando a tarefa contém uma instrução return ou throw.

Exceções

Aviso

Lança uma exceção parallel\Runtime\Error\Closed se parallel\Runtime tiver sido fechada.

Aviso

Lança uma exceção parallel\Runtime\Error\IllegalFunction se task é uma closure criada a partir de uma função interna.

Aviso

Lança uma exceção parallel\Runtime\Error\IllegalInstruction se task contiver instruções ilegais.

Aviso

Lança uma exceção parallel\Runtime\Error\IllegalParameter se task aceitar ou argv contiver variáveis ilegais.

Aviso

Lança uma exceção parallel\Runtime\Error\IllegalReturn se task retornar ilegalmente.

Veja Também