Weave Code
Sendinblue Mailer Laravel Package
symfony/sendinblue-mailer
Symfony Mailer transport for Sendinblue/Brevo. Send transactional emails through the Brevo API using Symfony’s mailer component, with simple configuration and seamless integration for Symfony apps and any PHP project using Symfony Mailer.
Symfony Sendinblue Mailer Bridge
Frequently asked questions about Sendinblue Mailer
- Can I use symfony/sendinblue-mailer in a Laravel app that doesn’t already use Symfony Mailer?
- Yes, but you’ll need to install Symfony Mailer first (`composer require symfony/mailer symfony/http-client`). Laravel’s native Mail facade is compatible with Symfony Mailer, so you can swap transports with minimal changes. Start by configuring the DSN in `.env` and updating `config/mail.php` to use Symfony’s transport.
- How do I configure Sendinblue’s API key in Laravel?
- Add your Sendinblue API key to `.env` using the DSN format: `MAILER_DSN=sendinblue://default:your_api_key@default`. Then update `config/mail.php` to set the default transport to this DSN. No additional Laravel-specific configuration is needed beyond Symfony Mailer’s setup.
- Will my existing Laravel Mailables work with this package?
- Yes, if your app uses Symfony Mailer’s transport. If you’re still on Laravel’s SwiftMailer, you’ll need to migrate to Symfony Mailer first. The package leverages Symfony’s abstraction layer, so Mailables built for Symfony Mailer will work out of the box.
- How do I use Sendinblue’s drag-and-drop templates in Laravel?
- Pass the template ID directly in your Mailable class using a custom method like `sendinblueTemplateId()`. For dynamic content, pre-render Blade templates to strings and pass them as `htmlContent` via Sendinblue’s API. Static templates are best for marketing emails, while dynamic content works for transactional emails.
- Does this package support Sendinblue’s webhook events (e.g., email opens, clicks) in Laravel?
- Yes, but you’ll need to set up a Laravel route to handle Sendinblue’s webhook payloads (e.g., `Route::post('/sendinblue-webhook', [WebhookController::class, 'handle'])`). Use Laravel’s `Bus` or `Events` system to dispatch internal events when webhooks are received. Verify your firewall allows Sendinblue’s IP ranges.
- What Laravel versions are compatible with symfony/sendinblue-mailer?
- This package works with Laravel 9+ since it relies on Symfony Mailer 6.x+, which is compatible with Laravel’s newer versions. For Laravel 8 or older, you’d need to manually align Symfony Mailer versions or use a different approach. Always test with `^6.0` in your `composer.json` to avoid breaking changes.
- Can I use this package for both transactional emails and marketing campaigns?
- Yes, but the approach differs. For transactional emails, use dynamic content via Sendinblue’s API variables or pre-rendered Blade templates. For marketing campaigns, leverage Sendinblue’s drag-and-drop templates with static IDs. The package supports both use cases under Symfony Mailer’s abstraction.
- What happens if Sendinblue’s API fails to deliver an email? Are there retries?
- This package doesn’t include built-in retry logic. To handle failures, wrap your email-sending logic in Laravel’s queue system (e.g., `Mail::to($user)->queue($mailable)`). This ensures retries and background processing if the API is temporarily unavailable.
- Is there a performance benefit to using Sendinblue’s SMTP relay instead of sending emails directly from Laravel?
- Yes, offloading email delivery to Sendinblue reduces server load, improves deliverability, and leverages Sendinblue’s infrastructure. This is especially useful for high-volume apps or those with strict email-sending limits. Configure the DSN to use Sendinblue’s SMTP relay for optimal performance.
- Are there alternatives to symfony/sendinblue-mailer for Laravel?
- Yes, alternatives include using Sendinblue’s native PHP SDK directly or Laravel-specific packages like `spatie/laravel-sendinblue`. However, this package offers deeper integration with Symfony Mailer, which is already a first-party Laravel-compatible component. Choose based on whether you prefer Symfony’s abstraction or a more Laravel-native solution.
Weaver
How can I help you explore Laravel packages today?