Download the PHP package carloswph/phell without Composer
On this page you can find all versions of the php package carloswph/phell. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download carloswph/phell
More information about carloswph/phell
Files in carloswph/phell
Package phell
Short Description A wrapper for obtaining information and deal with common tasks on Linux servers in data formats.
License MIT
Informations about the package phell
Phell
Linux system monitor utilities offer a comprehensive way of checking and monitoring any server. However, not everyone wants or is able to be checking the command line all times. Also, as those commands use to return unformatted strings, it becomes challenging to process or store such data in a more friendly way.
This wrapper offers classes to execute and retrieve common shell system commands and return data in a PHP-friendly way. Available classes/commands:
- df
- man
- free
- lscpu
- lsmem
- vmstat (no arguments)
Installing
This package can be installed using Composer composer require carloswph/phell
Usage
Using Composer, you need to use the classes correspondent to the shell commands you want data to be gotten and parsed. Additionally, you may want to use the enum class Params(), which provides constants to modify and apply parameters to the shell commands you are working with.
Using 'man' command
Using the command 'man' is somewhat different than using all the others. As per getting a response, one must provide the bash command for which the manual is required. So, while instantiating the class, you must pass the bash command as parameter.
Adding a new command
Of course you can use the main abstract class to manage any other shell command and add new classes. For such, the only mandatory method will be process(), using the protected visibility, and the sole necessary property being $command, in which you will declare your new shell command, like this:
Additionally, even though you can always find another way of processing additional parameters in your new command, we encourage you to use the enum class Params to do that - as some of the necessary parameters could be possibly around there yet.
Commands available
This package in a work in progress, so new commands will be added eventually. Keep checking the README file and updating the package to get access to all of them.
Available commands: df, free, lscpu, lsmem, vmstat
Underway: iostat, uptime, groups