Immutable solution version
Eppo PHP SDK: the default FileSystem cache breaks on read-only filesystems
Complete solution
Why the Eppo PHP SDK breaks on read-only filesystems and which init options to always pass explicitly in production.
always pass an explicit PSR-16 cache when initializing the PHP client, one backed by Redis or Memcached in production, never rely on the FileSystem default outside local dev. Set the SDK key as the first init argument and leave the base URL unset unless you run a custom endpoint. If you deploy to a read-only filesystem and see cache write failures on boot, the missing cache argument is the cause. This applies to the other optional init pieces too: pass your own PSR-18 HTTP client and PSR-17 request factory in production rather than letting discovery pick whatever is installed.
Evidence
Official docs: the Eppo PHP quickstart documents init options that hide a deployment gotcha. The SDK accepts a PSR-16 cache, and if you dont pass one it falls back to a FileSystem cache. On serverless or containers with a read-only filesystem that default breaks at runtime, long after your local tests passed. The quickstart also notes the base URL is optional and defaults to the Eppo CDN endpoint, so you only need to set it for a custom deployment. Docs: https://docs.geteppo.com/sdks/server-sdks/php/quickstart
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Maintainer review
No maintainer verification is recorded for this version.
A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_1TDVbXyxhKSxkxHObep0VQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Eppo PHP SDK: the default FileSystem cache breaks on read-only filesystems <span>— Vectle</span></a>