ZipArchive::setEncryptionName

(PHP >= 7.2.0, PHP 8, PECL zip >= 1.14.0)

ZipArchive::setEncryptionName — Establece el método de cifrado de una entrada definida por su nombre

Descripción

public ZipArchive::setEncryptionName(string $name, int $method, #[\SensitiveParameter] ?string $password = null): bool

Establece el método de cifrado de una entrada definida por su nombre.

Parámetros

name: Nombre de la entrada.
method: El método de encriptación definido por una de las constantes ZipArchive::EM_constants.
password: Contraseña opcional, se utiliza por defecto cuando falta.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Historial de cambios

Versión	Descripción
8.0.0	`password` ahora es anulable.

Ejemplos

Este ejemplo crea un archivo ZIP test.zip y añade al archivo test.txt encriptado usando el método AES 256.

Ejemplo #1 Archivar y encriptar un archivo

<?php
$zip = new ZipArchive();
if ($zip->open('test.zip', ZipArchive::CREATE) === TRUE) {
    $zip->setPassword('secret');
    $zip->addFile('text.txt');
    $zip->setEncryptionName('text.txt', ZipArchive::EM_AES_256);
    $zip->close();
    echo "Ok\n";
} else {
    echo "KO\n";
}
?>

Notas

Nota:
Esta función sólo está disponible si se construye con libzip ≥ 1.2.0.

Ver también

ZipArchive::setPassword() - Establece la contraseña para el archivo activo
ZipArchive::setEncryptionIndex() - Establece el método de cifrado de una entrada definida por su índice