PHP マニュアル: Phar アーカイブの PHP ローダー (起動スタブ) をデフォルトのローダーに設定する

説明

public true Phar::setDefaultStub(stringnull $index = null, stringnull $webIndex = null)

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

このメソッドは、 Phar::createDefaultStub と Phar::setStub の両方の機能を組み合わせた便利なメソッドです。

パラメータ

index: コマンドラインからアクセスした場合に実行する、 phar アーカイブ内の相対パス。
webIndex: ウェブブラウザからアクセスした場合に実行する、 phar アーカイブ内の相対パス。

戻り値

常に true を返します。

エラー / 例外

phar.readonly が php.ini で有効になっている場合に UnexpectedValueException をスローします。変更内容をディスクに書き込む際にエラーが発生した場合は PharException をスローします。

変更履歴

バージョン	説明
8.4.0	Phar::setDefaultStub の仮の戻り値の型が、true になりました。
8.0.0	`webIndex` は、nullable になりました。

例

例1 Phar::setDefaultStub の例

<?php
try {
    $phar = new Phar('myphar.phar');
    $phar->setDefaultStub('cli.php', 'web/index.php');
    // これは、以下と同じ意味です
    // $phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php'));
} catch (Exception $e) {
    // エラー処理
}
?>

参考

Phar::setStub
Phar::createDefaultStub