Class to send emails (with attachments or not) Usage: $mailfile = new CMailFile($subject,$sendto,$replyto,$message,$filepath,$mimetype,$filename,$cc,$ccc,$deliveryreceipt,$msgishtml,$errors_to,$css,$trackid,$moreinheader,$sendcontext,$replyto); $mailfile->sendfile();. More...

Public Member Functions
	__construct ($subject, $to, $from, $msg, $filename_list=array(), $mimetype_list=array(), $mimefilename_list=array(), $addr_cc="", $addr_bcc="", $deliveryreceipt=0, $msgishtml=0, $errors_to='', $css='', $trackid='', $moreinheader='', $sendcontext='standard', $replyto='', $upload_dir_tmp='', $in_reply_to='', $references='')
	CMailFile.

	sendfile ()
	Send mail that was prepared by constructor.

	dump_mail ()
	Write content of a SMTP request into a dump file (mode = all) Used for debugging.

	save_dump_mail_in_err ($message='')
	Save content if mail is in error Used for debugging.

	checkIfHTML ($msg)
	Correct an incomplete html string.

	buildCSS ()
	Build a css style (mode = all) into this->styleCSS and this->bodyCSS.

	write_smtpheaders ()
	Create SMTP headers (mode = 'mail')

	write_mimeheaders ($filename_list, $mimefilename_list)
	Create header MIME (mode = 'mail')

	write_body ($msgtext)
	Return email content (mode = 'mail')

	write_images ($images_list)
	Attach an image to email (mode = 'mail')

	check_server_port ($host, $port)
	Try to create a socket connection.

	server_parse ($socket, $response)
	This function has been modified as provided by SirSir to allow multiline responses when using SMTP Extensions.

Static Public Member Functions
static	encodetorfc2822 ($stringtoencode)
	Encode subject according to RFC 2822 - http://en.wikipedia.org/wiki/MIME#Encoded-Word.

static	getValidAddress ($address, $format, $encode=0, $maxnumberofemail=0)
	Return a formatted address string for SMTP protocol.

static	getArrayAddress ($address)
	Return a formatted array of address string for SMTP protocol.

Private Member Functions
	_encode_file ($sourcefile)
	Read a file on disk and return encoded content for emails (mode = 'mail')

	write_files ($filename_list, $mimetype_list, $mimefilename_list, $cidlist)
	Attach file to email (mode = 'mail')

	findHtmlImages ($images_dir)
	Search images into html message and init array this->images_encoded if found.

	findHtmlImagesIsSrcData ($images_dir)
	Seearch images with data:image format into html message.

Detailed Description

Class to send emails (with attachments or not) Usage: $mailfile = new CMailFile($subject,$sendto,$replyto,$message,$filepath,$mimetype,$filename,$cc,$ccc,$deliveryreceipt,$msgishtml,$errors_to,$css,$trackid,$moreinheader,$sendcontext,$replyto); $mailfile->sendfile();.

Definition at line 42 of file CMailFile.class.php.

Constructor & Destructor Documentation

◆ __construct()

CMailFile::__construct	(	$subject,
		$to,
		$from,
		$msg,
		$filename_list = array(),
		$mimetype_list = array(),
		$mimefilename_list = array(),
		$addr_cc = "",
		$addr_bcc = "",
		$deliveryreceipt = 0,
		$msgishtml = 0,
		$errors_to = '',
		$css = '',
		$trackid = '',
		$moreinheader = '',
		$sendcontext = 'standard',
		$replyto = '',
		$upload_dir_tmp = '',
		$in_reply_to = '',
		$references = '' )

CMailFile.

Parameters

string	$subject	Topic/Subject of mail
string	$to	Recipients emails (RFC 2822: "Name firstname <email>[, ...]" or "email[, ...]" or "<email>[, ...]"). Note: the keyword 'SUPERVISOREMAIL' is not allowed here and must be replaced by caller.
string	$from	Sender email (RFC 2822: "Name firstname <email>[, ...]" or "email[, ...]" or "<email>[, ...]")
string	$msg	Message
?string[]	$filename_list	List of files to attach (full path of filename on file system)
?string[]	$mimetype_list	List of MIME type of attached files
?string[]	$mimefilename_list	List of attached file name in message
string	$addr_cc	Email cc (Example: 'abc@d.nosp@m.ef.c.nosp@m.om, ghk@l.nosp@m.mn.c.nosp@m.om')
string	$addr_bcc	Email bcc (Note: This is autocompleted with MAIN_MAIL_AUTOCOPY_TO if defined)
	int<0,1>	$deliveryreceipt Ask a delivery receipt
	int<-1,1>	$msgishtml 1=String IS already html, 0=String IS NOT html, -1=Unknown make autodetection (with fast mode, not reliable)
string	$errors_to	Email for errors-to
	string\|array<string,string>	$css Css option (should be array, legacy: empty string if none)
