PHP Mail Utility

Contact Form Mailer

This project provides a professional contact form interface backed by PHPMailer and SMTP. It is designed to be dropped into a PHP site without a database.

What it does

Collects inquiry details through a polished on-page contact form.
Sends mail through PHPMailer using your SMTP provider.
Uses the visitor email as reply-to for faster follow-up.
Supports SMTP provider presets and a dedicated SMTP test action.
Saves failed sends into storage/failed-messages.json as a fallback.

Initial setup

Open functions/config.local.php.
Fill in smtp_host, smtp_port, smtp_secure, smtp_username, and smtp_password.
Set from_email and from_name to the mailbox identity you want to send from.
Set to_email and to_name to the inbox that should receive inquiries.
Optionally adjust rate_limit_per_hour.

How to use it

Open /ContactFormMailer/.
Use the provider preset panel to confirm the correct SMTP direction for your mail provider.
Run Send SMTP Test before using the live form.
Submit the contact form and review the on-page success or error feedback.
If sending fails, check storage/failed-messages.json for the saved fallback record.

Security and reliability

CSRF token validation is applied on both message sending and SMTP test endpoints.
A honeypot field blocks simple spam bots.
Rate limiting is applied per browser fingerprint over a one-hour window.
Config and helper files are protected from direct public access with .htaccess.

Project structure

index.php: main UI, preset panel, SMTP test panel, and live form.
css/style.css: form styling and right rail presentation.
js/app.js: AJAX form submission, provider preset rendering, and SMTP test flow.
functions/lib.php: config loading, validation, rate limit, failed fallback storage, and mail helpers.
functions/mail.php: live contact form endpoint.
functions/test-smtp.php: SMTP verification endpoint.
functions/phpmailer/src/: local PHPMailer runtime files.
storage/: rate limits and failed-message fallbacks.

Tip:

Always send an SMTP test first, then submit one real sample inquiry from a different email address so you verify both delivery and reply-to behavior before going live.