Phar::setAlias

(PECL phar:1.2.1)

Phar::setAlias — Phar アーカイブのエイリアスを設定する

説明

bool Phar::setAlias ( string $alias )

注意: このメソッドは、php.ini の phar.readonly が 0 でないと Phar オブジェクトで動作しません。それ以外の場合は PharException がスローされます。

Phar アーカイブのエイリアスを設定し、そのアーカイブのエイリアスとして書き込みます。エイリアスは phar アーカイブで内部的に使用するもので、 phar ストリームラッパーがアーカイブ内のファイルにアクセスする際にそのアーカイブのファイルシステム上での場所を気にせずにすむようになります。それ以外の方法としては、Phar が内部的に include() を横取りすることを利用したり Phar::interceptFileFuncs() を使って相対パスを利用したりといったものがあります。

パラメータ

alias: このアーカイブを指すときに使用する短い文字列。 phar ストリームラッパーがアクセスする際にこれを使用します。

返り値

エラー / 例外

書き込みアクセスが無効となっている場合に UnexpectedValueException をスローします。また、そのエイリアスが既に使用済みである場合や変更をディスクに書き込むときにエラーが発生した場合は PharException をスローします。

例

例1 Phar::setAlias() の例


<?php
try {
    $phar = new Phar('myphar.phar');
    $phar->setAlias('myp.phar');
} catch (Exception $e) {
    // エラー処理
}
?>

参考

add a note User Contributed Notes
Phar::setAlias

There are no user contributed notes for this page.

Phar::setDefaultStub

Phar::running

Last updated: Fri, 05 Sep 2008