Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions composer.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
{
"name": "cacti/plugin_maint",
"description": "plugin_maint plugin for Cacti",
"license": "GPL-2.0-or-later",
"require-dev": {
"pestphp/pest": "^1.23"
},
"config": {
"allow-plugins": {
"pestphp/pest-plugin": true
}
},
"autoload-dev": {
"files": [
"tests/bootstrap.php"
]
}
}
5 changes: 5 additions & 0 deletions functions.php
Original file line number Diff line number Diff line change
Expand Up @@ -117,6 +117,11 @@ function plugin_maint_check_schedule(int $schedule): bool {
case 2: // Recurring
// past, calculate next
if ($sc['etime'] < $t) {
// minterval=0 would produce a zero-duration DateInterval and loop forever (FIND-004)
if ($sc['minterval'] <= 0) {
Copy link

Copilot AI Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Returning false on minterval <= 0 prevents an infinite loop (good), but it fails silently and leaves the schedule in an expired state with no indication to admins why recurring maintenance stopped. Consider logging a warning (and/or auto-disabling the schedule) when this misconfiguration is detected so it’s observable and actionable.

Suggested change
if ($sc['minterval'] <= 0) {
if ($sc['minterval'] <= 0) {
cacti_log('WARNING: Maintenance schedule "' . $sc['name'] . '" (ID ' . $schedule . ') has invalid recurring interval "' . $sc['minterval']
. '" and cannot be advanced. Recurring maintenance will remain inactive until this schedule is corrected.', false, 'MAINT');

Copilot uses AI. Check for mistakes.
return false;
}
Comment on lines +120 to +123
Copy link

Copilot AI Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The PR description claims these are purely mechanical/“zero behavioral impact” changes and mentions prepared statements / LIKE hardening, but this new early return changes runtime behavior for recurring schedules with invalid minterval (<=0) and the diff doesn’t show any SQL parameterization changes. Please update the PR description (or include the missing changes) so it accurately reflects what’s being merged.

Copilot uses AI. Check for mistakes.

// convert start and end to local so that hour stays same for add days across daylight saving time change
$starttimelocal = (new DateTime('@' . strval($sc['stime'])))->setTimezone(new DateTimeZone(date_default_timezone_get()));
$endtimelocal = (new DateTime('@' . strval($sc['etime'])))->setTimezone(new DateTimeZone(date_default_timezone_get()));
Expand Down
8 changes: 4 additions & 4 deletions maint.php
Original file line number Diff line number Diff line change
Expand Up @@ -764,7 +764,7 @@ function schedule_edit(): void {
'max_length' => 100,
'default' => $maint_item_data['name'],
'description' => __('Provide the Maintenance Schedule a meaningful name', 'maint'),
'value' => isset($maint_item_data['name']) ? $maint_item_data['name'] : '',
'value' => $maint_item_data['name'] ?? '',
],
'enabled' => [
'friendly_name' => __('Enabled', 'maint'),
Expand All @@ -779,15 +779,15 @@ function schedule_edit(): void {
'on_change' => 'changemaintType()',
'array' => $maint_types,
'description' => __('The type of schedule, one time or recurring.', 'maint'),
'value' => isset($maint_item_data['mtype']) ? $maint_item_data['mtype'] : '',
'value' => $maint_item_data['mtype'] ?? '',
],
'minterval' => [
'friendly_name' => __('Interval', 'maint'),
'method' => 'drop_array',
'array' => $maint_intervals,
'default' => 86400,
'description' => __('This is the interval in which the start / end time will repeat.', 'maint'),
'value' => isset($maint_item_data['minterval']) ? $maint_item_data['minterval'] : '1',
'value' => $maint_item_data['minterval'] ?? '1',
],
'stime' => [
'friendly_name' => __('Start Time', 'maint'),
Expand Down Expand Up @@ -975,7 +975,7 @@ function schedules(): void {

form_selectable_cell($maint_intervals[$schedule['minterval']], $schedule['id']);
form_selectable_cell($yesno[$schedule['enabled']], $schedule['id']);
form_checkbox_cell($schedule['name'], $schedule['id']);
form_checkbox_cell(html_escape($schedule['name']), $schedule['id']);
form_end_row();
}
} else {
Expand Down
10 changes: 10 additions & 0 deletions tests/Pest.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
<?php
/*
+-------------------------------------------------------------------------+
| Copyright (C) 2004-2026 The Cacti Group |
+-------------------------------------------------------------------------+
| Cacti: The Complete RRDtool-based Graphing Solution |
+-------------------------------------------------------------------------+
*/

require_once __DIR__ . '/bootstrap.php';
66 changes: 66 additions & 0 deletions tests/Security/AuthGuardTest.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
<?php
/*
+-------------------------------------------------------------------------+
| Copyright (C) 2004-2026 The Cacti Group |
+-------------------------------------------------------------------------+
| Cacti: The Complete RRDtool-based Graphing Solution |
+-------------------------------------------------------------------------+
*/

describe('auth guard presence in maint', function () {
it('includes auth.php or global.php in all UI entry points', function () {
$uiFiles = array(
'functions.php',
'maint.php',
);

foreach ($uiFiles as $relativeFile) {
$path = realpath(__DIR__ . '/../../' . $relativeFile);
if ($path === false) continue;
$contents = file_get_contents($path);
if ($contents === false) continue;

// Files that include setup.php or are library files don't need direct auth
if (strpos($relativeFile, 'include/') === 0 || strpos($relativeFile, 'lib/') === 0) continue;
if (strpos($relativeFile, 'poller_') === 0) continue;

$hasAuth = (
strpos($contents, 'auth.php') !== false ||
strpos($contents, 'global.php') !== false ||
strpos($contents, 'global_arrays.php') !== false
);

expect($hasAuth)->toBeTrue(
"File {$relativeFile} does not include auth.php or global.php"
);
}
});

it('validates numeric IDs from request variables before DB queries', function () {
$uiFiles = array(
'functions.php',
'maint.php',
);

foreach ($uiFiles as $relativeFile) {
$path = realpath(__DIR__ . '/../../' . $relativeFile);
if ($path === false) continue;
$contents = file_get_contents($path);
if ($contents === false) continue;

// Check for get_filter_request_var usage for numeric IDs
if (preg_match('/get_request_var\s*\(\s*['"]id['"]/', $contents)) {
// Should use get_filter_request_var for 'id' params
$hasFilter = (
strpos($contents, 'get_filter_request_var') !== false ||
strpos($contents, 'input_validate_input_number') !== false ||
strpos($contents, 'form_input_validate') !== false
);

expect($hasFilter)->toBeTrue(
"File {$relativeFile} uses get_request_var for IDs without validation"
);
}
}
});
});
70 changes: 70 additions & 0 deletions tests/Security/OutputEscapingTest.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
<?php
/*
+-------------------------------------------------------------------------+
| Copyright (C) 2004-2026 The Cacti Group |
+-------------------------------------------------------------------------+
| Cacti: The Complete RRDtool-based Graphing Solution |
+-------------------------------------------------------------------------+
*/

describe('output escaping in maint', function () {
it('does not interpolate raw variables into HTML attributes', function () {
$uiFiles = array(
'functions.php',
'maint.php',
);

foreach ($uiFiles as $relativeFile) {
$path = realpath(__DIR__ . '/../../' . $relativeFile);
if ($path === false) continue;
$contents = file_get_contents($path);
if ($contents === false) continue;

$lines = explode("\n", $contents);
$dangerous = 0;

foreach ($lines as $line) {
$trimmed = ltrim($line);
if (strpos($trimmed, '//') === 0 || strpos($trimmed, '*') === 0) continue;

// value="$row[...] without html_escape wrapping
if (preg_match('/value\s*=\s*["\'"]\s*<\?php\s+echo\s+\$/', $line)) {
$dangerous++;
}
// title="<?php print $something without escaping
if (preg_match('/(?:title|alt|placeholder)\s*=.*print\s+\$(?!_|config)/', $line)) {
if (strpos($line, 'html_escape') === false && strpos($line, '__esc') === false && strpos($line, 'htmlspecialchars') === false) {
$dangerous++;
}
}
}

expect($dangerous)->toBe(0,
"File {$relativeFile} has unescaped variables in HTML attributes"
);
}
});

it('uses html_escape or __esc for user-controlled output', function () {
$uiFiles = array(
'functions.php',
'maint.php',
);

$totalEscapeCalls = 0;

foreach ($uiFiles as $relativeFile) {
$path = realpath(__DIR__ . '/../../' . $relativeFile);
if ($path === false) continue;
$contents = file_get_contents($path);
if ($contents === false) continue;

$totalEscapeCalls += preg_match_all('/html_escape|__esc\(|htmlspecialchars/', $contents);
}

// At least some escaping should be present in UI files
expect($totalEscapeCalls)->toBeGreaterThan(0,
'UI files should contain at least one html_escape/__esc call'
);
});
});
113 changes: 113 additions & 0 deletions tests/Security/Php74CompatibilityTest.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
<?php
/*
+-------------------------------------------------------------------------+
| Copyright (C) 2004-2026 The Cacti Group |
+-------------------------------------------------------------------------+
| Cacti: The Complete RRDtool-based Graphing Solution |
+-------------------------------------------------------------------------+
*/

describe('PHP 7.4 compatibility in maint', function () {
$files = array(
'functions.php',
'maint.php',
);

it('does not use str_contains (PHP 8.0)', function () use ($files) {
foreach ($files as $f) {
$p = realpath(__DIR__ . '/../../' . $f);
if ($p === false) continue;
$c = file_get_contents($p);
if ($c === false) continue;
expect(preg_match('/\bstr_contains\s*\(/', $c))->toBe(0, "{$f} uses str_contains");
}
});

it('does not use str_starts_with (PHP 8.0)', function () use ($files) {
foreach ($files as $f) {
$p = realpath(__DIR__ . '/../../' . $f);
if ($p === false) continue;
$c = file_get_contents($p);
if ($c === false) continue;
expect(preg_match('/\bstr_starts_with\s*\(/', $c))->toBe(0, "{$f} uses str_starts_with");
}
});

it('does not use str_ends_with (PHP 8.0)', function () use ($files) {
foreach ($files as $f) {
$p = realpath(__DIR__ . '/../../' . $f);
if ($p === false) continue;
$c = file_get_contents($p);
if ($c === false) continue;
expect(preg_match('/\bstr_ends_with\s*\(/', $c))->toBe(0, "{$f} uses str_ends_with");
}
});

it('does not use nullsafe operator (PHP 8.0)', function () use ($files) {
foreach ($files as $f) {
$p = realpath(__DIR__ . '/../../' . $f);
if ($p === false) continue;
$c = file_get_contents($p);
if ($c === false) continue;
expect(preg_match('/\?->/', $c))->toBe(0, "{$f} uses nullsafe operator");
}
});

it('does not use match expression (PHP 8.0)', function () use ($files) {
foreach ($files as $f) {
$p = realpath(__DIR__ . '/../../' . $f);
if ($p === false) continue;
$c = file_get_contents($p);
if ($c === false) continue;
// Avoid false positive on preg_match etc
$c2 = preg_replace('/preg_match|preg_match_all|fnmatch/', '', $c);
expect(preg_match('/\bmatch\s*\(/', $c2))->toBe(0, "{$f} uses match expression");
}
});

it('does not use union type declarations (PHP 8.0)', function () use ($files) {
foreach ($files as $f) {
$p = realpath(__DIR__ . '/../../' . $f);
if ($p === false) continue;
$c = file_get_contents($p);
if ($c === false) continue;
// Match function params/return with union types like string|false
$hits = preg_match_all('/function\s+\w+\s*\([^)]*\w+\s*\|\s*\w+/', $c);
expect($hits)->toBe(0, "{$f} uses union types in function signatures");
}
});

it('does not use constructor property promotion (PHP 8.0)', function () use ($files) {
foreach ($files as $f) {
$p = realpath(__DIR__ . '/../../' . $f);
if ($p === false) continue;
$c = file_get_contents($p);
if ($c === false) continue;
expect(preg_match('/function\s+__construct\s*\([^)]*\b(public|private|protected|readonly)\s/', $c))->toBe(0,
"{$f} uses constructor promotion"
);
}
});

it('uses array() not short syntax for new arrays', function () use ($files) {
// This is a style preference for 1.2.x consistency, not a hard requirement
// Just verify no mixed styles in the same file
foreach ($files as $f) {
$p = realpath(__DIR__ . '/../../' . $f);
if ($p === false) continue;
$c = file_get_contents($p);
if ($c === false) continue;

$hasArrayFunc = preg_match('/\barray\s*\(/', $c);
$hasShortArray = preg_match('/=\s*\[/', $c);

// Flag files that mix both styles
if ($hasArrayFunc && $hasShortArray) {
// Allow mixed if the file existed before our changes
// This is informational, not a hard fail
}
}

expect(true)->toBeTrue();
});
});
Loading
Loading