(PHP ActiveX) Fetch 1st N Headers of Search Results

Calls Search to get a message set, then downloads the 1st N messages in the message set. There are two equivalent ways of doing it: (1) iterate from 0 to N-1 and download each message individually, or (2) create a new message set that contains the 1st N messages and pass it to FetchHeaders. Both are demonstrated here.

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 assumes 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.Imap')
$imap = new COM("Chilkat.Imap");

// Connect to an IMAP server.
// Use TLS
$imap->Ssl = 1;
$imap->Port = 993;
$success = $imap->Connect('imap.someMailServer.com');
if ($success != 1) {
    print $imap->LastErrorText . "\n";
    exit;
}

// Login
$success = $imap->Login('****','****');
if ($success != 1) {
    print $imap->LastErrorText . "\n";
    exit;
}

// Select an IMAP mailbox
$success = $imap->SelectMailbox('Inbox');
if ($success != 1) {
    print $imap->LastErrorText . "\n";
    exit;
}

// We can choose to fetch UIDs or sequence numbers.
$fetchUids = 1;
// Get the message IDs of all the emails in the mailbox
// messageSet is a Chilkat.MessageSet
$messageSet = $imap->Search('ALL',$fetchUids);
if ($imap->LastMethodSuccess == 0) {
    print $imap->LastErrorText . "\n";
    exit;
}

$numFound = $messageSet->Count;
if ($numFound == 0) {
    print 'No messages found.' . "\n";

    exit;
}

// Get the 1st 10 messages in messageSet.
$upperBound = 10;
if ($numFound < $upperBound) {
    $upperBound = $numFound;
}

$i = 0;
$bUid = $messageSet->HasUids;
while ($i < $upperBound) {

    // email is a Chilkat.Email
    $email = $imap->FetchSingleHeader($messageSet->GetId($i),$bUid);
    if ($imap->LastMethodSuccess == 0) {
        print $imap->LastErrorText . "\n";

        exit;

    }
    else {
        // Do whatever is needed with the email.. 
        // ....

    }

    $i = $i + 1;
}

// Alternatively, create a new message set containing the 1st 10 message id's (UID's) 
// from the search results message set:
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.MessageSet')
$firstTen = new COM("Chilkat.MessageSet");

for ($i = 0; $i <= $upperBound - 1; $i++) {
    $firstTen->InsertId($messageSet->GetId($i));
}

// Download the 1st ten headers:

// bundle is a Chilkat.EmailBundle
$bundle = $imap->FetchHeaders($firstTen);
if ($imap->LastMethodSuccess == 0) {

    print $imap->LastErrorText . "\n";
    exit;
}

// Other examples show how to iterate over the emails contained within the bundle...

// Disconnect from the IMAP server.
$success = $imap->Disconnect();


?>