ZipArchive::setEncryptionName

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

ZipArchive::setEncryptionName — Устанавливает метод шифрования записи по имени

Описание

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

Метод устанавливает метод шифрования записи по имени.

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

name: Имя записи.
method: Метод шифрования, который задали одной из констант ZipArchive::EM_.
password: Пароль. Если не указывать, то будет использован пароль по умолчанию.

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

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Список изменений

Версия	Описание
8.0.0	Параметр `password` теперь принимает значение null.

Примеры

В этом примере создаётся ZIP-архив test.zip, содержащий файл test.txt, зашифрованный с помощью AES 256.

Пример #1 Архивируем и шифруем файл

<?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 "готово\n";
} else {
    echo "ошибка\n";
}

?>

Примечания

Замечание: Функция доступна только если скомпилировано с модулем libzip ≥ 1.2.0.

Смотрите также

ZipArchive::setPassword() - Устанавливает пароля для активного архива
ZipArchive::setEncryptionIndex() - Устанавливает метод шифрования записи по индексу

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 3 notes

down

mauro dot chojrin at leewayweb dot com ¶

5 years ago

Files compressed using this function on Linux won't be decompressed using Windows.

There seems to be some incompatibility with Windows built-in decompressor.

There's an alternative library that works better here: https://github.com/Ne-Lexa/php-zip

I got windows to open a file created with it by using the PKWARE encryption method

down

romke at romke dot nl ¶

5 years ago

On windows is the "EM_AES_256" by default not supported, but you can use winrar, winzip or 7zip.

At first we had a password of 128 chars (this was to long) and all extract applications give an error that the password was incorrect.

The next time we did use a password of 52 chars., this time i did work!

down

Anonymous ¶

1 year ago

When using setEncryptionName, the first parameter is equal to the entry name of the file you added.
In case you set an explicit entry name with the second parameters of the addFile method, then you need to use that entry name.
Using the first parameter of addFile will only work in case the second parameter is not used.

This works :
$zip->addFile('test.txt', 'my_awesome_textfile.txt');
$zip->setEncryptionName('my_awesome_textfile.txt', ZipArchive::EM_AES_256);

This does not work and will generate an archive without any encryption :
$zip->addFile('test.txt', 'my_awesome_textfile.txt');
$zip->setEncryptionName('text.txt', ZipArchive::EM_AES_256);

＋Добавить