Mail_Mime::addAttachment()
Вернуться к: Mail_Mime
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-Description 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. |
Note
This function can not be called statically.
Вернуться к: Mail_Mime