. * * @package LibreNMS * @link http://librenms.org * @copyright 2018 Tony Murray * @author Tony Murray */ namespace LibreNMS\Util; use App\Models\Device; use App\Models\Port; use Auth; use Carbon\Carbon; use Carbon\CarbonImmutable; use Illuminate\Support\Str; use LibreNMS\Config; use Symfony\Component\HttpFoundation\ParameterBag; class Url { /** * @param Device $device * @param string $text * @param array $vars * @param int $start * @param int $end * @param int $escape_text * @param int $overlib * @return string */ public static function deviceLink($device, $text = null, $vars = [], $start = 0, $end = 0, $escape_text = 1, $overlib = 1) { if (is_null($device)) { return ''; } if (!$device->canAccess(Auth::user())) { return $device->displayName(); } if (!$start) { $start = Carbon::now()->subDay()->timestamp; } if (!$end) { $end = Carbon::now()->timestamp; } if (!$text) { $text = $device->displayName(); } if ($escape_text) { $text = htmlentities($text); } $class = self::deviceLinkDisplayClass($device); $graphs = Graph::getOverviewGraphsForDevice($device); $url = Url::deviceUrl($device, $vars); // beginning of overlib box contains large hostname followed by hardware & OS details $contents = '

' . $device->displayName() . ''; if ($device->hardware) { $contents .= ' - ' . htmlentities($device->hardware); } if ($device->os) { $contents .= ' - ' . htmlentities(Config::getOsSetting($device->os, 'text')); } if ($device->version) { $contents .= ' ' . htmlentities($device->version); } if ($device->features) { $contents .= ' (' . htmlentities($device->features) . ')'; } if ($device->location_id) { $contents .= ' - ' . htmlentities($device->location); } $contents .= '

'; foreach ((array)$graphs as $entry) { $graph = isset($entry['graph']) ? $entry['graph'] : 'unknown'; $graphhead = isset($entry['text']) ? $entry['text'] : 'unknown'; $contents .= '

'; $contents .= '' . $graphhead . '
'; $contents .= Url::minigraphImage($device, $start, $end, $graph); $contents .= Url::minigraphImage($device, Carbon::now()->subWeek()->timestamp, $end, $graph); $contents .= '

'; } if ($overlib == 0) { $link = $contents; } else { $contents = self::escapeBothQuotes($contents); $link = Url::overlibLink($url, $text, $contents, $class); } return $link; } /** * @param Port $port * @param string $text * @param string $type * @param boolean $overlib * @param boolean $single_graph * @return mixed|string */ public static function portLink($port, $text = null, $type = null, $overlib = true, $single_graph = false) { $label = Rewrite::normalizeIfName($port->getLabel()); if (!$text) { $text = $label; } $content = '

' . addslashes(htmlentities($port->device->displayName() . ' - ' . $label)) . '

'; if ($port->ifAlias) { $content .= addslashes(htmlentities($port->ifAlias)) . '
'; } $content .= "

"; $graph_array = [ 'type' => $type ?: 'port_bits', 'legend' => 'yes', 'height' => 100, 'width' => 340, 'to' => Carbon::now()->timestamp, 'from' => Carbon::now()->subDay()->timestamp, 'id' => $port->port_id, ]; $content .= self::graphTag($graph_array); if (!$single_graph) { $graph_array['from'] = Carbon::now()->subWeek()->timestamp; $content .= self::graphTag($graph_array); $graph_array['from'] = Carbon::now()->subMonth()->timestamp; $content .= self::graphTag($graph_array); $graph_array['from'] = Carbon::now()->subYear()->timestamp; $content .= self::graphTag($graph_array); } $content .= '

'; if (!$overlib) { return $content; } elseif ($port->canAccess(Auth::user())) { return self::overlibLink(self::portUrl($port), $text, $content, self::portLinkDisplayClass($port)); } return Rewrite::normalizeIfName($text); } /** * @param Sensor $sensor * @param string $text * @param string $type * @param boolean $overlib * @param boolean $single_graph * @return mixed|string */ public static function sensorLink($sensor, $text = null, $type = null, $overlib = true, $single_graph = false) { $label = $sensor->sensor_descr; if (!$text) { $text = $label; } $content = '

