Понимание PHP склепа() возвращает значение

Question

PHP crypt function, как говорят, возвращаемое значение:

"Returns the hashed string or a string that is shorter than 13 characters and is 
guaranteed to differ from the salt on failure." 

Я не понимаю, что это значит ... Я понял, в основном, как эта функция работает, но я бы как знать, как интерпретировать возвращаемое значение, и попытаться понять, КОГДА это условие происходит. Это, безусловно, одно из самых неопределенных объяснений в руководстве по PHP, или, может быть, я просто ослеплю от него в течение долгого времени ...? :)

Answer 1

Одна вещь crypt documentation упоминает:

(5.3.2) Исправлено поведение Blowfish на недействительных раундов, чтобы вернуться "неудача" строка ("* 0" или "* 1"), вместо того, возвращаясь к DES.

По-видимому crypt может возвращать различные [плохо указанные] короткие строки при отказе. Я подозреваю, что бит «или« должен учитывать »отличается от соли».

Таким образом, строка «короче 13 символов» (о том, кто знает, что) -> сбой. Единственный документированный случай касается недействительных параметров Blowfish, но его можно было бы расширить в будущем. (Хотя не в документации, bug #64449 указывает на то, что «отказ» должен быть возвращен для алгоритмов, когда соль является недействительным.)

---

Рациональный, что соль никогда не возвращается могут быть связаны с bug #55439:

Если crypt() выполняется с солями MD5, возвращаемое значение составляет только соль.

Последствием является $valid = crypt($pw, $crypt); ИСТИНА, для любых $ pw.

Таким образом, гарантируя, что соль сама по себе не возвращается, она позволяет избежать цикла обратной связи, в котором хранятся хэши - только соль из-за ошибки - всегда регистрируются как действительные для любого пароля. Ограничение на то, что соль не возвращается может смягчить вырожденные взаимодействия разных (исправленных и непроверенных?) Серверов.

---

Кроме того, кто-нибудь знает, как найти точечную документацию для определенных версий PHP? Было бы интересно увидеть, когда была добавлена ​​статья «отличная от соли».