diversen/php-cli-spinners

Show a cli spinner while executing a callback

Maintainers

Details

github.com/diversen/php-cli-spinners

Homepage

Source

Issues

Installs: 1 496

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 2

Forks: 1

Open Issues: 0

v1.1.0 2024-03-09 16:11 UTC

Requires (Dev)

MIT 7f1dff53202090c865023adc419c6e2c73a9f5d6

clicallbackspinner

This package is auto-updated.

Last update: 2024-11-09 19:52:54 UTC

README

Simple PHP library for displaying spinners in the terminal while running a callback function.

You will need to have the pcntl extension installed.

The library uses this collection of spinners:

The spinners can be seen in action here

If you don't have the pcntl extension installed, you can still use the library, but you will not see the spinner.

On windows use WSL. There may be some trouble using UTF-8 characters in the terminal on WSL.

In this case you can use the simpleDots or simpleDotsScrolling spinner.

How it works

The library will run a callback function in a separate process which displays the spinner. The main process will run the callback function and return the result.

Installation

composer require diversen/php-cli-spinners

Usage

<?php

require_once "vendor/autoload.php";

use Diversen\Spinner;

$spinner = new Spinner(spinner: 'simpleDots', message: "Loading");
$res = $spinner->callback(function () {
    sleep(2);
    return 42;
});

echo "$res\n"; // 42

Examples

Clone:

git clone https://github.com/diversen/php-cli-spinners.git

See examples folder. E.g. run php examples/simple.php

License

MIT © Dennis Iversen