PHP8 PharData::addFile

2024-02-22 11:48 更新

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

PharData::addFile — 将文件系统中的文件添加到 tar/zip 存档中

说明

public PharData::addFile(string $filename, ?string $localName = null): void

使用此方法,可以将任何文件或 URL 添加到 tar/zip 存档中。如果 指定了可选的第二个参数, 该文件将以该名称存储在存档中,否则该参数将用作存储在 存档。URL 必须具有 localname,否则会引发异常。 此方法类似于 ZipArchive::addFile()。localnamefile

参数 

filename

要添加的磁盘上文件的完整路径或相对路径 到Phar档案馆。

localName

文件将存储在存档中的路径。

返回值 

无返回值,失败时引发异常。

更新日志 

版本说明
8.0.0localName现在是可为 null 的。

示例 

示例 #1 A PharData::addFile() example

<?php
try {
    $a = new PharData('/path/to/my.tar');

    $a->addFile('/full/path/to/file');
    // demonstrates how this file is stored
    $b = $a['full/path/to/file']->getContent();

    $a->addFile('/full/path/to/file', 'my/file.txt');
    $c = $a['my/file.txt']->getContent();

    // demonstrate URL usage
    $a->addFile('http://www.example.com', 'example.html');
} catch (Exception $e) {
    // handle errors here
}
?>

注释 

注意: PharData::addFile(), PharData:: addFromString() 和 PharData::offsetSet() 每次调用它们时都会保存一个新的 phar 存档。如果性能是一个问题,则应改用 PharData::buildFromDirectory() 或 PharData::buildFromIterator()。

参见 

  • PharData::offsetSet() - 将 tar/zip 中文件的内容设置为外部文件或字符串的内容
  • Phar::addFile() - 将一个文件从文件系统添加到 phar 档案中
  • PharData::addFromString() - 将字符串中的文件添加到 tar/zip 存档中
  • PharData::addEmptyDir() - 在 tar/zip 存档中添加一个空目录


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号