dprmc/office365-mail

Office365 transport for Laravel

v3.0 2022-10-26 15:59 UTC

Requires

• php: ^7.1.3 || ^8
• microsoft/microsoft-graph: ^1.5

Requires (Dev)

• laravel/framework: ^8.0
• mockery/mockery: ^1.3
• orchestra/testbench: ^6.0
• phpunit/phpunit: ^9.1

MIT

• Moritz Mair

README

Mail driver for the Laravel framework to send emails using Microsoft Graph without user authentication and SMTP. Only specify the E-Mail-Address in the FROM-Header of the E-Mail and this Office 365 Package will send the E-Mail trough the Microsoft Graph-Api and put the sent E-Mail in the sender's Mailbox sent folder.

Key features:

• Send E-Mails with the Microsoft Graph-Api instead of the SMTP driver
• Automatically puts the E-Mail in the Sent folder of the user in the From-Header
• One Application per Organization
• Supports multiple Domains
• Supports large file attachments
• Faster and Error-less than the Office-365 SMTP

To use this package you have to register your application here. More informations here.

Install the Package

You can install the package with Composer, either run composer require motze92/office365-mail, or edit your composer.json file:

Laravel 9

For Laravel 9 please use

{
  "require": {
    "motze92/office365-mail": "^3.0"
  }
}

Laravel 8

For Laravel 8 please use

{
  "require": {
    "motze92/office365-mail": "^2.0"
  }
}

Laravel < 7

For Laravel 6 and earlier please use

{
  "require": {
    "motze92/office365-mail": "^1.0"
  }
}

To publish the config file use this command:

php  artisan  vendor:publish  --tag=office365mail

Configure

To obtain needed config values use this instructions:

• Open the Azure Active Directory-Portal) with your Office365 Admin-User
• Open the Section Manage > App-Registrations
• Create a new App
• Within the App under Manage > API-Permissions > Application Permissions add the Mail.ReadWrite and the Mail.Send permission (Microsoft Graph > Application Permissions > Mail > Mail.ReadWrite and Microsoft Graph > Application Permissions > Mail > Mail.Send)
• After saving the permission apply the Admin-Permission for your organization
• In the Section Manage > Certificates and Secrets create a new Client Secret with Expiration = 24 months, this you need later for the .env - Variable OFFICE365MAIL_CLIENT_SECRET

The Mail.ReadWrite Permission is needed when sending large attachments (>4MB).

.env - File

Laravel < 7

MAIL_DRIVER=office365mail
OFFICE365MAIL_CLIENT_ID=YOUR-MS-GRAPH-CLIENT-ID
OFFICE365MAIL_TENANT=YOUR-MS-GRAPH-TENANT-ID
OFFICE365MAIL_CLIENT_SECRET=YOUR-MS-GRAPH-CLIENT-SECRET

Laravel > 7

MAIL_MAILER=office365mail
OFFICE365MAIL_CLIENT_ID=YOUR-MS-GRAPH-CLIENT-ID
OFFICE365MAIL_TENANT=YOUR-MS-GRAPH-TENANT-ID
OFFICE365MAIL_CLIENT_SECRET=YOUR-MS-GRAPH-CLIENT-SECRET

config/mail.php - add to mailer configuration array (https://github.com/laravel/laravel/blob/7.x/config/mail.php)

'office365mail' => [
            'transport' => 'office365mail',
      ],

Credits

Moritz Mair, Matthias Radmüller, Merlin Mayr

Copyright and license

Copyright (c) Moritz Mair. All Rights Reserved. Licensed under the MIT license.