略微加速

PHP官方手册 - 互联网笔记

PHP - Manual: Phar::addFile

2024-12-21

Phar::addFile

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

Phar::addFile将一个文件从文件系统添加到 phar 档案中

说明

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

注意:

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

通过这个方法,任何文件或者 URL 可以被添加到 phar 档案中。如果第二个可选参数 localName 被设定, 那么文件则会以该参数为名称保存到档案中,此外,file 参数会被作为路径保存在档案中。 URLs 必须提交 localname 参数,否则会抛出异常。 这个方法与 ZipArchive::addFile() 类似。

参数

filename

需要添加到 phar 档案的文件在磁盘上的完全(绝对)或者相对路径。

localName

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

返回值

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

更新日志

版本 说明
8.0.0 localName 现在可以为空。

范例

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

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

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

注释

注意: 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.

参见

add a noteadd a note

User Contributed Notes

There are no user contributed notes for this page.

官方地址:https://www.php.net/manual/en/phar.addfile.php

北京半月雨文化科技有限公司.版权所有 京ICP备12026184号-3