菜单
Use this skill when sending email in BoxLang with the bx-mail module: bx:mail component, attachments with bx:mailparam, multipart emails with bx:mailpart, SMTP configuration in boxlang.json, S/MIME signing and encryption, and server-level mail settings.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use this skill when writing, reviewing, or improving BoxLang code to ensure it follows community best practices for naming, structure, scoping, error handling, performance, and maintainability.
Use this skill when deploying BoxLang applications: CommandBox server setup, Docker containers, AWS Lambda, GitHub Actions CI/CD, BoxLang Version Manager (BVM), boxlang.json runtime config, environment variables, or Spring Boot integration.
Use this skill when generating API documentation for BoxLang or CFML projects with DocBox, including installation, CLI usage, programmatic configuration, HTML/JSON/UML/CommandBox output strategies, HTML themes, multiple sources, excludes patterns, and creating custom strategies. DocBox reads JavaDoc-style comments from your source code — see the code-documenter skill for annotation conventions.
Use this skill when reading, writing, copying, moving, or deleting files and directories in BoxLang: fileRead, fileWrite, fileCopy, fileMove, directoryList, directoryCreate, fileUpload, streaming large files, or processing CSV/JSON files from disk.
Use this skill when working with BoxLang lambdas, closures, arrow functions, higher-order functions, functional array/struct pipelines (map, filter, reduce, flatMap, groupBy, etc.), destructuring, or spread syntax.
Use this skill when working with BoxLang's interceptor/event system: creating interceptors, registering announcement points, announcing custom events with announce() or announceAsync(), building pre/post operation hooks, validation interceptors, security guards, or leveraging BoxRegisterInterceptor() BIF for standalone and module-based interception.
| name | bx-mail |
| description | Use this skill when sending email in BoxLang with the bx-mail module: bx:mail component, attachments with bx:mailparam, multipart emails with bx:mailpart, SMTP configuration in boxlang.json, S/MIME signing and encryption, and server-level mail settings. |
install-bx-module bx-mail
# CommandBox
box install bx-mail
bx:mail
from="sender@example.com"
to="recipient@example.com"
subject="Hello from BoxLang!"
{
writeOutput( "This is the email body." )
}
bx:mail
from="noreply@myapp.com"
to="user@example.com"
subject="Your Order Confirmation"
server="smtp.myapp.com"
port=587
username="smtp-user"
password="smtp-secret"
useTLS=true
type="html"
{
writeOutput( "<h1>Thank you for your order!</h1><p>Order #12345 confirmed.</p>" )
}
bx:mailparam)// Template syntax
<bx:mail
from="reports@myapp.com"
to="manager@example.com"
subject="Monthly Report"
mimeAttach="/app/reports/march-2026.pdf"
>
Please find your monthly report attached.
</bx:mail>
// Script syntax — explicit attachment via bx:mailparam
bx:mail from="reports@myapp.com" to="manager@example.com" subject="Monthly Report" {
writeOutput( "Please find your monthly report attached." )
bx:mailparam
file="/app/reports/march-2026.pdf"
fileName="March-2026-Report.pdf"
type="application/pdf"
disposition="attachment"
}
<bx:mail from="app@example.com" to="user@example.com" subject="Welcome!">
<bx:mailpart type="text">
Welcome to MyApp! Visit https://myapp.com to get started.
</bx:mailpart>
<bx:mailpart type="html">
<h1>Welcome to MyApp!</h1>
<p>Click <a href="https://myapp.com">here</a> to get started.</p>
</bx:mailpart>
<bx:mailparam
file="/app/assets/welcome-guide.pdf"
fileName="Welcome-Guide.pdf"
type="application/x-pdf"
disposition="attachment"
/>
</bx:mail>
bx:mail from="app@example.com" to="user@example.com" subject="Reset Password" {
bx:mailparam name="X-Priority" value="1"
bx:mailparam name="X-Mailer" value="MyApp v2.0"
bx:mailparam name="List-Unsubscribe" value="<mailto:unsubscribe@myapp.com>"
writeOutput( "Click here to reset your password." )
}
{
"modules": {
"mail": {
"settings": {
"mailServers": [
{
"smtp": "smtp.sendgrid.net",
"port": 587,
"username": "apikey",
"password": "${SENDGRID_API_KEY}",
"tls": true,
"ssl": false
}
]
}
}
}
}
bx:mail
from="sender@example.com"
to="recipient@example.com"
subject="Signed Email"
sign=true
keystore="/app/certs/keystore.jks"
keystorePassword="keystorePass"
keyAlias="myKey"
keyPassword="keyPass"
{
writeOutput( "This email is digitally signed." )
}
boxlang.json over hardcoding server/port/credentials in each bx:mail calltype="html" for HTML emails, otherwise the body renders as plain textbx:mailpart — don't set type on the outer bx:mailmimeAttach only supports a single file — use bx:mailparam for multiple attachments