RarEntry::extract
En esta página
RarEntry::extract
Extraer entrada del archivo
Descripción#
public RarEntry::extract(string $dir, [string $filepath], [string $password], [bool $extended_data]): bool
```php
RarEntry::extract extrae los datos de entrada. Esto creará un nuevo archivo en el `dir` especificado con el mismo nombre que el nombre de la entrada, a menos que el segundo argumento sea especificado. Siga leyendo más abajo para obtener mayor información.
## Parámetros
`dir`
Ruta al directorio donde los archivos deben ser extraídos. Este parámetro es considerado si y sólo si no es `filepath`. Si ambos parámetros están vacíos se intentará una extracción en el directorio actual.
`filepath`
Ruta (relativa o absoluta) que contiene el directorio y el nombre del archivo extraído. Este parámetro anula los parámetros `dir` y el nombre del archivo original.
`password`
La contraseña utilizada para cifrar esta entrada. Si la entrada no está cifrada, este valor no se utilizará y puede ser omitido. Si se omite este parámetro y la entrada está cifrada, la contraseña dada a `rar_open`, será utlizada. Si una contraseña incorrecta es dada, de forma explicita o implicita via `rar_open`, la comprobación CRC fallará y este método fallará y devolverá `false`. Si no se da la contraseña y se requiere una, este método fallará y devolverá `false`. Puede comprobar si una entrada está cifrada con RarEntry::isEncrypted.
`extended_data`
Si `true`, información extendida tales como NTFS ACLs e información propietaria Unix será establecida en los archivos extraidos, siempre que esta esté presente en el archivo.
> [!WARNING]
> Antes de la versión 2.0.0, esta función no manejaba las rutas relativas correctamente. Utilice `realpath` como una solución.
## Valores devueltos
Esta función retorna `true` en caso de éxito o `false` si ocurre un error.
## Historial de cambios
| Versión | Descripción |
|----|----|
| PECL rar 3.0.0 | `extended_data` fue añadido. |
| PECL rar 3.0.0 | Soporte para archivos RAR con nombres de entrada que se repiten ya no es defectuoso |
## Ejemplos
Ejemplo de RarEntry::extract
¿Cómo extraer todos los archivos en archivo?:
```php
Véase también#
RarEntry::getStream
rar://
wrapper