Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/wimil/ginfo

Last synced: about 2 months ago
JSON representation

Host: GitHub
URL: https://github.com/wimil/ginfo
Owner: wimil
License: mit
Created: 2020-11-28T19:51:26.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2020-11-28T19:55:14.000Z (about 4 years ago)
Last Synced: 2024-04-19T06:43:21.038Z (9 months ago)
Language: PHP
Size: 45.9 KB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Ginfo - Server stats library

[![License](https://poser.pugx.org/gemorroj/ginfo/license)](https://packagist.org/packages/gemorroj/ginfo)

[![Latest Stable Version](https://poser.pugx.org/gemorroj/ginfo/v/stable)](https://packagist.org/packages/gemorroj/ginfo)

[![Build Status Travis](https://secure.travis-ci.org/Gemorroj/ginfo.png?branch=master)](https://travis-ci.org/Gemorroj/ginfo)

[![Build Status AppVeyor](https://ci.appveyor.com/api/projects/status/wl8tt98r9807a06i?svg=true)](https://ci.appveyor.com/project/Gemorroj/ginfo)

### Ginfo is a:

 - Extensible, easy (composer) to use PHP Library to get extensive system stats programmatically from your PHP app

### Fork changes:

- drop ui

- drop internationalization

- drop bsd* support (sorry, I will not be able to support)

- drop dhcp3 support

- drop dnsmasq support

- drop php libvirt support

- drop lxd support

- no need `COM` extension on Windows, but need powershell

- minimal windows 10 support

- adapt the code to modern standards

- minimal php version 7.1.3

- add selinux status info

- add php info (basic, opcache, apcu)

### Installation:

```bash

composer require gemorroj/ginfo

```

### Example:

```php

getInfo();

\print_r($info->getGeneral());

\print_r($info->getPhp());

\print_r($info->getCpu());

\print_r($info->getMemory());

\print_r($info->getSoundCard());

\print_r($info->getUsb());

\print_r($info->getUps());

\print_r($info->getPci());

\print_r($info->getNetwork());

\print_r($info->getDisk());

\print_r($info->getBattery());

\print_r($info->getSensors());

\print_r($info->getProcesses());

\print_r($info->getServices());

\print_r($info->getPrinters());

\print_r($info->getSamba());

\print_r($info->getSelinux());

```

### Runs on

- Linux

- Windows >= 10

### Information reported

- CPU type/speed; Architecture

- Mount point usage

- Hard/optical/flash drives

- Hardware devices (PCI) (linux: need `pciutils`)

- USB devices (linux: need `usbutils`)

- Network devices and stats

- Uptime

- Memory usage (physical and swap, linux: need `free`)

- Temperatures/voltages/fan speeds (linux: need `hddtemp` as daemon, `mbmon` as daemon, `sensors` (part of `lm-sensors`), `hwmon`, `acpi themal zone`, `nvidia-smi`, `ipmitool`)

- RAID arrays (linux: need `mdadm`)

- Motherboard (linux: need `dimedecode`)

- Processes

- Systemd services (linux: need `systemctl`)

- logged users (linux: need `who`)

- UPS status (linux: need `apcaccess`)

- Printer status (linux: need `lpstat`)

- Samba status (linux: need `smbstatus`)

- Selinux status (linux: need `sestatus`)

- PHP (basic info, `opcache`, `apcu`)

### System requirements:

- PHP >= 7.1.3

- pcre extension

- proc_open

#### Windows

- You need to have `powershell`

- Allow execute ps1 scripts `Set-ExecutionPolicy RemoteSigned –Force`

#### Linux

- `/proc` and `/sys` mounted and readable by PHP

- Tested with the 2.6.x/3.x/4.x kernels