<?xml version="1.0" encoding="utf-8"?>

<chapter xml:id="libxml.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

&reftitle.setup;

<!-- {{{ Requirements -->

<section xml:id="libxml.requirements">

&reftitle.required;

<para>

この拡張モジュールは、PHP 8.4.0 以降では <link xlink:href="&url.libxml;">libxml</link> &gt;=

2.9.4 が、PHP 8.4.0 より前のバージョンでは、libxml &gt;= 2.9.0 が、PHP 8.0.0 より前のバージョンでは libxml &gt;= 2.6.0 が必要です。

</para>

</section>

<!-- }}} -->

<!-- {{{ Installation PHP >= 7.4 -->

<section xml:id="libxml.installation">

<title>PHP &gt;= 7.4 におけるインストール手順</title>

<para>

libxml 拡張モジュールはデフォルトで有効となりますが、

<option role="configure">--without-libxml</option>

で無効になっている可能性もあります。

</para>

<para>

PHP は libxml2 向けの正しいライブラリファイルやヘッダファイル、

コンパイルフラグを選ぶために <literal>pkg-config</literal> を使います。

configure スクリプトを実行する前に、

望ましいバージョンの libxml2 が選ばれるようにするために、

<literal>pkg-config</literal> の検索パスを制御する目的で

以下のようにして環境変数 <envar>PKG_CONFIG_PATH</envar> が使えます:

<![CDATA[PKG_CONFIG_PATH="/path/to/libxml2/prefix/lib/pkgconfig:/lib/pkgconfig"]]>

</para>

</section>

<!-- }}} -->

<!-- {{{ Installation PHP < 7.4 -->

<section xml:id="libxml.installation_old">

<title>PHP &lt; 7.4 におけるインストール手順</title>

<para>

libxml 拡張モジュールはデフォルトで有効となりますが、

<option role="configure">--disable-libxml</option>

で無効になっている可能性もあります。

</para>

<para>

オプションの <option role="configure">--with-libxml-dir</option>

ディレクティブを使って、PHP をコンパイルするシステム上での

<literal>libxml</literal> の位置を指定することができます。

指定しなければ、デフォルトの場所のみを探します。<literal>configure</literal> の際に libxml

(具体的には <literal>xml2-config</literal>) を探す順序は次のとおりです。

</para>

<orderedlist>

<listitem>

<para>

<option role="configure">--with-libxml-dir</option> で指定した ([DIR]) 場所

([DIR]=<filename>/bin/xml2-config</filename>)

</para>

</listitem>

<listitem>

<para>

<filename>/usr/local/bin/xml2-config</filename>

</para>

</listitem>

<listitem>

<para>

<filename>/usr/bin/xml2-config</filename>

</para>

</listitem>

</orderedlist>

<para>

<literal>configure</literal> 時に <option role="configure">--with-libxml-dir</option> で指定したディレクトリで

<filename>xml2-config</filename> が見つからない場合は、デフォルトの場所を探します。

</para>

</section>

<!-- }}} -->

</chapter>