Download the PHP package ahaaje/linux-system-information without Composer
On this page you can find all versions of the php package ahaaje/linux-system-information. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ahaaje/linux-system-information
More information about ahaaje/linux-system-information
Files in ahaaje/linux-system-information
Package linux-system-information
Short Description Light-weight library to help gather information on a running Linux system
License MIT
Informations about the package linux-system-information
Linux System Information
This is a light-weight library to gather information (stats) about the Linux system it is running on.
The information is read from the files in /proc/ and /etc/. These are usually world readable, but your system may vary. There is no dependency on system
or exec
calls to binaries installed on your system.
Features
- PSR-4 auto loading compliant structure
- Example file
- Normalize stats to "human readable" form
- Extendability
Stats that can be fetched
- hostname
- load average for 1, 5 or 15 minutes
- memory as total, available and used
- file system size and usage
Requirements
- Linux
- PHP 5.5
Installation
With composer simply do composer require ahaaje/linux-system-information
inside your project directory.
Usage
This is from the example file. You should not need to require the auto loader if already using composer to manage your project requirements
Stat numbers for disk space and memory are returned as kilo bytes, but you can add true
as a second parameter to
the get*Category() functions to have them normalized into MB, GB or TB - like this
Exceptions
Exceptions are thrown as siblings of RuntimeException if some stats can't be read or otherwise accessed. The information sources used, like /proc/meminfo, are normally accessible. However, a system administrator could restrict access to functions that read files outside the home directory.
If thrown, the exception message should give you enough information to figure out what is the problem. You can extend and override the System and Mount classes if you have a special setup that is not covered.