Documentation

SendGridHandler extends MailHandler
in package

SendGridrHandler uses the SendGrid API v2 function to send Log emails, more information in https://sendgrid.com/docs/API_Reference/Web_API/mail.html

Tags
author

Ricardo Fontanelli ricardo.fontanelli@hotmail.com

Table of Contents

Properties

$apiKey  : string
The SendGrid API Key
$apiUser  : string
The SendGrid API User
$bubble  : bool
$formatter  : FormatterInterface|null
$from  : string
The email addresses to which the message will be sent
$level  : Level
$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
close()  : void
Closes the handler.
getBubble()  : bool
Gets the bubbling behavior.
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.
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

$from

The email addresses to which the message will be sent

protected string $from

$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 $apiUser, string $apiKey, string $from, string|array<string|int, string> $to, string $subject[, int|string|Level $level = Level::Error ][, bool $bubble = true ]) : mixed
Parameters
$apiUser : string

The SendGrid API User

$apiKey : string

The SendGrid API Key

$from : string

The sender of the email

$to : string|array<string|int, string>

The recipients of the email

$subject : string

The subject 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

Tags
throws
MissingExtensionException

If the curl extension is missing

__destruct()

public __destruct() : mixed

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

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