©
本文檔使用 php中文網手册 發布
(PHP >= 5.3.0, PECL phar >= 1.0.0)
Phar::setMetadata — Sets phar archive meta-data
$metadata
)Note:
此方法需要 将 php.ini 中的 phar.readonly 设为 0 以适合 Phar 对象. 否则, 将抛出PharException.
Phar::setMetadata() should be used to store customized data that describes something about the phar archive as a complete entity. PharFileInfo::setMetadata() should be used for file-specific meta-data. Meta-data can slow down the performance of loading a phar archive if the data is large.
Some possible uses for meta-data include specifying which file within the archive should be used to bootstrap the archive, or the location of a file manifest like » PEAR's package.xml file. However, any useful data that describes the phar archive may be stored.
metadata
Any PHP variable containing information to store that describes the phar archive
没有返回值。
Example #1 A Phar::setMetadata() example
<?php
// make sure it doesn't exist
@ unlink ( 'brandnewphar.phar' );
try {
$p = new Phar ( dirname ( __FILE__ ) . '/brandnewphar.phar' , 0 , 'brandnewphar.phar' );
$p [ 'file.php' ] = '<?php echo "hello"' ;
$p -> setMetadata (array( 'bootstrap' => 'file.php' ));
var_dump ( $p -> getMetadata ());
} catch ( Exception $e ) {
echo 'Could not create and/or modify phar:' , $e ;
}
?>
以上例程会输出:
array(1) { ["bootstrap"]=> string(8) "file.php" }