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

Properties

$bubble  : bool
$contentType  : string|null
The Content-type for the message
$encoding  : string
The encoding for the message
$formatter  : FormatterInterface|null
$headers  : array<string|int, string>
Optional headers for the message
$level  : Level
$maxColumnWidth  : int
The wordwrap length for the message
$parameters  : array<string|int, string>
Optional parameters for the message
$processors  : array<string|int, callable>
$subject  : string
The subject of the email
$to  : array<string|int, string>
The email addresses to which the message will be sent

Methods

__construct()  : mixed
__destruct()  : mixed
__sleep()  : mixed
addHeader()  : $this
Add headers to the message
addParameter()  : $this
Add parameters to the message
close()  : void
Closes the handler.
getBubble()  : bool
Gets the bubbling behavior.
getContentType()  : string|null
getEncoding()  : string
getFormatter()  : FormatterInterface
getLevel()  : Level
Gets minimum logging level at which this handler will be triggered.
handle()  : bool
Handles a record.
handleBatch()  : void
Handles a set of records at once.
isHandling()  : bool
Checks whether the given record will be handled by this handler.
popProcessor()  : callable
pushProcessor()  : HandlerInterface
reset()  : void
setBubble()  : $this
Sets the bubbling behavior.
setContentType()  : $this
setEncoding()  : $this
setFormatter()  : HandlerInterface
setLevel()  : $this
Sets minimum logging level at which this handler will be triggered.
getDefaultFormatter()  : FormatterInterface
Gets the default formatter.
getHighestRecord()  : LogRecord
isHtmlBody()  : bool
processRecord()  : LogRecord
resetProcessors()  : void
send()  : void
Send a mail with the given content
write()  : void
Writes the (already formatted) record down to the log of the implementing handler

Properties

$contentType

The Content-type for the message

protected string|null $contentType = null

$headers

Optional headers for the message

protected array<string|int, string> $headers = []

$parameters

Optional parameters for the message

protected array<string|int, string> $parameters = []

$processors

protected array<string|int, callable> $processors = []
Tags
phpstan-var

array<(callable(LogRecord): LogRecord)|ProcessorInterface>

$to

The email addresses to which the message will be sent

protected array<string|int, string> $to

Methods

__construct()

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

The receiver of the mail

$subject : string

The subject of the mail

$from : string

The sender of the mail

$level : int|string|Level = Level::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

__destruct()

public __destruct() : mixed

addHeader()

Add headers to the message

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

Custom added headers

Return values
$this

addParameter()

Add parameters to the message

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

Custom added parameters

Return values
$this

close()

Closes the handler.

public close() : void
Tags
inheritDoc

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.

getLevel()

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

public getLevel() : Level
Return values
Level

handle()

Handles a record.

public handle(LogRecord $record) : bool
Parameters
$record : LogRecord

The record to handle

Tags
inheritDoc
Return values
bool

true means that this handler handled the record, and that bubbling is not permitted. false means the record was either not processed or that this handler allows bubbling.

handleBatch()

Handles a set of records at once.

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

The records to handle

Tags
inheritDoc

isHandling()

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

public isHandling(LogRecord $record) : bool
Parameters
$record : LogRecord

Partial log record having only a level initialized

Tags
inheritDoc
Return values
bool

setBubble()

Sets the bubbling behavior.

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

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

Return values
$this

setContentType()

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

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

Return values
$this

setEncoding()

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

setLevel()

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

public setLevel(Level|LogLevel::* $level) : $this
Parameters
$level : Level|LogLevel::*

Level or level name

Tags
phpstan-param

value-ofLevel::VALUES|value-ofLevel::NAMES|Level|LogLevel::* $level

Return values
$this

getHighestRecord()

protected getHighestRecord(array<string|int, mixed> $records) : LogRecord
Parameters
$records : array<string|int, mixed>
Tags
phpstan-param

non-empty-array<LogRecord> $records

Return values
LogRecord

isHtmlBody()

protected isHtmlBody(string $body) : bool
Parameters
$body : string
Return values
bool

send()

Send a mail with the given content

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

formatted email body to be sent

$records : array<string|int, mixed>

the array of log records that formed this content

Tags
inheritDoc

write()

Writes the (already formatted) record down to the log of the implementing handler

protected write(LogRecord $record) : void
Parameters
$record : LogRecord
Tags
inheritDoc

        
On this page

Search results