' . addslashes(htmlentities($sensor->device->displayName() . ' - ' . $label)) . '

'; $content .= "

"; $graph_array = [ 'type' => $type ?: 'sensor_' . $sensor->sensor_class, 'legend' => 'yes', 'height' => 100, 'width' => 340, 'to' => Carbon::now()->timestamp, 'from' => Carbon::now()->subDay()->timestamp, 'id' => $sensor->sensor_id, ]; $content .= self::graphTag($graph_array); if (!$single_graph) { $graph_array['from'] = Carbon::now()->subWeek()->timestamp; $content .= self::graphTag($graph_array); $graph_array['from'] = Carbon::now()->subMonth()->timestamp; $content .= self::graphTag($graph_array); $graph_array['from'] = Carbon::now()->subYear()->timestamp; $content .= self::graphTag($graph_array); } $content .= '

'; if (!$overlib) { return $content; } return self::overlibLink(self::sensorUrl($sensor), $text, $content, self::sensorLinkDisplayClass($sensor)); } /** * @param int|Device $device * @param array $vars * @return string */ public static function deviceUrl($device, $vars = []) { $routeParams = [is_int($device) ? $device : $device->device_id]; if (isset($vars['tab'])) { $routeParams[] = $vars['tab']; unset($vars['tab']); } return route('device', $routeParams) . self::urlParams($vars); } public static function portUrl($port, $vars = []) { return self::generate(['page' => 'device', 'device' => $port->device_id, 'tab' => 'port', 'port' => $port->port_id], $vars); } public static function sensorUrl($sensor, $vars = []) { return self::generate(['page' => 'device', 'device' => $sensor->device_id, 'tab' => 'health' , 'metric' => $sensor->sensor_class], $vars); } /** * @param Port $port * @return string */ public static function portThumbnail($port) { $graph_array = [ 'port_id' => $port->port_id, 'graph_type' => 'port_bits', 'from' => Carbon::now()->subDay()->timestamp, 'to' => Carbon::now()->timestamp, 'width' => 150, 'height' => 21, ]; return self::portImage($graph_array); } public static function portImage($args) { if (empty($args['bg'])) { $args['bg'] = 'FFFFFF00'; } return '

'; } public static function generate($vars, $new_vars = []) { $vars = array_merge($vars, $new_vars); $url = url($vars['page'] . ''); unset($vars['page']); return $url . self::urlParams($vars); } /** * Generate url parameters to append to url * $prefix will only be prepended if there are parameters * * @param array $vars * @param string $prefix * @return string */ private static function urlParams($vars, $prefix = '/') { $url = empty($vars) ? '' : $prefix; foreach ($vars as $var => $value) { if ($value == '0' || $value != '' && !Str::contains($var, 'opt') && !is_numeric($var)) { $url .= $var . '=' . urlencode($value) . '/'; } } return $url; } /** * @param array $args * @return string */ public static function graphTag($args) { $urlargs = []; foreach ($args as $key => $arg) { $urlargs[] = $key . '=' . urlencode($arg); } return '

'; } public static function graphPopup($args) { // Take $args and print day,week,month,year graphs in overlib, hovered over graph $original_from = $args['from']; $now = CarbonImmutable::now(); $graph = self::graphTag($args); $content = '

' . $args['popup_title'] . '

'; $content .= '

'; $args['width'] = 340; $args['height'] = 100; $args['legend'] = 'yes'; $args['from'] = $now->subDay()->timestamp; $content .= self::graphTag($args); $args['from'] = $now->subWeek()->timestamp; $content .= self::graphTag($args); $args['from'] = $now->subMonth()->timestamp; $content .= self::graphTag($args); $args['from'] = $now->subYear()->timestamp; $content .= self::graphTag($args); $content .= '

