From 44c6bcbc2d5f10eb2ee3d56ba1f66bf83453e8c0 Mon Sep 17 00:00:00 2001 From: Jonathan Miller <1+jmiller@noreply.git.mokoconsulting.tech> Date: Tue, 26 May 2026 02:29:37 +0000 Subject: [PATCH] feat(cli): add client_health_check.php --- cli/client_health_check.php | 188 ++++++++++++++++++++++++++++++++++++ 1 file changed, 188 insertions(+) create mode 100644 cli/client_health_check.php diff --git a/cli/client_health_check.php b/cli/client_health_check.php new file mode 100644 index 0000000..6f0268c --- /dev/null +++ b/cli/client_health_check.php @@ -0,0 +1,188 @@ +#!/usr/bin/env php + + * + * SPDX-License-Identifier: GPL-3.0-or-later + * + * FILE INFORMATION + * DEFGROUP: moko-platform.CLI + * INGROUP: moko-platform + * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform + * PATH: /cli/client_health_check.php + * BRIEF: Verify a client site's update server, installed version, and release availability + * + * Usage: + * php client_health_check.php --update-url URL + * php client_health_check.php --path /repo --github-output + * + * Options: + * --path Repository root (reads update server URL from manifest) + * --update-url Update server XML URL (overrides manifest) + * --site-url Live site URL for version checking via Joomla API (optional) + * --api-token Joomla API token for site-url (optional) + * --github-output Export results to $GITHUB_OUTPUT + */ + +declare(strict_types=1); + +$path = '.'; +$updateUrl = null; +$siteUrl = null; +$apiToken = null; +$ghOutput = false; + +foreach ($argv as $i => $arg) { + if ($arg === '--path' && isset($argv[$i + 1])) $path = $argv[$i + 1]; + if ($arg === '--update-url' && isset($argv[$i + 1])) $updateUrl = $argv[$i + 1]; + if ($arg === '--site-url' && isset($argv[$i + 1])) $siteUrl = $argv[$i + 1]; + if ($arg === '--api-token' && isset($argv[$i + 1])) $apiToken = $argv[$i + 1]; + if ($arg === '--github-output') $ghOutput = true; +} + +$root = realpath($path) ?: $path; +$checks = []; + +// ── Resolve update server URL from manifest ───────────────────────────── +if ($updateUrl === null) { + $searchDirs = ["{$root}/src", $root]; + foreach ($searchDirs as $dir) { + if (!is_dir($dir)) continue; + foreach (glob("{$dir}/*.xml") ?: [] as $f) { + $xml = file_get_contents($f); + if (preg_match('/]*>([^<]+)<\/server>/', $xml, $m)) { + $updateUrl = trim($m[1]); + break 2; + } + } + } +} + +if ($updateUrl === null) { + fwrite(STDERR, "No update server URL found. Use --update-url or provide a manifest with .\n"); + exit(1); +} + +echo "Update server: {$updateUrl}\n\n"; + +// ── Check 1: Update server accessible ─────────────────────────────────── +echo "--- Update Server ---\n"; +$ch = curl_init($updateUrl); +curl_setopt_array($ch, [ + CURLOPT_RETURNTRANSFER => true, + CURLOPT_TIMEOUT => 15, + CURLOPT_FOLLOWLOCATION => true, + CURLOPT_HTTPHEADER => ['User-Agent: MokoHealthCheck/1.0'], +]); +$response = curl_exec($ch); +$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); +curl_close($ch); + +if ($httpCode === 200 && !empty($response)) { + echo " PASS: HTTP {$httpCode}, " . strlen($response) . " bytes\n"; + $checks['update_server'] = 'pass'; +} else { + echo " FAIL: HTTP {$httpCode}\n"; + $checks['update_server'] = 'fail'; +} + +// ── Check 2: Parse updates.xml for stable version ─────────────────────── +$stableVersion = null; +$downloadUrl = null; + +if (!empty($response)) { + $sections = preg_split('//', $response); + foreach ($sections as $section) { + if (strpos($section, 'stable') !== false) { + if (preg_match('/([^<]+)<\/version>/', $section, $m)) { + $stableVersion = $m[1]; + } + if (preg_match('/]*>([^<]+)<\/downloadurl>/', $section, $m)) { + $downloadUrl = trim($m[1]); + } + break; + } + } + + if ($stableVersion === null && preg_match('/([^<]+)<\/version>/', $response, $m)) { + $stableVersion = $m[1]; + } +} + +echo "\n--- Stable Release ---\n"; +if ($stableVersion !== null) { + echo " Version: {$stableVersion}\n"; + $checks['stable_version'] = $stableVersion; +} else { + echo " FAIL: Could not parse stable version\n"; + $checks['stable_version'] = 'fail'; +} + +// ── Check 3: Download URL accessible ──────────────────────────────────── +if ($downloadUrl !== null) { + echo "\n--- Download URL ---\n"; + $ch = curl_init($downloadUrl); + curl_setopt_array($ch, [ + CURLOPT_NOBODY => true, + CURLOPT_TIMEOUT => 15, + CURLOPT_FOLLOWLOCATION => true, + ]); + curl_exec($ch); + $dlCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); + $dlSize = curl_getinfo($ch, CURLINFO_CONTENT_LENGTH_DOWNLOAD); + curl_close($ch); + + if ($dlCode === 200) { + $sizeKb = $dlSize > 0 ? round($dlSize / 1024) . 'KB' : 'unknown size'; + echo " PASS: HTTP {$dlCode}, {$sizeKb}\n"; + $checks['download'] = 'pass'; + } else { + echo " FAIL: HTTP {$dlCode}\n"; + $checks['download'] = 'fail'; + } +} + +// ── Check 4: Site version (optional) ──────────────────────────────────── +if ($siteUrl !== null && $apiToken !== null) { + echo "\n--- Site Version ---\n"; + $apiUrl = rtrim($siteUrl, '/') . '/api/index.php/v1/extensions?filter[type]=file'; + $ch = curl_init($apiUrl); + curl_setopt_array($ch, [ + CURLOPT_RETURNTRANSFER => true, + CURLOPT_TIMEOUT => 15, + CURLOPT_HTTPHEADER => [ + "X-Joomla-Token: {$apiToken}", + 'Accept: application/json', + ], + ]); + $siteResponse = curl_exec($ch); + $siteCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); + curl_close($ch); + + if ($siteCode === 200) { + echo " API accessible (HTTP {$siteCode})\n"; + $checks['site_api'] = 'pass'; + } else { + echo " WARN: Site API returned HTTP {$siteCode}\n"; + $checks['site_api'] = 'warn'; + } +} + +// ── Summary ───────────────────────────────────────────────────────────── +echo "\n=== Health Check Summary ===\n"; +$failed = 0; +foreach ($checks as $name => $result) { + $icon = ($result === 'fail') ? 'FAIL' : (($result === 'warn') ? 'WARN' : 'OK'); + if ($result === 'fail') $failed++; + echo " {$icon}: {$name} = {$result}\n"; +} + +if ($ghOutput) { + $ghFile = getenv('GITHUB_OUTPUT'); + if ($ghFile) { + file_put_contents($ghFile, "health_status=" . ($failed > 0 ? 'fail' : 'pass') . "\n", FILE_APPEND); + file_put_contents($ghFile, "health_version=" . ($stableVersion ?? 'unknown') . "\n", FILE_APPEND); + file_put_contents($ghFile, "health_failures={$failed}\n", FILE_APPEND); + } +} + +exit($failed > 0 ? 1 : 0);