<?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 => 'zh',
  ),
  'this' => 
  array (
    0 => 'book.parallel.php',
    1 => 'parallel',
    2 => 'parallel',
  ),
  'up' => 
  array (
    0 => 'refs.fileprocess.process.php',
    1 => '进程控制扩展',
  ),
  'prev' => 
  array (
    0 => 'function.system.php',
    1 => 'system',
  ),
  'next' => 
  array (
    0 => 'parallel.setup.php',
    1 => '安装',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    '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">简介</h1>
  <p class="simpara">
   parallel 是适用于 PHP ≥ 7.2.0 的并行并发扩展。自 parallel 1.2.0 起，要求 PHP ≥ 8.0.0。
  </p>
  <p class="simpara">
   下面是并行核心概念的简要描述，更多详细信息可以在手册的这一节中找到。
  </p>
  <div class="simplesect">
   <h3 class="title">Runtime</h3>
   <p class="simpara">
    <span class="classname"><a href="class.parallel-runtime.php" class="classname">parallel\Runtime</a></span> 表示 PHP 解释器线程。将可选的 bootstrap 文件传递给 <span class="methodname"><a href="parallel-runtime.construct.php" class="methodname">parallel\Runtime::__construct()</a></span>
    可用于配置 <span class="classname"><a href="class.parallel-runtime.php" class="classname">parallel\Runtime</a></span>，这通常是自动加载器或者一些其它预加载程序：引导文件将在任何任务执行之前加载。
   </p>
   <p class="simpara">
    构造之后，<span class="classname"><a href="class.parallel-runtime.php" class="classname">parallel\Runtime</a></span> 在 PHP 对象正常作用域规则关闭、杀死或者销毁之前一直可用。<span class="methodname"><a href="parallel-runtime.run.php" class="methodname">parallel\Runtime::run()</a></span>
    允许程序员安排并行执行的任务。<span class="classname"><a href="class.parallel-runtime.php" class="classname">parallel\Runtime</a></span> 有 FIFO 调度，任务将按照调度的顺序执行。
   </p>
  </div>
  <div class="simplesect">
   <h3 class="title">功能性 API</h3>
   <p class="simpara">
    Parallel 在 <span class="classname"><a href="class.parallel-runtime.php" class="classname">parallel\Runtime</a></span> 之上实现了一个功能性的、更高级别的 API，提供了单一函数入口点来通过自动调度执行并行代码：<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">
    Task 只是用于并行执行的 <span class="classname"><a href="class.closure.php" class="classname">Closure</a></span>。<span class="classname"><a href="class.closure.php" class="classname">Closure</a></span> 几乎可以包含任何指令，包含嵌套闭包。但是 task
    中禁止使用一些指令：
    <ul class="itemizedlist">
     <li class="listitem">
     <span class="simpara">yield</span>
     </li>
     <li class="listitem">
     <span class="simpara">使用引用</span>
     </li>
     <li class="listitem">
     <span class="simpara">声明类</span>
     </li>
     <li class="listitem">
     <span class="simpara">声明命名函数</span>
     </li>
    </ul>
   </p>
   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <span class="simpara">
     嵌套闭包可以 yield 或使用引用，但不得包含类声明或命名函数声明。
    </span>
   </p></blockquote>
   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <span class="simpara">
     Task 可能 include 的文件不禁止任何指令。
    </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> 用于访问 task 的返回值，并公开用于取消任务的 API。
   </p>
  </div>
  <div class="simplesect">
   <h3 class="title">Channel</h3>
   <p class="simpara">
    Task 可以通过参数调用，使用词法作用域变量（按值）和返回值（通过 <span class="classname"><a href="class.parallel-future.php" class="classname">parallel\Future</a></span>），但这些仅允许单向通信：它们允许程序员将数据发送到
    task 中并从 task 中检索数据，但不允许 task 之间进行双向通信。<span class="classname"><a href="class.parallel-channel.php" class="classname">parallel\Channel</a></span> API 允许 task
    之间进行双向通信，<span class="classname"><a href="class.parallel-channel.php" class="classname">parallel\Channel</a></span> 是 task 之间类似套接字的链接，程序员可以用于发送和接收数据。
   </p>
  </div>
  <div class="simplesect">
   <h3 class="title">Events</h3>
   <p class="simpara">
    <span class="classname"><a href="class.parallel-events.php" class="classname">parallel\Events</a></span> API 实现了原生特性（<span class="classname"><a href="class.traversable.php" class="classname">Traversable</a></span>）事件循环，和 <span class="methodname"><a href="parallel-events.poll.php" class="methodname">parallel\Events::poll()</a></span>
    方法。允许程序员使用 channel 和 future 组合。程序员只需将 channel 和 future 添加到事件循环中，可以选择使用 <span class="methodname"><a href="parallel-events.setinput.php" class="methodname">parallel\Events::setInput()</a></span> 设置用于写入的
    input。然后进入 foreach：当对象可用时，parallel 将从这些对象中读取和写入数据，同时生成描述已经发生的操作的 <span class="classname"><a href="class.parallel-events-event.php" class="classname">parallel\Events\Event</a></span> 对象。
   </p>
  </div>
   <div class="simplesect">
   <h3 class="title">参见</h3>
   <ul class="simplelist">
    <li><a href="philosophy.parallel.php" class="xref">Philosophy</a></li>
   </ul>
  </div>
 </div>

 






 




 




 




 




 




 




 




 




 







 




 

<ul class="chunklist chunklist_book"><li><a href="parallel.setup.php">安装</a></li><li><a href="philosophy.parallel.php">Philosophy</a></li><li><a href="functional.parallel.php">Functional API</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel.bootstrap.php">parallel\bootstrap</a> — Bootstrapping</li><li><a href="parallel.run.php">parallel\run</a> — Execution</li></ul></li><li><a href="class.parallel-runtime.php">parallel\Runtime</a> — The parallel\Runtime class<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-runtime.construct.php">parallel\Runtime::__construct</a> — Runtime Construction</li><li><a href="parallel-runtime.run.php">parallel\Runtime::run</a> — Execution</li><li><a href="parallel-runtime.close.php">parallel\Runtime::close</a> — Runtime Graceful Join</li><li><a href="parallel-runtime.kill.php">parallel\Runtime::kill</a> — Runtime Join</li></ul></li><li><a href="class.parallel-future.php">parallel\Future</a> — The parallel\Future class<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-future.cancel.php">parallel\Future::cancel</a> — Cancellation</li><li><a href="parallel-future.cancelled.php">parallel\Future::cancelled</a> — State Detection</li><li><a href="parallel-future.done.php">parallel\Future::done</a> — State Detection</li><li><a href="parallel-future.value.php">parallel\Future::value</a> — Resolution</li></ul></li><li><a href="class.parallel-channel.php">parallel\Channel</a> — The parallel\Channel class<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-channel.construct.php">parallel\Channel::__construct</a> — Channel Construction</li><li><a href="parallel-channel.make.php">parallel\Channel::make</a> — Access</li><li><a href="parallel-channel.open.php">parallel\Channel::open</a> — Access</li><li><a href="parallel-channel.recv.php">parallel\Channel::recv</a> — Sharing</li><li><a href="parallel-channel.send.php">parallel\Channel::send</a> — Sharing</li><li><a href="parallel-channel.close.php">parallel\Channel::close</a> — Closing</li></ul></li><li><a href="class.parallel-events.php">parallel\Events</a> — The parallel\Events class<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-events.setblocking.php">parallel\Events::setBlocking</a> — Behaviour</li><li><a href="parallel-events.settimeout.php">parallel\Events::setTimeout</a> — Behaviour</li><li><a href="parallel-events.setinput.php">parallel\Events::setInput</a> — Input</li><li><a href="parallel-events.addchannel.php">parallel\Events::addChannel</a> — Targets</li><li><a href="parallel-events.addfuture.php">parallel\Events::addFuture</a> — Targets</li><li><a href="parallel-events.remove.php">parallel\Events::remove</a> — Targets</li><li><a href="parallel-events.poll.php">parallel\Events::poll</a> — Polling</li></ul></li><li><a href="class.parallel-events-input.php">parallel\Events\Input</a> — The parallel\Events\Input class<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-events-input.add.php">parallel\Events\Input::add</a> — Inputs</li><li><a href="parallel-events-input.clear.php">parallel\Events\Input::clear</a> — Inputs</li><li><a href="parallel-events-input.remove.php">parallel\Events\Input::remove</a> — Inputs</li></ul></li><li><a href="class.parallel-events-event.php">parallel\Events\Event</a> — The parallel\Events\Event class</li><li><a href="class.parallel-events-event-type.php">parallel\Events\Event\Type</a> — The parallel\Events\Event\Type class</li><li><a href="class.parallel-sync.php">parallel\Sync</a> — The parallel\Sync class<ul class="chunklist chunklist_book chunklist_children"><li><a href="parallel-sync.construct.php">parallel\Sync::__construct</a> — Construction</li><li><a href="parallel-sync.get.php">parallel\Sync::get</a> — Access</li><li><a href="parallel-sync.set.php">parallel\Sync::set</a> — Access</li><li><a href="parallel-sync.wait.php">parallel\Sync::wait</a> — Synchronization</li><li><a href="parallel-sync.notify.php">parallel\Sync::notify</a> — Synchronization</li><li><a href="parallel-sync.invoke.php">parallel\Sync::__invoke</a> — Synchronization</li></ul></li></ul></div><?php manual_footer($setup); ?>