<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/refs.fileprocess.process.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'book.parallel.php',
    1 => 'parallel',
    2 => 'parallel',
  ),
  'up' => 
  array (
    0 => 'refs.fileprocess.process.php',
    1 => 'Extens&otilde;es para Controle de Processo',
  ),
  'prev' => 
  array (
    0 => 'function.system.php',
    1 => 'system',
  ),
  'next' => 
  array (
    0 => 'parallel.setup.php',
    1 => 'Instala&ccedil;&atilde;o',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/parallel/book.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/book.parallel.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="book.parallel" class="book">
 
 <h1 class="title">parallel</h1>
 

 <div id="intro.parallel" class="preface">
  <h1 class="title">Introdução</h1>
  <p class="simpara">
   parallel é uma extensão de simultaneidade paralela para PHP ≥ 7.2.0.
   A partir do parallel 1.2.0, PHP ≥ 8.0.0 é necessário.
  </p>
  <p class="simpara">
   Segue uma breve descrição dos conceitos básicos do parallel; informações mais detalhadas podem ser encontradas nesta seção do manual.
  </p>
  <div class="simplesect">
   <h3 class="title">Runtime</h3>
   <p class="simpara">
    Um <span class="classname"><a href="class.parallel-runtime.php" class="classname">parallel\Runtime</a></span> representa um thread interpretador de PHP. Um <span class="classname"><a href="class.parallel-runtime.php" class="classname">parallel\Runtime</a></span> é configurado com um arquivo de bootstrap opcional passado para <span class="methodname"><a href="parallel-runtime.construct.php" class="methodname">parallel\Runtime::__construct()</a></span>, normalmente é um autoloader
    ou alguma outra rotina de pré-carregamento: O arquivo de bootstrap irá ser incluído antes de qualquer tarefa ser executada.
   </p>
   <p class="simpara">
    Após a construção, o <span class="classname"><a href="class.parallel-runtime.php" class="classname">parallel\Runtime</a></span> permanece disponível até ser fechado, eliminado ou destruído pelas regras normais de escopo dos objetos PHP.
    <span class="methodname"><a href="parallel-runtime.run.php" class="methodname">parallel\Runtime::run()</a></span> permite ao programador agendar tarefas para execução em paralelo.
    Um <span class="classname"><a href="class.parallel-runtime.php" class="classname">parallel\Runtime</a></span> possui um agendamento FIFO, as tarefas serão executadas na ordem em que foram agendadas.
   </p>
  </div>
  <div class="simplesect">
   <h3 class="title">API funcional</h3>
   <p class="simpara">
    parallel implementa uma API funcional de nível superior sobre <span class="classname"><a href="class.parallel-runtime.php" class="classname">parallel\Runtime</a></span> que fornece um único ponto de entrada de função para executar código paralelo
    com agendamento automático: <span class="function"><a href="parallel.run.php" class="function">parallel\run()</a></span>.
   </p>
  </div>
  <div class="simplesect">
   <h3 class="title">Task</h3>
   <p class="para">
    Uma tarefa é simplesmente um <span class="classname"><a href="class.closure.php" class="classname">Closure</a></span> destinado à execução paralela. O <span class="classname"><a href="class.closure.php" class="classname">Closure</a></span> pode conter quase qualquer instrução, incluindo closures aninhados.
    Porém, existem algumas instruções que são proibidas nas tarefas:
    <ul class="itemizedlist">
     <li class="listitem">
     <span class="simpara">yield</span>
     </li>
     <li class="listitem">
     <span class="simpara">operador &#039;use&#039; por referência</span>
     </li>
     <li class="listitem">
     <span class="simpara">declaração de classe</span>
     </li>
     <li class="listitem">
     <span class="simpara">declaração de função com nome</span>
     </li>
    </ul>
   </p>
   <blockquote class="note"><p><strong class="note">Nota</strong>: 
    <span class="simpara">
     Closures aninhados podem ter &#039;use&#039; por referência ou &#039;yield&#039;, mas não devem conter declarações de classe ou de função nomeada.
    </span>
   </p></blockquote>
   <blockquote class="note"><p><strong class="note">Nota</strong>: 
    <span class="simpara">
     Nenhuma instrução é proibida nos arquivos que a tarefa pode incluir.
    </span>
   </p></blockquote>
  </div>
  <div class="simplesect">
   <h3 class="title">Future</h3>
   <p class="simpara">
    <span class="classname"><a href="class.parallel-future.php" class="classname">parallel\Future</a></span> é usado para acessar o valor de retorno da tarefa e expõe uma API para cancelamento da tarefa.
   </p>
  </div>
  <div class="simplesect">
   <h3 class="title">Channel</h3>
   <p class="simpara">
    Uma tarefa pode ser agendada com argumentos, usar variáveis de escopo léxico (por valor) e retornar um valor (através de um <span class="classname"><a href="class.parallel-future.php" class="classname">parallel\Future</a></span>), mas estes só permitem comunicação unidirecional:
    Eles permitem que o programador envie e recupere dados de uma tarefa, mas não permitem a comunicação bidirecional entre tarefas.
    A API <span class="classname"><a href="class.parallel-channel.php" class="classname">parallel\Channel</a></span> permite a comunicação bidirecional entre tarefas, um <span class="classname"><a href="class.parallel-channel.php" class="classname">parallel\Channel</a></span> é uma conexão entre tarefas semelhante a um soquete que o programador pode usar para enviar e receber dados.
   </p>
  </div>
  <div class="simplesect">
   <h3 class="title">Events</h3>
   <p class="simpara">
    A API <span class="classname"><a href="class.parallel-events.php" class="classname">parallel\Events</a></span> implementa um loop de eventos de sensação nativa (<span class="classname"><a href="class.traversable.php" class="classname">Traversable</a></span>) e um método <span class="methodname"><a href="parallel-events.poll.php" class="methodname">parallel\Events::poll()</a></span>.
    Permite ao programador trabalhar com conjuntos de channels e/ou futures.
    O programador simplesmente adiciona channels e futures ao loop de eventos, opcionalmente definindo a entrada para gravações com <span class="methodname"><a href="parallel-events.setinput.php" class="methodname">parallel\Events::setInput()</a></span>,
    e entra em um foreach: parallel irá ler e escrever em objetos à medida que eles se tornam disponíveis produzindo objetos <span class="classname"><a href="class.parallel-events-event.php" class="classname">parallel\Events\Event</a></span>
    que descrevem as operações que ocorreram.
   </p>
  </div>
   <div class="simplesect">
   <h3 class="title">Veja Também</h3>
   <ul class="simplelist">
    <li><a href="philosophy.parallel.php" class="xref">Filosofia</a></li>
   </ul>
  </div>
 </div>

 




 




 




 




 




 




 




 




 




 







 




 

<ul class="chunklist chunklist_book"><li><a href="parallel.setup.php">Instala&ccedil;&atilde;o</a></li><li><a href="philosophy.parallel.php">Filosofia</a></li><li><a href="functional.parallel.php">API funcional</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel.bootstrap.php">parallel\bootstrap</a> — Inicializa&ccedil;&atilde;o</li><li><a href="parallel.run.php">parallel\run</a> — Execu&ccedil;&atilde;o</li></ul></li><li><a href="class.parallel-runtime.php">parallel\Runtime</a> — A classe parallel\Runtime<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-runtime.construct.php">parallel\Runtime::__construct</a> — Constru&ccedil;&atilde;o de Runtime</li><li><a href="parallel-runtime.run.php">parallel\Runtime::run</a> — Execu&ccedil;&atilde;o</li><li><a href="parallel-runtime.close.php">parallel\Runtime::close</a> — Encerramento elegante de Runtime</li><li><a href="parallel-runtime.kill.php">parallel\Runtime::kill</a> — Encerramento de Runtime</li></ul></li><li><a href="class.parallel-future.php">parallel\Future</a> — A classe parallel\Future<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-future.cancel.php">parallel\Future::cancel</a> — Cancelamento</li><li><a href="parallel-future.cancelled.php">parallel\Future::cancelled</a> — Detec&ccedil;&atilde;o de estado</li><li><a href="parallel-future.done.php">parallel\Future::done</a> — Detec&ccedil;&atilde;o de estado</li><li><a href="parallel-future.value.php">parallel\Future::value</a> — Resolu&ccedil;&atilde;o</li></ul></li><li><a href="class.parallel-channel.php">parallel\Channel</a> — A classe parallel\Channel<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-channel.construct.php">parallel\Channel::__construct</a> — Constru&ccedil;&atilde;o de canal</li><li><a href="parallel-channel.make.php">parallel\Channel::make</a> — Constru&ccedil;&atilde;o de canal</li><li><a href="parallel-channel.open.php">parallel\Channel::open</a> — Acesso</li><li><a href="parallel-channel.recv.php">parallel\Channel::recv</a> — Compartilhamento</li><li><a href="parallel-channel.send.php">parallel\Channel::send</a> — Compartilhamento</li><li><a href="parallel-channel.close.php">parallel\Channel::close</a> — Fechamento</li></ul></li><li><a href="class.parallel-events.php">parallel\Events</a> — A classe parallel\Events<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-events.setblocking.php">parallel\Events::setBlocking</a> — Comportamento</li><li><a href="parallel-events.settimeout.php">parallel\Events::setTimeout</a> — Comportamento</li><li><a href="parallel-events.setinput.php">parallel\Events::setInput</a> — Entrada</li><li><a href="parallel-events.addchannel.php">parallel\Events::addChannel</a> — Alvos</li><li><a href="parallel-events.addfuture.php">parallel\Events::addFuture</a> — Alvos</li><li><a href="parallel-events.remove.php">parallel\Events::remove</a> — Alvos</li><li><a href="parallel-events.poll.php">parallel\Events::poll</a> — Pesquisa</li></ul></li><li><a href="class.parallel-events-input.php">parallel\Events\Input</a> — A classe parallel\Events\Input<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-events-input.add.php">parallel\Events\Input::add</a> — Entradas</li><li><a href="parallel-events-input.clear.php">parallel\Events\Input::clear</a> — Entradas</li><li><a href="parallel-events-input.remove.php">parallel\Events\Input::remove</a> — Entradas</li></ul></li><li><a href="class.parallel-events-event.php">parallel\Events\Event</a> — A classe parallel\Events\Event</li><li><a href="class.parallel-events-event-type.php">parallel\Events\Event\Type</a> — A classe parallel\Events\Event\Type</li><li><a href="class.parallel-sync.php">parallel\Sync</a> — A classe parallel\Sync<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-sync.construct.php">parallel\Sync::__construct</a> — Constru&ccedil;&atilde;o</li><li><a href="parallel-sync.get.php">parallel\Sync::get</a> — Acesso</li><li><a href="parallel-sync.set.php">parallel\Sync::set</a> — Acesso</li><li><a href="parallel-sync.wait.php">parallel\Sync::wait</a> — Sincroniza&ccedil;&atilde;o</li><li><a href="parallel-sync.notify.php">parallel\Sync::notify</a> — Sincroniza&ccedil;&atilde;o</li><li><a href="parallel-sync.invoke.php">parallel\Sync::__invoke</a> — Sincroniza&ccedil;&atilde;o</li></ul></li></ul></div><?php manual_footer($setup); ?>