updating php documentation as per scrutinizer suggestions