ZipArchive::addFile

Från Wiki.linux.se
Hoppa till navigering Hoppa till sök

ZipArchive::addFile

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

ZipArchive::addFile — Lägger till en fil i ett ZIP-arkiv från den angivna sökvägen

Beskrivning

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

Lägger till en fil i ett ZIP-arkiv från en given sökväg.

Not: För maximal portabilitet rekommenderas det att alltid använda snedstreck (/) som katalogseparator i ZIP-filnamn.

Parametrar

  • filepath

Sökvägen till filen som ska läggas till.

  • entryname

Om den anges och inte är tom, är detta det lokala namnet i ZIP-arkivet som kommer att ersätta filepath.

  • start

För partiell kopiering, startposition.

  • length

För partiell kopiering, längd som ska kopieras, om ZipArchive::LENGTH_TO_END (0) används, används filstorleken, om ZipArchive::LENGTH_UNCHECKED används, används hela filen (från start).

  • flags

Bitmask bestående av ZipArchive::FL_OVERWRITE, ZipArchive::FL_ENC_GUESS, ZipArchive::FL_ENC_UTF_8, ZipArchive::FL_ENC_CP437, ZipArchive::FL_OPEN_FILE_NOW. Beteendet för dessa konstanter beskrivs på sidan för ZIP-konstanter.

Returvärden

Returnerar true vid framgång eller false vid misslyckande.

Ändringshistorik

Version | Beskrivning
8.0.0, PECL zip 1.18.0 | flaggor lades till.
8.3.0, PECL zip 1.22.1 | ZipArchive::FL_OPEN_FILE_NOW lades till.
8.3.0, PECL zip 1.22.2 | ZipArchive::LENGTH_TO_END och ZipArchive::LENGTH_UNCHECKED lades till.

Exempel

Detta exempel öppnar ett ZIP-arkiv test.zip och lägger till filen /path/to/index.txt som newname.txt.

Exempel #1 Öppna och lägg till

<?php
$zip = new ZipArchive;
if ($zip->open('test.zip') === TRUE) {
    $zip->addFile('/path/to/index.txt', 'newname.txt');
    $zip->close();
    echo 'ok';
} else {
    echo 'failed';
}
?>

Noter

Not: När en fil sätts att läggas till i arkivet, kommer PHP att låsa filen. Låset släpps endast när ZipArchive-objektet har stängts, antingen via ZipArchive::close() eller när ZipArchive-objektet förstörs. Detta kan hindra dig från att ta bort filen som läggs till tills låset har släppts.

Se även

ZipArchive::replaceFile() - Ersätt fil i ZIP-arkiv med en given sökväg

Sidslut

Orginalhemsidan på Engelska :https://www.php.net/manual/en/phar.using.php
PHP Funktioner Funktionsreferens Komprimerings- och arkivtillägg Zip Klasser


Det här är en maskinöversättning av PHP-manualen till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp Stockholm som har sponsrat Linux.se med webbhotell.