(PHP ActiveX) Unzip One File to a Stream

Demonstrates how to unzip a particular file contained within a .zip archive to a Chilkat stream.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows Note: The php_com_dotnet.dll may need to be enabled inside of php.ini.

<?php

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

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Zip')
$zip = new COM("Chilkat.Zip");

// First open a .zip.
$success = $zip->OpenZip('qa_data/hamlet.zip');
if ($success != 1) {
    print $zip->LastErrorText . "\n";
    exit;
}

// Find the entry to be unzipped to a stream..
// entry is a Chilkat.ZipEntry
$entry = $zip->FirstMatchingEntry('*hamlet.xml');
if ($zip->LastMethodSuccess != 1) {
    print $zip->LastErrorText . "\n";
    exit;
}

// There are three ways we can unzip (inflate) to a stream.
// 
// 1) Set a sink file on the stream object and call UnzipToStream synchronously.
//    This unzips to the stream's sink (which is to simply unzip to a file in the filesystem).
// 
// 2) Create a stream object and call UnzipToStreamAsync.  This starts the unzip in a background
//    thread (after Task.Run is called).  Your application can then read the unzipped (inflated) file
//    directly from the stream.
// 
// 3) (not shown in this example) Unzip to a stream object that is the source of something else.
//    

// ----------------------------------------------------------------
// Case 1: Unzip to a file by setting the sink of streamA to a file.
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Stream')
$streamA = new COM("Chilkat.Stream");
$streamA->SinkFile = 'qa_output/hamletA.xml';

$success = $entry->UnzipToStream($streamA);
if ($success != 1) {
    print $entry->LastErrorText . "\n";

    exit;
}

// Close the stream to close the output file.
$success = $streamA->WriteClose();

// ----------------------------------------------------------------
// Case 2a: Uzip to a stream asynchronously. 
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Stream')
$streamB = new COM("Chilkat.Stream");

// unzipTask is a Chilkat.Task
$unzipTask = $entry->UnzipToStreamAsync($streamB);
if ($entry->LastMethodSuccess != 1) {
    print $entry->LastErrorText . "\n";

    exit;
}

// Start the background unzip thread.
$unzipTask->Run();

// Read the stream.  (this is reading the unzipped file data)
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder')
$sb = new COM("Chilkat.StringBuilder");
while ($streamB->EndOfStream != 1) {
    // Each call to ReadSb appends to the contents of sb.
    $streamB->ReadSb($sb);
}

$sb->WriteFile('qa_output/hamletB.xml','utf-8',0);

print 'Success.' . "\n";

// ----------------------------------------------------------------
// Case 2b: Uzip to a stream asynchronously and emit output while reading. 
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Stream')
$streamC = new COM("Chilkat.Stream");

// unzipTask is a Chilkat.Task
$unzipTask = $entry->UnzipToStreamAsync($streamC);
if ($entry->LastMethodSuccess != 1) {
    print $entry->LastErrorText . "\n";

    exit;
}

$unzipTask->Run();

while ($streamC->EndOfStream != 1) {
    $s = $streamC->readString();
    print $s . "\n";
}

print 'Success.' . "\n";

?>