Skip to content

A simple and basic PHP Logger writing logs based on an abbreviation of the PSR-3 standard.

License

Notifications You must be signed in to change notification settings

advename/Simple-PHP-Logger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 

Repository files navigation

💾 Simple PHP Logger 💾

License MIT

Simple php logger is a single file PHP log writer which writes logs into a .txt file using one line of code, e.g.

Logger::info("I'm an info message");

outputs inside a log-28-nov-2019.txt:

[22:50:35 28-Nov-2019] [localhost/test.php] [1] : [INFO] - I'm an info message

Features

  • single file
  • singleton pattern
  • six log levels (info, notice, debug, warning, error, fatal)
  • logs the line where the Logger method is executed (good for troubleshooting)
  • logs the relative filepath of the source file, not the required one (good for troubleshooting)

🔧 Motivation

There are many PHP Logger's out there, but most of them are either very heavy or too basic. Sometimes, you simply want something in the middle, suitable for every situation and project size. Therefore, I've decided to create a simple PHP Logger, inspired by several other logging libraries.

✅ Installation

Simply download the Logger.php file and require it wherever you need it. You can also insert it into a Log directory and add a namespace to it, for those who want to use it within an OOP project Make sure that the logs/ directory exists and is writable, else the logger throws an error that it cant read/write/create the log files.

🔎 Log levels

The simple php logger uses six log levels:

Level Description Example
INFO Used for general informations "The server has been running X hours"
NOTICE Used for interesting events "The user $userName has logged in."
DEBUG Used for debugging Could be used instead of echo'ing values
WARNING Used for anything that might/ might not be a problem. "The image XX is 30MB big. This can cause slow web performance"
ERROR Any error which is fatal to the operation, but not shutting down the application Can't open a required file, missing data, etc.
FATAL Any error which is shutting down the application Database unavailable

📚 How to use

Basic example

Here's a basic example how you could use simple php logger

<?php
include_once 'Logger.php';

function connectToDatabase()
{
    $dbhost = 'localhost';
    $dbname =  'post_website';
    $dbuser = 'root';
    $dbport = '3306';
    $dbpass = '';
    try {
        $pdo = new PDO("mysql:host=$dbhost;port=$dbport;dbname=$dbname", $dbuser, $dbpass);
    } catch (PDOException $e) {
        
        Logger::fatal("Database connection failed", [$e->getMessage()]); // <- Log a fatal error with details
        
        die("Oh snap, looks like something didn't work. Please retry again later"); // <- UX friendly die() message
    }
}

Logging methods

<?php
// Info log
Logger::info("The article XX has YY comments");

// Notice log
Logger::notice("The user XX has created the YY article");

// Debug log
Logger::debug("This is where the code breaks");

// Warning log
// $file would be a e.g. data about an image received from a POST request
Logger::debug("The file XX is 100GB big", $file);

// Error log
Logger::error("The file XX is missing");

// Fatal log
$information = ["Very bad database", "I didnt feed him"];
Logger::error("Database connection failed", $information);

📖 Log output

The simple php logger outputs the logs in the following blueprint:

[Hour:Minutes:Seconds Date-Month-Yearh] [file-path] [line-of-execution] : [Log level] Descriptive message (optional = The array/object of additional information)

You can change the default time output using the setOptions() method.

Logger::setOptions([
    'logFormat' => 'Y-M-d H:i:s'
]);

Logger outputs

[15:45:33 27-Nov-2019] [localhost/test.php] [4] : [INFO]- The article XX has YY comments 
[15:45:33 27-Nov-2019] [localhost/test.php] [8] : [NOTICE]- The user XX has created the YY article 
[15:45:33 27-Nov-2019] [localhost/test.php] [12] : [DEBUG]- This is where the code breaks 
[15:45:33 27-Nov-2019] [localhost/test.php] [16] : [WARNING]- The file XX is 100GB big 
[15:45:33 27-Nov-2019] [localhost/test.php] [19] : [ERROR]- The file XX is missing 
[15:45:33 27-Nov-2019] [localhost/test.php] [23] : [FATAL]- Database connection failed ["Very bad database","I didnt feed him"]
Note

Big thanks to reddit user u/mferly for his support and guidance!

This logger is not a replacement for a PSR-3 compliant logger library such as Monolog, KLogger or Analog. This Logger should simply be used to quickly implement a simple logger with several methods.

Inspired by

About

A simple and basic PHP Logger writing logs based on an abbreviation of the PSR-3 standard.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages