<dependencies> タグによって依存性の情報を再構成しました。 依存性はグループ化され、属性の情報はタグに展開されました。 また、わかりやすくして可読性を高めるため、単語を省略することを やめました。package.xml バージョン 1.0 の一部を抜粋した

<deps>
 <dep type="pkg" rel="ge" version="1.3.1">Archive_Tar</dep>
 <dep type="php" rel="ge" version="4.2.0"/>
 <dep type="pkg" rel="has" optional="yes">PEAR_Frontend_Web</dep>
</deps>

は、package.xml 2.0 ではこのような形式になります。

<dependencies>
 <required>
  <pearinstaller>
   <min>1.4.8</min>
  </pearinstaller>
  <php>
   <min>4.2.0</min>
  </php>
  <package>
   <name>Archive_Tar</name>
   <channel>pear.php.net</channel>
   <min>1.3.1</min>
  </package>
 </required>
 <optional>
  <package>
   <name>PEAR_Frontend_Web</name>
   <channel>pear.php.net</channel>
  </package>
 </optional>
</dependencies>

これらの変更により、xml の妥当性検証およびパースを単純化しました。 package.xml 1.0 とは異なり、<pearinstaller> および <php> の依存性はすべての package.xml で必須となることに注意しましょう。 さらに、<pearinstaller> および <php> の中では <min> タグが必須となります。

オプションの依存性グループを使うと、 必須ではないけれども一括して導入する必要のある機能群を定義することができます。 この機能セットは <package> および <extension> 依存性で構成されています。 たとえば、あるパッケージのオプションとしてリモートシェルでの操作をする機能があるとしましょう。 その場合は、オプションの依存性グループ remoteshell を作って PECL 拡張モジュール ssh2 と SSH_RemoteShell パッケージ (架空のものです) を設定します。 依存性グループは、package.xml で次のように設定します。

<group name="remoteshell" hint="Add support for Remote Shell Operations">
 <package>
  <name>SSH_RemoteShell</name>
  <channel>pear.php.net</channel>
 </package>
 <extension>
  <name>ssh2</name>
 </extension>
</group>

この依存性グループをインストールするには pear install Packagename#remoteshell のようにします。

<pearinstaller> は、package.xml のパースおよびインストールを 適切に行うための PEAR の最小バージョンを定義します。バージョン情報を サポートしている他のすべての依存性タグと同様、以下の 4 つのタグが サポートされており、これでバージョンを定義します。

• <min> - この package.xml をインストールするために要求される PEAR の最小バージョン。このタグは、package.xml の <pearinstaller> 依存性の中で必須です。

• <max> - サポートしている PEAR インストーラの最大バージョン。 使用する際には注意してください! このタグを使用すると、PEAR の 新しいバージョンを使用している人がパッケージをインストール できなくなってしまいます!

• <recommended> - PEAR インストーラの推奨バージョン。 このタグは、バージョンの管理をより厳しくするために使用します。 --force オプションを指定しない限り、推奨バージョンに 一致していないバージョンではインストールできなくなります。 これは、特別なセキュリティのレベルを提供するために使用できます。 パッケージのインストールが正しく動作することを確認済みの バージョンを指定したうえで、さらに将来のアップグレードを 妨げることもなくなります。

• <exclude> - 互換性のない PEAR インストーラのバージョン。 これは、パッケージを正常にインストールすることができない PEAR のバージョンを避けるために使用します。複数のバージョンを 指定する場合には、<exclude> タグを複数指定します。

バージョン情報をサポートしている他のすべての依存性タグと同様、 以下の 4 つのタグがサポートされており、これでバージョンを定義します。

• <min> - この package.xml をインストールするために要求される PHP の最小バージョン。このタグは、package.xml の <php> 依存性の中で必須です。

• <max> - サポートしている PHP の最大バージョン。

• <exclude> - 互換性のない PHP のバージョン。 これは、パッケージを正常にインストールすることができない PHP のバージョンを避けるために使用します。複数のバージョンを 指定する場合には、<exclude> タグを複数指定します。

サブパッケージ依存性は、パッケージ依存性と同じ xml 書式となります。 サブパッケージ依存性を使用するのは、パッケージが複数に分割される場合のみです。 言い換えれば、もし子パッケージの中に親パッケージと同名のファイルの 旧バージョンが含まれていた場合、通常は子パッケージが親パッケージと 競合します。というのも親パッケージのファイルを上書きしてしまうことに なるからです。

簡単な例を挙げて考えてみましょう。 パッケージ Foo 1.0.0 には Foo.php および Foo/Bar.php が含まれています。 パッケージ Foo の開発者は、Foo を 2 つのパッケージ Foo および Foo_Bar に分けることにしました。Foo 1.1.0 には foo.php が含まれ、Foo_Bar 0.1.0 には Foo/Bar.php が含まれます。この場合、Foo_Bar 0.1.0 は Foo 1.0.0 と競合します。というのも両方に Foo/Bar.php が含まれているからです。

Foo_Bar に対する subpackage 依存性を Foo に設定しておくと、インストーラは Foo 1.0.0 の Foo.php と Foo 1.1.0 の Foo.php の競合を無視するのと同様に Foo 1.0.0 の Foo/Bar.php と Foo_Bar 0.1.0 の Foo/Bar.php の競合も無視します。

ご理解いただけるとおり、<package> 依存性は PEAR の依存性の中でも 最も複雑なものです。PEAR 1.4.0 では 3 種類のパッケージ依存性を サポートしています。