'; $args['from'] = $original_from; $args['link'] = self::generate($args, ['page' => 'graphs', 'height' => null, 'width' => null, 'bg' => null]); return self::overlibLink($args['link'], $graph, $content, null); } public static function lazyGraphTag($args) { $urlargs = []; foreach ($args as $key => $arg) { $urlargs[] = $key . "=" . urlencode($arg); } if (Config::get('enable_lazy_load', true)) { return '

'; } return '

'; } public static function overlibLink($url, $text, $contents, $class = null) { $contents = "

" . $contents . '

'; $contents = str_replace('"', "\'", $contents); if ($class === null) { $output = '"; } else { $output .= '>'; } $output .= $text . ''; return $output; } public static function overlibContent($graph_array, $text) { $overlib_content = '

' . $text . '
'; $now = Carbon::now(); foreach ([1, 7, 30, 365] as $days) { $graph_array['from'] = $now->subDays($days)->timestamp; $overlib_content .= self::escapeBothQuotes(self::graphTag($graph_array)); } $overlib_content .= '

'; return $overlib_content; } /** * Generate minigraph image url * * @param Device $device * @param int $start * @param int $end * @param string $type * @param string $legend * @param int $width * @param int $height * @param string $sep * @param string $class * @param int $absolute_size * @return string */ public static function minigraphImage($device, $start, $end, $type, $legend = 'no', $width = 275, $height = 100, $sep = '&', $class = 'minigraph-image', $absolute_size = 0) { $vars = ['device=' . $device->device_id, "from=$start", "to=$end", "width=$width", "height=$height", "type=$type", "legend=$legend", "absolute=$absolute_size"]; return '

'; } /** * @param Device $device * @return string */ private static function deviceLinkDisplayClass($device) { if ($device->disabled) { return 'list-device-disabled'; } if ($device->ignore) { return $device->status ? 'list-device-ignored-up' : 'list-device-ignored'; } return $device->status ? 'list-device' : 'list-device-down'; } /** * Get html class for a port using ifAdminStatus and ifOperStatus * * @param Port $port * @return string */ public static function portLinkDisplayClass($port) { if ($port->ifAdminStatus == "down") { return "interface-admindown"; } if ($port->ifAdminStatus == "up" && $port->ifOperStatus != "up") { return "interface-updown"; } return "interface-upup"; } /** * Get html class for a sensor * * @param \App\Models\Sensor $sensor * @return string */ public static function sensorLinkDisplayClass($sensor) { if ($sensor->sensor_current > $sensor->sensor_limit) { return "sensor-high"; } if ($sensor->sensor_current < $sensor->sensor_limit_low) { return "sensor-low"; } return 'sensor-ok'; } /** * @param string $os * @param string $feature * @param string $icon * @param string $dir directory to search in (images/os/ or images/logos) * @return string */ public static function findOsImage($os, $feature, $icon = null, $dir = 'images/os/') { $possibilities = [$icon]; if ($os) { if ($os == "linux") { // first, prefer the first word of $feature $distro = Str::before(strtolower(trim($feature)), ' '); $possibilities[] = "$distro.svg"; $possibilities[] = "$distro.png"; // second, prefer the first two words of $feature (i.e. 'Red Hat' becomes 'redhat') if (strpos($feature, ' ') !== false) { $distro = Str::replaceFirst(' ', null, strtolower(trim($feature))); $distro = Str::before($distro, ' '); $possibilities[] = "$distro.svg"; $possibilities[] = "$distro.png"; } } $os_icon = Config::getOsSetting($os, 'icon', $os); $possibilities[] = "$os_icon.svg"; $possibilities[] = "$os_icon.png"; } foreach ($possibilities as $file) { if (is_file(Config::get('html_dir') . "/$dir" . $file)) { return $file; } } // fallback to the generic icon return 'generic.svg'; } /** * parse a legacy path (one without ? or &) * * @param string $path * @return ParameterBag */ public static function parseLegacyPath($path) { $parts = array_filter(explode('/', $path), function ($part) { return Str::contains($part, '='); }); $vars = []; foreach ($parts as $part) { [$key, $value] = explode('=', $part); $vars[$key] = $value; } return new ParameterBag($vars); } private static function escapeBothQuotes($string) { return str_replace(["'", '"'], "\'", $string); } }