<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/mysql-xdevapi.setup.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'en',
  ),
  'this' => 
  array (
    0 => 'mysql-xdevapi.installation.php',
    1 => 'Installation',
    2 => 'Installation',
  ),
  'up' => 
  array (
    0 => 'mysql-xdevapi.setup.php',
    1 => 'Installing/Configuring',
  ),
  'prev' => 
  array (
    0 => 'mysql-xdevapi.requirements.php',
    1 => 'Requirements',
  ),
  'next' => 
  array (
    0 => 'mysql-xdevapi.configuration.php',
    1 => 'Runtime Configuration',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/mysql_xdevapi/setup.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="mysql-xdevapi.installation" class="section">
  <h2 class="title">Installation</h2>

  <p class="para">
   This <a href="https://pecl.php.net/" class="link external">&raquo;&nbsp;PECL</a> extension is not bundled with PHP.
  </p>

  <p class="para">
   An example installation procedure on Ubuntu 18.04 with PHP 7.2:
  </p>
<div class="example-contents">
<div class="cdata"><pre>
// Dependencies
$ apt install build-essential libprotobuf-dev libboost-dev openssl protobuf-compiler liblz4-tool zstd

// PHP with the desired extensions; php7.2-dev is required to compile
$ apt install php7.2-cli php7.2-dev php7.2-mysql php7.2-pdo php7.2-xml

// Compile the extension
$ pecl install mysql_xdevapi
</pre></div>
</div>


  <p class="para">
    The <code class="literal">pecl install</code> command does not enable PHP extensions (by default)
    and enabling PHP extensions can be done in several ways. 
    Another PHP 7.2 on Ubuntu 18.04 example:
  </p>

<div class="example-contents">
<div class="cdata"><pre>
// Create its own ini file
$ echo &quot;extension=mysql_xdevapi.so&quot; &gt; /etc/php/7.2/mods-available/mysql_xdevapi.ini

// Use the &#039;phpenmod&#039; command (note: it&#039;s Debian/Ubuntu specific)
$ phpenmod -v 7.2 -s ALL mysql_xdevapi

// A &#039;phpenmod&#039; alternative is to manually symlink it
// $ ln -s /etc/php/7.2/mods-available/mysql_xdevapi.ini /etc/php/7.2/cli/conf.d/20-mysql_xdevapi.ini

// Let&#039;s see which MySQL extensions are enabled now
$ php -m |grep mysql

mysql_xdevapi
mysqli
mysqlnd
pdo_mysql
</pre></div>
</div>


  <p class="para">
   Information for installing this PECL extension may be
found in the manual chapter titled <a href="install.pecl.php" class="link">Installation
of PECL extensions</a>. Additional information such as new releases,
downloads, source files, maintainer information, and a CHANGELOG, can be
located here: 
   <a href="https://pecl.php.net/package/mysql_xdevapi" class="link external">&raquo;&nbsp;https://pecl.php.net/package/mysql_xdevapi</a>.
  </p>
 </div><?php manual_footer($setup); ?>