This function initializes an authentication session using the supported methods. These are, in order of preference: Digest-MD5,CRAMMD5,LOGIN, and PLAIN.
The userid to authenticate as.
The password to authenticate with.
The requested authentication method.If none is specified, the best supported method will be used.
returns Returns a PEAR_Error with an error message on any kind of failure, or true on success.