1. チャネルサーバを基にした、通常のパッケージ依存性 (package.xml 1.0 と同じ考え方)。

2. PHP 拡張モジュールを提供するパッケージ (PECL など) との依存性 (サーバベースおよび URI ベースの両方)。

3. 静的な URI を基にしたパッケージ依存性。

<deps>
 <dep type="pkg" rel="has">PEAR</dep>
</deps>

<dependencies>
 <required>
<!-- ... -->
  <package>
   <name>PEAR</name>
   <channel>pear.php.net</channel>
  </package>
 </required>
</dependencies>

<dep type="pkg" rel="has">Foo</dep>

<package>
 <name>Foo</name>
 <channel>pear.php.net</channel>
</package>

<dep type="pkg" rel="ge" version="1.0.0">Foo</dep>

<package>
 <name>Foo</name>
 <channel>pear.php.net</channel>
 <min>1.0.0</min>
</package>

<dep type="pkg" rel="gt" version="1.0.0">Foo</dep>

<package>
 <name>Foo</name>
 <channel>pear.php.net</channel>
 <min>1.0.0</min>
 <exclude>1.0.0</exclude>
</package>

<dep type="pkg" rel="le" version="1.0.0">Foo</dep>

<package>
 <name>Foo</name>
 <channel>pear.php.net</channel>
 <max>1.0.0</max>
</package>

<dep type="pkg" rel="ge" version="1.0.0">Foo</dep>

<package>
 <name>Foo</name>
 <channel>pear.php.net</channel>
 <max>1.0.0</max>
 <exclude>1.0.0</exclude>
</package>

<dep type="pkg" rel="ge" version="1.0.0">Foo</dep>
<dep type="pkg" rel="le" version="1.9.0">Foo</dep>

<package>
 <name>Foo</name>
 <channel>pear.php.net</channel>
 <min>1.0.0</min>
 <max>1.9.0</max>
</package>

<dep type="pkg" rel="not">Foo</dep>

<package>
 <name>Foo</name>
 <channel>pear.php.net</channel>
 <conflicts/>
</package>

<package>
 <name>Foo<name>
 <uri>http://www.example.com/Foo-1.3.0</uri>
</package>

<package>
 <name>PDO</name>
 <channel>pecl.php.net</channel>
 <min>0.3.1</min>
 <providesextension>PDO</providesextension>
</package>

バージョン情報をサポートしている他のすべての依存性タグと同様、 標準のバージョン情報タグ (min、max、recommended、exclude) をすべてサポートされています。それに加えて <conflicts> タグがサポートされており、これによって 反依存性をサポートします。

• <min> - この package.xml をインストールするために必要な PHP 拡張モジュールの最小バージョン。

• <max> - サポートされる PHP 拡張モジュールの最大バージョン。

• <recommended> - 推奨される PHP 拡張モジュールのバージョン。 このタグは、バージョンの管理をより厳しくするために使用します。 --force オプションを指定しない限り、推奨バージョンに 一致していないバージョンではインストールできなくなります。 これは、特別なセキュリティのレベルを提供するために使用できます。 パッケージのインストールが正しく動作することを確認済みの バージョンを指定したうえで、さらに将来のアップグレードを 妨げることもなくなります。

• <exclude> - 互換性のない PHP 拡張モジュールのバージョン。 複数のバージョンを指定する場合には、<exclude> タグを複数指定します。

• <conflicts> - 依存性を否定します。 もし拡張モジュールが存在すれば、依存性の要求は 満たされずにインストールが失敗します。

OS 依存性は、特定の系統の OS (unix など) や固有の OS (darwin あるいは freebsd など) のみにパッケージを制限するために使用します。 以下に例を示します。

<os>
 <name>linux</name>
</os>

特定の OS 以外のすべての環境でパッケージをインストール できるよう指定するには、<conflicts/> タグを使用します。

<os>
 <name>windows</name>
 <conflicts/>
</os>

使用可能な OS の値は以下のとおりです。

• windows

• unix

• linux

• freebsd

• darwin (Mac OS X のことです)

• sunos

• irix

• hpux

• aix

さらに、 php_uname() 関数がサポートしているものであれば、どんな難しい OS でも 使用可能です。OS として "unix" を指定すると、 linux、freebsd、darwin、sunos、irix、hpux あるいは aix のすべてが対象となります。

arch (アーキテクチャ) 依存性は、特定の OS およびプロセッサのみに パッケージを制限するために使用します。以下に例を示します。

<arch>
 <pattern>linux-*-i386-*</pattern>
</arch>

特定のアーキテクチャ以外のすべての環境でパッケージをインストール できるよう指定するには、<conflicts/> タグを使用します。

<arch>
 <pattern>linux-*-i?86-*</pattern>
 <conflicts/>
</arch>

アーキテクチャのパターンは OS_Guess->matchSignature() メソッドで定義され、sysname[-release[-cpu[-extra]]] のような形式になります。[] で囲まれている部分はオプションです。 また、すべての部分でワイルドカードとして "*" を使用可能です。さらに、1 文字のみを表すワイルドカードとして "?" が使用可能です。たとえば i?86 は i386、i686、i586 などにマッチします。

sysname の意味は OS 依存性と同じですが、unix はサポートされていません。

release は、OS のバージョンです。

cpu は特定の CPU を表します。一般的な値は i?86、sparc、powerpc です。

extra は、php_uname() の最後に付加される その他の項目です。glibc のバージョンなどが含まれます。