PharFileInfo::setMetadata

PharFileInfo 클래스

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

PharFileInfo::setMetadata — 파일과 함께 저장된 파일별 메타데이터를 설정합니다.


설명

public PharFileInfo::setMetadata(mixed $metadata): void

PharFileInfo::setMetadata()는 파일에 저장된 기존 정보로 나타낼 수 없는 파일에 사용자 정의 데이터를 저장하는 데만 사용해야 합니다. 메타 데이터는 데이터가 크거나 메타 데이터를 포함하는 파일이 많은 경우 phar 아카이브 로드 성능을 크게 저하시킬 수 있습니다. 파일 권한은 기본적으로 phar 내부에서 지원된다는 점에 유의하는 것이 중요합니다. PharFileInfo::chmod() 메서드로 설정할 수 있습니다. phar의 내용을 수정하는 모든 기능과 마찬가지로, 파일이 Phar 아카이브 내에 있는 경우 성공하려면 phar.readonly INI 변수가 꺼져 있어야 합니다. PharData 아카이브 내의 파일에는 이 제한이 없습니다.

메타 데이터에 대한 몇 가지 가능한 용도에는 파일이 phar에서 디스크로 추출될 때 설정되어야 하는 사용자/그룹을 전달하는 것이 포함됩니다. 다른 용도에는 반환할 MIME 유형을 명시적으로 지정하는 것이 포함될 수 있습니다. 그러나 파일을 설명하지만 파일 내부에 포함되어서는 안 되는 유용한 데이터는 저장될 수 있습니다.


매개변수
metadata
파일과 함께 저장할 정보를 포함하는 모든 PHP 변수

반환 값

값이 반환되지 않습니다.


Examples

예제 #1 PharFileInfo::setMetadata() 예제

                  
<?php
// make sure it doesn't exist
@unlink('brandnewphar.phar');
try {
    $p = new Phar(dirname(__FILE__) . '/brandnewphar.phar', 0, 'brandnewphar.phar');
    $p['file.txt'] = 'hello';
    $p['file.txt']->setMetadata(array('user' => 'bill', 'mime-type' => 'text/plain'));
    var_dump($p['file.txt']->getMetaData());
} catch (Exception $e) {
    echo 'Could not create/modify phar: ', $e;
}
?>

위의 예는 다음을 출력합니다.

array(2) {
  ["user"]=>
  string(4) "bill"
  ["mime-type"]=>
  string(10) "text/plain"
}

기타

PHP

웹학교

참조