updated PHP Doc Block

Update some PHP Doc Block for better IDE completetion
I'm not sure about this whitespace here... The docblock should be flush with the function.  Is this a tabs-to-spaces issue?