fusionpbx/app/system/resources/classes/linux_system_information.php

<?php

/*
 * The MIT License
 *
 * Copyright 2025 Tim Fry <tim@fusionpbx.com>.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */

/**
 * Description of linux_system_information
 *
 * @author Tim Fry <tim@fusionpbx.com>
 */
class linux_system_information extends system_information {

	/**
	 * Returns the number of CPU cores available on the system.
	 *
	 * This method executes a shell command to parse the /proc/cpuinfo file and counts the number of processor entries found.
	 *
	 * @return int The total number of CPU cores
	 */
	public function get_cpu_cores(): int {
		$result = @trim(shell_exec("grep -P '^processor' /proc/cpuinfo"));
		$cpu_cores = count(explode("\n", $result));
		return $cpu_cores;
	}

	//get the CPU details

	/**
	 * Returns the current CPU usage as a percentage.
	 *
	 * This method reads the CPU statistics from /proc/stat and calculates
	 * the CPU usage by comparing the total and idle time of each core.
	 * The result is rounded to two decimal places.
	 *
	 * @return float The current CPU usage in percent.
	 */
	public function get_cpu_percent(): float {
		$stat1 = file_get_contents('/proc/stat');
		usleep(500000);
		$stat2 = file_get_contents('/proc/stat');

		$lines1 = explode("\n", trim($stat1));
		$lines2 = explode("\n", trim($stat2));

		$percent_cpu = 0;
		$core_count = 0;

		foreach ($lines1 as $i => $line1) {
			if (strpos($line1, 'cpu') !== 0 || $line1 === 'cpu')
				continue;

			$parts1 = preg_split('/\s+/', $line1);
			$parts2 = preg_split('/\s+/', $lines2[$i]);

			$total1 = array_sum(array_slice($parts1, 1));
			$total2 = array_sum(array_slice($parts2, 1));

			$idle1 = $parts1[4];
			$idle2 = $parts2[4];

			$total_delta = $total2 - $total1;
			$idle_delta = $idle2 - $idle1;

			$cpu_usage = ($total_delta - $idle_delta) / $total_delta * 100;
			$percent_cpu += $cpu_usage;
			$core_count++;
		}

		return round($percent_cpu / $core_count, 2);
	}

	/**
	 * Returns the current system uptime as reported by the 'uptime' command.
	 *
	 * This method executes the 'uptime' command and returns its output.
	 *
	 * @return string The current system uptime.
	 */
	public function get_uptime() {
		return shell_exec('uptime');
	}

	/**
	 * Returns the current CPU usage as a percentage per core.
	 *
	 * This method reads the CPU statistics from /proc/stat and calculates
	 * the CPU usage by comparing the total and idle time of each core.
	 * The result is rounded to two decimal places.
	 *
	 * @return array An array where the keys are the core numbers (starting at 0)
	 *               and the values are the current CPU usage for each core in percent.
	 */
	public function get_cpu_percent_per_core(): array {
		static $last = [];

		$lines = file('/proc/stat');
		$results = [];

		foreach ($lines as $line) {
			if (preg_match('/^cpu(\d+)\s+(.+)$/', $line, $matches)) {
				$core = (int) $matches[1];
				$parts = preg_split('/\s+/', trim($matches[2]));
				$total = array_sum($parts);
				$idle = $parts[3] ?? 0;

				if (!isset($last[$core])) {
					$last[$core] = ['total' => $total, 'idle' => $idle];
					$results[$core] = 0;
				} else {
					$delta_total = $total - $last[$core]['total'];
					$delta_idle = $idle - $last[$core]['idle'];
					$usage = $delta_total > 0 ? (1 - ($delta_idle / $delta_total)) * 100 : 0;

					$results[$core] = round($usage, 2);
					$last[$core] = ['total' => $total, 'idle' => $idle];
				}
			}
		}

		return $results;
	}

	/**
	 * Returns the current network speed for the specified interface.
	 *
	 * This method reads the network statistics from /proc/net/dev and calculates
	 * the network speed by comparing the received and transmitted bytes between two measurements.
	 *
	 * @param string $interface The network interface to read stats from. Defaults to 'eth0'.
	 *
	 * @return array An array containing the current receive (rx_bps) and transmit (tx_bps) speeds in bits per second.
	 */
	public function get_network_speed(string $interface = 'eth0'): array {
		static $last = [];

		// Read network stats
		$data = file('/proc/net/dev');
		foreach ($data as $line) {
			if (strpos($line, $interface . ':') !== false) {
				$parts = preg_split('/\s+/', trim(str_replace(':', ' ', $line)));
				$rx_bytes = (int) $parts[1];
				$tx_bytes = (int) $parts[9];

				$now = microtime(true);

				if (!isset($last[$interface])) {
					$last[$interface] = ['rx' => $rx_bytes, 'tx' => $tx_bytes, 'time' => $now];
					return ['rx_bps' => 0, 'tx_bps' => 0];
				}

				$delta_time = $now - $last[$interface]['time'];
				$delta_rx = $rx_bytes - $last[$interface]['rx'];
				$delta_tx = $tx_bytes - $last[$interface]['tx'];

				$last[$interface] = ['rx' => $rx_bytes, 'tx' => $tx_bytes, 'time' => $now];

				return [
					'rx_bps' => $delta_rx / $delta_time,
					'tx_bps' => $delta_tx / $delta_time
				];
			}
		}

		return ['rx_bps' => 0, 'tx_bps' => 0];
	}
}