laravel-mailjet - GitLite

KO | EN

gitlite — search

#javascript #ai #llm #golang #go #machine-learning #rust #deep-learning #macos #cli #kubernetes #vue #awesome-list #mcp

laravel-mailjet

(★ 111)

Laravel package for Mailjet API V3 and Laravel Mailjet Mail Transport

파일 탐색기

최종 버전 다운로드 (.zip)

- - basic-template.png
  - condition.png
  - favicon.ico
  - favicon_mj.ico
  - full.png
  - if.png
  - insert-templ-lang.png
  - inside_if.png
  - logo.png
  - logo_mjml.png
  - loop.png
  - mailjet_logo_blue2.svg
  - mj.contact.name.png
  - mjml_screen.png
  - mjml_template.png
  - navbar.png
  - orderdetails.png
  - passport-condition-new-setup.png
  - passport-condition-new.png
  - productlist.png
  - refund.png
  - result-order.png
  - result-order2.png
  - unavailable.png
- - extra.css
- configuration.md
- CONTRIBUTING.md
- index.md
- mailjet-doc.md
- tests.md
- usage.md
- - CampaignContract.php
  - CampaignDraftContract.php
  - ContactMetadataContract.php
  - ContactsListContract.php
  - ContactsV4Contract.php
  - EventCallbackUrlContract.php
  - MailjetServiceContract.php
  - TemplateServiceContract.php
- - MailjetException.php
- - Mailjet.php
- - Campaign.php
  - CampaignDraft.php
  - Contact.php
  - ContactMetadata.php
  - ContactsList.php
  - EventCallbackUrl.php
  - Model.php
  - Requestable.php
  - Template.php
- - CampaignDraftServiceProvider.php
  - CampaignServiceProvider.php
  - ContactMetadataServiceProvider.php
  - ContactsListServiceProvider.php
  - ContactsServiceProvider.php
  - EventCallbackUrlServiceProvider.php
  - MailjetClientServiceProvider.php
  - TemplateServiceProvider.php
- - CampaignDraftService.php
  - CampaignService.php
  - ContactMetadataService.php
  - ContactsListService.php
  - ContactsV4Service.php
  - EventCallbackUrlService.php
  - MailjetService.php
  - TemplateService.php
- MailjetServiceProvider.php
- - CampaignDraftServiceProviderTest.php
  - CampaignServiceProviderTest.php
  - ContactMetadataServiceProviderTest.php
  - ContactsListServiceProviderTest.php
  - EventCallbackUrlServiceProviderTest.php
  - MailjetClientServiceProviderTest.php
  - MailjetServiceProviderTest.php
  - TemplateServiceProviderTest.php
- - MailjetServiceTest.php
- bootstrap.php
.env.example
.gitattributes
.gitignore
.travis.yml
composer.json
CONTRIBUTING.md
LICENSE.md
mkdocs.yml
phpunit.xml
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Laravel Mailjet

