Documentation

NativeMailerHandler extends MailHandler
in package

NativeMailerHandler uses the mail() function to send the emails

Tags
author

Christophe Coevoet stof@notk.org

author

Mark Garrett mark@moderndeveloperllc.com

Table of Contents

$bubble  : mixed
$contentType  : string
The Content-type for the message
$encoding  : string
The encoding for the message
$formatter  : FormatterInterface
$headers  : array<string|int, mixed>
Optional headers for the message
$level  : mixed
$maxColumnWidth  : int
The wordwrap length for the message
$parameters  : array<string|int, mixed>
Optional parameters for the message
$processors  : mixed
$subject  : string
The subject of the email
$to  : array<string|int, mixed>
The email addresses to which the message will be sent
__construct()  : mixed
__destruct()  : mixed
addHeader()  : self
Add headers to the message
addParameter()  : self
Add parameters to the message
close()  : mixed
Closes the handler.
getBubble()  : bool
Gets the bubbling behavior.
getContentType()  : string
getEncoding()  : string
getFormatter()  : FormatterInterface
Gets the formatter.
getLevel()  : int
Gets minimum logging level at which this handler will be triggered.
handle()  : mixed
{@inheritdoc}
handleBatch()  : mixed
Handles a set of records at once.
isHandling()  : bool
Checks whether the given record will be handled by this handler.
popProcessor()  : callable
Removes the processor on top of the stack and returns it.
pushProcessor()  : self
Adds a processor in the stack.
reset()  : mixed
setBubble()  : self
Sets the bubbling behavior.
setContentType()  : self
setEncoding()  : self
setFormatter()  : self
Sets the formatter.
setLevel()  : self
Sets minimum logging level at which this handler will be triggered.
getDefaultFormatter()  : FormatterInterface
Gets the default formatter.
getHighestRecord()  : mixed
processRecord()  : array<string|int, mixed>
Processes a record.
send()  : mixed
Send a mail with the given content
write()  : void
Writes the record down to the log of the implementing handler

Properties

$contentType

The Content-type for the message

protected string $contentType = 'text/plain'

$headers

Optional headers for the message

protected array<string|int, mixed> $headers = array()

$parameters

Optional parameters for the message

protected array<string|int, mixed> $parameters = array()

$to

The email addresses to which the message will be sent

protected array<string|int, mixed> $to

Methods

__construct()

public __construct(string|array<string|int, mixed> $to, string $subject, string $from[, int $level = Logger::ERROR ][, bool $bubble = true ][, int $maxColumnWidth = 70 ]) : mixed
Parameters
$to : string|array<string|int, mixed>

The receiver of the mail

$subject : string

The subject of the mail

$from : string

The sender of the mail

$level : int = Logger::ERROR

The minimum logging level at which this handler will be triggered

$bubble : bool = true

Whether the messages that are handled can bubble up the stack or not

$maxColumnWidth : int = 70

The maximum column width that the message lines will have

Return values
mixed

addHeader()

Add headers to the message

public addHeader(string|array<string|int, mixed> $headers) : self
Parameters
$headers : string|array<string|int, mixed>

Custom added headers

Return values
self

addParameter()

Add parameters to the message

public addParameter(string|array<string|int, mixed> $parameters) : self
Parameters
$parameters : string|array<string|int, mixed>

Custom added parameters

Return values
self

close()

Closes the handler.

public close() : mixed

This will be called automatically when the object is destroyed

Return values
mixed

getBubble()

Gets the bubbling behavior.

public getBubble() : bool
Return values
bool

true means that this handler allows bubbling. false means that bubbling is not permitted.

getContentType()

public getContentType() : string
Return values
string

$contentType

getLevel()

Gets minimum logging level at which this handler will be triggered.

public getLevel() : int
Return values
int

handle()

{@inheritdoc}

public handle(array<string|int, mixed> $record) : mixed
Parameters
$record : array<string|int, mixed>
Return values
mixed

handleBatch()

Handles a set of records at once.

public handleBatch(array<string|int, mixed> $records) : mixed
Parameters
$records : array<string|int, mixed>

The records to handle (an array of record arrays)

Return values
mixed

isHandling()

Checks whether the given record will be handled by this handler.

public isHandling(array<string|int, mixed> $record) : bool
Parameters
$record : array<string|int, mixed>

Partial log record containing only a level key

Return values
bool

popProcessor()

Removes the processor on top of the stack and returns it.

public popProcessor() : callable
Return values
callable

pushProcessor()

Adds a processor in the stack.

public pushProcessor(mixed $callback) : self
Parameters
$callback : mixed
Return values
self

setBubble()

Sets the bubbling behavior.

public setBubble(bool $bubble) : self
Parameters
$bubble : bool

true means that this handler allows bubbling. false means that bubbling is not permitted.

Return values
self

setContentType()

public setContentType(string $contentType) : self
Parameters
$contentType : string

The content type of the email - Defaults to text/plain. Use text/html for HTML messages.

Return values
self

setEncoding()

public setEncoding(string $encoding) : self
Parameters
$encoding : string
Return values
self

setLevel()

Sets minimum logging level at which this handler will be triggered.

public setLevel(int|string $level) : self
Parameters
$level : int|string

Level or level name

Return values
self

getHighestRecord()

protected getHighestRecord(array<string|int, mixed> $records) : mixed
Parameters
$records : array<string|int, mixed>
Return values
mixed

processRecord()

Processes a record.

protected processRecord(array<string|int, mixed> $record) : array<string|int, mixed>
Parameters
$record : array<string|int, mixed>
Return values
array<string|int, mixed>

send()

Send a mail with the given content

protected send(mixed $content, array<string|int, mixed> $records) : mixed
Parameters
$content : mixed

formatted email body to be sent

$records : array<string|int, mixed>

the array of log records that formed this content

Return values
mixed

write()

Writes the record down to the log of the implementing handler

protected abstract write(array<string|int, mixed> $record) : void
Parameters
$record : array<string|int, mixed>
Return values
void

Search results