agent foundation

lib/Service/Settings/SettingCacheService.php

@@ -61,11 +61,14 @@ class SettingCacheService
             return false;
         }
 
+        // Write to a temp file first, then rename — rename is atomic on most filesystems,
+        // so readers never see a half-written file. LOCK_EX prevents concurrent write corruption.
         $tmp = tempnam($dir, 'settings_');
         if ($tmp === false) {
             return false;
         }
 
+        // PHP include returns an array — loaded by OPcache on subsequent requests, much faster than DB.
         $payload = "<?php\nreturn " . $this->exportValue($settings) . ";\n";
         $written = @file_put_contents($tmp, $payload, LOCK_EX);
         if ($written === false) {