Download the PHP package khalyomede/syslog without Composer

Syslog

Log into your Syslog destination.

Summary

• Prerequistes
• Installation
• Examples of uses
• Methods definitions
• Prototype ready

Prerequistes

• PHP version >= 7.0.0
• Socket extension enabled (php_sockets.dll on windows or php_sockets.so on Linux distributions)
• A log server that accepts UDP packet messages (as this library send the log through UDP)

Installation

In your project folder:

Examples of uses

All the examples can be found in the /example folder.

• Example 1: logging into your log destination
• Example 2: templatize your message for logging
• Example 3: use a generic method for logging
• Example 4: templatize when using the generic logging
• Example 5: force the date before logging
• Example 6: specify an indentifier for your next logs

Example 1: logging into your log destination

Example 2: templatize your message for logging

Example 3: use a generic method for logging

If you do not want to pass through the class constants of LogLevel, you can provide a string instead:

Beware that the informational severity string equivalent is info.

Example 4: templatize when using the generic logging

Example 5: force the date before logging

Example 6: specify an indentifier for your next logs

The identifier will stick to your next logs. If you would like to clear it at a point, you can use:

It returns an instance of Khalyomede\Syslog so you can chain it with any other method.

Methods definitions

• alert
• critical
• date
• debug
• deleteIdentifier
• device
• emergency
• error
• facility
• host
• identifier
• info
• log
• notice
• port
• processus
• source
• warning

alert

Sends a message to the log destination with an alert severity.

Note

The keys of the context should respect the following format: lower case, numbers, with underscores and periods only.

Exception

InvalidArgumentException:

• If the message is empty
• If the context does not contains an array of key-pairs values
• If one of the context keys is not properly formated

LogicException:

• If one of the following properties are not filled: host, post, source, device, processus

RuntimeException:

• If the socket creation failed
• If the message could not be sent through the socket connection

critical

Sends a message to the log destination with a critical severity.

Note

The keys of the context should respect the following format: lower case, numbers, with underscores and periods only.

Exception

InvalidArgumentException:

• If the message is empty
• If the context does not contains an array of key-pairs values
• If one of the context keys is not properly formated

LogicException:

• If one of the following properties are not filled: host, post, source, device, processus

RuntimeException:

• If the socket creation failed
• If the message could not be sent through the socket connection

date

Force the log to be timestamped to a specific date.

Note

If you do not call this method at each log call, the date will be set to the time at which you call the sysloger.

debug

Sends a message to the log destination with a debug severity.

Note

The keys of the context should respect the following format: lower case, numbers, with underscores and periods only.

Exception

InvalidArgumentException:

• If the message is empty
• If the context does not contains an array of key-pairs values
• If one of the context keys is not properly formated

LogicException:

• If one of the following properties are not filled: host, post, source, device, processus

RuntimeException:

• If the socket creation failed
• If the message could not be sent through the socket connection

deleteIdentifier

Reset the identifier to its empty value.

device

Set the name of the device that is sending the log. For more information, see the definition of this attribute on the Syslog RFC5424 documentation.

emergency

Sends a message to the log destination with an emergency severity.

Note

The keys of the context should respect the following format: lower case, numbers, with underscores and periods only.

Exception

InvalidArgumentException:

• If the message is empty
• If the context does not contains an array of key-pairs values
• If one of the context keys is not properly formated

LogicException:

• If one of the following properties are not filled: host, post, source, device, processus

RuntimeException:

• If the socket creation failed
• If the message could not be sent through the socket connection

error

Sends a message to the log destination with an error severity.

Note

The keys of the context should respect the following format: lower case, numbers, with underscores and periods only.

Exception

InvalidArgumentException:

• If the message is empty
• If the context does not contains an array of key-pairs values
• If one of the context keys is not properly formated

LogicException:

• If one of the following properties are not filled: host, post, source, device, processus

RuntimeException:

• If the socket creation failed
• If the message could not be sent through the socket connection

facility

Set the target plateform. For more information, see the definition of this attribute on the Syslog RFC5424 documentation.

host

Set the target log destination host.

Note

The value should be an IP or a valid domain.

identifier

Set an optional identifier to group your logs.

info

Sends a message to the log destination with an info severity.

Note

The keys of the context should respect the following format: lower case, numbers, with underscores and periods only.

Exception

InvalidArgumentException:

• If the message is empty
• If the context does not contains an array of key-pairs values
• If one of the context keys is not properly formated

LogicException:

• If one of the following properties are not filled: host, post, source, device, processus

RuntimeException:

• If the socket creation failed
• If the message could not be sent through the socket connection

log

Log using an opt-in severity parameter. This has the same effect than any other others severity logging methods.

Note

The keys of the context should respect the following format: lower case, numbers, with underscores and periods only.

Exception

InvalidArgumentException:

• If the severity is empty
• If the severity is not one of the following: emergency, alert, critical, error, warning, notice, info, debug
• If the message is empty
• If the context does not contains an array of key-pairs values
• If one of the context keys is not properly formated

LogicException:

• If one of the following properties are not filled: host, post, source, device, processus

RuntimeException:

• If the socket creation failed
• If the message could not be sent through the socket connection

notice

Sends a message to the log destination with a notice severity.

Note

The keys of the context should respect the following format: lower case, numbers, with underscores and periods only.

Exception

InvalidArgumentException:

• If the message is empty
• If the context does not contains an array of key-pairs values
• If one of the context keys is not properly formated

LogicException:

• If one of the following properties are not filled: host, post, source, device, processus

RuntimeException:

• If the socket creation failed
• If the message could not be sent through the socket connection

port

Set the port of the log destination server address.

processus

Set the original processus that is responsible for this log. For more information, see the definition of this attribute on the Syslog RFC5424 documentation.

source

Set the original server that generated this log. For more information, see the definition of this attribute on the Syslog RFC5424 documentation.

warning

Sends a message to the log destination with a warning severity.

Note

The keys of the context should respect the following format: lower case, numbers, with underscores and periods only.

Exception

InvalidArgumentException:

• If the message is empty
• If the context does not contains an array of key-pairs values
• If one of the context keys is not properly formated

LogicException:

• If one of the following properties are not filled: host, post, source, device, processus

RuntimeException:

• If the socket creation failed
• If the message could not be sent through the socket connection

Prototype ready

This class lets you extend its functionality to your needs without having to dive into the source code. For example:

For more information, check khalyomede/prototype documentation.