PHP download

Download the PHP package dschuppelius/php-error-toolkit without Composer

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

Table of contents
Download dschuppelius/php-error-toolkit
More information about dschuppelius/php-error-toolkit
Files in dschuppelius/php-error-toolkit

Vendor dschuppelius
Package php-error-toolkit
Short Description Logging and error handling foundation for the Schuppelius PHP toolkits (PSR-3 loggers, global error handler, LoggerRegistry, Laravel bridge)
License MIT

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?

Example code of dschuppelius/php-error-toolkit

Informations about the package php-error-toolkit

PHP Error Toolkit

A PSR-3 compliant logging library built for PHP 8.1+ with a focus on console and file logging. Designed as a lightweight, reusable component for modern PHP applications.

Features

🎯 PSR-3 Compliant - Full compatibility with PSR-3 logging standards
🖥️ Console Logging - Colored output with ANSI support and terminal detection
📄 File Logging - Automatic log rotation and fail-safe mechanisms
🏭 Factory Pattern - Clean instantiation with singleton behavior
🌐 Global Registry - Centralized logger management across your application
✨ Magic Methods - Convenient logDebug(), logInfo(), logErrorAndThrow() methods via trait
⏱️ Timer Logging - Measure execution time with logInfoWithTimer() and similar methods
🔄 Conditional Logging - logInfoIf(), logErrorUnless() for conditional log output
🔧 OS Helper - Cross-platform system detection and utilities
🎨 Cross-Platform - Windows, Linux and macOS terminal support
🧪 Fully Tested - Comprehensive test suite with PHPUnit

Installation

Install via Composer:

Requirements

PHP 8.1 to 8.4
PSR-3 Log Interface

Quick Start

Basic Usage with Console Logger

File Logging

Using the ErrorLog Trait

Add logging capabilities to any class:

Logger Types

Console Logger

Colored output with level-specific colors
Automatic terminal detection
Debug console support (VS Code, etc.)
Clean formatting with newline management

File Logger

Automatic log rotation when size limit exceeded
Fail-safe fallback to console/syslog
Customizable file size limits
Thread-safe file operations

Null Logger

Silent logger for testing/production environments
PSR-3 compliant no-op implementation

Global Logger Registry

Manage loggers globally across your application:

Log Levels

Supports all PSR-3 log levels with integer-based filtering:

EMERGENCY (0) - System is unusable
ALERT (1) - Action must be taken immediately
CRITICAL (2) - Critical conditions
ERROR (3) - Error conditions
WARNING (4) - Warning conditions
NOTICE (5) - Normal but significant condition
INFO (6) - Informational messages
DEBUG (7) - Debug-level messages

ErrorLog Trait Features

The ErrorLog trait provides comprehensive logging capabilities with multiple advanced features:

Magic Methods

All PSR-3 log levels are available as magic methods:

Hex Output for String Messages

For debugging encoding or binary transport issues, you can log a message with an additional hex representation:

Jedes Zeichen steht genau über seinem Hex-Code. Für Multibyte-Zeichen (z. B. ä → C3 A4) wird die Zeichenspalte entsprechend verbreitert:

You can also enable it on direct PSR-3 logger calls via context flag:

Conditional Logging

Log messages only when conditions are met:

Log with Timer

Measure execution time of operations:

Log and Return

Log a message and return a value in one call:

Log Exceptions

Log exceptions with full stack trace:

Log and Throw Exceptions

Combine logging and exception throwing in a single call with log{Level}AndThrow():

Available log-and-throw methods:

Method	Log Level
`logErrorAndThrow()`	ERROR
`logCriticalAndThrow()`	CRITICAL
`logAlertAndThrow()`	ALERT
`logEmergencyAndThrow()`	EMERGENCY

Method signature:

Logger Management

The trait provides flexible logger management:

Automatic Project Detection

The trait automatically detects project names from class namespaces:

Fallback Logging System

When no logger is available, the trait provides intelligent fallbacks:

Primary: Uses configured PSR-3 logger
Fallback 1: PHP error_log() if configured
Fallback 2: System syslog with project-specific facility
Fallback 3: File logging to system temp directory

Context Support

All logging methods support PSR-3 context arrays:

Configuration

Log Level Filtering

File Logger Options

Testing

Run the test suite:

Or run PHPUnit directly:

Cross-Platform Terminal Support

The toolkit automatically detects:

Windows VT100 support via sapi_windows_vt100_support()
Unix/Linux TTY via posix_isatty()
Debug consoles (VS Code, PHPStorm, etc.)
PHPUnit color configuration

Helper Classes

OsHelper

Cross-platform operating system detection and utilities:

TerminalHelper

Terminal detection and capabilities:

PhpUnitHelper

PHPUnit-specific utilities:

Architecture

Factory Pattern - All loggers created via factories with singleton behavior
Strategy Pattern - Different logging strategies (Console, File, Null)
Registry Pattern - Global logger management
Trait-based - Easy integration via ErrorLog trait
Helper Classes - Reusable utilities for OS detection, terminal handling, PHPUnit support
PSR-3 Compliant - Standard logging interface

License

MIT License. See LICENSE file for details.

Author

Daniel Jörg Schuppelius

Website: schuppelius.org
Email: [email protected]

Contributing

This is a personal toolkit for Daniel Schuppelius's projects. For bugs or feature requests, please open an issue.

All versions of php-error-toolkit with dependencies

PHP Build Version

Package Version

Version v2.7.3 Release 16. Sep 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of php-error-toolkit from vendor dschuppelius

Requires php Version >=8.1 <8.6
psr/log Version ^3.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 dschuppelius/php-error-toolkit contains the following files

Loading the files please wait ...