port-adhoc/imap

Imap class for PHP

, _(*1)

imap-php

Uid oriented Imap class, _(*2)

Summary

• Installation
• Usage
• Function list

Installation

In your repository :, _(*3)

composer require port-adhoc/imap

back to summary, _(*4)

Usage

• Example 1 : traversing a whole mailbox and retriving its content

Example 1 : traversing a whole mailbox and retriving its content

use PortAdhoc\Imap\Imap;
use PortAdhoc\Imap\Encoding;

$imap = new Imap;

$imap->server = 'example.host.com';
$imap->port = 993;
$imap->flags = ['imap', 'ssl', 'readonly'];
$imap->user = 'example@host.com';
$imap->password = 'example';
$imap->mailbox = 'INBOX';
$imap->start = '1';
$imap->end = '*';

$imap->connect();

$messages = $imap->getMessages();

foreach( $messages as $message ) {
  $subject = $message->getSubject();
  $date = $message->getDate();
  $from = $message->getFrom();
  $to = $message->getTo();
  $cc = $message->getCC();
  $bcc = $message->getBCC();
  $text = $message->getPlainText( Encoding::UTF_8 );
  $html = $message->getPlainText( Encoding::UTF_8 );
  $attachments = $message->getAttachments();
}

back to summary, _(*5)

Function list

• Attachment::
  • getName
  • getContent
• Email::
  • properties
  • name
  • email
• Imap::
  • construct
  • properties
  • server
  • port
  • flags
  • user
  • password
  • mailbox
  • start
  • end
  • connection_time
  • message_fetching_time
  • connect
  • getConnectionString
  • getMessage
  • getMessages
• Message::
  • getAttachments
  • getBCC
  • getCC
  • getDate
  • getFrom
  • getHtml
  • getImap
  • getInReplyTo
  • getMessageId
  • getMsgno
  • getPlainText
  • getReferences
  • getReplyTo
  • getReturnPath
  • getSender
  • getStructure
  • getSubject
  • getTo
  • getUid
  • isAnswered
  • isDeleted
  • isDraft

Attachment

getName

public function getName(): string

Example:, _(*6)

use PortAdhoc\Imap\Imap;

$imap = new Imap;

$imap->server = 'example.host.com';
$imap->port = 993;
$imap->flags = ['imap', 'ssl', 'readonly'];
$imap->user = 'example@host.com';
$imap->password = 'example';
$imap->mailbox = 'INBOX'; // or INBOX/folder
$imap->start = '500'; // uid
$imap->end = '500'; // uid

$imap->connect();

$uid = 500;

$message = $imap->getMessage( $uid );

$attachments = $message->getAttachments();

foreach( $attachments as $attachment ) {
    $name = $attachment->getName();

    echo $name;
}

Result:, _(*7)

> php script.php
reporting result quarter 4.xlsx

getContent

public function getContent(): string

Example:, _(*8)

use PortAdhoc\Imap\Imap;

$imap = new Imap;

$imap->server = 'example.host.com';
$imap->port = 993;
$imap->flags = ['imap', 'ssl', 'readonly'];
$imap->user = 'example@host.com';
$imap->password = 'example';
$imap->mailbox = 'INBOX'; // or INBOX/folder
$imap->start = '500'; // uid
$imap->end = '500'; // uid

$imap->connect();

$uid = 500;

$message = $imap->getMessage( $uid );

$attachments = $message->getAttachments();

foreach( $attachments as $attachment ) {
    $name = $attachment->getName();
    $content = $attachement->getContent();
    $path = __DIR__ . '/' . $name; // inside the current repository

    file_put_contents( $path, $content );
}

Result:, _(*9)

/vendor
composer.json
composer.lock
script.php
reporting result quarter 4.xlsx

Imap

Imap construct

public function __construct(): PortAdhoc\Imap\Imap

Example:, _(*10)

use PortAdhoc\Imap\Imap;

$imap = new Imap;

back to function list, _(*11)

back to summary, _(*12)

Imap properties

public string $server;
public int $port;
public string $user;
public string $password;
public string $mailbox;
public int $connection_time;
public int $message_fetching_time;
public string $start; // uid
public string $end; // uid

back to function list, _(*13)

back to summary, _(*14)

connect

public function connect(): PortAdhoc\Imap\Imap

Example:, _(*15)

use PortAdhoc\Imap\Imap;

$imap = new Imap;

$imap->server = 'example.host.com';
$imap->port = 993;
$imap->flags = ['imap', 'ssl', 'readonly'];
$imap->user = 'example@host.com';
$imap->password = 'example';
$imap->mailbox = 'INBOX'; // or INBOX/folder
$imap->start = '1'; // uid
$imap->end = '500'; // uid

$imap->connect();

back to function list, _(*16)

back to summary, _(*17)

getMessage

public function getMessage( int $uid ): PortAdhoc\Imap\Message

Example:, _(*18)

use PortAdhoc\Imap\Imap;

$imap = new Imap;

$imap->server = 'example.host.com';
$imap->port = 993;
$imap->flags = ['imap', 'ssl', 'readonly'];
$imap->user = 'example@host.com';
$imap->password = 'example';
$imap->mailbox = 'INBOX'; // or INBOX/folder
$imap->start = '1'; // uid
$imap->end = '500'; // uid

$imap->connect();

$uid = 500;

$message = $imap->getMessage( $uid );

back to function list, _(*19)

back to summary, _(*20)

getMessages

public function getMessages(): PortAdhoc\Imap\Message[]

Example:, _(*21)

use PortAdhoc\Imap\Imap;

$imap = new Imap;

$imap->server = 'example.host.com';
$imap->port = 993;
$imap->flags = ['imap', 'ssl', 'readonly'];
$imap->user = 'example@host.com';
$imap->password = 'example';
$imap->mailbox = 'INBOX'; // or INBOX/folder
$imap->start = '1'; // uid
$imap->end = '500'; // uid

$imap->connect();

$messages = $imap->getMessages();

foreach( $messages as $message ) {
  // ...
}

back to function list, _(*22)

back to summary, _(*23)

getConnectionString

public function getConnectionString(): string

Example:, _(*24)

use PortAdhoc\Imap\Imap;

$imap = new Imap;

$imap->server = 'example.host.com';
$imap->port = 993;
$imap->flags = ['imap', 'ssl', 'readonly'];
$imap->user = 'example@host.com';
$imap->password = 'example';
$imap->mailbox = 'INBOX'; // or INBOX/folder
$imap->start = '1'; // uid
$imap->end = '500'; // uid

$cs = $imap->getConnectionString();

echo $cs;

Result:, _(*25)

> php script.php
{example.host.com:993/imap/ssl/readonly}INBOX/folder

back to function list, _(*26)

back to summary, _(*27)

Email

Email properties

public $email;
public $name;

Example:, _(*28)

use PortAdhoc\Imap\Imap;

$imap = new Imap;

$imap->server = 'example.host.com';
$imap->port = 993;
$imap->flags = ['imap', 'ssl', 'readonly'];
$imap->user = 'example@host.com';
$imap->password = 'example';
$imap->mailbox = 'INBOX';

$uid = 500;

$message = $imap->getMessage( $uid );

$from = $message->getFrom();

$email = $from->email;
$name = $from->name;

echo $name . ' ' . $email;

Result:, _(*29)

> php script.php
John Doe john.doe@contoso.com

back to function list, _(*30)

back to summary, _(*31)