topcu/laravelimap

There is no license information available for the latest version (v1.2) of this package.

Laravel wrapper for php-imap

v1.2 2017-07-24 13:34 UTC

This package is not auto-updated.

Last update: 2024-04-13 23:41:25 UTC


README

Installation

$ composer require php-imap/php-imap

Add following lines into config/app.php

    'providers' => [
    	...
	Topcu\Dumber\DumberServiceProvider::class,
	...
    ],
    'aliases' => [ 
    	...
	'Imap' => \Topcu\LaravelImap\Facades\Imap::class,
	...
    ],

Configuration

If you'd like to use a single connection, add imap into config/services.php and define your credentials in .env file

    'imap' => [
        "imap_path" => env("IMAP_SERVER_PATH"), // "{imap.gmail.com:993/imap/ssl}INBOX", 
        "login"     => env("IMAP_SERVER_LOGIN"), // "mail@example.com", 
        "password"  => env("IMAP_SERVER_PASSWORD")
    ]

Otherwise, you can call Imap::connection() anytime with config parameters as:

    Imap::connection([
         "imap_path" => "{imap.gmail.com:993/imap/ssl}INBOX", 
         "login"     => "mail@example.com", 
         "password"  => "somepassword",
     ]);

Usage examples

Using Facade

    $mail_ids = Imap::searchMailbox("UNSEEN");
    $mail = Imap::getMail($mail_ids[0]);

Using IoC

use Topcu\LaravelImap\Mailbox;

class Foo
{
    //...
    public function bar(Mailbox $imap)
    {
        $mail_ids = $imap->searchMailbox("UNSEEN");
        $mail = $imap->getMail($mail_ids[0]);
    }
    //...
}

Setting connection parameters dynamically

    $mail_ids = Imap::connection($imap_config)->searchMailbox("UNSEEN");
    $mail = Imap::getMail($mail_ids[0]);