PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

Phar::addFromString — 以字符串的形式添加一个文件到 phar 档案

说明

public Phar::addFromString(string $localName, string $contents): void

注意:此方法需要 将 php.ini 中的 phar.readonly 设为 0 以适合 Phar 对象. 否则, 将抛出PharException.

通过这个方法，任何字符串都可以被添加到 phar 档案中。 文件将会以 localname 为路径保存到档案中。 这个方法与 ZipArchive::addFromString() 类似。

参数

localName

文件保存到档案时的路径。

contents

要保存的文件内容。

返回值

没有返回值，失败时会抛出异常。

示例

示例 #1 一个 Phar::addFromString() 示例

<?php
try {
    $a = new Phar('/path/to/phar.phar');

    $a->addFromString('path/to/file.txt', 'my simple file');
    $b = $a['path/to/file.txt']->getContent();

    // to add contents from a stream handle for large files, use offsetSet()
    $c = fopen('/path/to/hugefile.bin');
    $a['largefile.bin'] = $c;
    fclose($c);
} catch (Exception $e) {
    // handle errors here
}
?>

注释

注意: Phar::addFile(), Phar::addFromString() and Phar::offsetSet() save a new phar archive each time they are called. If performance is a concern, Phar::buildFromDirectory() or Phar::buildFromIterator() should be used instead.

参见

• Phar::offsetSet() - Set the contents of an internal file to those of an external file
• PharData::addFromString() - Add a file from a string to the tar/zip archive
• Phar::addFile() - 将一个文件从文件系统添加到 phar 档案中
• Phar::addEmptyDir() - 添加一个空目录到 phar 档案