PharData::convertToData

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

PharData::convertToData — phar 아카이브를 실행 불가능한 tar 또는 zip 파일로 변환


설명

public PharData::convertToData(?int $format = null, ?int $compression = null, ?string $extension = null): ?PharData

이 메서드는 실행할 수 없는 tar 또는 zip 아카이브를 다른 실행할 수 없는 형식으로 변환하는 데 사용됩니다.

변경 사항이 지정되지 않은 경우 이 메서드는 BadMethodCallException을 throw합니다. 이 메서드는 tar 아카이브를 zip 형식으로 또는 그 반대로 변환하는 데 사용해야 합니다. 이 메서드를 사용하여 tar 아카이브의 압축을 간단히 변경할 수도 있지만 논리적 일관성을 위해 PharData::compress() 메서드를 사용하는 것이 좋습니다.

성공하면 이 메서드는 디스크에 새 아카이브를 만들고 PharData 개체를 반환합니다. 이전 아카이브는 디스크에서 제거되지 않으며 프로세스가 완료된 후 수동으로 수행해야 합니다.


매개변수

format
Phar::TAR 또는 Phar::ZIP 중 하나여야 합니다. null로 설정하면 기존 파일 형식이 유지됩니다.
compression
전체 아카이브 압축이 없는 경우 Phar::NONE, zlib 기반 압축의 경우 Phar::GZ, bzip 기반 압축의 경우 Phar::BZ2 중 하나여야 합니다.
extension
이 매개변수는 변환된 아카이브의 기본 파일 확장자를 재정의하는 데 사용됩니다. .phar는 실행할 수 없는 tar 또는 zip 아카이브의 파일 이름 어디에도 사용할 수 없습니다.

tar 기반 phar 아카이브로 변환하는 경우 기본 확장자는 지정된 압축에 따라 .tar, .tar.gz.tar.bz2입니다. zip 기반 아카이브의 경우 기본 확장자는 .zip입니다.


반환 값

이 메서드는 성공하면 PharData 개체를 반환하고 실패하면 null을 반환합니다.


오류/예외

이 메서드는 파르 생성 과정중에 압축할 수 없는 경우 BadMethodCallException을 throw하고, 알 수 없는 압축 메서드가 지정되었으며, 요청된 아카이브가 Phar::startBuffering()으로 버퍼링 중이고 Phar::stopBuffering()으로 종료되지 않았으며, 실행 중에 문제가 발생하면 PharException이 발생합니다.


변경 로그

버전 설명
8.0.0 format,compressionextension는 이제 null을 허용합니다.

Examples

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

PharData::convertToData() 사용:

                  
<?php
try {
    $tarphar = new PharData('myphar.tar');
    // note that myphar.tar is *not* unlinked
    // convert it to the non-executable tar file format
    // creates myphar.zip
    $zip = $tarphar->convertToData(Phar::ZIP);
    // create myphar.tbz
    $tgz = $zip->convertToData(Phar::TAR, Phar::BZ2, '.tbz');
    // creates myphar.phar.tgz
    $phar = $tarphar->convertToData(Phar::PHAR); // throws exception
} catch (Exception $e) {
    // handle the error here
}
?>
                  
                

기타