Php/docs/phar.setstub
Phar::setStub
(PHP 5 >= 5.3.0, PHP 7, PECL phar >= 1.0.0)
Phar::setStub — Used to set the PHP loader or bootstrap stub of a Phar archive
说明
public Phar::setStub
( string $stub
[, int $len = -1
] ) : bool
Note:
此方法需要 将
php.ini中的phar.readonly设为0以适合 Phar 对象. 否则, 将抛出PharException.
This method is used to add a PHP bootstrap loader stub to a new Phar archive, or to replace the loader stub in an existing Phar archive.
The loader stub for a Phar archive is used whenever an archive is included directly as in this example:
<?phpinclude 'myphar.phar';?>
The loader is not accessed when including a file through the phar
stream wrapper like so:
<?phpinclude 'phar://myphar.phar/somefile.php';?>
参数
stub- A string or an open stream handle to use as the executable stub for this phar archive.
len
返回值
成功时返回 true， 或者在失败时返回 false。
错误／异常
UnexpectedValueException is thrown if phar.readonly is enabled in php.ini. PharException is thrown if any problems are encountered flushing changes to disk.
范例
Example #1 A Phar::setStub() example
<?phptry { $p = new Phar(dirname(__FILE__) . '/brandnewphar.phar', 0, 'brandnewphar.phar'); $p['a.php'] = '<?php var_dump("Hello");'; $p->setStub('<?php var_dump("First"); Phar::mapPhar("brandnewphar.phar"); __HALT_COMPILER(); ?>'); include 'phar://brandnewphar.phar/a.php'; var_dump($p->getStub()); $p['b.php'] = '<?php var_dump("World");'; $p->setStub('<?php var_dump("Second"); Phar::mapPhar("brandnewphar.phar"); __HALT_COMPILER(); ?>'); include 'phar://brandnewphar.phar/b.php'; var_dump($p->getStub());} catch (Exception $e) { echo 'Write operations failed on brandnewphar.phar: ', $e;}?>
以上例程会输出：
string(5) "Hello"
string(82) "<?php var_dump("First"); Phar::mapPhar("brandnewphar.phar"); __HALT_COMPILER(); ?>"
string(5) "World"
string(83) "<?php var_dump("Second"); Phar::mapPhar("brandnewphar.phar"); __HALT_COMPILER(); ?>"
参见
- Phar::getStub() - Return the PHP loader or bootstrap stub of a Phar archive
- Phar::createDefaultStub() - Create a phar-file format specific stub
