« ZipArchive::addEmptyDirZipArchive::addFromString »PHP ManualZipArchive

ZipArchive::addFile

(PHP 5 >= 5.2.0, PHP 7, PHP 8, PECL zip >= 1.1.0)

ZipArchive::addFile — Додає до ZIP-архіву файл за вказаним шляхом

Опис

public ZipArchive::addFile(    string $filepath,    string $entryname = "",    int $start = 0,    int $length = ZipArchive::LENGTH_TO_END,    int $flags = ZipArchive::FL_OVERWRITE): bool

Додає до ZIP-архіву файл по зазначеному шляху.

Зауваження: Для максимальної переносимості, рекомендується завжди використовувати прямі сліші ( ) як роздільник директорій в іменах файлів.

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

filepath

Шлях до файлу для додавання.

entryname

Имя файла внутри ZIP-архива. Если указано, то переопределит параметрfilepath

start

Початкова позиція для копіювання.

length

Довжина, яка має бути скопійована під час виконання операції часткового копіювання, якщо вказано значення ZipArchive::LENGTH_TO_END (0), буде використано розмір файлу, якщо вказано значення ZipArchive::LENGTH_UNCHECKED, буде використано весь файл (починаючи зі значення параметра start

flags

Бітова маска, що складається із значень: ZipArchive::FL_OVERWRITE ZipArchive::FL_ENC_GUESS ZipArchive::FL_ENC_UTF_8 ZipArchive::FL_ENC_CP437 **ZipArchive::FL_OPEN_FILE_NOW**Поведение констант описано на страницеZIP-константи

Значення, що повертаються

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

список змін

ВерсияОпис
8.0.0 / 1.18.0Добавлен параметрflags
8.3.0 / 1.22.1Добавлена константа**ZipArchive::FL_OPEN_FILE_NOW**
8.3.0 / 1.22.2Додано константи, що задають значення довжини: ZipArchive::LENGTH_TO_END і ZipArchive::LENGTH_UNCHECKED

Приклади

У цьому прикладі відкривається файл ZIP-архіву test.zip і до нього додається файл /path/to/index.txt під ім'ям newname.txt.

Приклад #1 Відкрити та додати

Loading...

Примітки

Зауваження :

У процесі додавання файлу до архіву PHP заблокує файл. Розблокування відбудеться лише після закриття об'єкту ZipArchive, шляхом виклику ZipArchive::close() або знищення об'єкта ZipArchive. Це запобігає видаленню доданого до архіву файлу до того, як він буде розблокований.

Дивіться також