Download the PHP package easycorp/easy-log-handler without Composer

On this page you can find all versions of the php package easycorp/easy-log-handler. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package easy-log-handler

EasyLogHandler (human-friendly log files)

Symfony log files are formatted in the same way for all environments. This means that dev.log is optimized for machines instead of humans. The result is a log file bloated with useless information that makes you less productive.

EasyLogHandler is a new Monolog handler that creates human-friendly log files. It's optimized to display the log information in a clear and concise way. Use it in the development environment to become a much more productive developer.

  1. Features
  2. Installation
  3. Configuration and Usage

Features

These are some of the best features of EasyLogHandler and how it compares itself with the default Symfony logs.

Better Log Structure

Symfony log files are a huge stream of text. When you open them, you can't easily tell when a request started or finished and which log messages belong together:

Symfony EasyLogHandler
structure-overview-symfony-mini structure-overview-easylog-mini

EasyLogHandler structures the log files in a different way:

structure-easylog

Less Verbose Logs

First of all, EasyLogHandler doesn't display the timestamp in every log message. In the dev environment you shouldn't care about that, so the timestamp is only displayed once for each group of log messages.

Symfony EasyLogHandler
timestamps-symfony timestamps-easylog

The extra information, which some log messages include to add more details about the log, is displayed only when it's different from the previous log. In contrast, Symfony always displays the extra for all logs, generating a lot of duplicated information:

Symfony
extra-symfony
EasyLogHandler
extra-easylog

It's becoming increasingly popular to use placeholders in log messages instead of the actual values (e.g. Matched route "{route}". instead of Matched route "home".) This is great for machines, because they can group similar messages that only vary in the placeholder values.

However, for humans this "feature" is disturbing. That's why EasyLogHandler automatically replaces any placeholder included in the log message:

Symfony
placeholders-symfony
EasyLogHandler
placeholder-easylog

Better Visual Hierarchy

Important elements, such as deprecations and security-related messages, must stand out in log files to help you spot them instantly. However, in Symfony all logs look exactly the same. How can you know which are the important ones?

Symfony
visual-hierarchy-symfony
(all messages look exactly the same)
EasyLogHandler
visual-hierarchy-easylog
(deprecations, warnings, errors and security messages stand out)

Dynamic Variable Inlining

Log messages usually contain related variables in their context and extra properties. Displaying the content of these variables in the log files is always a tough balance between readability and conciseness.

EasyLogHandler decides how to inline these variables dynamically depending on each log message. For example, Doctrine query parameters are always inlined but request parameters are inlined for unimportant requests and nested for important requests:

dynamic-inline-easylog

Stack Traces

When log messages include error stack traces, you definitely want to take a look at them. However, Symfony displays stack traces inlined, making them impossible to inspect. EasyLogHandler displays them as proper stack traces:

Symfony
stack-trace-symfony
EasyLogHandler
stack-trace-easylog

Log Message Grouping

One of the most frustrating experiences when inspecting log files is having lots of repeated or similar consecutive messages. They provide little information and they just distract you. EasyLogHandler process all log messages at once instead of one by one, so it's aware when there are similar consecutive logs.

For example, this is a Symfony log file displaying three consecutive missing translation messages:

translation-group-symfony

And this is how the same messages are displayed by EasyLogHandler:

translation-group-easylog

The difference is even more evident for "event notified" messages, which usually generate tens of consecutive messages:

Symfony
event-group-symfony
EasyLogHandler
event-group-easylog

Installation

This project is distributed as a PHP package instead of a Symfony bundle, so you just need to require the project with Composer:

Configuration and Usage

Step 1

Define a new service in your application for this log handler:

Newer Symfony version:

Older Symfony version:

Step 2

Update your Monolog configuration in the dev environment to define a buffered handler that wraps this new handler service (keep reading to understand why). You can safely copy+paste this configuration:

Newer Symfony version:

Older Symfony version:

Most log handlers treat each log message separately. In contrast, EasyLogHandler advanced log processing requires each log message to be aware of the other logs (for example to merge similar consecutive messages). This means that all the logs associated with the request must be captured and processed in batch.

In the above configuration, the buffered handler saves all log messages and then passes them to the EasyLog handler, which processes all messages at once and writes the result in the log file.

Use the buffered handler to configure the channels logged/excluded and the level of the messages being logged.


All versions of easy-log-handler with dependencies

PHP Build Version
Package Version
Requires php Version >=7.1
monolog/monolog Version ~1.6|~2.0
symfony/yaml Version ^3.4|^4.0|^5.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package easycorp/easy-log-handler contains the following files

Loading the files please wait ....