Documentación offline PHP master

Phar::copy

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Phar::copy

Copia un fichero perteneciente a un archivo hacia otro fichero del mismo archivo

Descripción#

public Phar::copy(string $from, string $to): true
```php

> [!NOTE]
> Este método requiere que la variable de configuración INI `phar.readonly` esté definida a `0` para funcionar con los objetos `Phar` . De lo contrario, se lanzará una excepción `PharException`.

Copia un fichero perteneciente a un archivo hacia un nuevo fichero del mismo archivo. Es una alternativa orientada a objetos al uso de `copy` con un flujo phar.

## Parámetros

`from`  

`to`  

## Valores devueltos

Retorna siempre `true`.

## Errores/Excepciones

Levanta una excepción `UnexpectedValueException` si el fichero origen no existe, si el fichero destino ya existe, si el acceso en escritura está desactivado, si abrir uno u otro de los ficheros falla, si la lectura del fichero origen falla, o levanta una excepción `PharException` si la escritura de los cambios en el phar falla.

## Ejemplos

Ejemplo con `Phar::copy`

Este ejemplo muestra cómo utilizar `Phar::copy` y la comparación en términos de rendimiento con el equivalente utilizando el flujo phar. La diferencia principal entre los dos métodos concierne la gestión de errores. Todos los métodos Phar levantan excepciones, mientras que las funciones de flujo utilizan `trigger_error`.
copy('a', 'b'); echo $phar['b']; // Muestra "phar://myphar.phar/b" } catch (Exception $e) { // Maneja los errores } // El equivalente en términos de flujo del código anterior // se devuelven E_WARNING en lugar de excepciones copy('phar://monphar.phar/a', 'phar//monphar.phar/c'); echo file_get_contents('phar://monphar.phar/c'); // Muestra "salut" ?>

```php