Копирует файл внутри tar- или zip-архива в новый файл внутри того же архива

# PharData::copy

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

PharData::copy — Копирует файл внутри tar- или zip-архива в новый файл внутри того же архива

### Описание

public function PharData::copy(string `$from`, string `$to`): true

Метод копирует файл из tar- или zip-архива в новый файл внутри того же архива. Это объектно-ориентированная альтернатива функции copy() с обёрткой потока phar.

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

`from`

`to`

### Возвращаемые значения

Функция возвращает логическое значение `true`.

### Ошибки

Метод выбрасывает исключение UnexpectedValueException, если исходный файл не существует, целевой файл уже существует, доступ на запись запретили, если хотя бы один файл невозможно открыть или невозможно прочитать исходный файл, или выбрасывает исключение PharException, если в phar-файл невозможно записать изменения.

### Примеры

Пример #1 Пример копирования файла внутри tar- или zip-архива методом PharData::copy()

Пример показывает работу метода PharData::copy() и эквивалентной ему по функциональности обёртки потока для решения одной и той же задачи. Основная разница между подходами состоит в обработке ошибок. Методы класса PharData выбрасывают исключения, а обёртка потока использует функцию trigger_error().

    <?php

    try {
        $phar = new PharData('myphar.tar');

        $phar['a'] = 'привет';
        $phar->copy('a', 'b');

        echo $phar['b']; // Выводит "phar://myphar.tar/b"
    } catch (Exception $e) {
        // Обработка ошибок
    }

    // Обёртка потока эквивалентна приведённому коду.
    // Вместо исключения срабатывает ошибка уровня E_WARNING
    copy('phar://myphar.tar/a', 'phar//myphar.tar/c');
    echo file_get_contents('phar://myphar.tar/c'); // Выведет "привет"

    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open