<?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.pthreads.php',
    1 => 'pthreads',
    2 => 'pthreads',
  ),
  'up' => 
  array (
    0 => 'refs.fileprocess.process.php',
    1 => 'Extens&otilde;es para Controle de Processo',
  ),
  'prev' => 
  array (
    0 => 'parallel-sync.invoke.php',
    1 => 'parallel\\Sync::__invoke',
  ),
  'next' => 
  array (
    0 => 'pthreads.setup.php',
    1 => 'Instala&ccedil;&atilde;o/Configura&ccedil;&atilde;o',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/pthreads/book.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/book.pthreads.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

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

 <div id="intro.pthreads" class="preface">
  <h1 class="title">Introdução</h1>
  <p class="simpara">
   pthreads é uma API orientada a objetos que fornece todas as ferramentas necessárias
   para multithreading em PHP. Aplicações PHP podem criar, ler, escrever,
   executar e sincronizar com Threads, Workers e objetos Threaded.
  </p>
  <div class="warning"><strong class="warning">Aviso</strong>
   <p class="simpara">
    Esta extensão é considerada sem manutenção e inoperante.
   </p>
  </div>
  <div class="tip"><strong class="tip">Dica</strong>
   <p class="simpara">
    Considere usar <a href="book.parallel.php" class="link">parallel</a> no lugar.
   </p>
  </div>
  <div class="warning"><strong class="warning">Aviso</strong>
   <p class="simpara">
    A extensão pthreads não pode ser usada em um ambiente de servidor web.
    Threading em PHP é, portanto, restrito apenas a aplicações baseadas em CLI.
   </p>
  </div>
  <div class="warning"><strong class="warning">Aviso</strong>
   <p class="simpara">
    pthreads (v3) só pode ser usado com PHP 7.2+: Isso ocorre porque o modo ZTS
    não é seguro em 7.0 e 7.1.
   </p>
  </div>
  <p class="simpara">
   A classe <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span> forma a base da
   funcionalidade que permite a operação dos pthreads. Expõe métodos de sincronização
   e algumas interfaces úteis para o programador.
  </p>
  <p class="simpara">
   A classe <span class="classname"><a href="class.thread.php" class="classname">Thread</a></span> permite que threads sejam criadas
   simplesmente estendendo-as e implementando um método <code class="literal">run</code>. Quaisquer
   membros podem ser gravados e lidos por qualquer contexto com uma referência ao
   thread. Qualquer contexto também pode executar qualquer método público e protegido.
   O corpo do método run será executado em um thread separado quando o
   método <span class="methodname"><a href="thread.start.php" class="methodname">Thread::start()</a></span> da implementação for
   chamado a partir do contexto que o criou. Somente o contexto que cria um
   thread pode iniciar e ingressar nele.
  </p>
  <p class="simpara">
   A classe <span class="classname"><a href="class.worker.php" class="classname">Worker</a></span> tem um estado persistente e estará
   disponível a partir da chamada para <span class="methodname"><a href="thread.start.php" class="methodname">Thread::start()</a></span> (um
   método herdado) até que o objeto saia do escopo ou seja explicitamente
   desligamento (via <span class="methodname"><a href="worker.shutdown.php" class="methodname">Worker::shutdown()</a></span>). Qualquer contexto com uma
   referência ao objeto worker pode empilhar tarefas no Worker (via
   <span class="methodname"><a href="worker.stack.php" class="methodname">Worker::stack()</a></span>), onde essas tarefas serão executadas
   pelo worker em um thread separado. O método <code class="literal">run</code> de um
   objeto worker será executado antes de qualquer objeto na pilha do worker,
   permitindo a inicialização de recursos que os objetos a serem executados possam
   necessitar.
  </p>
  <p class="simpara">
   A classe <span class="classname"><a href="class.pool.php" class="classname">Pool</a></span> é usada para criar um grupo de workers
   para distribuir objetos <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span> entre eles. É a
   maneira mais fácil e eficiente de usar vários threads em
   aplicações PHP.
  </p>
  <div class="caution"><strong class="caution">Cuidado</strong>
   <p class="simpara">
    A classe <span class="classname"><a href="class.pool.php" class="classname">Pool</a></span> não estende a classe
    <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span> e, portanto, objetos baseados em pool são
    considerados objetos PHP normais. Como tal, as suas instâncias não devem ser
    partilhadas entre diferentes contextos.
   </p>
  </div>
  <p class="simpara">
   A classe <span class="classname"><a href="class.volatile.php" class="classname">Volatile</a></span> é nova no pthreads v3. É usado
   para denotar propriedades <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span> mutáveis de classes
   <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span> (uma vez que agora são imutáveis por
   padrão). Também é usado para armazenar arrays PHP em
   contextos <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span>.
  </p>
  <p class="simpara">
   A sincronização é uma habilidade importante durante o threading. Todos os objetos
   que o pthreads cria possuem sincronização integrada na forma (que será
   familiar aos programadores java) de
   <span class="methodname"><a href="threaded.wait.php" class="methodname">Threaded::wait()</a></span> e
   <span class="methodname"><a href="threaded.notify.php" class="methodname">Threaded::notify()</a></span>. Chamar
   <span class="methodname"><a href="threaded.wait.php" class="methodname">Threaded::wait()</a></span> em um objeto fará com que o contexto
   espere por outro contexto para chamar
   <span class="methodname"><a href="threaded.notify.php" class="methodname">Threaded::notify()</a></span> no mesmo objeto. Este mecanismo
   permite uma sincronização poderosa entre objetos <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span>
   em PHP.
  </p>
  <div class="caution"><strong class="caution">Cuidado</strong>
  <p class="simpara">
   Quaisquer objetos destinados ao uso nas partes multithread de sua
   aplicação devem estender <span class="classname"><a href="class.threaded.php" class="classname">Threaded</a></span>.
  </p>
  </div>
  <p class="simpara">
   Armazenamento de dados:
   Como regra geral, qualquer tipo de dados que possa ser serializado pode ser usado como membro de um objeto Threaded, ele pode ser lido e escrito a partir de qualquer contexto com uma referência ao objeto Threaded.
   Nem todo tipo de dados é armazenado em série; os tipos básicos são armazenados em sua forma verdadeira.
   Tipos complexos, arrays e objetos que não são encadeados são armazenados serialmente; eles podem ser lidos e gravados no Threaded Object a partir de qualquer contexto com uma referência.
   Com exceção dos Objetos Threaded, qualquer referência usada para definir um membro de um Objeto Threaded é separada da referência no Objeto Threaded;
   os mesmos dados podem ser lidos diretamente do Objeto Threaded a qualquer momento por qualquer contexto com uma referência ao Objeto Threaded.
  </p>
  <p class="simpara">
   Membros Estáticos:
   Quando um novo contexto é criado (Thread ou Worker), geralmente eles são copiados, mas recursos e objetos com estado interno são anulados (por questões de segurança). Isso permite que eles funcionem como uma espécie de armazenamento local de threads. Por exemplo, ao iniciar o contexto, uma classe cujos membros estáticos incluem informações de conexão para um servidor de banco de dados, e a própria conexão, terá apenas as informações de conexão simples copiadas, não a conexão. Permitir que o novo contexto inicie uma conexão da mesma forma que o contexto que a criou, armazenando a conexão no mesmo local sem afetar o contexto original.
  </p>
  <div class="caution"><strong class="caution">Cuidado</strong>
  <p class="simpara">
   Quando print_r, var_dump e outras funções de depuração de objetos são executadas, elas não incluem proteção recursiva.
  </p>
  </div>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <span class="simpara">
    Recursos:
    As extensões e funcionalidades que definem recursos em PHP são completamente despreparadas para este tipo de ambiente; O pthreads prevê que os recursos sejam compartilhados entre contextos; no entanto, para a maioria dos tipos de recursos, isso deve ser considerado inseguro. Deve-se ter extrema cautela e cuidado ao compartilhar recursos entre contextos.
   </span>
  </p></blockquote>
  <div class="caution"><strong class="caution">Cuidado</strong>
   <p class="simpara">
    No ambiente em que o pthreads é executado, algumas restrições e limitações são necessárias para fornecer um ambiente estável.
   </p>
  </div>
 </div>

 




 




 




 




 




 




 




 





<ul class="chunklist chunklist_book"><li><a href="pthreads.setup.php">Instala&ccedil;&atilde;o/Configura&ccedil;&atilde;o</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="pthreads.requirements.php">Depend&ecirc;ncias</a></li><li><a href="pthreads.installation.php">Instala&ccedil;&atilde;o</a></li></ul></li><li><a href="pthreads.constants.php">Constantes predefinidas</a></li><li><a href="class.threaded.php">Threaded</a> — A classe Threaded<ul class="chunklist chunklist_book chunklist_children"><li><a href="threaded.chunk.php">Threaded::chunk</a> — Manipula&ccedil;&atilde;o</li><li><a href="threaded.count.php">Threaded::count</a> — Manipula&ccedil;&atilde;o</li><li><a href="threaded.extend.php">Threaded::extend</a> — Manipula&ccedil;&atilde;o em tempo de execu&ccedil;&atilde;o</li><li><a href="thread.isrunning.php">Threaded::isRunning</a> — Detec&ccedil;&atilde;o de estado</li><li><a href="threaded.isterminated.php">Threaded::isTerminated</a> — Detec&ccedil;&atilde;o de estado</li><li><a href="threaded.merge.php">Threaded::merge</a> — Manipula&ccedil;&atilde;o</li><li><a href="threaded.notify.php">Threaded::notify</a> — Sincroniza&ccedil;&atilde;o</li><li><a href="threaded.notifyone.php">Threaded::notifyOne</a> — Sincroniza&ccedil;&atilde;o</li><li><a href="threaded.pop.php">Threaded::pop</a> — Manipula&ccedil;&atilde;o</li><li><a href="threaded.run.php">Threaded::run</a> — Execu&ccedil;&atilde;o</li><li><a href="threaded.shift.php">Threaded::shift</a> — Manipula&ccedil;&atilde;o</li><li><a href="threaded.synchronized.php">Threaded::synchronized</a> — Sincroniza&ccedil;&atilde;o</li><li><a href="threaded.wait.php">Threaded::wait</a> — Sincroniza&ccedil;&atilde;o</li></ul></li><li><a href="class.thread.php">Thread</a> — A classe Thread<ul class="chunklist chunklist_book chunklist_children"><li><a href="thread.getcreatorid.php">Thread::getCreatorId</a> — Identifica&ccedil;&atilde;o</li><li><a href="thread.getcurrentthread.php">Thread::getCurrentThread</a> — Identifica&ccedil;&atilde;o</li><li><a href="thread.getcurrentthreadid.php">Thread::getCurrentThreadId</a> — Identifica&ccedil;&atilde;o</li><li><a href="thread.getthreadid.php">Thread::getThreadId</a> — Identifica&ccedil;&atilde;o</li><li><a href="thread.isjoined.php">Thread::isJoined</a> — Detec&ccedil;&atilde;o de estado</li><li><a href="thread.isstarted.php">Thread::isStarted</a> — Detec&ccedil;&atilde;o de estado</li><li><a href="thread.join.php">Thread::join</a> — Sincroniza&ccedil;&atilde;o</li><li><a href="thread.start.php">Thread::start</a> — Execu&ccedil;&atilde;o</li></ul></li><li><a href="class.worker.php">Worker</a> — A classe Worker<ul class="chunklist chunklist_book chunklist_children"><li><a href="worker.collect.php">Worker::collect</a> — Coleta refer&ecirc;ncias a tarefas conclu&iacute;das</li><li><a href="worker.getstacked.php">Worker::getStacked</a> — Obt&eacute;m o tamanho da pilha restante</li><li><a href="worker.isshutdown.php">Worker::isShutdown</a> — Detec&ccedil;&atilde;o de estado</li><li><a href="worker.shutdown.php">Worker::shutdown</a> — Desliga o trabalhador</li><li><a href="worker.stack.php">Worker::stack</a> — Trabalho de empilhamento</li><li><a href="worker.unstack.php">Worker::unstack</a> — Trabalho de desempilhamento</li></ul></li><li><a href="class.collectable.php">Collectable</a> — A interface Collectable<ul class="chunklist chunklist_book chunklist_children"><li><a href="collectable.isgarbage.php">Collectable::isGarbage</a> — Determina se um objeto foi marcado como lixo</li></ul></li><li><a href="class.pool.php">Pool</a> — A classe Pool<ul class="chunklist chunklist_book chunklist_children"><li><a href="pool.collect.php">Pool::collect</a> — Coleta refer&ecirc;ncias a tarefas conclu&iacute;das</li><li><a href="pool.construct.php">Pool::__construct</a> — Cria um novo pool de trabalhadores</li><li><a href="pool.resize.php">Pool::resize</a> — Redimensiona o Pool</li><li><a href="pool.shutdown.php">Pool::shutdown</a> — Desliga todos os trabalhadores</li><li><a href="pool.submit.php">Pool::submit</a> — Envia um objeto para execu&ccedil;&atilde;o</li><li><a href="pool.submitTo.php">Pool::submitTo</a> — Envia uma tarefa a um trabalhador espec&iacute;fico para execu&ccedil;&atilde;o</li></ul></li><li><a href="class.volatile.php">Volatile</a> — A classe Volatile</li></ul></div><?php manual_footer($setup); ?>