Phar::setMetadata()
(PHP 5 >= 5.3.0, PHP 7, PECL phar >= 1.0.0)
Sets phar archive meta-data
说明
public Phar::setMetadata(mixed $metadata): void
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
返回值
没有返回值。
范例
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" }
参见
- Phar::getMetadata() Returns phar archive meta-data
- Phar::delMetadata() Deletes the global metadata of the phar
- Phar::hasMetadata() Returns whether phar has global meta-data