---
title: "PHP Mail"
description: "What BooleanSMTP's PHP Mail connection does, why it is not recommended for real sites, and when it is still useful."
image: "https://booleansmtp.com/docs/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://booleansmtp.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# PHP Mail

import { Steps, Aside } from '@booleanpress/nimbus/components';

**PHP Mail** leaves WordPress's own mail delivery in place — the same `mail()` function it would use
without BooleanSMTP installed — and only applies the connection's From address and From name. It
needs no host, API key, or password, so there's nothing to gather before you add it.

> **Caution**
>
> PHP Mail is often filtered as spam, because it sends directly from your web server instead of
> through an authenticated provider. Use it for local testing or as a last-resort fallback, not as
> your primary connection.

## Add the connection

1. In your WordPress admin sidebar, go to **BooleanSMTP → Mailers**.
2. Click **Add Connection** and choose **PHP Mail**.
3. Under **Sender Settings**, fill in **From Email** (on your site's own domain) and **From Name**.
4. Click **Register Connection**.

![The PHP Mail connection form, with only Connection Name and Sender Settings fields — no credentials needed.](../../../assets/screenshots/php-mail.webp "PHP Mail connection form")

## Send a test email

Use **Test Email** in the sidebar to confirm the connection works — see
[Send a test email](/docs/getting-started/send-a-test-email/) for the steps. A successful test only
confirms your server handed the message off, not that it reached the inbox.

## Common errors

If the test fails, your host has likely disabled the server's local mail function — there's no
setting on this connection to fix that. Use a real provider connection instead.

## Next steps

- [Which mailer should I use?](/docs/learn/choose-a-mailer/)
- [Amazon SES](/docs/mailers/ses/)
- [Custom SMTP](/docs/mailers/smtp/)
- [Nothing arrived?](/docs/learn/nothing-arrived/)

Source: https://booleansmtp.com/docs/mailers/php/index.mdx
