PHP 8.4.1 Released!

PharData::setMetadata

(No version information available, might only be in Git)

PharData::setMetadataSets phar archive meta-data

Descrizione

public PharData::setMetadata(mixed $metadata): void

Nota:

This method requires the php.ini setting phar.readonly to be set to 0 in order to work for Phar objects. Otherwise, a PharException will be thrown.

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.

Elenco dei parametri

metadata

Any PHP variable containing information to store that describes the phar archive

Valori restituiti

Nessun valore viene restituito.

Esempi

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;
}
?>

Il precedente esempio visualizzerà:

array(1) {
  ["bootstrap"]=>
  string(8) "file.php"
}

Vedere anche:

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top