cgiemail - 云端在线

程序：

您的姓名

cgiemail、cgiecho、cgifile - CGI 表单到邮件的转换工具

这款 邮箱 用户 指南

本指南将帮助您编写向您发送电子邮件的 WWW 表单。 这
需要以下步骤：

· 创建电子邮件模板。

· 在您的页面上放置一个指向模板的链接。

· 决定是否使用mailto: 链接。

· 创建 HTML 表单。

· 创建更高级的 HTML 表单。

· 确保 ACTION 是正确的。

· 用cgiecho 试试你的表格。

· 使用 cgiemail 上线。

· 收不到邮件调试

以下步骤是可选的。

· 向成功页面添加文本。

· 使用备用成功页面。

· 进行一些必要的输入。

· 为某些输入指定格式。

· 使用CGI 环境变量。

创建 an e-mail 模板。
在您开始通过 Web 接收电子邮件之前，您应该决定这些
消息应该看起来像。 创建一个 ASCII 文件，称为电子邮件模板，看起来像
这样的事情：

转到： [电子邮件保护] 标题行
题目：问题三
空行
你叫什么名字？ [你的名字]
你的追求是什么？ [任务] 身体
你最喜欢的颜色是什么？ [颜色]

从某种意义上说，这个模板是自由形式的。 想给你发邮件的人可以下载
这个模板，填好后邮寄给你。 但是，模板也将被使用
通过 cgiemail 程序，因此在将文件上传到 WWW 服务器之前，请注意
请遵循以下准则：

· 无论您希望表单用户在何处提供信息，请使用一个词
在没有空格的方括号内，例如您的姓名：[您的姓名]。 不是[把你的名字
这里]。

· 确保收件人：字段中的地址正确。

· 如果标题行之间有空行，请将其删除。

· 如果标题行之前有空行，请将其删除。

· 确保所有标题行都有效。 该行的第一个字符必须是
信。 大多数信息应该放在消息正文中； 不要自己编造
标头。

· 确保标题行和正文之间有一个空行。

· 确保将其保存为 ASCII 文本。 例如，如果您使用的是 Microsoft Word，请使用
“另存为”并选择“仅带换行符的文本”。

· 如果您在 Mac 上创建文件，请确保将其作为文本上传，即 CR 的翻译。
（Unix 计算机表示行尾的代码与 Mac 不同，因此您的
文件可能看起来像 Unix 计算机的长行。）

在这些指导方针中有很大的灵活性。 您可以输入 Bcc:、X-Face: 或任何
标题中的其他标题。 您可以将 Cc: [yourname] 之类的内容放在标题中。 是
有创造力的。 只是不要在那里放任何你不想让你的网站管理员看到的东西，
因为那是退回邮件的去处。

现在继续将您的电子邮件模板上传到 WWW 服务器并使用您的
万维网浏览器。

Put a 链接 至 此 模板 on 您的 页面。
下面是一个例子：

你想过桥吗？ 下载我的“问题三”表格并将其发送至
<[电子邮件保护]>.

即使在创建 WWW 表单后，您仍希望保留此链接以增加
残障用户的可访问性。

决定 if a 站长： 链接 将 的事。
已经，无需任何复杂的 HTML，您就有办法让 WWW 上的人向您发送
你想要的信息。 在开始制作 HTML 表单之前，请确定是否
这真的很值得。 WWW 上的表格有两个特别的缺点：

· 你会从那些只是“上网冲浪”的人那里收到很多无聊的电子邮件。

· 用户的邮箱地址是人工输入的，经常被打错，让你有
没办法回复。 这对 mailto: 链接来说不是问题。

创建 此 HTML 形式。
如果你决定创建一个 HTML 表单，你需要给人们一种方法来提供一个
电子邮件地址。 使用 mailto: 链接，他们的邮寄者将提供 From: 地址
他们。 但是现在您需要在电子邮件模板的顶部添加一行，如下所示：

来自：[电子邮件]

这是一个示例 HTML 表单。

您的电子邮件地址： ____________________

你的名字： ____________________

你的追求： ____________________

您最喜欢的颜色：____________________

发送电子邮件（此示例实际上并未发送电子邮件。）

这是 HTML 源代码：

<表单方法=“发布”
行动="http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt">

您的电子邮件地址：
你的名字：
你的追求：
你最喜欢的颜色：



这是一个非常简单的例子。 请注意，每个输入的 NAME 对应于您
之前放在电子邮件模板中。 在此示例中，它们是电子邮件、您的姓名、任务、
和颜色。 这是使用 cgiemail 的关键概念。 小心使它们完全正确
相同的; 如果您在 HTML 表单中输入 NAME="colour" 和 [color]（注意拼写
差异）在您的电子邮件模板中，输入将不会显示在电子邮件中。

创建 更多 高级 HTML 形式。
要学习创建更复杂的表单，请阅读 NCSA 指南。 他们所有的示例表格
只需更改 ACTION 即可转换为 cgiemail 形式。 不同于其他形式的
电子邮件程序，您不需要使用具有特殊名称的隐藏输入。

所有类型的输入（单选按钮等）的工作方式都相同。 每个输入都需要一个 NAME，并且
该名称必须出现在您的电子邮件模板中的方括号内。 就这么简单。 到
获得更多想法，请参阅 cgiemail 示例页面。

根据 肯定 此 活动正式启动 is 纠正。
HTML 表单最棘手的部分是正确设置 ACTION。 从
您的电子邮件模板的 URL，然后将其拆分为两部分，例如

http://web.mit.edu/wwwdev/cgiemail/questions3.txt
\ / \ /
`--- 第 1 部分 ---' ` -------- 第 2 部分 ----------'

