PharData::decompress

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

PharData::decompress — 전체 Phar 아카이브의 압축을 풉니다.


설명

public PharData::decompress(?string $extension = null): ?PharData

tar 기반 아카이브의 경우 이 메소드는 전체 아카이브의 압축을 풉니다.

Zip 기반 아카이브의 경우 이 메소드는 예외와 함께 실패합니다. gzip 압축으로 압축된 아카이브의 압축을 풀려면 zlib 확장을 활성화해야 하고 bzip2 압축으로 압축된 아카이브의 압축을 풀려면 bzip2 확장을 활성화해야 합니다.

또한 이 메소드는 기본적으로 아카이브의 파일 확장명인 .tar의 이름을 자동으로 바꿉니다. 또는 extension 매개변수를 사용하여 파일 확장자를 지정할 수 있습니다.


매개변수

extension
압축 해제의 경우 기본 파일 확장자는 .tar입니다. 다른 파일 확장자를 지정하려면 이 매개변수를 사용하십시오. 실행 가능한 아카이브만 파일 이름에 .phar를 포함할 수 있다는 점에 유의하십시오.

반환 값

PharData 개체는 성공하면 반환되고 실패하면 null이 반환됩니다.


오류/예외

zlib 확장을 사용할 수 없거나 bzip2 확장이 활성화되어 있지 않으면 BadMethodCallException을 던집니다.


변경 로그

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

Examples

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

                  
<?php
$p = new PharData('/path/to/my.tar.gz');
$p->decompress(); // creates /path/to/my.tar
?>
                  
                

기타