sendgrid php

NOUVEAU:

• Envoyez des SMS avec Twilio.

Cette bibliothèque vous permet d'utiliser rapidement et facilement l'API Web Twilio SendGrid v3 via PHP.

La version 7.XX de cette bibliothèque fournit une prise en charge complète de tous les points de terminaison de l'API Web Twilio SendGrid v3, y compris la nouvelle v3 /mail/send.

Si vous avez besoin d'assistance pour utiliser SendGrid, veuillez consulter le centre d'aide du support Twilio SendGrid.

Veuillez parcourir le reste de ce README pour plus de détails.

Nous apprécions votre soutien continu, merci !

Table des matières

• Installation

• Démarrage rapide

• Cas d'utilisation

• Usage

• Annonces

• Comment contribuer

• Dépannage

• À propos

• Soutien

• Licence

Installation

Conditions préalables

• PHP version 7.3, 7.4, 8.0 ou 8.1

• Le service Twilio SendGrid, à partir du niveau gratuit pour envoyer jusqu'à 40 000 e-mails pendant les 30 premiers jours, puis envoyer 100 e-mails/jour gratuitement pour toujours ou consulter nos tarifs.

• Pour les messages SMS, vous aurez besoin d'un compte Twilio gratuit.

Configurer les variables d'environnement

Mettez à jour l'environnement de développement avec votre SENDGRID_API_KEY, par exemple :

1. Copiez l'exemple de fichier env dans un nouveau fichier nommé .env

 cp .env.sample .env

2. Modifiez le fichier .env pour inclure votre SENDGRID_API_KEY

3. Sourcez le fichier .env

 source ./.env

Installer le package

Ajoutez Twilio SendGrid à votre fichier composer.json . Si vous n'utilisez pas Composer, nous vous le recommandons vivement. C'est un excellent moyen de gérer les dépendances dans votre application PHP.

 { "require": {"sendgrid/sendgrid": "~7"
  }
}

Alternative : installer le package à partir du zip

Si vous n'utilisez pas Composer, téléchargez et installez simplement la dernière version packagée de la bibliothèque sous forme de fichier zip .

⬇ Télécharger la bibliothèque packagée ⬇

Les versions précédentes de la bibliothèque peuvent être téléchargées directement depuis GitHub.

Dépendances

• Le service Twilio SendGrid, à partir du niveau gratuit

• Le client php-http sans dépendance

Démarrage rapide

Incluez les lignes appropriées ci-dessous en haut de chaque exemple en fonction de votre méthode d'installation :

 <?php// Décommentez la ligne suivante si vous utilisez un chargeur de dépendances (tel que Composer) (recommandé)// require 'vendor/autoload.php';// Décommentez la ligne suivante si vous n'utilisez pas de dépendance chargeur (tel que Composer), en remplaçant <PATH TO> par le chemin d'accès au fichier sendgrid-php.php// require_once '<PATH TO>/sendgrid-php.php' ;

Bonjour E-mail

Voici le code minimum nécessaire pour envoyer un e-mail. Vous pouvez trouver plus d'exemples dans notre fichier USE_CASES :

 $email = new SendGridMailMail();$email->setFrom("[email protected]", "Example User");$email->setSubject("Envoyer avec Twilio SendGrid est amusant");$email->addTo( "[email protected]", "Example User");$email->addContent("text/plain", "et facile à faire n'importe où, même avec PHP");$email->addContent("text/html", "<strong>et facile à faire n'importe où, même avec PHP</strong>");$sendgrid = new SendGrid(getenv('SENDGRID_API_KEY')); essayez {$response = $sendgrid->send($email);print $response->statusCode() . "n";print_r($response->headers());print $response->body() . "n" ;
} catch (Exception $e) {echo 'Exception interceptée : '. $e->getMessage() ."n";
}

Le constructeur SendGridMail crée un objet de personnalisation pour vous. Voici un exemple de la façon d’y ajouter.

Utilisation générale de l'API Web v3 (avec interface Fluent)

 $apiKey = getenv('SENDGRID_API_KEY');$sg = new SendGrid($apiKey);essayez {$response = $sg->client->suppression()->bounces()->get();print $response- >statutCode() . "n";print_r($response->headers());print $response->body() . "n" ;
} catch (Exception $e) {echo 'Exception interceptée : '.  $e->getMessage(). "n" ;
}

Utilisation générale de l'API Web v3 (sans interface Fluent)

 $apiKey = getenv('SENDGRID_API_KEY');$sg = new SendGrid($apiKey);try {$response = $sg->client->_("suppression/bounces")->get();print $response- >statutCode() . "n";print_r($response->headers());print $response->body() . "n" ;
} catch (Exception $e) {echo 'Exception capturée : '.  $e->getMessage(). "n" ;
}

Cas d'utilisation

Exemples de cas d'utilisation courants de l'API, par exemple comment envoyer un e-mail avec un modèle transactionnel.

Usage

• Documents Twilio SendGrid

• Documentation sur l'utilisation de la bibliothèque générique

• Exemple de code

Annonces

La v7 est sortie ! Veuillez consulter les notes de version pour plus de détails.

Toutes les mises à jour de cette bibliothèque sont documentées dans notre CHANGELOG et nos versions.

Comment contribuer

Nous encourageons la contribution à nos bibliothèques (vous pourriez même gagner de jolis cadeaux), veuillez consulter notre guide CONTRIBUER pour plus de détails.

Liens rapides :

• Demande de fonctionnalité

• Rapports de bogues

• Améliorations de la base de code

• Examiner les demandes de tirage

Dépannage

Veuillez consulter notre guide de dépannage pour les problèmes courants de bibliothèque.

À propos

sendgrid-php est géré et financé par Twilio SendGrid, Inc. Les noms et logos de sendgrid-php sont des marques commerciales de Twilio SendGrid, Inc.

Soutien

Pour obtenir une assistance produit, veuillez consulter le centre d'aide du support Twilio SendGrid.

Licence

La licence MIT (MIT)