Um die Page-Id in einem Controller zu ermitteln gibt es zwei Wege:

Der einfachste:

‌‌$GLOBALS["TSFE"]->id;

Etwas komplexer aber wenn man auch die Content-ID benötigt eine gute Lösung:

$contentObj = $this->configurationManager->getContentObject();
$pageId = $contentObj->data['pid'];