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