普贤教程 › 包参考

mimebuilder 包

MIME 邮件构造

项	值
包名	`mimebuilder`
版本	`0.1.0`
入口	`mimebuilder.px`
分类	`数据格式与编解码`
文件数 / 行数	`1 / 332`

安装与引入

bash

pxpkg init          # 首次
pxpkg add mimebuilder@0.1.0
pxpkg install

import mimebuilder

所属分类教程：数据格式与编解码

公开接口

函数	参数
`mb_new`
`mb_set_from`	`msg, addr, name = ""`
`mb_set_to`	`msg, addr, name = ""`
`mb_set_cc`	`msg, addr, name = ""`
`mb_set_subject`	`msg, subject`
`mb_set_body`	`msg, text, html = ""`
`mb_add_attachment`	`msg, filename, content, mime_type = "application/octet-stream"`
`mb_format_addr`	`addr, name`
`mb_gen_boundary`
`mb_encode_qp`	`text`
`mb_decode_qp`	`text`
`mb_encode_b64`	`text`
`mb_decode_b64`	`text`
`mb_build`	`msg`
`mb_parse`	`text`

其余 4 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`mb_hex_upper`	`n`
`mb_hex_to_int`	`c`
`mb_b64_char_val`	`c`
`mb_join`	`arr, sep`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/mimebuilder — MIME 邮件构造
------------------------------------------------------------
纯函数库，双模式一致。
对齐 PHP mail() / PHPMailer / Python email.mime：
mb_new()                       → 创建空邮件
mb_set_from(msg, addr, name)   → 设置发件人
mb_set_to(msg, addr, name)     → 添加收件人
mb_set_cc(msg, addr, name)     → 添加抄送
mb_set_subject(msg, subject)   → 设置主题
mb_set_body(msg, text, html)   → 设置正文
mb_add_attachment(msg, filename, content, mime_type) → 添加附件
mb_build(msg)                  → 生成 MIME 文本
mb_parse(text)                 → 解析 MIME 文本
mb_encode_qp(text)             → Quoted-Printable 编码
mb_decode_qp(text)             → Quoted-Printable 解码
mb_encode_b64(text)            → Base64 编码
mb_decode_b64(text)            → Base64 解码
mb_gen_boundary()              → 生成边界分隔符
mb_format_addr(addr, name)     → 格式化邮件地址
============================================================