[Chore]: Add OPcache health checks and status service

composer.json

@@ -3,13 +3,14 @@
     "type": "package",
     "license": "Elastic-2.0",
     "require": {
-        "php": "8.4.*",
         "filament/filament": "^4.11.6",
         "internachi/modular": "^2.0 || ^3.0",
         "internachi/modularize": "^1.1",
         "laravel/framework": "^11.0|^12.0",
         "laravel/pennant": "^1.0",
         "laravel/prompts": "^0.3",
+        "php": "8.4.*",
+        "spatie/laravel-health": "^1.40",
         "tapp/filament-timezone-field": "^3.0"
     },
     "require-dev": {

src/Health/Checks/OpcacheCachedFilesCheck.php

@@ -0,0 +1,82 @@
+<?php
+
+/*
+<COPYRIGHT>
+
+    Copyright © 2016-2026, Canyon GBS LLC. All rights reserved.
+
+    Canyon GBS Common is licensed under the Elastic License 2.0. For more details,
+    see https://github.com/canyongbs/common/blob/main/LICENSE.
+
+    Notice:
+
+    - You may not provide the software to third parties as a hosted or managed
+      service, where the service provides users with access to any substantial set of
+      the features or functionality of the software.
+    - You may not move, change, disable, or circumvent the license key functionality
+      in the software, and you may not remove or obscure any functionality in the
+      software that is protected by the license key.
+    - You may not alter, remove, or obscure any licensing, copyright, or other notices
+      of the licensor in the software. Any use of the licensor’s trademarks is subject
+      to applicable law.
+    - Canyon GBS LLC respects the intellectual property rights of others and expects the
+      same in return. Canyon GBS™ and Canyon GBS Common are registered trademarks of
+      Canyon GBS LLC, and we are committed to enforcing and protecting our trademarks
+      vigorously.
+    - The software solution, including services, infrastructure, and code, is offered as a
+      Software as a Service (SaaS) by Canyon GBS LLC.
+    - Use of this software implies agreement to the license terms and conditions as stated
+      in the Elastic License 2.0.
+
+    For more information or inquiries please visit our website at
+    https://www.canyongbs.com or contact us via email at legal@canyongbs.com.
+
+</COPYRIGHT>
+*/
+
+namespace CanyonGBS\Common\Health\Checks;
+
+use CanyonGBS\Common\Health\Services\OpcacheStatusService;
+use Spatie\Health\Checks\Check;
+use Spatie\Health\Checks\Result;
+
+class OpcacheCachedFilesCheck extends Check
+{
+    public function run(): Result
+    {
+        $status = app(OpcacheStatusService::class)->getStatus();
+
+        if ($status === false) {
+            return Result::make()
+                ->failed('OPcache is not available.');
+        }
+
+        $numCachedScripts = $status['opcache_statistics']['num_cached_scripts'] ?? 0;
+        $maxCachedKeys = $status['opcache_statistics']['max_cached_keys'] ?? 0;
+
+        if ($maxCachedKeys === 0) {
+            return Result::make()
+                ->failed('OPcache max_cached_keys is zero.');
+        }
+
+        $usagePercentage = round($numCachedScripts / $maxCachedKeys * 100, 2);
+
+        $result = Result::make()
+            ->shortSummary("{$numCachedScripts}/{$maxCachedKeys}")
+            ->meta([
+                'num_cached_scripts' => $numCachedScripts,
+                'max_cached_keys' => $maxCachedKeys,
+                'usage_percentage' => $usagePercentage,
+            ]);
+
+        if ($numCachedScripts >= $maxCachedKeys) {
+            return $result->failed("OPcache file cache is full ({$numCachedScripts}/{$maxCachedKeys})");
+        }
+
+        if ($usagePercentage >= 90) {
+            return $result->warning("OPcache file cache is nearly full ({$usagePercentage}% used)");
+        }
+
+        return $result->ok();
+    }
+}