Buyer beware: PHP documentation is not always as extensive as is boasted and the user comments often times are very dangerously wrong. For an example of this see the comments to json_encode where many wrong PHP implementations are suggested (they don't take care of escaping non-ASCII data), or the read/write/socket functions where bizarre timeout behavior is suggested, or the microtime and usleep functions where even more bizarre things are suggested.