replace タスクには、3 つの必須属性があります。

1. type - これは package-info あるいは pear-config のいずれかである必要があります。package-info の場合は package.xml 自身から取得した情報をもとに置換を行い、 pear-config の場合は設定変数 (

   pear config-show

   で表示されるもの) の値をもとに置換を行います。

2. from - 変換元となるテキストです。 通常のテキストと区別するため、これは伝統的に "@" で囲まれ、例えば from="@version@" のようになります。

3. to - "from" が現れた際に変換するために 使用する抽象項目。package-info の場合に変換候補として指定可能なのは、 以下のいずれかです。api-state、api-version、channel、 date、description、license、license-uri、name、notes、release_date、release-license、release_notes、 state、summary、time、version そしてパッケージによっては extends、providesextension、srcpackage および srcuri。

package-info 型の置換はパッケージの作成時に行われることに注意しましょう。 そのため、.tgz/.tar リリースの中には置換後のファイルが含められます。 pear-config 型の置換はインストールシステムによってのみ行われ、 インストールの際に実行されます。

このタスクは、Windows 固有のファイル (DOS のバッチファイルなど) を 非 Windows 環境 (たとえば行末を \n に変換してしまう Unix など) で 作成することを可能にします。このタスクは、インストール時だけでなく パッケージ作成時にも実行されることに注意しましょう。そのため、 .tgz/.tar リリースの中には正しい行末のファイルが含まれます。

このタスクは、Unix 固有のファイル (シェルスクリプトなど) を 非 Unix 環境 (たとえば行末を \r\n に変換してしまう Windows など) で 作成することを可能にします。このタスクは、インストール時だけでなく パッケージ作成時にも実行されることに注意しましょう。そのため、 .tgz/.tar リリースの中には正しい行末のファイルが含まれます。

postinstallscript タスクは、参照しているファイルが インストール後に実行するスクリプトであることを インストーラに通知します。

セキュリティ上の理由により、このスクリプトはユーザによって 手動で実行させなければなりません。そのため、インストーラは このタスクをその他のタスクとは別の特別なコードで管理します。

<postinstallscript> タグでは、インストーラがユーザからの入力を 取得するために使用するパラメータを定義しています。 Web インストーラおよびコマンドラインインストーラの両方をサポートするには、 すべての入力を PEAR で処理し、インストール後スクリプトに所定の形式で 渡す必要があります。あなたがしなければならないことは、 <postinstallscript> タグの内部で使用するパラメータを定義することだけです。

パラメータつきの単純なインストール後スクリプトを表す xml は、 このようになります。

<tasks:postinstallscript>
 <paramgroup>
  <id>first</id>
  <param>
   <name>test</name>
   <prompt>Testing Thingy</prompt>
   <type>string</type>
  </param>
 </paramgroup>
</tasks:postinstallscript>

この段階では、"string" 型のみがサポートされることに注意しましょう。 その他の型もいずれサポートされる予定です。 次に、より複雑な例を示します。

<tasks:postinstallscript>
 <paramgroup>
  <id>first</id>
  <param>
   <name>test</name>
   <prompt>Testing Thingy</prompt>
   <type>string</type>
   <default>hi</default>
  </param>
  <param>
   <name>test2</name>
   <prompt>Testing Thingy 2</prompt>
   <type>string</type>
  </param>
 </paramgroup>
 <paramgroup>
  <id>second</id>
  <name>first::test</name>
  <conditiontype>preg_match</conditiontype>
  <value>g+</value>
  <param>
   <name>test</name>
   <prompt>Testing Thingy a</prompt>
   <type>string</type>
   <default>hi</default>
  </param>
  <param>
   <name>test2</name>
   <prompt>Testing Thingy b</prompt>
   <type>string</type>
  </param>
 </paramgroup>
</tasks:postinstallscript>

このスクリプトには 2 つのパラメータグループがあります。まず最初の グループが処理された後に、2 番目のグループが処理されます (自然な 流れです)。しかし、ここでは 2 番目のグループは条件付きの パラメータグループとなっています。これは、前のパラメータグループでの ユーザの入力を検証し、それが条件を満たす場合にのみプロンプトを 表示します。条件は、3 つのタグ <tasks:name>、<tasks:conditiontype> および <tasks:value> で指定します。3 つのタグはすべて必須であり、 ひとつでも欠けていると xml の妥当性検証に失敗することに注意しましょう。

<tasks:name> は、前のパラメータグループのパラメータ名です。書式は グループ ID::パラメータ名 のようになります。つまり、上の例の "first::test" は、<tasks:paramgroup> first の <tasks:param> test のことを指します。

<tasks:conditiontype> は、<tasks:name> で指定したパラメータの値を どのように処理するかを定義します。"="、"!=" あるいは "preg_match" のいずれかとなります。

• =: これは (明らかに) パラメータの値が <tasks:value> タグと 等しいかどうかを調べます。

• !=: これは (明らかに) パラメータの値が <tasks:value> タグと 等しくないかどうかを調べます。

• preg_match: これは、<tasks:value> タグの内容を、 preg_match() 関数の / および / の間の値として使用します。正規表現には、両端の // を 「含めないでください」。2 番目の <tasks:paramgroup> において、 値 "g+" は以下のように扱われます。

  <?php
preg_match('/g+/', first::test value)
?>