« PharFileInfo::isCompressedPharException »PHP ManualPharFileInfo

PharFileInfo::setMetadata

(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-архіву. Важливо пам'ятати, що архіви з коробки підтримують права на файли і їх можна задати за допомогою методу PharFileInfo::chmod(). Так як ця функціональність змінює phar-архів, необхідно, щоб опція phar.readonly було відключено, інакше внести зміни до архіву Phar не вийде. На архіви PharData обмеження на запис не поширюється.

Метадані файлів можна використовувати, наприклад, для вказівки, які права треба призначити файлу під час експорту його на диск, або для вказівки MIME-типу, який він повертає. Загалом - будь-яка корисна інформація, якій не місце всередині файлу.

Список параметрів

metadata

Будь-яка змінна PHP, що містить необхідну інформацію

Значення, що повертаються

Функція не повертає значення після виконання.

Приклади

Приклад #1 Приклад використання PharFileInfo::setMetadata()****

Loading...

Результат виконання наведеного прикладу:

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

Дивіться також