PHPackages fabiotech/laravel-elasticemail - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. fabiotech/laravel-elasticemail ActiveLibrary[Mail & Notifications](/categories/mail) fabiotech/laravel-elasticemail ============================== A production-ready Elastic Email API transport for Laravel Mail. v0.3.1(today)12↑2900%MITPHPPHP ^8.3CI passing Since Aug 28Pushed todayCompare [ Source](https://github.com/FabioTECH1/laravel-elasticemail)[ Packagist](https://packagist.org/packages/fabiotech/laravel-elasticemail)[ Docs](https://github.com/FabioTECH1/laravel-elasticemail)[ RSS](/packages/fabiotech-laravel-elasticemail/feed)WikiDiscussions main Synced today READMEChangelogDependencies (15)Versions (4)Used By (0) Laravel Elastic Email ===================== [](#laravel-elastic-email) A Laravel Mail transport for the Elastic Email transactional HTTP API, powered by the official `elasticemail/elasticemail-php` SDK. It does not use SMTP. Requirements ------------ [](#requirements) - PHP 8.3 or newer - PHP cURL extension (required for enforceable connection and wall-clock request timeouts) - Laravel 12.61.1+ or 13.12.0+ - An Elastic Email API key restricted to the `SendHttp` permission Installation ------------ [](#installation) ``` composer require fabiotech/laravel-elasticemail ``` Laravel discovers the package automatically. Configure the mailer and API key: ``` MAIL_MAILER=elasticemail ELASTIC_EMAIL_API_KEY=your-api-key ``` No application service-provider code and no manual `config/mail.php` entry are required. Usage ----- [](#usage) Use Laravel Mailables and Notifications normally: ``` use Illuminate\Support\Facades\Mail; Mail::to('primary@example.com') ->cc('copy@example.com') ->bcc('archive@example.com') ->send(new InvoiceMail($invoice)); ``` The transport supports HTML and plain-text bodies, To/CC/BCC, multiple Reply-To addresses, envelope senders, inline and regular attachments, queued mail, and provider message identifiers. Laravel-generated `Email` and `TemplatedEmail` messages are supported; arbitrary raw MIME messages are rejected before conversion so they cannot bypass resource limits. Production configuration ------------------------ [](#production-configuration) The secure defaults are: Environment variableDefaultHard ceilingPurpose`ELASTIC_EMAIL_CONNECT_TIMEOUT``5``60`TCP/TLS connection timeout in seconds`ELASTIC_EMAIL_TIMEOUT``15``600`Complete HTTP request timeout in seconds`ELASTIC_EMAIL_MAX_BODY_BYTES``2000000``20000000`Maximum bytes in each HTML or text body`ELASTIC_EMAIL_MAX_ATTACHMENTS``10``100`Maximum attachment count`ELASTIC_EMAIL_MAX_ATTACHMENT_BYTES``10000000``20000000`Maximum raw bytes in one attachment`ELASTIC_EMAIL_MAX_MESSAGE_BYTES``15000000``20000000`Maximum aggregate raw body and attachment bytes`ELASTIC_EMAIL_MAX_PAYLOAD_BYTES``20000000``20000000`Maximum encoded JSON request bytes`ELASTIC_EMAIL_MAX_RECIPIENTS``1000``10000`Maximum combined From/Reply-To/To/CC/BCC addresses`ELASTIC_EMAIL_MAX_HEADER_BYTES``16384``65536`Maximum bytes in one subject/address/filename metadata value`ELASTIC_EMAIL_MAX_METADATA_BYTES``262144``1000000`Maximum aggregate address/header/filename metadata bytes`ELASTIC_EMAIL_MAX_RESPONSE_BYTES``65536``1000000`Maximum decoded provider response bytesSize/count limits must be plain positive decimal integers and cannot exceed the hard ceilings. Timeouts may be positive decimals within their ceilings. The payload ceiling follows Elastic Email's documented 20 MB message limit; the other ceilings keep all size arithmetic bounded. Set lower application-specific limits when users can influence outgoing content. The package limits transport-side amplification, but it cannot protect memory already consumed while an application uploads, builds, or serializes a queued message. Publish the configuration only when you need a checked-in override: ``` php artisan vendor:publish --tag=elasticemail-config php artisan config:cache ``` Values in `config/mail.php` override package defaults. Keep the same finite limits when overriding the mailer: ``` 'elasticemail' => [ 'transport' => 'elasticemail', 'key' => env('ELASTIC_EMAIL_API_KEY'), 'connect_timeout' => 5, 'timeout' => 15, 'max_body_bytes' => 2_000_000, 'max_attachments' => 10, 'max_attachment_bytes' => 10_000_000, 'max_message_bytes' => 15_000_000, 'max_payload_bytes' => 20_000_000, 'max_recipients' => 1_000, 'max_header_bytes' => 16_384, 'max_metadata_bytes' => 262_144, 'max_response_bytes' => 65_536, ], ``` Body resources must be local and seekable. Symfony's normal attachment APIs use base64 transfer encoding and are supported for in-memory, resource-backed, storage, file, and inline attachments. Custom non-base64 attachment encodings are rejected. Security and privacy -------------------- [](#security-and-privacy) - Give the API key only `SendHttp` permission, keep it in an environment secret store, and rotate it immediately if it may have leaked. - TLS verification is enabled, redirects are disabled, and both request time and decoded response size are bounded on the package-managed client. - Failure logs contain only counts, byte lengths, elapsed milliseconds, a safe failure category, the numeric status, retryability, and exception class. Addresses, domains, subjects, content, provider error prose, request IDs, and credentials are never logged by this package. - Validate authorization, destination addresses, uploads, and rate limits before constructing a Mailable. Isolate mail queues from latency-sensitive jobs and set a finite PHP memory limit. - The response cap applies when Laravel creates the transport through this package. If you directly instantiate `ElasticEmailTransport` with a custom `EmailsApi`, that client is your security boundary and must enforce an equivalent decoded-response limit, TLS verification, redirect policy, and timeouts. See [SECURITY.md](SECURITY.md) for private vulnerability reporting and supported versions. Failures and retries -------------------- [](#failures-and-retries) Provider and network failures become safe Symfony `TransportException` instances. The exception message distinguishes HTTP, timeout, DNS, TLS, connection, provider-response, response-read, and response-limit failures without exposing provider-controlled data. Local policy failures use `MessageRejectedException`, a permanent transport failure that applications can catch separately. Failure logs include `failure_kind` (`api`, `connect`, `dns`, `http`, `provider_response`, `request`, `response_limit`, `response_read`, `timeout`, or `tls`) and non-negative `elapsed_ms` fields. Connection failures, HTTP 408, 425, 429, and 5xx responses are marked retryable; a response-limit failure is not. The transport does not retry automatically: a timeout can happen after the provider accepted the email, so blind retries can create duplicate deliveries. Configure finite queue attempts, exponential backoff, and an application idempotency strategy appropriate to the message. Do not endlessly retry `MessageRejectedException` jobs. Deployment checklist -------------------- [](#deployment-checklist) 1. Use a least-privilege `SendHttp` key and confirm it is absent from code, logs, images, and shell history. 2. Set application upload/content limits at or below the package limits. 3. Cache production configuration, restart long-lived workers, and send a canary email. 4. Configure finite queue attempts/backoff, worker memory limits, monitoring, and failed-job alerts. 5. Run `composer audit --locked`, the test suite, and your application's mail tests before deployment. 6. Monitor delivery failures by status/count, without adding recipient or provider-response data to logs. Development ----------- [](#development) ``` composer install composer validate --strict composer audit --locked composer analyse composer test composer format ``` The CI matrix covers supported Laravel, PHP, and Symfony combinations, including the minimum direct production dependencies. CodeQL, dependency review, Dependabot, and exact GitHub Action commit pins protect the release workflow. License ------- [](#license) Laravel Elastic Email is open-source software licensed under the MIT license. ### Health Score 39 — LowBetter than 84% of packages Maintenance100 Actively maintained with recent releases Popularity5 Limited adoption so far Community6 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 3 Last Release 0d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/61967471?v=4)[Faruk Yusuf Abiola](/maintainers/FabioTECH1)[@FabioTECH1](https://github.com/FabioTECH1) --- Top Contributors [![FabioTECH1](https://avatars.githubusercontent.com/u/61967471?v=4)](https://github.com/FabioTECH1 "FabioTECH1 (7 commits)") --- Tags laravelemailmailertransportelastic email ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/fabiotech-laravel-elasticemail/health.svg) ``` [![Health](https://phpackages.com/badges/fabiotech-laravel-elasticemail/health.svg)](https://phpackages.com/packages/fabiotech-laravel-elasticemail) ``` ### Alternatives [shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.8M687](/packages/shopware-core)[laravel/framework The Laravel Framework. 34.9k556.2M21.6k](/packages/laravel-framework)[aws/aws-sdk-php AWS SDK for PHP - Use Amazon Web Services in your PHP project 6.2k555.0M2.9k](/packages/aws-aws-sdk-php)[shopware/platform The Shopware e-commerce core 3.4k1.5M3](/packages/shopware-platform)[tempest/framework The PHP framework that gets out of your way. 2.3k37.6k21](/packages/tempest-framework)[typo3/cms TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL. 1.2k1.9M122](/packages/typo3-cms) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)