- * * The string representations of two Password objects are equal only if
- * the original plaintext passwords match. In other words, if the toString() result of
- * two objects match, the passwords are the same, and the user will be logged in.
- * Since the string representation of a hash includes its type name (@see Password::toString),
- * this property is preserved across all classes that inherit Password.
- * If a hashing scheme does not fulfill this expectation, it must make sure to override the
- * Password::equals() function and use custom comparison logic. However, this is not
- * recommended unless absolutely required by the hashing mechanism.