string	$trackid	Tracking string (contains type and id of related element)
string	$moreinheader	More in header. $moreinheader must contains the "\r\n" at end of each line
string	$sendcontext	'standard', 'emailing', 'ticket', 'password', ... (used to define which sending mode and parameters to use)
string	$replyto	Reply-to email (will be set to the same value than From by default if not provided)
string	$upload_dir_tmp	Temporary directory (used to convert images embedded as img src=data:image)
string	$in_reply_to	Message-ID of the message we reply to
string	$references	String with list of Message-ID of the thread ('<123> <456> ...')

Definition at line 228 of file CMailFile.class.php.

References ascii_check(), buildCSS(), checkIfHTML(), dol_nl2br(), dol_sanitizeEmail(), dol_string_unaccent(), dol_syslog(), dol_textishtml(), encodetorfc2822(), findHtmlImages(), findHtmlImagesIsSrcData(), getArrayAddress(), getDolGlobalString(), getValidAddress(), write_body(), write_files(), write_mimeheaders(), and write_smtpheaders().

Member Function Documentation

◆ _encode_file()

CMailFile::_encode_file ( $sourcefile )

private

Read a file on disk and return encoded content for emails (mode = 'mail')

Parameters

string $sourcefile Path to file to encode

Returns: int<-1,-1>|string Return integer <0 if KO, encoded string if OK

Definition at line 1453 of file CMailFile.class.php.

References dol_osencode(), and dol_syslog().

Referenced by write_files().

◆ buildCSS()

CMailFile::buildCSS ( )

Build a css style (mode = all) into this->styleCSS and this->bodyCSS.

Returns: void

Definition at line 1585 of file CMailFile.class.php.

Referenced by __construct().

◆ check_server_port()

CMailFile::check_server_port	(		$host,
			$port )

Try to create a socket connection.

Parameters

string	$host	Add ssl:// for SSL/TLS.
int	$port	Example: 25, 465

Returns: int Socket id if ok, 0 if KO

Definition at line 1898 of file CMailFile.class.php.

References dol_syslog(), getDolGlobalString(), server_parse(), and utf8_check().

◆ checkIfHTML()

CMailFile::checkIfHTML ( $msg )

Correct an incomplete html string.

Parameters

string $msg String

Returns: string Completed string

Definition at line 1559 of file CMailFile.class.php.

Referenced by __construct(), and write_body().

◆ dump_mail()

CMailFile::dump_mail ( )

Write content of a SMTP request into a dump file (mode = all) Used for debugging.

Note that to see full SMTP protocol, you can use tcpdump -w /tmp/smtp -s 2000 port 25"

Returns: void

Definition at line 1478 of file CMailFile.class.php.

References archiveOrBackupFile(), dolChmod(), and getDolGlobalInt().

Referenced by sendfile().

◆ encodetorfc2822()

static CMailFile::encodetorfc2822 ( $stringtoencode )

static

Encode subject according to RFC 2822 - http://en.wikipedia.org/wiki/MIME#Encoded-Word.

Parameters

string $stringtoencode String to encode

Returns: string string encoded

Definition at line 1440 of file CMailFile.class.php.

Referenced by __construct(), and sendfile().

◆ findHtmlImages()

CMailFile::findHtmlImages ( $images_dir )

private

Search images into html message and init array this->images_encoded if found.

Parameters

string $images_dir Path to store physical images files. For example $dolibarr_main_data_root.'/medias'

Returns: int >0 if OK, <0 if KO

Definition at line 2005 of file CMailFile.class.php.

References dol_hash().

Referenced by __construct().

◆ findHtmlImagesIsSrcData()

CMailFile::findHtmlImagesIsSrcData ( $images_dir )

private

Seearch images with data:image format into html message.

If we find some, we create it on disk.

Parameters

string $images_dir Location of where to store physically images files. For example $dolibarr_main_data_root.'/medias'

Returns: int >0 if OK, <0 if KO

Definition at line 2092 of file CMailFile.class.php.

References dol_is_dir(), dol_is_file(), dol_mkdir(), dol_syslog(), and dolChmod().

Referenced by __construct().

◆ getArrayAddress()

static CMailFile::getArrayAddress ( $address )

static

Return a formatted array of address string for SMTP protocol.

Parameters

string $address Example: 'John Doe john@.nosp@m.doe..nosp@m.com, Alan Smith alan@.nosp@m.smit.nosp@m.h.com' or 'john@.nosp@m.doe..nosp@m.com, alan@.nosp@m.smit.nosp@m.h.com'

Returns: array<string,?string> array(email => name)

See also: getValidAddress()

Definition at line 2261 of file CMailFile.class.php.

References getDolGlobalString().

Referenced by __construct().

◆ getValidAddress()

static CMailFile::getValidAddress	(	$address,
		$format,
		$encode = 0,
		$maxnumberofemail = 0 )

static

Return a formatted address string for SMTP protocol.

Parameters

