<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/yar.setup.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'yar.installation.php',
    1 => '安装',
    2 => '安装',
  ),
  'up' => 
  array (
    0 => 'yar.setup.php',
    1 => '安装/配置',
  ),
  'prev' => 
  array (
    0 => 'yar.requirements.php',
    1 => '需求',
  ),
  'next' => 
  array (
    0 => 'yar.configuration.php',
    1 => '运行时配置',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/yar/setup.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="yar.installation" class="section">
  <h2 class="title">安装</h2>
  <p class="simpara">
   Yar 有三种安装方式：通过 PECL、通过 PIE，或从源码构建。
  </p>
  <p class="simpara">
   此 <a href="https://pecl.php.net/" class="link external">&raquo;&nbsp;PECL</a> 扩展未与 PHP 捆绑。
  </p>
  <p class="simpara">
   安装此 PECL 扩展相关的信息可在手册中标题为
<a href="install.pecl.php" class="link">PECL
扩展的安装</a>章节中找到。更多信息如新的发行版本、下载、源文件、
维护人员信息及变更日志等，都在此处：
   <a href="https://pecl.php.net/package/yar" class="link external">&raquo;&nbsp;https://pecl.php.net/package/yar</a>。
  </p>
  <p class="simpara">
   此扩展在 Windows 平台的二进制扩展 (<abbr title="Dynamic Link Library">DLL</abbr> 文件) 
<abbr title="PHP Extension Community Library">PECL</abbr> 可以在 PECL 官方网站上下载。
  </p>
  <div class="example" id="example-1">
   <p><strong>示例 #1 用 PECL 安装 Yar</strong></p>
   <div class="example-contents">
<div class="shellcode"><pre class="shellcode">pecl install yar</pre>
</div>
   </div>

  </div>
  <p class="simpara">
   自 Yar 2.4.0 起，也可以使用 <a href="https://github.com/php/pie" class="link external">&raquo;&nbsp;PIE</a>（PHP Installer for
   Extensions，PHP 扩展安装器）安装本扩展。在命令行执行以下命令：
  </p>
  <div class="example" id="example-2">
   <p><strong>示例 #2 用 PIE 安装 Yar</strong></p>
   <div class="example-contents">
<div class="shellcode"><pre class="shellcode">pie install laruence/yar</pre>
</div>
   </div>

  </div>
  <p class="simpara">
   安装时可以同时启用 msgpack 打包器：
  </p>
  <div class="example" id="example-3">
   <p><strong>示例 #3 用 PIE 安装 Yar 并启用 msgpack</strong></p>
   <div class="example-contents">
<div class="shellcode"><pre class="shellcode">pie install laruence/yar --enable-msgpack</pre>
</div>
   </div>

  </div>
  <p class="simpara">
   源代码托管在
   <a href="https://github.com/laruence/yar" class="link external">&raquo;&nbsp;GitHub</a> 上。
   若要自源码构建该扩展，请在命令行执行以下命令，
   并把其中的路径替换为本地 PHP 安装的实际路径：
  </p>
  <div class="example" id="example-4">
   <p><strong>示例 #4 从源码构建 Yar</strong></p>
   <div class="example-contents">
<div class="shellcode"><pre class="shellcode">/path/to/phpize
./configure --with-php-config=/path/to/php-config
make &amp;&amp; make install</pre>
</div>
   </div>

  </div>
  <p class="simpara">
   可用的 <code class="literal">configure</code> 选项如下：
  </p>
  <dl>
   
    <dt>
     <strong class="option configure">--with-curl</strong>
    </dt>
    <dd>
     <p class="simpara">
      当 cURL 不在默认的 include 路径中时，
      指定 cURL 的安装位置。
     </p>
    </dd>
   
   
    <dt>
     <strong class="option configure">--enable-msgpack</strong>
    </dt>
    <dd>
     <p class="simpara">
      启用 <code class="literal">msgpack</code> 打包器，并将
      <code class="literal">msgpack</code> 扩展作为可选依赖。当
      Yar 使用该选项编译时，
      <a href="yar.configuration.php#ini.yar.packager" class="link">yar.packager</a> 的默认值变为
      <code class="literal">msgpack</code>。
     </p>
    </dd>
   
   
    <dt>
     <strong class="option configure">--enable-epoll</strong>
    </dt>
    <dd>
     <p class="simpara">
      使用 Linux <code class="literal">epoll</code> 代替
      <code class="literal">select()</code> 进行 I/O 多路复用，自
      Yar 2.1.2 起可用。在高并发场景下，该选项可以提升
      <span class="classname"><a href="class.yar-concurrent-client.php" class="classname">Yar_Concurrent_Client</a></span> 的性能。
      它仅在 Linux 上生效；在其他平台上会被静默忽略。
     </p>
    </dd>
   
  </dl>
 </div><?php manual_footer($setup); ?>