2017-25 © Pedro Peláez
 

library linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

image

linfo/linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

  • Tuesday, June 19, 2018
  • by jrgp
  • Repository
  • 22 Watchers
  • 210 Stars
  • 122,176 Installations
  • PHP
  • 13 Dependents
  • 1 Suggesters
  • 56 Forks
  • 9 Open issues
  • 9 Versions
  • 14 % Grown

The README.md

Linfo - Server stats UI/library

Build Status, (*1)

Linfo is a:

  • Light themable Web UI and REST API displaying lots of system stats
  • Ncurses CLI view of WebUI
  • Extensible, easy (composer) to use PHP5 Library to get extensive system stats programmatically from your PHP app

Contributing

Interested in contributing? Check out Development Readme, (*2)

web UI

Linfo WebUI Screenshot, (*3)

ncurses preview

Linfo Ncurses Screenshot, (*4)

See: Enabling ncurses, (*5)

PHP library usage

composer require linfo/linfo

<?php
$linfo = new \Linfo\Linfo;
$parser = $linfo->getParser();

var_dump($parser->getCPU()); // and a whole lot more

Runs on

  • Linux
  • Windows
  • FreeBSD
  • NetBSD
  • OpenBSD
  • DragonflyBSD
  • Darwin/Mac OSX
  • Solaris
  • Minix

Information reported

  • CPU type/speed; Architecture
  • Mount point usage
  • Hard/optical/flash drives
  • Hardware Devices
  • Network devices and stats
  • Uptime/date booted
  • Hostname
  • Memory usage (physical and swap, if possible)
  • Temperatures/voltages/fan speeds
  • RAID arrays
  • Via included extensions:
    • Nvidia GPU temps
    • Truecrypt mounts
    • DHCPD leases
    • Samba status
    • APC UPS status
    • Transmission torrents status
    • uTorrent torrents status
    • Soldat server status
    • CUPS printer status
    • IPMI
    • libvirt VMs
    • lxd Containers
    • more

System requirements:

  • At least PHP 8

Windows

Linux

  • /proc and /sys mounted and readable by PHP
  • Tested with the 2.6.x/3.x/4.x/5.x/6.x kernels

FreeBSD

  • PHP able to execute usual programs under /bin, /usr/bin, /usr/local/bin, etc
  • Tested on 8.0-RELEASE, 10.2-RELEASE

NetBSD

  • PHP able to execute usual programs under /bin, /usr/bin, /usr/local/bin, /usr/pkg/bin, etc
  • Tested on NetBSD 5.0.2

OpenBSD

  • PHP able to execute usual programs under /bin, /usr/bin, /usr/local/bin, etc
  • Tested on OpenBSD 4.7, 5.7
  • Turn chroot of httpd/nginx/php-fpm off

Web UI Installation

  1. Extract tarball contents to somewhere under your web root
  2. Rename sample.config.inc.php to config.inc.php, after optionally changing values in it
  3. Visit page in web browser
  4. Pass URL to your friends to show off

URL arguments

  • ?out=json - JSON output
  • ?out=jsonp&callback=functionName - JSON output with a function callback. (Look here: http://www.json-p.org/ )
  • ?out=php_array - PHP serialized associative array
  • ?out=html - Usual lightweight HTML (default)

Extensions

  • See a list of php files in src/Linfo/Extensions/
  • Open them and look at the comment at the top of the file for usage

Troubleshooting:

Set $settings['show_errors'] = true; in config.inc.php to yield useful error messages., (*6)

TODO:

  • Support for other Unix operating systems (Hurd, IRIX, AIX, HP UX, etc)
  • Support for strange operating systems: Haiku/BeOS
  • More superfluous features/extensions
  • Make ncurses mode rival htop (half kidding)

Meta

This project is dedicated to the memory of Eric Looper., (*7)

The Versions

19/06 2018

dev-master

9999999-dev http://github.com/jrgp/linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

  Sources   Download

MIT GPL GPL-2.0-or-later

The Requires

  • ext-pcre *
  • php >=5.3.0

 

The Development Requires

by Joe Gillotti

system linux health cpu specs

05/04 2018

v4.0.0

4.0.0.0 http://github.com/jrgp/linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

  Sources   Download

MIT

The Requires

  • php >=5.3.0
  • ext-pcre *

 

The Development Requires

by Joe Gillotti

system linux health cpu specs

31/03 2018

v3.0.2

3.0.2.0 http://github.com/jrgp/linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

  Sources   Download

GPL-2.0-or-later

The Requires

  • php >=5.3.0
  • ext-pcre *

 

The Development Requires

by Joe Gillotti

system linux health cpu specs

25/08 2016

v3.0.1

3.0.1.0 http://github.com/jrgp/linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

  Sources   Download

GPL

The Requires

  • php >=5.3.0
  • ext-pcre *

 

by Joe Gillotti

system linux health cpu specs

21/10 2015

v3.0.0

3.0.0.0 http://github.com/jrgp/linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

  Sources   Download

GPL

The Requires

  • php >=5.3.0
  • ext-pcre *

 

by Joe Gillotti

system linux health cpu specs

15/09 2015

v2.0.3

2.0.3.0 http://github.com/jrgp/linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

  Sources   Download

GPL

The Requires

  • php >=5.3.0
  • ext-pcre *

 

by Joe Gillotti

system linux health cpu specs

24/11 2014

v2.0.2

2.0.2.0 http://github.com/jrgp/linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

  Sources   Download

GPL

The Requires

  • php >=5.1.0
  • ext-pcre *

 

by Joe Gillotti

system linux health cpu specs

09/07 2014

v2.0.1

2.0.1.0 http://github.com/jrgp/linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

  Sources   Download

GPL

The Requires

  • php >=5.1.0
  • ext-pcre *

 

by Joe Gillotti

system linux health cpu specs

08/07 2014

v2.00

2.00.0.0 http://github.com/jrgp/linfo

App and library for easily parsing and displaying system information of the host, like network/torrents/cpu/memory/usb/pci/sound cards/filesystems/raid array/ipmi/etc.

  Sources   Download

GPL

The Requires

  • php >=5.1.0
  • ext-pcre *

 

by Joe Gillotti

system linux health cpu specs