[![Build Status](https://travis-ci.org/mailjet/laravel-mailjet.svg?branch=master)](https://travis-ci.org/mailjet/laravel-mailjet)
[![Packagist](https://img.shields.io/packagist/v/mailjet/laravel-mailjet.svg)](https://packagist.org/packages/mailjet/laravel-mailjet)
[![Packagist](https://img.shields.io/packagist/dt/mailjet/laravel-mailjet.svg)](https://packagist.org/packages/mailjet/laravel-mailjet)
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/mailjet/laravel-mailjet/blob/master/LICENSE.md)
[![Documentation](https://img.shields.io/badge/documentation-gh--pages-blue.svg)](https://mailjet.github.io/laravel-mailjet/)

Laravel package for handling Mailjet API v3 using this wrapper: <https://github.com/mailjet/mailjet-apiv3-php>

It also provides a mailjetTransport for [Laravel mail feature](https://laravel.com/docs/master/mail)

## Installation

First, include the package in your dependencies:

composer require mailjet/laravel-mailjet

Then, you need to add some informations in your configuration files. You can find your Mailjet API key/secret [here](https://app.mailjet.com/account/api_keys).
Please also set your email from address and name.

* In the providers array:

```php
'providers' => [
    ...
    Mailjet\LaravelMailjet\MailjetServiceProvider::class,
    ...
]
```

## Laravel 11.0+
In the file  `example-app/bootstrap/providers.php`
```php
use Mailjet\LaravelMailjet\MailjetServiceProvider;

return [
    App\Providers\AppServiceProvider::class,
    MailjetServiceProvider::class,
];
```

> **Note:** The `Mailjet` alias is registered automatically via [Package Auto-Discovery](https://laravel.com/docs/packages#package-discovery). No manual alias configuration needed — just use `use Mailjet\LaravelMailjet\Facades\Mailjet;` in your code.

* In the aliases array (Laravel 10 and below):

```php
'aliases' => [
    ...
    'Mailjet' => Mailjet\LaravelMailjet\Facades\Mailjet::class,
    ...
]
```

* In the services.php file:

```php
'mailjet' => [
    'key' => env('MAILJET_APIKEY'),
    'secret' => env('MAILJET_APISECRET'),
    'sandbox' => filter_var(env('MAILJET_SANDBOX', false), FILTER_VALIDATE_BOOLEAN),
]
```

* In your .env file:

```php
MAILJET_APIKEY=YOUR_APIKEY
MAILJET_APISECRET=YOUR_APISECRET
MAIL_FROM_ADDRESS=YOUR_EMAIL_FROM_ADDRESS
MAIL_FROM_NAME=YOU_FROM_NAME
# Optional: Enable sandbox mode for testing (emails won't be actually sent)
MAILJET_SANDBOX=false
```

## Full configuration

For details head to [configuration doc](docs/configuration.md).

## Mail driver configuration

In order to use Mailjet as your Mail driver, you need to update the mail driver in your `config/mail.php` or your `.env` file to `MAIL_MAILER=mailjet` (for Laravel 6 and older use MAIL_DRIVER constant instead), and make sure you are using a valid and authorised from email address configured on your Mailjet account. The sending email addresses and domain can be managed [here](https://app.mailjet.com/account/sender)

For Laravel 7+ you also need to specify new available mail driver in config/mail.php:
```
'mailers' => [
    ...

'mailjet' => [
        'transport' => 'mailjet',
    ],
],
```
For usage, please check the [Laravel mail documentation](https://laravel.com/docs/master/mail)

## Usage

In order to usage this package, you first need to import Mailjet Facade in your code:

use Mailjet\LaravelMailjet\Facades\Mailjet;

Then, in your code you can use one of the methods available in the MailjetServices.

Low level API methods:

* `Mailjet::get($resource, $args, $options)`
* `Mailjet::post($resource, $args, $options)`
* `Mailjet::put($resource, $args, $options)`
* `Mailjet::delete($resource, $args, $options)`

High level API methods:

* `Mailjet::getAllLists($filters)`
* `Mailjet::createList($body)`
* `Mailjet::getListRecipients($filters)`
* `Mailjet::getSingleContact($id)`
* `Mailjet::createContact($body)`
* `Mailjet::createListRecipient($body)`
* `Mailjet::editListrecipient($id, $body)`

For more informations about the filters you can use in each methods, refer to the [Mailjet API documentation](https://dev.mailjet.com/email-api/v3/apikey/)

All method return `Mailjet\Response` or throw a `MailjetException` in case of API error.

You can also get the Mailjet API client with the method `getClient()` and make your own custom request to Mailjet API.

If you need to delete a contact, you need to register ContactsServiceProvider:
* In the providers array:

```php
'providers' => [
    ...
    \Mailjet\LaravelMailjet\Providers\ContactsServiceProvider::class,
    ...
]
```

and use it:
```php
public function handle(ContactsV4Service $contactsV4Service)
{
    $response = $contactsV4Service->delete(351406781);
    ...
}
```