](https://docs.typo3.org/other/typo3/view-helper-reference/main/en-us/Global/Uri/Page.html#typo3-fluid-uri-page),
pass the current request to the FluidEmail instance:
```php
use TYPO3\CMS\Core\Mail\FluidEmail;
$email = new FluidEmail();
$email->setRequest($this->request);
```
Read more aboout [Getting the PSR-7 request object](https://docs.typo3.org/permalink/t3coreapi:getting-typo3-request-object@main) in different
contexts.
In a context where no valid request object can be retrieved, such as in a
[Console command](https://docs.typo3.org/permalink/t3coreapi:symfony-console-commands@main) a valid frontend context need to be
simulated ([Simulating a frontend request in TYPO3 Commands](https://docs.typo3.org/permalink/t3coreapi:console-command-tutorial-fe-request-example@main))
or the affected ViewHelpers cannot be used.
Trying to use these ViewHelpers without a valid request throws an [error](https://docs.typo3.org/m/typo3/reference-exceptions/main/en-us/Exceptions/1639819269.html)
like the following:
**Example error output**
```text
[ERROR] The rendering context of ViewHelper f:link.page is missing a valid request object.
```
### Send email of type `MailMessage` with an injected `MailerInterface` {#mail-mail-message}
The following methods have been removed:TYPO3\CMS\Core\Mail\MailMessage->send()TYPO3\CMS\Core\Mail\MailMessage->isSent()
`\TYPO3\CMS\Core\Mail\MailMessage` can be used to generate an email
without using Fluid. The email can then be sent via the injected interface
`\TYPO3\CMS\Core\Mail\MailerInterface`.
**EXT:site_package/Classes/Controller/MyMailerController.php**
```php
from(new Address('john.doe@example.org', 'John Doe'))
// Set the "To" addresses
->to(
new Address('receiver@example.org', 'Max Mustermann'),
new Address('other@example.org'),
)
// Give the message a subject
->subject('Your subject')
// Give it the text message
->text('Here is the message itself')
// And optionally an HTML message
->html('Here is the message itself
')
// Optionally add any attachments
->attachFromPath('/path/to/my-document.pdf');
// And finally send it
$this->mailer->send($email);
}
}
```
## How to add attachments {#mail-attachments}
Attach files that exist in your file system:
**EXT:site_package/Classes/Utility/MyMailUtility.php**
```php
// Attach file to message
$email->attachFromPath('/path/to/documents/privacy.pdf');
// Optionally you can tell email clients to display a custom name for the file
$email->attachFromPath('/path/to/documents/privacy.pdf', 'Privacy Policy');
// Alternatively attach contents from a stream
$email->attach(fopen('/path/to/documents/contract.doc', 'r'));
```
## How to add inline media {#mail-inline}
Add some inline media like images in an email:
**EXT:site_package/Classes/Utility/MyMailUtility.php**
```php
// Get the image contents from a PHP resource
$email->embed(fopen('/path/to/images/logo.png', 'r'), 'logo');
// Get the image contents from an existing file
$email->embedFromPath('/path/to/images/signature.png', 'footer-signature');
// reference images using the syntax 'cid:' + "image embed name"
$email->html('
... 
...');
```
## How to set and use a default sender {#mail-sender}
It is possible to define a default email sender ("From:") in
**System > Settings > Configure Installation-Wide Options**:
**config/system/additional.php | typo3conf/system/additional.php**
```php
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromAddress'] = 'john.doe@example.org';
$GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromName'] = 'John Doe';
```
This is how you can use these defaults:
**EXT:site_package/Classes/Controller/MyMailerController.php**
```php
setFrom(MailUtility::getSystemFrom());
$this->mailer->send($email);
}
}
```
## Register a custom mailer {#register-custom-mailer}
To be able to use a custom mailer implementation in TYPO3, the interface
`\TYPO3\CMS\Core\Mail\MailerInterface` is available, which extends
`\Symfony\Component\Mailer\MailerInterface`. By default,
`\TYPO3\CMS\Core\Mail\Mailer` is registered as implementation.
After implementing your custom mailer, add the following lines into the
[`Configuration/Services.yaml`](../../ExtensionArchitecture/FileStructure/Configuration/ServicesYaml.md#file-extension-configuration-services-yaml) file to ensure that your custom
mailer is used.
**EXT:site_package/Configuration/Services.yaml**
```yaml
TYPO3\CMS\Core\Mail\MailerInterface:
alias: MyVendor\SitePackage\Mail\MyCustomMailer
```
## PSR-14 events on sending messages {#mail-psr-14-events}
Some PSR-14 events are available:
- [BeforeMailerSentMessageEvent](https://docs.typo3.org/permalink/t3coreapi:beforemailersentmessageevent@main) to manipulate messages before they are
sent by the mailer.
- [AfterMailerSentMessageEvent](https://docs.typo3.org/permalink/t3coreapi:aftermailersentmessageevent@main) to further process a sent message.
## Symfony mail documentation {#mail-symfony-mime}
Please refer to the Symfony documentation for more information about
available methods.
> [!NOTE]
> **See also**
>
> - [The Mime Component](https://symfony.com/doc/current/components/mime.html)
> - [Sending Emails with Mailer](https://symfony.com/doc/current/mailer.html)