Weave Code
Sdd Sparkpost Transport Bundle Laravel Package
sddproductions/sdd-sparkpost-transport-bundle
A Symfony bundle that adds SparkPost as a mail transport, letting you send email through SparkPost's API using Symfony Mailer. Configure your API key and DSN, then send messages with the familiar Mailer interface—no custom integration code required.
This bundle is an integration between https://github.com/DigitalState/Platform-Transport-Bundle and https://github.com/SparkPost/php-sparkpost
Frequently asked questions about Sdd Sparkpost Transport Bundle
- How do I install sddproductions/sdd-sparkpost-transport-bundle?
- Install it with Composer using composer require sddproductions/sdd-sparkpost-transport-bundle. Then register the bundle in your Symfony application and configure your SparkPost API key and DSN. Because it is a Symfony bundle, it is not a native Laravel package and does not install as a Laravel service provider out of the box.
- Does this package work with Laravel?
- No, this is a Symfony bundle built to integrate DigitalState Platform Transport Bundle with the SparkPost PHP SDK. Laravel uses its own mail system, so this package is not a drop-in Laravel mail transport. Laravel developers would need to adapt the integration or use a Laravel-compatible SparkPost transport instead.
- How do I configure the SparkPost transport DSN?
- Configure your SparkPost API key and DSN in the bundle configuration as required by the DigitalState transport integration. The DSN tells Symfony Mailer which transport to use and includes the credentials needed to call SparkPost's API. Keep the API key in environment variables rather than committing it to source control.
- What Laravel versions are supported?
- This package is a Symfony bundle, so it does not publish a Laravel version support matrix. Its compatibility depends on the Symfony framework, DigitalState Platform Transport Bundle, and SparkPost PHP SDK versions listed in its Composer requirements. Laravel applications are not officially targeted by this package.
- Can I use this to send transactional email through SparkPost's API?
- Yes, the bundle adds SparkPost as a mail transport so messages sent through the Symfony Mailer interface are delivered via SparkPost's API. That makes it suitable for transactional email such as password resets, notifications, and order confirmations. You still need a valid SparkPost account, sending domain, and API key.
- How do I test SparkPost email sending without hitting the real API?
- In unit or functional tests, use Symfony Mailer's test transport or a fake mailer so messages are captured instead of sent. For integration tests, mock the SparkPost client or use a SparkPost test key or sandbox configuration where available. Avoid sending real email from automated tests and never use production API keys in CI.
- Is this package maintained and production-ready?
- Check the GitHub repository and Packagist for recent commits, releases, open issues, and compatibility updates before using it in production. It is a focused integration bundle, so maintenance activity matters more than feature count. Pin a known-good version and review changes before upgrading.
- What are alternatives for sending SparkPost email in Laravel or Symfony?
- For Symfony, newer Symfony Mailer versions include a SparkPost transport that can be configured with a sparkpost+api DSN. For Laravel, you can use a Laravel-compatible SparkPost transport package, the Symfony Mailer bridge, or call the SparkPost PHP SDK directly. Choose based on your framework version, maintenance needs, and whether you need webhooks or advanced SparkPost features.
- Do I need the SparkPost PHP SDK installed separately?
- No, the bundle integrates the SparkPost PHP SDK as a Composer dependency, so Composer should install the required libraries automatically. You still need a SparkPost account, a verified sending domain, and an API key with permission to send email. Check the package's composer.json for the exact dependency versions.
- How should I handle errors and production concerns like SparkPost API rate limits?
- Catch exceptions thrown by Symfony Mailer or the transport, log failures with context, and consider retries with backoff for transient errors. Monitor SparkPost API limits, sending domain health, and webhook events in production. Store API keys in environment variables and rotate them if they are exposed.
Weaver
How can I help you explore Laravel packages today?