string	$address	Example: 'John Doe john@.nosp@m.doe..nosp@m.com, Alan Smith alan@.nosp@m.smit.nosp@m.h.com' or 'john@.nosp@m.doe..nosp@m.com, alan@.nosp@m.smit.nosp@m.h.com'
int	$format	0=auto, 1=emails with <>, 2=emails without <>, 3=auto + label between ", 4 label or email, 5 mailto link @param int $encode 0=No encode name, 1=Encode name to RFC2822 @param int $maxnumberofemail 0=No limit. Otherwise, maximum number of emails returned ($address may contains several email separated with ','). Add '...' if there is more. @return string If format 0: '<john@doe.com>' or 'John Doe <john@doe.com>' or '=?UTF-8?B?Sm9obiBEb2U=?= <john@doe.com>' If format 1: '<john@doe.com>' If format 2: 'john@doe.com' If format 3: '<john@doe.com>' or '"John Doe" <john@doe.com>' or '"=?UTF-8?B?Sm9obiBEb2U=?=" <john@doe.com>' If format 4: 'John Doe' or 'john@doe.com' if no label exists If format 5: <a href="john@.nosp@m.doe..nosp@m.com">John Doe</a> or <a href="john@.nosp@m.doe..nosp@m.com">john@.nosp@m.doe..nosp@m.com if no label exists

See also: getArrayAddress()

Definition at line 2192 of file CMailFile.class.php.

References getDolGlobalString().

Referenced by __construct(), sendfile(), Adherent\sendReminderForExpiredSubscription(), and showDirectPublicLink().

◆ save_dump_mail_in_err()

CMailFile::save_dump_mail_in_err ( $message = '' )

Save content if mail is in error Used for debugging.

Parameters

string $message Add also a message

Returns: void

Definition at line 1517 of file CMailFile.class.php.

References dol_move(), dol_now(), dol_print_date(), dolChmod(), and getDolGlobalString().

Referenced by sendfile().

◆ sendfile()

CMailFile::sendfile ( )

Send mail that was prepared by constructor.

Returns: bool True if mail sent, false otherwise. Negative int if error in hook. String if incorrect send mode.

@phan-suppress PhanTypeMismatchReturnNullable False positif by phan for unclear reason.

Definition at line 828 of file CMailFile.class.php.

References ascii_check(), dol_syslog(), dump_mail(), encodetorfc2822(), getDolGlobalInt(), getDolGlobalString(), getSupportedOauth2Array(), getValidAddress(), and save_dump_mail_in_err().

◆ server_parse()

CMailFile::server_parse	(		$socket,
			$response )

This function has been modified as provided by SirSir to allow multiline responses when using SMTP Extensions.

Parameters

resource	$socket	Socket
string	$response	Response string

Returns: boolean true if success

Definition at line 1978 of file CMailFile.class.php.

Referenced by check_server_port().

◆ write_body()

CMailFile::write_body ( $msgtext )

Return email content (mode = 'mail')

Parameters

string $msgtext Message string

Returns: string String content

Definition at line 1722 of file CMailFile.class.php.

References checkIfHTML(), getDolGlobalString(), and write_images().

Referenced by __construct().

◆ write_files()

CMailFile::write_files	(	$filename_list,
		$mimetype_list,
		$mimefilename_list,
		$cidlist )

private

Attach file to email (mode = 'mail')

Parameters

string[]	$filename_list	Tableau
string[]	$mimetype_list	Tableau
string[]	$mimefilename_list	Tableau
?string[]	$cidlist	Array of CID if file must be completed with CID code

Returns: string|int<-1,-1> String with files encoded or -1 when error

Definition at line 1818 of file CMailFile.class.php.

References _encode_file(), and dol_syslog().

Referenced by __construct().

◆ write_images()

CMailFile::write_images ( $images_list )

Attach an image to email (mode = 'mail')

Parameters

array<array{name:string,fullpath:string,content_type:string,cid:string,image_encoded:string}> $images_list Array of array image

Returns: string Chaine images encodees

Definition at line 1866 of file CMailFile.class.php.

References dol_syslog().

Referenced by write_body().

◆ write_mimeheaders()

CMailFile::write_mimeheaders	(		$filename_list,
			$mimefilename_list )

Create header MIME (mode = 'mail')

Parameters

string[]	$filename_list	Array of filenames
string[]	$mimefilename_list	Array of mime types

Returns: string mime headers

Definition at line 1693 of file CMailFile.class.php.

References dol_syslog().

Referenced by __construct().

◆ write_smtpheaders()

CMailFile::write_smtpheaders ( )

Create SMTP headers (mode = 'mail')

Returns: string headers

Definition at line 1612 of file CMailFile.class.php.

References dol_syslog(), and getDolGlobalString().

Referenced by __construct().

The documentation for this class was generated from the following file:

dolibarr_dev/htdocs/core/class/CMailFile.class.php

Public Member Functions

Static Public Member Functions

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ _encode_file()

◆ buildCSS()

◆ check_server_port()

◆ checkIfHTML()

◆ dump_mail()

◆ encodetorfc2822()

◆ findHtmlImages()

◆ findHtmlImagesIsSrcData()

◆ getArrayAddress()

◆ getValidAddress()

◆ save_dump_mail_in_err()

◆ sendfile()

◆ server_parse()

◆ write_body()

◆ write_files()

◆ write_images()

◆ write_mimeheaders()

◆ write_smtpheaders()