andy/webhook
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Additional Parsers, improve design of email

Browse Source
This commit is contained in:
Andy Dixon
2026-01-22 16:24:19 +00:00
parent 53889663dd
commit 861c9dddde
2 changed files with 761 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+102 -4
View File
@@ -5,10 +5,12 @@ A simple, elegant PHP solution for debugging webhooks by forwarding them directl
## 🌟 Features
- **Email Delivery**: Receive complete webhook data directly in your inbox
- **Custom Parsers**: Beautifully formatted emails for GitHub and other services
- **Secure**: Built-in email validation and XSS protection
- **Instant**: Real-time webhook processing and forwarding
- **Simple**: No database or complex setup required
- **Universal**: Supports all HTTP methods and content types
- **Extensible**: Easy to add new parsers for any webhook service
## 📋 Overview
@@ -21,19 +23,70 @@ Replace `@` with `%40` in your email address:
- `test@example.com` becomes `test%40example.com`
### 2. Configure Webhook
Use the following URL format as your webhook endpoint:
Use one of the following URL formats as your webhook endpoint:
**Standard format** (raw webhook data):
```
https://your-domain.com/{encoded-email}
```
**With parser** (formatted email for specific services):
```
https://your-domain.com/{encoded-email}/{parser-name}
```
### 3. Check Your Inbox
Receive detailed webhook data instantly in your email with the subject:
Receive webhook data instantly in your email!
**Standard format:**
```
‼️ Webhook Request Received - [timestamp]
```
**With parser:**
```
📤 GitHub push - username/repo
💳 Stripe payment.succeeded - $99.99
```
## 🎨 Webhook Parsers
Parsers format webhooks from specific services into beautiful, readable emails.
### Available Parsers
#### GitHub (`/github`)
Formats GitHub webhook events with full event details.
**Supported events:**
- Push events (with commit details)
- Pull requests
- Issues
- Releases
- And more...
**Example URL:**
```
https://your-domain.com/test%40example.com/github
```
**What you get:**
- Event-specific formatting
- Commit details with author info
- Pull request/issue metadata
- Clean, scannable layout
- Relevant emojis for quick identification
### Creating Your Own Parser
Want to add support for Stripe, GitLab, or other services? Check out the [**Parser Development Guide**](../PARSER_PROMPT.md) for detailed instructions on creating custom parsers.
---
## 💡 Usage Examples
### Standard Webhook (Raw Data)
### cURL - POST Request with JSON
```bash
curl -X POST https://your-domain.com/test%40example.com \
@@ -73,6 +126,40 @@ response = requests.post(
print(response.text)
```
### With GitHub Parser
Configure your GitHub webhook with:
```
https://your-domain.com/yourname%40company.com/github
```
When events occur, you'll receive formatted emails like:
**Push Event:**
```
📤 GitHub push - yourname/your-repo
Repository: yourname/your-repo
Branch: refs/heads/main
Commits: 3
Pusher: developerUsername
Commits:
abc1234 Fix bug in authentication by John Doe
def5678 Update dependencies by Jane Smith
ghi9012 Add new feature by Bob Johnson
```
**Pull Request:**
```
🔀 GitHub pull_request (opened) - yourname/your-repo
Number: #42
Title: Add new authentication method
State: open
Branch: feature-auth → main
```
## 📦 Installation
1. Clone the repository:
@@ -129,18 +216,22 @@ Each webhook email contains:
## 🎯 Common Use Cases
- **Debugging**: See exactly what data third-party services are sending
- **GitHub Notifications**: Get beautifully formatted emails for pushes, PRs, and issues
- **Integration Testing**: Test webhook integrations before implementing full handlers
- **Monitoring**: Monitor webhook activity and payload changes over time
- **Documentation**: Capture real examples for API documentation
- **Development**: Quickly test webhook flows during development
- **Troubleshooting**: Diagnose issues with webhook payloads and headers
- **Custom Parsers**: Add your own parsers for Stripe, GitLab, Slack, etc.
## 💡 Tips & Best Practices
- **Email Filtering**: Create an email filter for the subject line "‼️ Webhook Request Received" to organize incoming webhooks
- **Use Parsers**: Use `/github`, `/stripe`, etc. for prettier emails from supported services
- **Email Filtering**: Create email filters based on subject patterns ("📤 GitHub", "💳 Stripe") to organize webhooks
- **Plus Addressing**: Use email plus addressing (e.g., `yourname+github%40gmail.com`) to track which services are sending webhooks
- **Timestamp in Emails**: Check the "Date Received" field to verify webhook timing and debug delivery delays
- **Parse the Body**: The raw body section contains the exact payload - perfect for copying into your code for testing
- **Standard Format**: Use the standard format (no parser) when you need complete raw data for debugging
- **Create Parsers**: Build custom parsers for your favorite services - see [Parser Guide](../PARSER_PROMPT.md)
## 📝 Error Handling
@@ -171,6 +262,13 @@ Give a ⭐️ if this project helped you!
## 📜 Version History
- **2.0.0** - Parser System Release
- ✨ **NEW**: Custom parser support for formatted webhooks
- ✨ **NEW**: GitHub webhook parser with full event support
- ✨ **NEW**: Parser development guide (PARSER_PROMPT.md)
- Backward compatible with existing webhook URLs
- Same security and styling standards
- **1.0.0** - Initial release
- Basic webhook forwarding functionality
- HTML email formatting
index.php
+654 -39
View File
@@ -24,8 +24,12 @@ $requestUri = $_SERVER['REQUEST_URI'] ?? '';
$path = parse_url($requestUri, PHP_URL_PATH);
// Remove leading and trailing forward slashes from the path
// Example: '/email%40domain.com/' becomes 'email%40domain.com'
$emailEncoded = trim($path, '/');
// Example: '/email%40domain.com/' or '/email%40domain.com/github'
$pathParts = explode('/', trim($path, '/'));
// Extract email and optional parser
$emailEncoded = $pathParts[0] ?? '';
$parserName = $pathParts[1] ?? null;
// Decode the URL-encoded email address (e.g., %40 becomes @)
// Example: 'email%40domain.com' becomes 'email@domain.com'
@@ -105,6 +109,26 @@ $ipAddressSafe = htmlspecialchars($ipAddress, ENT_QUOTES, 'UTF-8');
$requestMethodSafe = htmlspecialchars($requestMethod, ENT_QUOTES, 'UTF-8');
$contentTypeSafe = htmlspecialchars($contentType, ENT_QUOTES, 'UTF-8');
// Check if a parser is specified and exists
$html = '';
$subject = '';
if ($parserName && function_exists($parserName . 'Parse')) {
$parserFunction = $parserName . 'Parse';
$parsed = $parserFunction($rawBody, $headersArray, [
'date' => $dateReceived,
'ip' => $ipAddress,
'method' => $requestMethod,
'contentType' => $contentType
]);
if ($parsed !== false) {
$html = $parsed['html'];
$subject = $parsed['subject'];
}
}
// If no parser or parser failed, use default format
if (empty($html)) {
// Construct the HTML email body using a heredoc string for better readability
// This creates a styled HTML email with all webhook details
$html = <<<HTML
@@ -115,70 +139,661 @@ $html = <<<HTML
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Webhook Request Received</title>
<style>
/* Main body styling with dark blue background */
/* Gmail-safe reset and main styling */
body {
background-color: #004080;
color: white;
font-family: Arial, sans-serif;
padding: 20px;
background-color: #ffffff;
color: #1a1a1a;
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
line-height: 1.6;
padding: 0;
margin: 0;
}
/* Section heading styling */
h2 {
color: white;
border-bottom: 1px solid #ccc;
padding-bottom: 5px;
margin-top: 20px;
/* Container for better email client compatibility */
.container {
max-width: 700px;
margin: 0 auto;
padding: 40px 20px;
}
/* Preformatted text block styling for code/data display */
pre {
background-color: #002f5f;
padding: 15px;
border-radius: 5px;
color: #f0f0f0;
font-family: monospace;
/* Header styling with elegant separator */
.header {
text-align: center;
padding-bottom: 30px;
border-bottom: 3px solid #000000;
margin-bottom: 40px;
}
.header h1 {
color: #000000;
font-size: 28px;
font-weight: 700;
margin: 0 0 10px 0;
letter-spacing: -0.5px;
}
.header .timestamp {
color: #666666;
font-size: 14px;
font-weight: 500;
margin: 0;
}
/* Section styling with elegant typography */
.section {
margin-bottom: 35px;
}
.section-title {
color: #000000;
font-size: 18px;
font-weight: 700;
margin: 0 0 12px 0;
padding-bottom: 8px;
border-bottom: 2px solid #e0e0e0;
letter-spacing: -0.3px;
}
/* Data display with subtle borders */
.data-box {
border: 1px solid #d0d0d0;
border-radius: 8px;
padding: 16px 20px;
margin: 0;
font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', 'Consolas', monospace;
font-size: 13px;
line-height: 1.7;
color: #2a2a2a;
white-space: pre-wrap;
word-wrap: break-word;
overflow-x: auto;
box-shadow: 0 1px 3px rgba(0,0,0,0.08);
}
/* Metadata grid for clean information display */
.metadata {
display: table;
width: 100%;
border: 1px solid #d0d0d0;
border-radius: 8px;
overflow: hidden;
box-shadow: 0 1px 3px rgba(0,0,0,0.08);
}
.metadata-row {
display: table-row;
}
.metadata-row:not(:last-child) .metadata-label,
.metadata-row:not(:last-child) .metadata-value {
border-bottom: 1px solid #e8e8e8;
}
.metadata-label {
display: table-cell;
padding: 12px 16px;
font-weight: 600;
color: #000000;
width: 35%;
vertical-align: top;
font-size: 14px;
}
.metadata-value {
display: table-cell;
padding: 12px 16px;
color: #333333;
font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', 'Consolas', monospace;
font-size: 13px;
vertical-align: top;
}
/* Footer styling */
.footer {
margin-top: 50px;
padding-top: 25px;
border-top: 2px solid #e0e0e0;
text-align: center;
color: #888888;
font-size: 12px;
}
</style>
</head>
<body>
<!-- Display the timestamp of when the webhook was received -->
<h2>Request Received</h2>
<pre>Date: $dateReceivedSafe</pre>
<div class="container">
<!-- Email Header -->
<div class="header">
<h1>⚡ Webhook Request Received</h1>
<p class="timestamp">$dateReceivedSafe</p>
</div>
<!-- Display metadata about the request origin and method -->
<h2>Request Information</h2>
<pre>IP Address: $ipAddressSafe
Request Method: $requestMethodSafe
Content-Type: $contentTypeSafe</pre>
<!-- Request Information Section -->
<div class="section">
<div class="section-title">📋 Request Information</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">IP Address</div>
<div class="metadata-value">$ipAddressSafe</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Method</div>
<div class="metadata-value">$requestMethodSafe</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Content-Type</div>
<div class="metadata-value">$contentTypeSafe</div>
</div>
</div>
</div>
<!-- Display all HTTP headers sent with the request -->
<h2>Request Headers</h2>
<pre>$headersText</pre>
<!-- Request Headers Section -->
<div class="section">
<div class="section-title">📨 Request Headers</div>
<pre class="data-box">$headersText</pre>
</div>
<!-- Display the raw request body exactly as received -->
<h2>Request Body</h2>
<pre>$rawBodySafe</pre>
<!-- Request Body Section -->
<div class="section">
<div class="section-title">📦 Request Body</div>
<pre class="data-box">$rawBodySafe</pre>
</div>
<!-- Display all PHP superglobal variables for complete request context -->
<h2>PHP Variables</h2>
<pre>$variablesTextSafe</pre>
<!-- PHP Variables Section -->
<div class="section">
<div class="section-title">🔧 PHP Variables</div>
<pre class="data-box">$variablesTextSafe</pre>
</div>
<!-- Footer -->
<div class="footer">
<p>This webhook was automatically forwarded to your email address.</p>
</div>
</div>
</body>
</html>
HTML;
// Construct the email subject line with an attention-grabbing emoji and timestamp
$subject = "‼️ Webhook Request Received - $dateReceived";
}
/**
* Helper function to render nested arrays/objects as HTML tables
*
* @param array $data The data to render
* @param int $depth Current recursion depth
* @return string HTML representation of the data
*/
function renderDataAsTable($data, $depth = 0) {
if ($depth > 10) {
return '<div class="data-box">Max depth reached</div>';
}
$html = '';
if (!is_array($data)) {
$safe = htmlspecialchars((string)$data, ENT_QUOTES, 'UTF-8');
return "<div class=\"simple-value\">$safe</div>";
}
// Check if it's an indexed array of similar items (like commits)
$isIndexedArray = array_keys($data) === range(0, count($data) - 1);
if ($isIndexedArray && count($data) > 0) {
// Render as a list of items
foreach ($data as $index => $item) {
if (is_array($item)) {
$html .= '<div class="array-item">';
$html .= '<div class="array-item-title">Item ' . ($index + 1) . '</div>';
$html .= '<div class="metadata">';
foreach ($item as $key => $value) {
$keySafe = htmlspecialchars($key, ENT_QUOTES, 'UTF-8');
if (is_array($value)) {
$html .= '<div class="metadata-row">';
$html .= '<div class="metadata-label">' . $keySafe . '</div>';
$html .= '<div class="metadata-value">';
$html .= renderDataAsTable($value, $depth + 1);
$html .= '</div>';
$html .= '</div>';
} else {
$valueSafe = htmlspecialchars((string)$value, ENT_QUOTES, 'UTF-8');
$html .= '<div class="metadata-row">';
$html .= '<div class="metadata-label">' . $keySafe . '</div>';
$html .= '<div class="metadata-value">' . $valueSafe . '</div>';
$html .= '</div>';
}
}
$html .= '</div>';
$html .= '</div>';
} else {
$valueSafe = htmlspecialchars((string)$item, ENT_QUOTES, 'UTF-8');
$html .= '<div class="array-item-simple">• ' . $valueSafe . '</div>';
}
}
} else {
// Render as key-value table
$html .= '<div class="metadata">';
foreach ($data as $key => $value) {
$keySafe = htmlspecialchars($key, ENT_QUOTES, 'UTF-8');
if (is_array($value) && !empty($value)) {
// Close current table and start a subsection
$html .= '</div>';
$html .= '<div class="subsection">';
$html .= '<div class="subsection-title">' . $keySafe . '</div>';
$html .= renderDataAsTable($value, $depth + 1);
$html .= '</div>';
$html .= '<div class="metadata">';
} else if (is_array($value) && empty($value)) {
$html .= '<div class="metadata-row">';
$html .= '<div class="metadata-label">' . $keySafe . '</div>';
$html .= '<div class="metadata-value"><em>empty</em></div>';
$html .= '</div>';
} else {
$valueSafe = htmlspecialchars((string)$value, ENT_QUOTES, 'UTF-8');
$html .= '<div class="metadata-row">';
$html .= '<div class="metadata-label">' . $keySafe . '</div>';
$html .= '<div class="metadata-value">' . $valueSafe . '</div>';
$html .= '</div>';
}
}
$html .= '</div>';
}
return $html;
}
/**
* GitHub Webhook Parser
* Parses GitHub webhook events into a formatted email
*
* @param string $rawBody The raw request body
* @param array $headers The request headers
* @param array $metadata Request metadata (date, ip, method, contentType)
* @return array|false Array with 'html' and 'subject' keys, or false on failure
*/
function githubParse($rawBody, $headers, $metadata) {
$payload = json_decode($rawBody, true);
if (!$payload) {
return false;
}
// Determine event type from headers
$event = $headers['X-GitHub-Event'] ?? $headers['X-Github-Event'] ?? 'Unknown';
$delivery = $headers['X-GitHub-Delivery'] ?? $headers['X-Github-Delivery'] ?? 'Unknown';
// Extract common data
$action = $payload['action'] ?? null;
$repository = $payload['repository']['full_name'] ?? 'Unknown';
$sender = $payload['sender']['login'] ?? 'Unknown';
// Sanitize for HTML
$eventSafe = htmlspecialchars($event, ENT_QUOTES, 'UTF-8');
$actionSafe = $action ? htmlspecialchars($action, ENT_QUOTES, 'UTF-8') : null;
$repoSafe = htmlspecialchars($repository, ENT_QUOTES, 'UTF-8');
$senderSafe = htmlspecialchars($sender, ENT_QUOTES, 'UTF-8');
$dateSafe = htmlspecialchars($metadata['date'], ENT_QUOTES, 'UTF-8');
$ipSafe = htmlspecialchars($metadata['ip'], ENT_QUOTES, 'UTF-8');
// Build event-specific content
$eventContent = '';
$eventIcon = '🔔';
switch ($event) {
case 'push':
$eventIcon = '📤';
$ref = htmlspecialchars($payload['ref'] ?? 'Unknown', ENT_QUOTES, 'UTF-8');
$commits = $payload['commits'] ?? [];
$commitCount = count($commits);
$eventContent = <<<HTML
<div class="section">
<div class="section-title">Push Details</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Branch</div>
<div class="metadata-value">$ref</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Commits</div>
<div class="metadata-value">$commitCount</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Pusher</div>
<div class="metadata-value">$senderSafe</div>
</div>
</div>
</div>
HTML;
if ($commitCount > 0) {
$eventContent .= '<div class="section"><div class="section-title">Commits</div>';
foreach (array_slice($commits, 0, 10) as $commit) {
$message = htmlspecialchars($commit['message'] ?? '', ENT_QUOTES, 'UTF-8');
$author = htmlspecialchars($commit['author']['name'] ?? 'Unknown', ENT_QUOTES, 'UTF-8');
$sha = htmlspecialchars(substr($commit['id'] ?? '', 0, 7), ENT_QUOTES, 'UTF-8');
$eventContent .= "<div class=\"commit-item\"><strong>$sha</strong> $message <em>by $author</em></div>";
}
$eventContent .= '</div>';
}
break;
case 'pull_request':
$eventIcon = '🔀';
$pr = $payload['pull_request'] ?? [];
$prNumber = htmlspecialchars($pr['number'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$prTitle = htmlspecialchars($pr['title'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$prUrl = htmlspecialchars($pr['html_url'] ?? '#', ENT_QUOTES, 'UTF-8');
$prState = htmlspecialchars($pr['state'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$prBase = htmlspecialchars($pr['base']['ref'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$prHead = htmlspecialchars($pr['head']['ref'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$eventContent = <<<HTML
<div class="section">
<div class="section-title">Pull Request Details</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Number</div>
<div class="metadata-value">#$prNumber</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Title</div>
<div class="metadata-value">$prTitle</div>
</div>
<div class="metadata-row">
<div class="metadata-label">State</div>
<div class="metadata-value">$prState</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Branch</div>
<div class="metadata-value">$prHead → $prBase</div>
</div>
<div class="metadata-row">
<div class="metadata-label">URL</div>
<div class="metadata-value"><a href="$prUrl" style="color: #0066cc;">$prUrl</a></div>
</div>
</div>
</div>
HTML;
break;
case 'issues':
$eventIcon = '📝';
$issue = $payload['issue'] ?? [];
$issueNumber = htmlspecialchars($issue['number'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$issueTitle = htmlspecialchars($issue['title'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$issueUrl = htmlspecialchars($issue['html_url'] ?? '#', ENT_QUOTES, 'UTF-8');
$issueState = htmlspecialchars($issue['state'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$eventContent = <<<HTML
<div class="section">
<div class="section-title">Issue Details</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Number</div>
<div class="metadata-value">#$issueNumber</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Title</div>
<div class="metadata-value">$issueTitle</div>
</div>
<div class="metadata-row">
<div class="metadata-label">State</div>
<div class="metadata-value">$issueState</div>
</div>
<div class="metadata-row">
<div class="metadata-label">URL</div>
<div class="metadata-value"><a href="$issueUrl" style="color: #0066cc;">$issueUrl</a></div>
</div>
</div>
</div>
HTML;
break;
case 'release':
$eventIcon = '🚀';
$release = $payload['release'] ?? [];
$tagName = htmlspecialchars($release['tag_name'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$releaseName = htmlspecialchars($release['name'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$releaseUrl = htmlspecialchars($release['html_url'] ?? '#', ENT_QUOTES, 'UTF-8');
$eventContent = <<<HTML
<div class="section">
<div class="section-title">Release Details</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Tag</div>
<div class="metadata-value">$tagName</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Name</div>
<div class="metadata-value">$releaseName</div>
</div>
<div class="metadata-row">
<div class="metadata-label">URL</div>
<div class="metadata-value"><a href="$releaseUrl" style="color: #0066cc;">$releaseUrl</a></div>
</div>
</div>
</div>
HTML;
break;
default:
// Generic event display - render as structured tables
$eventContent = '<div class="section"><div class="section-title">Event Details</div>';
$eventContent .= renderDataAsTable($payload);
$eventContent .= '</div>';
}
$actionDisplay = $actionSafe ? " ($actionSafe)" : '';
$html = <<<HTML
<!DOCTYPE html>
<html lang="en-GB">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>GitHub Webhook - $eventSafe</title>
<style>
body {
background-color: #ffffff;
color: #1a1a1a;
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
line-height: 1.6;
padding: 0;
margin: 0;
}
.container {
max-width: 700px;
margin: 0 auto;
padding: 40px 20px;
}
.header {
text-align: center;
padding-bottom: 30px;
border-bottom: 3px solid #000000;
margin-bottom: 40px;
}
.header h1 {
color: #000000;
font-size: 28px;
font-weight: 700;
margin: 0 0 10px 0;
letter-spacing: -0.5px;
}
.header .timestamp {
color: #666666;
font-size: 14px;
font-weight: 500;
margin: 0;
}
.section {
margin-bottom: 35px;
}
.section-title {
color: #000000;
font-size: 18px;
font-weight: 700;
margin: 0 0 12px 0;
padding-bottom: 8px;
border-bottom: 2px solid #e0e0e0;
letter-spacing: -0.3px;
}
.data-box {
border: 1px solid #d0d0d0;
border-radius: 8px;
padding: 16px 20px;
margin: 0;
font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', 'Consolas', monospace;
font-size: 13px;
line-height: 1.7;
color: #2a2a2a;
white-space: pre-wrap;
word-wrap: break-word;
overflow-x: auto;
box-shadow: 0 1px 3px rgba(0,0,0,0.08);
}
.metadata {
display: table;
width: 100%;
border: 1px solid #d0d0d0;
border-radius: 8px;
overflow: hidden;
box-shadow: 0 1px 3px rgba(0,0,0,0.08);
}
.metadata-row {
display: table-row;
}
.metadata-row:not(:last-child) .metadata-label,
.metadata-row:not(:last-child) .metadata-value {
border-bottom: 1px solid #e8e8e8;
}
.metadata-label {
display: table-cell;
padding: 12px 16px;
font-weight: 600;
color: #000000;
width: 35%;
vertical-align: top;
font-size: 14px;
}
.metadata-value {
display: table-cell;
padding: 12px 16px;
color: #333333;
font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', 'Consolas', monospace;
font-size: 13px;
vertical-align: top;
}
.commit-item {
padding: 10px 16px;
border-left: 3px solid #e0e0e0;
margin-bottom: 8px;
background: #f8f8f8;
border-radius: 4px;
font-size: 14px;
}
.commit-item strong {
color: #0066cc;
font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', 'Consolas', monospace;
}
.commit-item em {
color: #666666;
font-style: normal;
font-size: 13px;
}
.subsection {
margin: 20px 0;
}
.subsection-title {
color: #000000;
font-size: 16px;
font-weight: 600;
margin: 15px 0 10px 0;
padding: 8px 12px;
background: #f0f0f0;
border-left: 4px solid #666666;
border-radius: 4px;
}
.array-item {
margin-bottom: 20px;
padding: 12px;
background: #fafafa;
border: 1px solid #e0e0e0;
border-radius: 6px;
}
.array-item-title {
font-weight: 600;
color: #000000;
margin-bottom: 10px;
padding-bottom: 8px;
border-bottom: 2px solid #d0d0d0;
}
.array-item-simple {
padding: 8px 12px;
margin: 4px 0;
background: #f8f8f8;
border-left: 3px solid #d0d0d0;
font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', 'Consolas', monospace;
font-size: 13px;
}
.simple-value {
font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', 'Consolas', monospace;
font-size: 13px;
color: #333333;
}
.footer {
margin-top: 50px;
padding-top: 25px;
border-top: 2px solid #e0e0e0;
text-align: center;
color: #888888;
font-size: 12px;
}
</style>
</head>
<body>
<div class="container">
<div class="header">
<h1>$eventIcon GitHub: $eventSafe$actionDisplay</h1>
<p class="timestamp">$dateSafe</p>
</div>
<div class="section">
<div class="section-title">📋 Repository Information</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Repository</div>
<div class="metadata-value">$repoSafe</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Event</div>
<div class="metadata-value">$eventSafe</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Sender</div>
<div class="metadata-value">$senderSafe</div>
</div>
<div class="metadata-row">
<div class="metadata-label">IP Address</div>
<div class="metadata-value">$ipSafe</div>
</div>
</div>
</div>
$eventContent
<div class="footer">
<p>This GitHub webhook was automatically forwarded to your email address.</p>
</div>
</div>
</body>
</html>
HTML;
$subject = "$eventIcon GitHub $eventSafe$actionDisplay - $repoSafe";
return [
'html' => $html,
'subject' => $subject
];
}
// Build email headers to ensure proper HTML rendering and sender information
// MIME-Version declares email format capabilities
$emailHeaders = "MIME-Version: 1.0\r\n";
// Content-type specifies HTML email with UTF-8 character encoding
$emailHeaders .= "Content-type: text/html; charset=UTF-8\r\n";
// From header sets the sender address to a no-reply address on the same domain
$emailHeaders .= "From: no-reply@" . ($_SERVER['SERVER_NAME'] ?? 'localhost') . "\r\n";
// From header sets the sender address to a no-reply address at wh.dixon.cx
$emailHeaders .= "From: no-reply@wh.dixon.cx\r\n";
// Send the email using PHP's built-in mail function
// Parameters: recipient, subject, message body, headers