PHP8 Phar::addFile

2024-02-20 09:16 更新

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

Phar::addFile — 將一個文件從文件系統(tǒng)添加到 phar 檔案中

說明

public Phar::addFile(string $filename, ?string $localName = null): void
注意:此方法需要 將 php.ini 中的 phar.readonly 設(shè)為 0 以適合 Phar 對象. 否則, 將拋出PharException.

通過這個方法，任何文件或者 URL 可以被添加到 phar 檔案中。如果第二個可選參數(shù) localName 被設(shè)定， 那么文件則會以該參數(shù)為名稱保存到檔案中，此外，file 參數(shù)會被作為路徑保存在檔案中。 URLs 必須提交 localname 參數(shù)，否則會拋出異常。 這個方法與 ZipArchive::addFile() 類似。

參數(shù)

filename

需要添加到 phar 檔案的文件在磁盤上的完全（絕對）或者相對路徑。

localName

文件保存到檔案時的路徑。

返回值

沒有返回值，失敗時會拋出異常。

更新日志

版本說明
8.0.0localName 現(xiàn)在可以為空。

示例

示例 #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.

參見

  • Phar::offsetSet() - Set the contents of an internal file to those of an external file
  • PharData::addFile() - Add a file from the filesystem to the tar/zip archive
  • Phar::addFromString() - 以字符串的形式添加一個文件到 phar 檔案
  • Phar::addEmptyDir() - 添加一個空目錄到 phar 檔案


以上內(nèi)容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號