PharData::addFile

(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 아카이브에 추가할 수 있습니다. 선택적 두 번째 매개변수 localname이 지정되면 파일은 해당 이름으로 아카이브에 저장됩니다. 그렇지 않으면 file 매개변수가 아카이브에 저장할 경로로 사용됩니다. URL에는 지역 이름이 있어야 하며 그렇지 않으면 예외가 발생합니다. 이 메서드는 ZipArchive::addFile()과 유사합니다.


매개변수

filename
phar 아카이브에 추가할 디스크의 파일에 대한 전체 또는 상대 경로입니다.
localName
파일이 아카이브에 저장될 경로입니다.

반환 값

반환 값이 없으며 실패 시 예외가 발생합니다.


변경 로그

버전 설명
8.0.0 localName은 이제 null을 허용합니다.

Examples

예제 #1 PharData::addFile() 예제

                  
<?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()를 대신 사용해야 합니다.


기타