small fixes, update PhpDoc

Fix return statement
Authenticate throws exception
Fix PhpDoc
Add missing $id field declaration
Fix typos