s-ichikawa/laravel-sendgrid-driver

This library adds a 'sendgrid' mail driver to Laravel.

Thursday, December 28, 2017
by s-ichikawa
Repository
6 Watchers
100 Stars
242,525 Installations

PHP
2 Dependents
0 Suggesters
22 Forks
1 Open issues
23 Versions
17 % Grown

The README.md

Laravel SendGrid Driver

, _(*1)

A Mail Driver with support for Sendgrid Web API, using the original Laravel API. This library extends the original Laravel classes, so it uses exactly the same methods., _(*2)

To use this package required your Sendgrid Api Key. Please make it Here., _(*3)

Compatibility

Laravel	laravel-sendgrid-driver
9, 10, 11	^4.0
7, 8	^3.0
5, 6	^2.0

Install (for Laravel)

Add the package to your composer.json and run composer update., _(*4)

"require": {
    "s-ichikawa/laravel-sendgrid-driver": "^4.0"
},

or installed with composer, _(*5)

$ composer require s-ichikawa/laravel-sendgrid-driver

Install (for Lumen)

Add the package to your composer.json and run composer update., _(*6)

"require": {
    "s-ichikawa/laravel-sendgrid-driver": "^4.0"
},

or installed with composer, _(*7)

$ composer require "s-ichikawa/laravel-sendgrid-driver"

Add the sendgrid service provider in bootstrap/app.php, _(*8)

$app->configure('mail');
$app->configure('services');
$app->register(Sichikawa\LaravelSendgridDriver\MailServiceProvider::class);

unset($app->availableBindings['mailer']);

Create mail config files. config/mail.php, _(*9)

<?php
return [
    'driver' => env('MAIL_DRIVER', 'sendgrid'),
];

Configure

.env, _(*10)

MAIL_DRIVER=sendgrid
SENDGRID_API_KEY='YOUR_SENDGRID_API_KEY'
# Optional: for 7+ laravel projects
MAIL_MAILER=sendgrid

config/services.php (In using lumen, require creating config directory and file.), _(*11)

    'sendgrid' => [
        'api_key' => env('SENDGRID_API_KEY'),
    ],

config/mail.php, _(*12)

    'mailers' => [
        'sendgrid' => [
            'transport' => 'sendgrid',
        ],
    ],

endpoint config

If you need to set custom endpoint, you can set any endpoint by using endpoint key. For example, calls to SendGrid API through a proxy, call endpoint for confirming a request., _(*13)

    'sendgrid' => [
        'api_key' => env('SENDGRID_API_KEY'),
        'endpoint' => 'https://custom.example.com/send',
    ],

How to use

Every request made to /v3/mail/send will require a request body formatted in JSON containing your email’s content and metadata. Required parameters are set by Laravel's usually mail sending, but you can also use useful features like "categories" and "send_at"., _(*14)

more info https://www.twilio.com/docs/sendgrid/api-reference/mail-send/mail-send, _(*15)

Laravel 10, 11:, _(*16)

<?
use Sichikawa\LaravelSendgridDriver\SendGrid;

class SendGridSample extends Mailable
{
    use SendGrid;

    public function envelope(): Envelope
    {
        $this->sendgrid([
                'personalizations' => [
                    [
                        'to' => [
                            ['email' => 'to1@gmail.com', 'name' => 'to1'],
                            ['email' => 'to2@gmail.com', 'name' => 'to2'],
                        ],
                        'cc' => [
                            ['email' => 'cc1@gmail.com', 'name' => 'cc1'],
                            ['email' => 'cc2@gmail.com', 'name' => 'cc2'],
                        ],
                        'bcc' => [
                            ['email' => 'bcc1@gmail.com', 'name' => 'bcc1'],
                            ['email' => 'bcc2@gmail.com', 'name' => 'bcc2'],
                        ],
                    ],
                ],
                'categories' => ['user_group1'],
            ]);
        return new Envelope(
            from:    'from@example.com',
            replyTo: 'reply@example.com',
            subject: 'example',
        );
    }
}

