PHP download

Download the PHP package jdz/process without Composer

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

Table of contents
Download jdz/process
More information about jdz/process
Files in jdz/process

Vendor jdz
Package process
Short Description Utility to debug processes calculating execution time
License MIT
Homepage https://jdz.joffreydemetz.com/process

Keywords debug process utilities core JDZ

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 jdz/process

Informations about the package process

Process

A PHP package for tracking the execution time of processes, sections, and subsections. This package allows you to track and format the time taken for each part of your process, providing a detailed hierarchical view of the execution time.

Features

Track execution time of processes, sections, and subsections
Hierarchical structure for sections and subsections
Formatted time output
Easy to use API

Upgrading from 1.x: the 1.0.0 entry point was Process::singleton(). Since 2.0.0 it is Process::create(); singleton() is deprecated but still there (it delegates to create()).

Requirements

PHP 8.2 or higher

Installation

Install via Composer:

Quick Start

Basic Example

Here is a basic example of how to use the Process class to track the execution time of a process, including sections and subsections. You can find the complete example in the file examples/example.php.

Example Output

When calling toArray(), it will return an array of lines representing the process, sections, and subsections (one entry per line, timings vary):

Methods Overview

Process::create(): Get the shared Process instance (created on first call). Process::singleton() is a deprecated alias.
startSection(string $name): Start a new section with the given name.
startSubsection(string $name, bool $endPrevious = true): Start a new subsection within the current section.
endSection(): End the current section and close all its subsections.
endSubsection(): End the current subsection and return to the parent section.
close(): End the process and calculate the total execution time.
getTime(): Get the formatted time for the entire process.
toArray(): Export the sections and their execution times as an array of formatted strings.

Time Format

The time is formatted as follows:

Minutes: Only shown if greater than 0.
Seconds: Only shown if greater than 0 or if minutes are shown.
Milliseconds: Always shown if non-zero, or if minutes or seconds are shown.

Examples of formatted time:

3 min 3 s 234 ms
2 s 150 ms
0ms (zero duration)

Testing

Run the test suite:

ProcessItemTest covers the ProcessItem class, including:
- Construction and initialization
- Parent-child relationships
- Time tracking and closure
- Hierarchical export functionality
- Time formatting
ProcessTest covers the Process class, including:
- Shared instance (create() / deprecated singleton())
- Section and subsection management
- Time tracking and formatting
- Complex nested workflows
- Idempotent operations

License

This library is licensed under the MIT License. See the LICENSE file for details.

Changelog

Version 2.0.2

Times are rounded to the millisecond before being split: 0.9996 s reads 1 s 0 ms, not 1000 ms
An item that is not closed yet formats as 0ms without a PHP deprecation
ProcessItem::formatSeconds(): the one formatter, shared by Process and ProcessItem

Version 2.0.1

Requires PHP >= 8.2
PHPUnit 11

Version 2.0.0

Added create(); singleton() is deprecated in its favor (still available, delegates to create()).
Added Unit tests
Improved time formatting to handle zero durations correctly.

Version 1.0

Initial release with core functionality for tracking process execution time, sections, and subsections.

All versions of process with dependencies

PHP Build Version

Package Version

Version 2.0.2 Release 10. Oct 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of process from vendor jdz

Requires php Version >=8.2

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 jdz/process contains the following files

Loading the files please wait ...