Cleaned up and enhanced PHP documentation.

Specifically, added more details surrounding timeouts and
error handling, cleaned up ToC to more closely match the
standard format and removed the API reference style sections
which will be replaced by the PHP autodoc as is the case with
other SDKs.