- Package
- getgrav/grav
- Fixed in
- 2.0.2
- Published
- Thu 17 Sep 2026, 15:53 LisbonUpdated Mon 26 Oct 2026, 00:27 Lisbon
- Installs on Packagist
- 91K
In plain words
An attacker-controlled ZIP archive can bypass Grav's uncompressed-size cap and fill the disk or exhaust inodes during extraction. This affects package installation and upgrades through GPM, and admin backup restores, when the archive comes from a malicious package source or admin upload. The attacker therefore needs access at the admin/operator trust level.
Affected versions
| Package | Affected | Fixed in |
|---|---|---|
| getgrav/grav | = 2.0.1 | 2.0.2 |
Am I affected?
Look for getgrav/grav version 2.0.1 in composer.lock; 2.0.2 is fixed. Check whether you extract archives through gpm install, direct-install, self-upgrade or admin backup restore. The system.gpm.archive.max_uncompressed_size cap, which defaults to 1 GiB, does not prevent this bypass; the entry-count and nesting-depth caps remain effective.
What to do
Check which version you have, then update to a fixed release for your branch (2.0.2):
composer show getgrav/grav | grep versions
composer update getgrav/grav
If your version constraint in composer.json keeps you below a fixed release, raise it first. Whether your configuration is affected, and the exact version ranges, are in the advisory itself.
If you cannot update yet
Enforce the size limit during extraction by reading entries through a counting stream and aborting once cumulative written bytes exceed max_uncompressed_size, leaving nothing on disk. Alternatively, check on-disk bytes incrementally during extraction. Treat any pre-extraction sum of declared sizes as advisory only.
The advisory's description
Summary
The decompression-bomb bound added in 2.0.1 (commit 1c1003c) sums ZipArchive::statIndex($i)['size'] and rejects an archive whose declared uncompressed total exceeds system.gpm.archive.max_uncompressed_size (default 1 GiB) before extracting (ZipArchiver.php:77-86; same logic in GPM\Installer::unZip at Installer.php:228-238). statIndex()['size'] is the uncompressed size declared in the ZIP central directory, which is attacker-forgeable and is not checked against the actual inflated stream. An archive declaring 1 byte per entry passes the cap while extractTo() writes the real (large) content. The entry-count and nesting-depth caps count real structure and still hold; only the size dimension is defeated, so the disk-fill / inode-exhaustion case the bound targets is not prevented. Incomplete fix for GHSA-928x-9mpw-8h56.
Details
extract()/unZip() validate every entry up front, then call Folder::create + extractTo. The size check is:
$totalSize += (int) $stat['size']; // declared central-directory size
if ($maxSize > 0 && $totalSize > $maxSize) { ... reject ... }
$stat['size'] is read from the central directory, which the archive author writes. libzip does not cross-check declared-vs-actual size during extractTo, so a forged-small value passes the gate and the real stream inflates to disk. The max_files (entry count) and max_depth (entry-name segments) checks are not forgeable this way.
PoC
Build a 10 KiB deflate ZIP of 10 MiB of zeros, patch both uncompressed-size fields (local header + central directory) to 1:
import zipfile, struct
data = b'\x00' * (10*1024*1024)
with zipfile.ZipFile('bomb.zip','w',zipfile.ZIP_DEFLATED) as z:
z.writestr('big.bin', data)
raw = bytearray(open('bomb.zip','rb').read())
raw = raw.replace(struct.pack('<I', 10*1024*1024), struct.pack('<I', 1))
open('bomb_forged.zip','wb').write(raw)
Drive the exact pre-extraction loop, then extract:
$zip = new ZipArchive(); $zip->open('bomb_forged.zip');
$total = 0;
for ($i = 0; $i < $zip->count(); $i++) { $total += (int) $zip->statIndex($i)['size']; }
// => $total === 1 (what the 1 GiB bound checks: PASSES)
$zip->extractTo('/tmp/zout');
// => filesize('/tmp/zout/big.bin') === 10485760 (written despite the cap)
Verified on Grav 2.0.1 (6f619f0ae), PHP 8.4.22, libzip 1.7.3.
Impact
A forged archive fills the disk / exhausts inodes during extraction. Reached via GPM\Installer::unZip (gpm install / direct-install / self-upgrade) and admin backup restore (ZipArchiver::extract). The archive bytes come from a package source or an admin upload, so the actor sits at admin/operator trust and a consented malicious package already has worse primitives.
Fix
ZipArchiver.php:77-86 and Installer.php:228-238: don't trust the declared size. Extract each entry through a counting stream (ZipArchive::getStream + fread loop) and abort once cumulative written bytes pass max_uncompressed_size, leaving nothing on disk; or check on-disk bytes incrementally during extraction. If the pre-pass stays, treat the declared-size sum as advisory and add the streamed byte counter as the real enforcement. max_files and max_depth remain effective.
Reported by iliaal.
The advisory
- GitHub Advisory Database: GHSA-8h9x-89f2-m7x3, with who is affected and how
- OSV.dev: GHSA-8h9x-89f2-m7x3
- The week's digest, with the other advisories from 14 Sep 2026
- All advisories for getgrav/grav