PHP Requires Chilkat v11.0.0+

Find a ZIP Entry by Exact Path Using EntryOf

See more Zip Examples

This example demonstrates how to use the EntryOf method to find a ZIP entry whose stored path exactly matches a specified path.

Unlike EntryMatching, which performs wildcard matching, EntryOf performs an exact path lookup.

This method is useful when:

• The exact ZIP path is already known
• Retrieving a specific file or directory entry
• Verifying whether a particular entry exists in the ZIP archive

Suppose the ZIP archive contains:

docs/
docs/readme.txt
docs/manual.pdf
images/logo.png
data/config/settings.json

ZIP archives may optionally contain explicit directory entries such as docs/. These directory entries can also be retrieved using EntryOf.

The example:

• Finds an exact file entry
• Finds an exact directory entry
• Demonstrates the difference between file and directory entries

Chilkat2 PHP

<?php

use Chilkat2\Zip;
use Chilkat2\ZipEntry;

$success = false;

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

$success = false;

// Open an existing ZIP archive.
$zip = new Zip();

try {
    $zip->OpenZip('example.zip');
} catch (\Chilkat2\Exception $e) {
    echo $e->getMessage(), "\n";
    exit;
}

$entry = new ZipEntry();

// ------------------------------------------------------------
// Find a specific file entry by its exact ZIP path.

$success = $zip->EntryOf('docs/readme.txt', $entry);

if ($success) {
    echo "Found file entry:\n";
    echo '  FileName = ', $entry->FileName, "\n";
    echo '  IsDirectory = ', ($entry->IsDirectory ? 'true' : 'false'), "\n";
    echo "\n";
}

// ------------------------------------------------------------
// Find a directory entry.
//
// ZIP archives may optionally contain explicit directory entries.
// In this example, "docs/" is a separate directory entry.

$success = $zip->EntryOf('docs/', $entry);

if ($success) {
    echo "Found directory entry:\n";
    echo '  FileName = ', $entry->FileName, "\n";
    echo '  IsDirectory = ', ($entry->IsDirectory ? 'true' : 'false'), "\n";
    echo "\n";
}

// ------------------------------------------------------------
// Attempt to find a non-existent entry.

$success = $zip->EntryOf('images/missing.png', $entry);

if (!$success) {
    echo "The entry images/missing.png was not found.\n";
}

$zip->CloseZip();

echo "Done.\n";