Laravel 9:, _(*17)

<?
use Sichikawa\LaravelSendgridDriver\SendGrid;

class SendGridSample extends Mailable
{
    use SendGrid;

    public function build():
    {
        return $this
            ->view('template name')
            ->subject('subject')
            ->from('from@example.com')
            ->to(['to@example.com'])
            ->sendgrid([
                'personalizations' => [
                    [
                        'to' => [
                            ['email' => 'to1@gmail.com', 'name' => 'to1'],
                            ['email' => 'to2@gmail.com', 'name' => 'to2'],
                        ],
                        'cc' => [
                            ['email' => 'cc1@gmail.com', 'name' => 'cc1'],
                            ['email' => 'cc2@gmail.com', 'name' => 'cc2'],
                        ],
                        'bcc' => [
                            ['email' => 'bcc1@gmail.com', 'name' => 'bcc1'],
                            ['email' => 'bcc2@gmail.com', 'name' => 'bcc2'],
                        ],
                    ],
                ],
                'categories' => ['user_group1'],
            ]);
    }
}

Using Template Id

Illuminate\Mailer has generally required a view file. But in case of using template id, set an empty array at view function., _(*18)

Laravel 10, 11:, _(*19)

<?
    public function envelope(): Envelope
    {
        $this->sendgrid([
            'personalizations' => [
                [
                    'dynamic_template_data' => [
                        'title' => 'Subject',
                        'name'  => 's-ichikawa',
                    ],
                ],
            ],
            'template_id' => config('services.sendgrid.templates.dynamic_template_id'),
        ]);
        return new Envelope(
            from:    'from@example.com',
            replyTo: 'reply@example.com',
            subject: 'example',
        );
    }

Laravel 9:, _(*20)

<?
    public function build():
    {
        return $this
            ->view('template name')
            ->subject('subject')
            ->from('from@example.com')
            ->to(['to@example.com'])
            ->sendgrid([
                'personalizations' => [
                    [
                        'dynamic_template_data' => [
                            'title' => 'Subject',
                            'name'  => 's-ichikawa',
                        ],
                    ],
                ],
                'template_id' => config('services.sendgrid.templates.dynamic_template_id'),
            ]);
    }

The Versions

28/12 2017

dev-master

9999999-dev

This library adds a 'sendgrid' mail driver to Laravel.

library laravel-sendgrid-driver

This library adds a 'sendgrid' mail driver to Laravel.

s-ichikawa/laravel-sendgrid-driver

The README.md

Laravel SendGrid Driver

Compatibility

Install (for Laravel)

Install (for Lumen)

Configure

endpoint config

How to use

Using Template Id

The Versions

dev-master

The Requires

The Development Requires

by shingo.ichikawa

2.0.2

The Requires

The Development Requires

by shingo.ichikawa

dev-dev

The Requires

The Development Requires

by shingo.ichikawa

2.0.1

The Requires

The Development Requires

by shingo.ichikawa

2.0.0

The Requires

The Development Requires

by shingo.ichikawa

dev-dev_2

The Requires

The Development Requires

by shingo.ichikawa

1.2.6

The Requires

The Development Requires

by shingo.ichikawa

1.2.5

The Requires

The Development Requires

by shingo.ichikawa

1.2.4

The Requires

The Development Requires

by shingo.ichikawa

1.2.3

The Requires

The Development Requires

by shingo.ichikawa

1.2.2

The Requires

The Development Requires

by shingo.ichikawa

1.2.1

The Requires

The Development Requires

by shingo.ichikawa

1.2.0

The Requires

The Development Requires

by shingo.ichikawa

1.1.6

The Requires

The Development Requires

by shingo.ichikawa

1.1.5

The Requires

The Development Requires

by shingo.ichikawa

1.1.4

The Requires

The Development Requires

by shingo.ichikawa

dev-dev54

The Requires

The Development Requires