This bug has been fixed in CVS.

Snapshots of the sources are packaged every three hours; this change
will be in the next snapshot. You can grab the snapshot at
http://snaps.php.net/.
 
Thank you for the report, and for helping us make PHP better.

I think that problem not in documentation, but in function itself.

Address 255.255.255.255 is _valid_ address, and function must return 0xffffffff (-1), not FALSE.

In versions before 5.0 ip2long was return -1 in both situations - as error and in case of addres=255.255.255.255. This is not good solution, and, as I think, authors rewrite function to return FALSE in case of invalid IP and return -1 in case of IP=255.255.255.255. And this behavior of function was written in documentation, so documentation _is_ correct.

Sorry for so many words in bad English :(

This is already documented and the function works as the documentation states. If you don't like how it was implemented, you are free to send a patch and/or to open a feature request. This is not a bug.

Also a duplicate of #25487.

The function should NEVER return FALSE, but it should return -1 for 255.255.255.255; if it does not do this, or it is not documented as such. The bug is open.

http://www.php.net/Changelog-5.php#5.0.0RC3 :

Fixed ip2long() to return FALSE if an IP address passed to this function is not valid. (Derick).

The function really returns FALSE for 255.255.255.255 and for invalid addresses and this is what is documented. If it's not correct, change this bug to Network related, fix the source and then change it back to Documentation problem.

If the behavior is correct, leave the bug closed.

Since version 5.0 ip2long returns FALSE on invalid address. It is documented, and it is correct.

But ip2long returns FALSE on 255.255.255.255 - it is _not_ correct, because 255.255.255.255 is _valid_ address.

Documentation says that ip2long returns -1 on 255.255.255.255 - it is _correct_, because unsigned 0xffffffff is signed -1.

Unfortunatelly, I cannot fix this error by myself...

Please try using this CVS snapshot:

  http://snaps.php.net/php5-latest.tar.gz
 
For Windows:
 
  http://snaps.php.net/win32/php5-win32-latest.zip

Fixed in CVS, thanks.

Sorry, but problem not fixed - I try php5-win32-latest.zip and php5.0-win32-200408190830.zip. Both snapshots return FALSE on address 255.255.255.255.

Function ip2long() fixed long time ago, but now I see incorrect note in documentation (at bottom of the chapter):

"Note:  ip2long() will return -1 (PHP 4) or FALSE (PHP 5) for the IP 255.255.255.255"

This is incorrect. ip2long returns -1 in both PHP4 and PHP5 for IP 255.255.255.255. Value "-1" is _correct_ value for 255.255.255.255, so that note must be deleted from documentation. Note about PHP4 is exist near the top of chapter.

This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.

"ip2long() will return FALSE for the IP 255.255.255.255 in PHP 5 <= 5.0.2. It was fixed in PHP 5.0.3 where it returns -1 (same as PHP 4)."

The function is returning -1 also for any substring of "255.255.255.255" (e.g. "" or "255.") but it should return FALSE.

memcmp(Z_STRVAL_PP(str), "255.255.255.255", Z_STRLEN_PP(str)) should be replaced by strcmp(Z_STRVAL_PP(str), "255.255.255.255").

It behaves the same in PHP 4. No bug here.