Phar::copy
(PHP 5 >= 5.3.0, PHP 7, PECL phar >= 2.0.0)
Phar::copy — Копирует один файл внутри phar-архива в другой новый файл внутри phar-архива
Описание
$oldfile
, string $newfile
) : boolЗамечание:
Для корректной работы с объектами Phar этому методу необходима установка значения php.ini
phar.readonlyв0. В противном случае, будет выброшено исключение PharException.
Копирует внутренний файл phar-архива в другой новый файл внутри phar-архива. Это объектно-ориентированная альтернатива использованию copy() с оберткой потока phar.
Список параметров
-
oldfile -
-
newfile -
Возвращаемые значения
возвращает true в случае успеха, но безопаснее заключить вызов метода
в блок try/catch и считать его успешным, если не было выброшено исключение.
Ошибки
Выбрасывает исключение UnexpectedValueException если: исходный файл не существует, целевой файл уже существует, доступ на запись отключен, открытие какого-либо файла невозможно или чтение исходного файла потерпело неудачу. Если запись изменений в phar не удалась, будет выброшено исключение PharException.
Примеры
Пример #1 Пример использования Phar::copy()
В этом примере показано использование метода Phar::copy() и эквивалентной ему по функциональности обертки потока для решения одной и той же задачи. Основным различием между этими двумя подходами является обработка ошибок. Все методы Phar выбрасывают исключения, тогда как обертка потока использует trigger_error().
<?php
try {
$phar = new Phar('myphar.phar');
$phar['a'] = 'привет';
$phar->copy('a', 'b');
echo $phar['b']; // будет выведено "привет"
} catch (Exception $e) {
// обработка ошибок
}
// обертка потока, эквивалентная коду выше.
// в случае ошибки будет вызвано предупреждение E_WARNING, а не исключение
copy('phar://myphar.phar/a', 'phar//myphar.phar/c');
echo file_get_contents('phar://myphar.phar/c'); // будет выведено "привет"
?>