1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/email.R
\name{send_mail}
\alias{send_mail}
\title{Send email}
\usage{
send_mail(
mail_from,
mail_rcpt,
message,
smtp_server = "smtp://localhost",
use_ssl = c("try", "no", "force"),
verbose = TRUE,
...
)
}
\arguments{
\item{mail_from}{email address of the sender.}
\item{mail_rcpt}{one or more recipient email addresses. Do not include names,
these go into the \code{message} headers.}
\item{message}{either a string or connection with (properly formatted) email
message, including sender/recipient/subject headers. See example.}
\item{smtp_server}{hostname or address of the SMTP server, or, an
\verb{smtp://} or \verb{smtps://} URL. See "Specifying the server, port,
and protocol" below.}
\item{use_ssl}{Request to upgrade the connection to SSL using the STARTTLS command,
see \href{https://curl.se/libcurl/c/CURLOPT_USE_SSL.html}{CURLOPT_USE_SSL}
for details. Default will try to SSL, proceed as normal otherwise.}
\item{verbose}{print output}
\item{...}{other options passed to \code{\link[=handle_setopt]{handle_setopt()}}. In most cases
you will need to set a \code{username} and \code{password} or \code{login_options}
to authenticate with the SMTP server, see details.}
}
\description{
Use the curl SMTP client to send an email. The \code{message} argument must be
properly formatted \href{https://www.rfc-editor.org/rfc/rfc2822}{RFC2822} email message with From/To/Subject headers and CRLF
line breaks.
}
\section{Specifying the server, port, and protocol}{
The \code{smtp_server} argument takes a hostname, or an SMTP URL:
\itemize{
\item \code{mail.example.com} - hostname only
\item \code{mail.example.com:587} - hostname and port
\item \verb{smtp://mail.example.com} - protocol and hostname
\item \verb{smtp://mail.example.com:587} - full SMTP URL
\item \verb{smtps://mail.example.com:465} - full SMTPS URL
}
By default, the port will be 25, unless \verb{smtps://} is specified--then
the default will be 465 instead.
For internet SMTP servers you probably need to pass a
\href{https://curl.se/libcurl/c/CURLOPT_USERNAME.html}{username} and
\href{https://curl.se/libcurl/c/CURLOPT_PASSWORD.html}{passwords} option.
For some servers you also need to pass a string with
\href{https://curl.se/libcurl/c/CURLOPT_LOGIN_OPTIONS.html}{login_options}
for example \code{login_options="AUTH=NTLM"}.
}
\section{Encrypting connections via SMTPS or STARTTLS}{
There are two different ways in which SMTP can be encrypted: SMTPS servers
run on a port which only accepts encrypted connections, similar to HTTPS.
Alternatively, a regular insecure smtp connection can be "upgraded" to a
secure TLS connection using the STARTTLS command. It is important to know
which method your server expects.
If your smtp server listens on port 465, then use a \verb{smtps://hostname:465}
URL. The SMTPS protocol \emph{guarantees} that TLS will be used to protect
all communications from the start.
If your email server listens on port 25 or 587, use an \verb{smtp://} URL in
combination with the \code{use_ssl} parameter to control if the connection
should be upgraded with STARTTLS. The default value \code{"try"} will
\emph{opportunistically} try to upgrade to a secure connection if the server
supports it, and proceed as normal otherwise.
}
\examples{
\dontrun{# Set sender and recipients (email addresses only)
recipients <- readline("Enter your email address to receive test: ")
sender <- 'test@noreply.com'
# Full email message in RFC2822 format
message <- 'From: "R (curl package)" <test@noreply.com>
To: "Roger Recipient" <roger@noreply.com>
Subject: Hello R user!
Dear R user,
I am sending this email using curl.'
# Send the email
send_mail(sender, recipients, message, smtp_server = 'smtps://smtp.gmail.com',
username = 'curlpackage', password = 'qyyjddvphjsrbnlm')}
}
|
