Download the PHP package macino/cli-dumper without Composer
On this page you can find all versions of the php package macino/cli-dumper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download macino/cli-dumper
More information about macino/cli-dumper
Files in macino/cli-dumper
Package cli-dumper
Short Description Alternative for dumping vars in terminal env. Neat and compact with possible highlights.
License MIT
FAQ
Example:
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 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.
Informations about the package cli-dumper
CliDumper Documentation
Overview
CliDumper is a compact and flexible PHP library designed for efficiently dumping PHP data structures such as arrays, objects, and scalars into a readable and customizable format. It enhances log readability, especially in scenarios involving large and complex data, by eliminating excessive verbosity and emphasizing minimalism, color, and structure.
With features like customizable output and syntax highlighting for scalar types, CliDumper stands out as a developer-friendly tool for debugging, logging, and real-time output processing in CLI environments.
Why CliDumper?
Dealing with complex data logs can often lead to cluttered log files filled with var_dump, var_export, or print_r outputs. While these methods are useful, they can become cumbersome, especially when searching for specific values in lengthy or nested outputs.
CliDumper solves this by:
- Reducing verbosity: It formats output compactly and only highlights what's necessary.
- Improving readability: It uses color highlights to distinguish between data types (e.g., numbers, strings, nulls, etc.).
- Customization options: Developers can define their own formatting rules for scalar values.
- Structured visualization: It efficiently handles arrays, objects, and nested structures.
Key Features
- Compact Output: Generates concise dumps for even the most complex data structures.
- Customizable Formatter: Modify scalar type representations (e.g., color-coded outputs).
- Visual Highlights:
- Color differentiation for types (e.g., null, string, numeric, boolean).
- Options to organize nested elements for clarity.
- Efficient Debugging: Output can be directly printed to CLI or returned as a string for further processing.
- Truncation: Set limits for string length to keep outputs within manageable size.
- Optional Separators: Add separators in output for better log organization.
Installation
Using Composer
Install the library via Composer:
Usage
Here are the basic usage examples for the CliDumper class:
Initialization
Dump Debugging Data
The dump method outputs a message and variable data to the CLI. Customize the output with optional flags.
Parameters
$msg: (string) A message or title displayed before the dump.$data: (mixed) The data to be dumped.$separateLeafs: (bool) Breaks scalar members onto new lines and organizes them by key.$separate: (bool) Adds a separator line (e.g.,------) before the output.
Alias for Dump
The d method is an alias for the dump method.
Custom Formatting
You can define your own formatter callback to modify scalar type representations. Use the $formatter property to define a custom formatting function.
Example:
Inline Dump
Use inlineDump to output or retrieve a serialized version of a variable without the heading message.
Parameters:
$var: (mixed) The variable to be dumped.$separateLeafs: (bool) Breaks scalar members onto new lines and organizes them by key.$return: (bool) Iftrue, the method returns the dump as a string instead of printing it.
Configuration Options
Public Properties
-
$enabled:- Type:
bool - Default:
true - Enables or disables dumping.
Example:
- Type:
-
$truncate:- Type:
int - Default:
80 - Limits the length of strings in the dump. Set
0for no limit.
Example:
- Type:
-
$maxDepth:- Type:
int - Default:
-1(no limit) - Specifies the maximum depth for nested data structures. If set, the dumper will truncate any nesting deeper than the specified level.
Example:
- Type:
-
$formatter:- Type:
callable - Default: A simple formatter that outputs unaltered scalars.
- Provides custom display formatting for different scalar types.
Example:
- Type:
Methods
dump
Outputs formatted data to the CLI with an optional message.
d
Alias for dump.
inlineDump
Returns a formatted string of the provided data or prints it directly.
Use Cases
- Debugging:
- Quickly visualize complex data structures in developer-friendly formats.
- Highlight and differentiate key elements in the output using colors.
- Logging:
- Write cleaner, compact logs for later analysis.
- Real-time Data Processing:
- Print readable information from live CLI applications.
Limitations
- Primarily suited for CLI-based debugging and logs; not meant to replace JSON, XML, or other structured formats for storage.
Conclusion
CliDumper is a lightweight solution for PHP developers looking to improve debugging experiences, enhance log readability, and cleanly process real-time data in CLI environments. With its color coding, formatting flexibility, and compact outputs, CliDumper simplifies viewing intricate data structures without sacrificing detail.