然后将脚本名称放在中间。 通常这是“/cgi-bin/cgiecho”，但它
取决于您的服务器的配置方式。 在 web.mit.edu 上它恰好是
``/bin/cgiecho''，因此我的 ACTION 如下所示：

http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt
\ /\ /\ /
`--- 第 1 部分 ---' 脚本名称 ` -------- 第 2 部分 ----------'

为简单起见，您可以省略第 1 部分，但如果您想测试您的
表单作为本地文件。 如果您不知道这意味着什么，请随意省略第 1 部分。

尝试 输出 您的 申请 - 切乔。
将您的表单弹出到您最喜欢的 WWW 浏览器中，填写输入内容并提交。 你
应该会看到处理后的表单是什么样的。 相反，如果您看到一个带有数字的错误
接近 500，您的 ACTION 可能设置错误。 返回上一步。

如果您的某些输入似乎没有显示在已处理的表单中，请确保
HTML 表单中的输入名称与 ASCII 模板中的名称完全相同。 例如
HTML 表单中的 NAME="yourname" 和电子邮件模板中的 [yourname]。

Go 生活 - 电子邮件。
现在在 HTML 表单的 ACTION 中将 cgiecho 更改为 cgiemail。 试试看。 你应该
接收带有处理过的表单的电子邮件。 如果您获得成功页面但没有
收到邮件，您的模板文件有问题。 回去确保你
正确遵循步骤 1 中的准则。

如果有效，恭喜！

9、收不到邮件调试

通常，邮件是异步发送的，这意味着它会进入队列以在某个时间发送
合适的时间。 异步邮件发送更高效、更可靠，但具有
缺点是问题只能通过将错误消息邮寄回
发件人。 对于邮件系统，邮件的发件人似乎是网络服务器，所以
错误消息不会给你。

如果收不到邮件，可以通过创建临时使用同步邮件传递
一个名为 cgiemail-mailopt 的隐藏输入并为其赋予一个包含“同步”的值，例如



注意：对于 1.1 版，这将不起作用。 请您的网站管理员安装更新的版本。
一些邮件程序有一个非标准的扩展名，可以将退回邮件发送到错误中的地址-
To: 除 web 服务器外的标题。 但是，一些错误使此标题行
不可读，所以没有办法绝对确保反弹会给你。

可选的： 添加 文本 至 此 成功 页面。
发送邮件时，会出现一个标题为“成功”的页面，其中包含电子邮件消息的文本。
你可以使用一个叫做“addendum”的隐藏变量来添加你自己的文本。 这是一个简单的
例：



如果您愿意假设表单的读者正在使用最新的浏览器软件
像 Lynx 2.6 或 Netscape 3.0，那么您可以使用
适当的字符实体。 例如，如果您想添加

谢谢！

那么 HTML 标记将是

谢谢！

这意味着您需要在表单中包含以下内容：

<输入类型=“隐藏”名称=“附录”
VALUE="<em>谢谢！</em>">

请注意，除了难以编写之外，此功能对使用较旧的人不起作用
浏览器软件。

可选的： 使用 an 备用 成功 页面。
如果您不喜欢成功发送电子邮件时出现的默认页面，您可以
在 HTML 表单中使用名为“成功”的隐藏变量指定备用 URL，
例如

<INPUT TYPE="隐藏" NAME="成功" VALUE="http://web.mit.edu/">

注意：您的 URL 以 / 或 http:// 开头/. 否则 cgiemail 将引导您的浏览器
到第二次调用 cgiemail，导致错误没有变量替换。

从 1.3 版开始，无法使此备用成功页面包含信息
用户在表单中提交。 此功能可能会在未来版本中添加。

可选的： 根据 一些 输入 必需的。
如果您想自动拒绝某些输入为空的表单，请添加
HTML 表单和电子邮件中输入名称的前缀“required-”
模板。 下面是一个例子：

在 HTML 表单中：

你的名字：

在电子邮件模板中

您的姓名：[必填-您的姓名]

可选的： 指定 格式 一些 投入。
如果在您的电子邮件模板中，方括号内的文本以 % 开头，cgiemail 将
使用 打印输出（） 函数在 C 中逗号后的字段名称。 如果你不熟悉
有这个函数，看看C的书。如果你熟悉它，请注意这些
两个区别：

· 格式字符串中的第一个字符必须是 %。

· 像\n 和\t 这样的字符必须是文字。 如果你想要一个换行符，你必须放一个
逗号前的换行符，尽管这看起来很奇怪。 例如，如果
Godzilla's Pizza 希望每行列出一个浇头，他们会将以下内容放入
他们的电子邮件模板：

[%s
，配料]

可选的： 使用 CGI 环境 变量。
此功能可能有效，也可能无效，具体取决于您的网站管理员是否启用了它
配置 cgiemail 时。

除了表单输入之外，您的电子邮件模板还可以包含 CGI 环境变量
只需在变量名称前加上美元符号即可。 例如，

[$HTTP_USER_AGENT]

会将用户的浏览器和/或网关的名称放入您的电子邮件消息中。 为了
尊重隐私，您的 HTML 表单应警告用户有关
它们将包含在电子邮件中，例如 HTTP_USER_AGENT、REMOTE_ADDR。

行政
上游联系方式：cgiemail[电子邮件保护]>

Debian 维护者：Anibal Monsalve Salazar[电子邮件保护]>

WWW 上提供了有关构建、安装和使用 cgiemail 的完整信息：

http://web.mit.edu/wwwdev/cgiemail/

使用 onworks.net 服务在线使用 cgiemail