PHP-873: Add support for MONGODB-X509
Update after CR on PR #496

- Reorder function comments to make return values more obvious
- Use switch rather then if/else if/else
- Order auth mechanisms by their value
Merged Pull Request #496

* pull-request/496:
  Update after CR on PR #496
  PHP-873: Add support for MONGODB-X509