---
title: "Phalcon Logger"
version: "5.14"
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.phalcon.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Phalcon Logger
:::info[NOTE]
All classes are prefixed with `Phalcon`
:::
## Logger\AbstractLogger
Abstract
Source on GitHub
Abstract Logger Class
Abstract logger class, providing common functionality. A formatter interface
is available as well as an adapter one. Adapters can be created easily using
the built in AdapterFactory. A LoggerFactory is also available that allows
developers to create new instances of the Logger or load them from config
files (see Phalcon\Config\Config object).
@property AdapterInterface[] $adapters
@property array $excluded
@property int $logLevel
@property string $name
@property string $timezone
- **`Phalcon\Logger\AbstractLogger`**
- [`Phalcon\Logger\Logger`](#loggerlogger)
__Uses__ `DateTimeImmutable` · `DateTimeZone` · `Exception` · `Phalcon\Logger\Adapter\AdapterInterface` · `Phalcon\Logger\Exceptions\AdapterNotFound` · `Phalcon\Logger\Exceptions\NoAdaptersConfigured`
### Method Summary
### Constants
int
ALERT = 2
int
CRITICAL = 1
int
CUSTOM = 8
int
DEBUG = 7
int
EMERGENCY = 0
int
ERROR = 3
int
INFO = 6
int
NOTICE = 5
int
TRACE = 9
int
WARNING = 4
### Properties
protected
AdapterInterface[]
$adapters = []
The adapter stack
protected
array
$excluded = []
The excluded adapters for this log process
protected
int
$logLevel = 8
Minimum log level for the logger
protected
string
$name = ""
protected
DateTimeZone
$timezone
### Methods
Public · 10
__construct()
```php
public function __construct(
string $name,
array $adapters = [],
DateTimeZone $timezone = null
);
```
Constructor.
addAdapter()
```php
public function addAdapter(
string $name,
AdapterInterface $adapter
): static;
```
Add an adapter to the stack. For processing we use FIFO
excludeAdapters()
```php
public function excludeAdapters( array $adapters = [] ): static;
```
Exclude certain adapters.
getAdapter()
```php
public function getAdapter( string $name ): AdapterInterface;
```
Returns an adapter from the stack
getAdapters()
```php
public function getAdapters(): array;
```
Returns the adapter stack array
getLogLevel()
```php
public function getLogLevel(): int;
```
Returns the log level
getName()
```php
public function getName(): string;
```
Returns the name of the logger
removeAdapter()
```php
public function removeAdapter( string $name ): static;
```
Removes an adapter from the stack
setAdapters()
```php
public function setAdapters( array $adapters ): static;
```
Sets the adapters stack overriding what is already there
setLogLevel()
```php
public function setLogLevel( int $level ): static;
```
Sets the adapters stack overriding what is already there
Protected · 3
addMessage()
```php
protected function addMessage(
int $level,
string $message,
array $context = []
): bool;
```
Adds a message to each handler for processing
getLevelNumber()
```php
protected function getLevelNumber( mixed $level ): int;
```
Converts the level from string/word to an integer
getLevels()
```php
protected function getLevels(): array;
```
Returns an array of log levels with integer to string conversion
## Logger\AdapterFactory
Class
Source on GitHub
Factory used to create adapters used for Logging
- [`Phalcon\Factory\AbstractConfigFactory`](/5.14/api/phalcon_factory/#factoryabstractconfigfactory)
- [`Phalcon\Factory\AbstractFactory`](/5.14/api/phalcon_factory/#factoryabstractfactory)
- **`Phalcon\Logger\AdapterFactory`**
__Uses__ `Phalcon\Factory\AbstractFactory` · `Phalcon\Logger\Adapter\AdapterInterface` · `Phalcon\Logger\Exception`
### Method Summary
### Methods
Public · 2
__construct()
```php
public function __construct( array $services = [] );
```
AdapterFactory constructor.
newInstance()
```php
public function newInstance(
string $name,
string $fileName,
array $options = []
): AdapterInterface;
```
Create a new instance of the adapter
Protected · 2
getExceptionClass()
```php
protected function getExceptionClass(): string;
```
getServices()
```php
protected function getServices(): array;
```
Returns the available adapters
## Logger\Adapter\AbstractAdapter
Abstract
Source on GitHub
Class AbstractAdapter
@property string $defaultFormatter
@property FormatterInterface $formatter
@property bool $inTransaction
@property array $queue
- **`Phalcon\Logger\Adapter\AbstractAdapter`** — implements [`Phalcon\Logger\Adapter\AdapterInterface`](#loggeradapteradapterinterface)
- [`Phalcon\Logger\Adapter\Noop`](#loggeradapternoop)
- [`Phalcon\Logger\Adapter\Stream`](#loggeradapterstream)
- [`Phalcon\Logger\Adapter\Syslog`](#loggeradaptersyslog)
__Uses__ `Phalcon\Logger\Exceptions\DeserializationFailed` · `Phalcon\Logger\Exceptions\SerializationFailed` · `Phalcon\Logger\Exceptions\TransactionAlreadyActive` · `Phalcon\Logger\Exceptions\TransactionNotActive` · `Phalcon\Logger\Formatter\FormatterInterface` · `Phalcon\Logger\Formatter\Line` · `Phalcon\Logger\Item`
### Method Summary
### Properties
protected
string
$defaultFormatter = "Phalcon\\Logger\Formatter\\Line"
Name of the default formatter class
protected
FormatterInterface|null
$formatter = null
Formatter
protected
bool
$inTransaction = false
Tells if there is an active transaction or not
protected
array
$queue = []
Array with messages queued in the transaction
protected
int
$queueLimit = 0
Maximum number of items retained in the transaction queue. 0 (default) keeps the original unbounded behavior; a positive value drops the oldest queued item FIFO before a new one is appended in add().
### Methods
Public · 13
__destruct()
```php
public function __destruct();
```
Destructor cleanup
__serialize()
```php
public function __serialize(): array;
```
Prevent serialization
__unserialize()
```php
public function __unserialize( array $data ): void;
```
Prevent unserialization
add()
```php
public function add( Item $item ): AdapterInterface;
```
Adds a message to the queue
begin()
```php
public function begin(): AdapterInterface;
```
Starts a transaction
commit()
```php
public function commit(): AdapterInterface;
```
Commits the internal transaction
```php
public function getFormatter(): FormatterInterface;
```
getQueueLimit()
```php
public function getQueueLimit(): int;
```
Returns the configured transaction-queue cap (0 = unlimited)
inTransaction()
```php
public function inTransaction(): bool;
```
Returns the whether the logger is currently in an active transaction or
not
process()
```php
abstract public function process( Item $item ): void;
```
Processes the message in the adapter
rollback()
```php
public function rollback(): AdapterInterface;
```
Rollbacks the internal transaction
```php
public function setFormatter( FormatterInterface $formatter ): AdapterInterface;
```
Sets the message formatter
setQueueLimit()
```php
public function setQueueLimit( int $queueLimit ): AdapterInterface;
```
Sets the maximum number of items retained in the transaction
queue. 0 disables the cap (the default; preserves the original
unbounded behavior).
Protected · 1
```php
protected function getFormattedItem( Item $item ): string;
```
Returns the formatted item
## Logger\Adapter\AdapterInterface
Interface
Source on GitHub
Phalcon\Logger\AdapterInterface
Interface for Phalcon\Logger adapters
- **`Phalcon\Logger\Adapter\AdapterInterface`**
__Uses__ `Phalcon\Logger\Formatter\FormatterInterface` · `Phalcon\Logger\Item`
### Method Summary
### Methods
Public · 9
add()
```php
public function add( Item $item ): AdapterInterface;
```
Adds a message in the queue
begin()
```php
public function begin(): AdapterInterface;
```
Starts a transaction
close()
```php
public function close(): bool;
```
Closes the logger
commit()
```php
public function commit(): AdapterInterface;
```
Commits the internal transaction
```php
public function getFormatter(): FormatterInterface;
```
Returns the internal formatter
inTransaction()
```php
public function inTransaction(): bool;
```
Returns the whether the logger is currently in an active transaction or
not
process()
```php
public function process( Item $item ): void;
```
Processes the message in the adapter
rollback()
```php
public function rollback(): AdapterInterface;
```
Rollbacks the internal transaction
```php
public function setFormatter( FormatterInterface $formatter ): AdapterInterface;
```
Sets the message formatter
## Logger\Adapter\Exceptions\FileOpenFailed
Class
Source on GitHub
This file is part of the Phalcon Framework.
(c) Phalcon Team <team@phalcon.io>
For the full copyright and license information, please view the LICENSE.txt
file that was distributed with this source code.
- `\Exception`
- [`Phalcon\Logger\Exception`](#loggerexception)
- **`Phalcon\Logger\Adapter\Exceptions\FileOpenFailed`**
__Uses__ `Phalcon\Logger\Exception`
### Method Summary
### Methods
Public · 1
__construct()
```php
public function __construct(
string $name,
string $mode
);
```
## Logger\Adapter\Exceptions\InvalidStreamMode
Class
Source on GitHub
This file is part of the Phalcon Framework.
(c) Phalcon Team <team@phalcon.io>
For the full copyright and license information, please view the LICENSE.txt
file that was distributed with this source code.
- `\Exception`
- [`Phalcon\Logger\Exception`](#loggerexception)
- **`Phalcon\Logger\Adapter\Exceptions\InvalidStreamMode`**
__Uses__ `Phalcon\Logger\Exception`
### Method Summary
### Methods
Public · 1
__construct()
```php
public function __construct();
```
## Logger\Adapter\Exceptions\SyslogOpenFailed
Class
Source on GitHub
This file is part of the Phalcon Framework.
(c) Phalcon Team <team@phalcon.io>
For the full copyright and license information, please view the LICENSE.txt
file that was distributed with this source code.
- `\Exception`
- [`Phalcon\Logger\Exception`](#loggerexception)
- **`Phalcon\Logger\Adapter\Exceptions\SyslogOpenFailed`**
__Uses__ `Phalcon\Logger\Exception`
### Method Summary
### Methods
Public · 1
__construct()
```php
public function __construct(
string $name,
int $facility
);
```
## Logger\Adapter\Noop
Class
Source on GitHub
Class Noop
@package Phalcon\Logger\Adapter
- [`Phalcon\Logger\Adapter\AbstractAdapter`](#loggeradapterabstractadapter)
- **`Phalcon\Logger\Adapter\Noop`**
__Uses__ `Phalcon\Logger\Item`
### Method Summary
### Methods
Public · 2
close()
```php
public function close(): bool;
```
Closes the stream
process()
```php
public function process( Item $item ): void;
```
Processes the message i.e. writes it to the file
## Logger\Adapter\Stream
Class
Source on GitHub
Phalcon\Logger\Adapter\Stream
Adapter to store logs in plain text files
```php
$logger = new \Phalcon\Logger\Adapter\Stream('app/logs/test.log');
$logger->log('This is a message');
$logger->log(\Phalcon\Logger\Enum::ERROR, 'This is an error');
$logger->error('This is another error');
$logger->close();
```
@property resource|null $handler
@property string $mode
@property string $name
- [`Phalcon\Logger\Adapter\AbstractAdapter`](#loggeradapterabstractadapter)
- **`Phalcon\Logger\Adapter\Stream`**
__Uses__ `Phalcon\Logger\Adapter\Exceptions\FileOpenFailed` · `Phalcon\Logger\Adapter\Exceptions\InvalidStreamMode` · `Phalcon\Logger\Item`
### Method Summary
### Properties
protected
resource|null
$handler = null
Stream handler resource
protected
string
$mode = "ab"
The file open mode. Defaults to 'ab'
protected
string
$name
Stream name
### Methods
Public · 4
__construct()
```php
public function __construct(
string $name,
array $options = []
);
```
Stream constructor.
close()
```php
public function close(): bool;
```
Closes the stream
getName()
```php
public function getName(): string;
```
Stream name
process()
```php
public function process( Item $item ): void;
```
Processes the message i.e. writes it to the file
Protected · 3
phpFclose()
```php
protected function phpFclose( mixed $handle ): bool;
```
@todo to be removed when we get traits
phpFopen()
```php
protected function phpFopen(
string $filename,
string $mode
);
```
@todo to be removed when we get traits
phpFwrite()
```php
protected function phpFwrite(
mixed $handle,
string $message
);
```
@todo to be removed when we get traits
## Logger\Adapter\Syslog
Class
Source on GitHub
Class Syslog
@property string $defaultFormatter
@property int $facility
@property string $name
@property bool $opened
@property int $option
- [`Phalcon\Logger\Adapter\AbstractAdapter`](#loggeradapterabstractadapter)
- **`Phalcon\Logger\Adapter\Syslog`**
__Uses__ `Phalcon\Logger\Adapter\Exceptions\SyslogOpenFailed` · `Phalcon\Logger\Enum` · `Phalcon\Logger\Item`
### Method Summary
### Properties
protected
int
$facility = 0
protected
string
$name = ""
protected
bool
$opened = false
protected
int
$option = 0
### Methods
Public · 3
__construct()
```php
public function __construct(
string $name,
array $options = []
);
```
Syslog constructor.
close()
```php
public function close(): bool;
```
Closes the logger
process()
```php
public function process( Item $item ): void;
```
Processes the message i.e. writes it to the syslog
Protected · 1
openlog()
```php
protected function openlog(
string $ident,
int $option,
int $facility
): bool;
```
Open connection to system logger
@link https://php.net/manual/en/function.openlog.php
## Logger\Enum
Class
Source on GitHub
Log Level Enum constants
- **`Phalcon\Logger\Enum`**
### Constants
int
ALERT = 2
int
CRITICAL = 1
int
CUSTOM = 8
int
DEBUG = 7
int
EMERGENCY = 0
int
ERROR = 3
int
INFO = 6
int
NOTICE = 5
int
TRACE = 9
int
WARNING = 4
## Logger\Exception
Class
Source on GitHub
Phalcon\Logger\Exception
Exceptions thrown in Phalcon\Logger will use this class
- `\Exception`
- **`Phalcon\Logger\Exception`**
- [`Phalcon\Logger\Adapter\Exceptions\FileOpenFailed`](#loggeradapterexceptionsfileopenfailed)
- [`Phalcon\Logger\Adapter\Exceptions\InvalidStreamMode`](#loggeradapterexceptionsinvalidstreammode)
- [`Phalcon\Logger\Adapter\Exceptions\SyslogOpenFailed`](#loggeradapterexceptionssyslogopenfailed)
- [`Phalcon\Logger\Exceptions\AdapterNotFound`](#loggerexceptionsadapternotfound)
- [`Phalcon\Logger\Exceptions\DeserializationFailed`](#loggerexceptionsdeserializationfailed)
- [`Phalcon\Logger\Exceptions\NoAdaptersConfigured`](#loggerexceptionsnoadaptersconfigured)
- [`Phalcon\Logger\Exceptions\SerializationFailed`](#loggerexceptionsserializationfailed)
- [`Phalcon\Logger\Exceptions\TransactionAlreadyActive`](#loggerexceptionstransactionalreadyactive)
- [`Phalcon\Logger\Exceptions\TransactionNotActive`](#loggerexceptionstransactionnotactive)
## Logger\Exceptions\AdapterNotFound
Class
Source on GitHub
This file is part of the Phalcon Framework.
(c) Phalcon Team <team@phalcon.io>
For the full copyright and license information, please view the LICENSE.txt
file that was distributed with this source code.
- `\Exception`
- [`Phalcon\Logger\Exception`](#loggerexception)
- **`Phalcon\Logger\Exceptions\AdapterNotFound`**
__Uses__ `Phalcon\Logger\Exception`
### Method Summary
### Methods
Public · 1
__construct()
```php
public function __construct( string $name );
```
## Logger\Exceptions\DeserializationFailed
Class
Source on GitHub
This file is part of the Phalcon Framework.
(c) Phalcon Team <team@phalcon.io>
For the full copyright and license information, please view the LICENSE.txt
file that was distributed with this source code.
- `\Exception`
- [`Phalcon\Logger\Exception`](#loggerexception)
- **`Phalcon\Logger\Exceptions\DeserializationFailed`**
__Uses__ `Phalcon\Logger\Exception`
### Method Summary
### Methods
Public · 1
__construct()
```php
public function __construct();
```
## Logger\Exceptions\NoAdaptersConfigured
Class
Source on GitHub
This file is part of the Phalcon Framework.
(c) Phalcon Team <team@phalcon.io>
For the full copyright and license information, please view the LICENSE.txt
file that was distributed with this source code.
- `\Exception`
- [`Phalcon\Logger\Exception`](#loggerexception)
- **`Phalcon\Logger\Exceptions\NoAdaptersConfigured`**
__Uses__ `Phalcon\Logger\Exception`
### Method Summary
### Methods
Public · 1
```php
public function __construct();
```
## Logger\Exceptions\SerializationFailed
Class
Source on GitHub
This file is part of the Phalcon Framework.
(c) Phalcon Team <team@phalcon.io>
For the full copyright and license information, please view the LICENSE.txt
file that was distributed with this source code.
- `\Exception`
- [`Phalcon\Logger\Exception`](#loggerexception)
- **`Phalcon\Logger\Exceptions\SerializationFailed`**
__Uses__ `Phalcon\Logger\Exception`
### Method Summary
### Methods
Public · 1
__construct()
```php
public function __construct();
```
## Logger\Exceptions\TransactionAlreadyActive
Class
Source on GitHub
This file is part of the Phalcon Framework.
(c) Phalcon Team <team@phalcon.io>
For the full copyright and license information, please view the LICENSE.txt
file that was distributed with this source code.
- `\Exception`
- [`Phalcon\Logger\Exception`](#loggerexception)
- **`Phalcon\Logger\Exceptions\TransactionAlreadyActive`**
__Uses__ `Phalcon\Logger\Exception`
### Method Summary
### Methods
Public · 1
__construct()
```php
public function __construct();
```
## Logger\Exceptions\TransactionNotActive
Class
Source on GitHub
This file is part of the Phalcon Framework.
(c) Phalcon Team <team@phalcon.io>
For the full copyright and license information, please view the LICENSE.txt
file that was distributed with this source code.
- `\Exception`
- [`Phalcon\Logger\Exception`](#loggerexception)
- **`Phalcon\Logger\Exceptions\TransactionNotActive`**
__Uses__ `Phalcon\Logger\Exception`
### Method Summary
### Methods
Public · 1
__construct()
```php
public function __construct();
```
## Logger\Formatter\AbstractFormatter
Abstract
Source on GitHub
Class AbstractFormatter
- [`Phalcon\Support\Helper\Str\AbstractStr`](/5.14/api/phalcon_support/#supporthelperstrabstractstr)
- **`Phalcon\Logger\Formatter\AbstractFormatter`** — implements [`Phalcon\Logger\Formatter\FormatterInterface`](#loggerformatterformatterinterface)
- [`Phalcon\Logger\Formatter\Json`](#loggerformatterjson)
- [`Phalcon\Logger\Formatter\Line`](#loggerformatterline)
__Uses__ `DateTimeImmutable` · `Phalcon\Logger\Item` · `Phalcon\Support\Helper\Str\AbstractStr`
### Method Summary
### Properties
protected
string
$dateFormat = "c"
Default date format
protected
string
$interpolatorLeft = "%"
protected
string
$interpolatorRight = "%"
### Methods
Public · 2
```php
public function getDateFormat(): string;
```
```php
public function setDateFormat( string $format ): void;
```
Protected · 2
```php
protected function getFormattedDate( Item $item ): string;
```
Returns the date formatted for the logger.
```php
protected function getInterpolatedMessage(
Item $item,
string $message
): string;
```
## Logger\Formatter\FormatterInterface
Interface
Source on GitHub
Phalcon\Logger\FormatterInterface
This interface must be implemented by formatters in Phalcon\Logger
- **`Phalcon\Logger\Formatter\FormatterInterface`**
__Uses__ `Phalcon\Logger\Item`
### Method Summary
### Methods
Public · 1
```php
public function format( Item $item ): string;
```
Applies a format to an item
## Logger\Formatter\Json
Class
Source on GitHub
Formats messages using JSON encoding
- [`Phalcon\Support\Helper\Str\AbstractStr`](/5.14/api/phalcon_support/#supporthelperstrabstractstr)
- [`Phalcon\Logger\Formatter\AbstractFormatter`](#loggerformatterabstractformatter)
- **`Phalcon\Logger\Formatter\Json`**
__Uses__ `JsonException` · `Phalcon\Logger\Item`
### Method Summary
### Methods
Public · 2
```php
public function __construct(
string $dateFormat = "c",
string $interpolatorLeft = "%",
string $interpolatorRight = "%"
);
```
Json constructor.
```php
public function format( Item $item ): string;
```
Applies a format to a message before sent it to the internal log
## Logger\Formatter\Line
Class
Source on GitHub
Class Line
- [`Phalcon\Support\Helper\Str\AbstractStr`](/5.14/api/phalcon_support/#supporthelperstrabstractstr)
- [`Phalcon\Logger\Formatter\AbstractFormatter`](#loggerformatterabstractformatter)
- **`Phalcon\Logger\Formatter\Line`**
__Uses__ `Exception` · `Phalcon\Logger\Item`
### Method Summary
### Properties
protected
string
$format
Format applied to each message
### Methods
Public · 4
```php
public function __construct(
string $format = "[%date%][%level%] %message%",
string $dateFormat = "c",
string $interpolatorLeft = "%",
string $interpolatorRight = "%"
);
```
Line constructor.
```php
public function format( Item $item ): string;
```
Applies a format to a message before sent it to the internal log
```php
public function getFormat(): string;
```
Return the format applied to each message
```php
public function setFormat( string $format ): static;
```
Set the format applied to each message
## Logger\Item
Class
Source on GitHub
Phalcon\Logger\Item
Represents each item in a logging transaction
@property array $context
@property string $message
@property int $level
@property string $levelName
@property DateTimeImmutable $dateTime
- **`Phalcon\Logger\Item`**
__Uses__ `DateTimeImmutable`
### Method Summary
### Properties
protected
array
$context = []
protected
DateTimeImmutable
$dateTime
protected
int
$level
protected
string
$levelName
protected
string
$message
### Methods
Public · 6
__construct()
```php
public function __construct(
string $message,
string $levelName,
int $level,
DateTimeImmutable $dateTime,
array $context = []
);
```
Item constructor.
getContext()
```php
public function getContext(): array;
```
getDateTime()
```php
public function getDateTime(): DateTimeImmutable;
```
getLevel()
```php
public function getLevel(): int;
```
getLevelName()
```php
public function getLevelName(): string;
```
getMessage()
```php
public function getMessage(): string;
```
## Logger\Logger
Class
Source on GitHub
Phalcon Logger.
A logger, with various adapters and formatters. A formatter
interface is available as well as an adapter one. Adapters can be created
easily using the built-in AdapterFactory. A LoggerFactory is also available
that allows developers to create new instances of the Logger or load them
from config files (see Phalcon\Config\Config object).
- [`Phalcon\Logger\AbstractLogger`](#loggerabstractlogger)
- **`Phalcon\Logger\Logger`** — implements [`Phalcon\Logger\LoggerInterface`](#loggerloggerinterface)
__Uses__ `Exception` · `Phalcon\Logger\Exception`
### Method Summary
public
void
alert(string $message,array $context = [])
Action must be taken immediately.
public
void
critical(string $message,array $context = [])
Critical conditions.
public
void
debug(string $message,array $context = [])
Detailed debug information.
public
void
emergency(string $message,array $context = [])
System is unusable.
public
void
error(string $message,array $context = [])
Runtime errors that do not require immediate action but should typically
public
void
info(string $message,array $context = [])
Interesting events.
public
void
log(mixed $level,string $message,array $context = [])
Logs with an arbitrary level.
public
void
notice(string $message,array $context = [])
Normal but significant events.
public
void
trace(string $message,array $context = [])
Extra-verbose diagnostic output.
public
void
warning(string $message,array $context = [])
Exceptional occurrences that are not errors.
### Methods
Public · 10
alert()
```php
public function alert(
string $message,
array $context = []
): void;
```
Action must be taken immediately.
Example: Entire website down, database unavailable, etc. This should
trigger the SMS alerts and wake you up.
critical()
```php
public function critical(
string $message,
array $context = []
): void;
```
Critical conditions.
Example: Application component unavailable, unexpected exception.
debug()
```php
public function debug(
string $message,
array $context = []
): void;
```
Detailed debug information.
emergency()
```php
public function emergency(
string $message,
array $context = []
): void;
```
System is unusable.
error()
```php
public function error(
string $message,
array $context = []
): void;
```
Runtime errors that do not require immediate action but should typically
be logged and monitored.
info()
```php
public function info(
string $message,
array $context = []
): void;
```
Interesting events.
Example: User logs in, SQL logs.
log()
```php
public function log(
mixed $level,
string $message,
array $context = []
): void;
```
Logs with an arbitrary level.
notice()
```php
public function notice(
string $message,
array $context = []
): void;
```
Normal but significant events.
trace()
```php
public function trace(
string $message,
array $context = []
): void;
```
Extra-verbose diagnostic output.
Use for high-frequency, fine-grained events such as raw socket frames,
HTTP response bodies, or internal state transitions that are too noisy
for DEBUG.
warning()
```php
public function warning(
string $message,
array $context = []
): void;
```
Exceptional occurrences that are not errors.
Example: Use of deprecated APIs, poor use of an API, undesirable things
that are not necessarily wrong.
## Logger\LoggerFactory
Class
Source on GitHub
Factory creating logger objects
- [`Phalcon\Factory\AbstractConfigFactory`](/5.14/api/phalcon_factory/#factoryabstractconfigfactory)
- **`Phalcon\Logger\LoggerFactory`**
__Uses__ `DateTimeZone` · `Phalcon\Config\ConfigInterface` · `Phalcon\Factory\AbstractConfigFactory`
### Method Summary
### Methods
Public · 3
__construct()
```php
public function __construct( AdapterFactory $factory );
```
load()
```php
public function load( mixed $config ): Logger;
```
Factory to create an instance from a Config object
newInstance()
```php
public function newInstance(
string $name,
array $adapters = [],
DateTimeZone $timezone = null
): Logger;
```
Returns a Logger object
Protected · 2
getArrVal()
```php
protected function getArrVal(
array $collection,
mixed $index,
mixed $defaultValue = null
): mixed;
```
@todo Remove this when we get traits
getExceptionClass()
```php
protected function getExceptionClass(): string;
```
## Logger\LoggerInterface
Interface
Source on GitHub
Interface for Phalcon based logger objects.
- **`Phalcon\Logger\LoggerInterface`**
__Uses__ `Phalcon\Logger\Adapter\AdapterInterface`
### Method Summary
public
void
alert(string $message,array $context = [])
Action must be taken immediately.
public
void
critical(string $message,array $context = [])
Critical conditions.
public
void
debug(string $message,array $context = [])
Detailed debug information.
public
void
emergency(string $message,array $context = [])
System is unusable.
public
void
error(string $message,array $context = [])
Runtime errors that do not require immediate action but should typically
public
AdapterInterface
getAdapter( string $name )
Returns an adapter from the stack
public
array
getAdapters()
Returns the adapter stack array
public
int
getLogLevel()
Returns the log level
public
string
getName()
Returns the name of the logger
public
void
info(string $message,array $context = [])
Interesting events.
public
void
log(mixed $level,string $message,array $context = [])
Logs with an arbitrary level.
public
void
notice(string $message,array $context = [])
Normal but significant events.
public
void
trace(string $message,array $context = [])
Extra-verbose diagnostic output.
public
void
warning(string $message,array $context = [])
Exceptional occurrences that are not errors.
### Methods
Public · 14
alert()
```php
public function alert(
string $message,
array $context = []
): void;
```
Action must be taken immediately.
Example: Entire website down, database unavailable, etc. This should
trigger the SMS alerts and wake you up.
critical()
```php
public function critical(
string $message,
array $context = []
): void;
```
Critical conditions.
Example: Application component unavailable, unexpected exception.
debug()
```php
public function debug(
string $message,
array $context = []
): void;
```
Detailed debug information.
emergency()
```php
public function emergency(
string $message,
array $context = []
): void;
```
System is unusable.
error()
```php
public function error(
string $message,
array $context = []
): void;
```
Runtime errors that do not require immediate action but should typically
be logged and monitored.
getAdapter()
```php
public function getAdapter( string $name ): AdapterInterface;
```
Returns an adapter from the stack
getAdapters()
```php
public function getAdapters(): array;
```
Returns the adapter stack array
getLogLevel()
```php
public function getLogLevel(): int;
```
Returns the log level
getName()
```php
public function getName(): string;
```
Returns the name of the logger
info()
```php
public function info(
string $message,
array $context = []
): void;
```
Interesting events.
Example: User logs in, SQL logs.
log()
```php
public function log(
mixed $level,
string $message,
array $context = []
): void;
```
Logs with an arbitrary level.
notice()
```php
public function notice(
string $message,
array $context = []
): void;
```
Normal but significant events.
trace()
```php
public function trace(
string $message,
array $context = []
): void;
```
Extra-verbose diagnostic output.
warning()
```php
public function warning(
string $message,
array $context = []
): void;
```
Exceptional occurrences that are not errors.
Example: Use of deprecated APIs, poor use of an API, undesirable things
that are not necessarily wrong.
Source: https://docs.phalcon.io/5.14/api/phalcon_logger/index.mdx