Mail_Mime::addAttachment()
Synopsis
boolean addAttachment (
string
$file
, string
$c_type = 'application/octet-stream'
, string
$name = ''
, boolean
$isfile = true
, string
$encoding = 'base64'
, string
$disposition = 'attachment'
, string
$charset = ''
, string
$language = ''
, string
$location = ''
, string
$n_encoding = null
, string
$f_encoding = null
, string
$description = ''
, string
$h_charset = null
)
Описание
Adds an attachment to a message.
Parameter
-
string $file
- The file name or the data itself -
string $c_type
- The content type of the image or file. -
string $name
- The suggested file name for the data. Only used, if$file
contains data. -
boolean $isfile
- Whether$file
is a file name or not. -
string $encoding
- Type of transfer encoding to use for the file data. Defaults is "base64". For text based files (eg. scripts/html etc.) this could be given as "quoted-printable". -
string $disposition
- The content-disposition of this file Defaults to attachment. Possible values: attachment, inline. -
string $charset
- The character set of attachment's content. -
string $language
- The language of the attachment -
string $location
- The RFC 2557.4 location of the attachment -
string $n_encoding
- Encoding of the attachment's name in Content-Type By default filenames are encoded using RFC2231 method Here you can set RFC2047 encoding (quoted-printable or base64) instead. -
string $f_encoding
- Encoding of the attachment's filename in Content-Disposition header. -
string $description
- Content-Описание header. -
string $h_charset
- The character set of the headers e.g. filename If not specified, $charset will be used
Return value
boolean
- Returns TRUE on success,
PEAR_Error on failure.
Throws
Error code | Error message | Reason | Solution |
---|---|---|---|
NULL |
"File is not readable file_name "
|
The file was not found or the script has not enough rights to access the file. | Check the file name and path. Check user and file permissions. |
NULL |
"Could not open file_name "
|
The file is already opened and exclusivly locked by another application. | In the most cases a program opens the file for writing. addAttachment() does no file locking, so this problem is not caused by competitive callings of this function. |
Замечание
This function can not be called statically.