php-src/UPGRADING

$Id$

PHP X.Y UPGRADE NOTES

1. Backward Incompatible Changes
2. New Features
3. Changes in SAPI modules
4. Deprecated Functionality
5. Changed Functions
6. New Functions
7. New Classes and Interfaces
8. Removed Extensions
9. Other Changes to Extensions
10. New Global Constants
11. Changes to INI File Handling
12. Windows Support
13. Other Changes


========================================
1. Backward Incompatible Changes
========================================

- Core
  . Added null coalesce operator (??).
    (RFC: https://wiki.php.net/rfc/isset_ternary)
  . list() now always supports ArrayAccess and never supports strings.
    Previously both were accepted in some situations and not in others.
    (RFC: https://wiki.php.net/rfc/fix_list_behavior_inconsistency)
  . Bitwise shifts by negative numbers of bits are disallowed (throws E_WARNING
    and gives FALSE, like a division by zero).
  . Left bitwise shifts by a number of bits beyond the bit width of an integer
    will always result in 0, even on CPUs which wrap around.
  . Right bitwise shifts by a number of bits beyond the bit width of an integer
    will always result in 0 or -1 (depending on sign), even on CPUs which wrap
    around.
  . Removed ASP (<%) and script (<script language=php>) tags.
    (RFC: https://wiki.php.net/rfc/remove_alternative_php_tags)

- DBA
  . dba_delete() now returns false if the key was not found for the inifile
    handler, too.

- GMP
  . Requires libgmp version 4.2 or newer now.
  . gmp_setbit() and gmp_clrbit() now return FALSE for negative indices, making
    them consistent with other GMP functions.

========================================
2. New Features
========================================

- Core
  . Support for strings with length >= 2^31 bytes in 64 bit builds
  . Closure::call() method added

- Standard
  . intdiv() function for integer division added.

========================================
3. Changes in SAPI modules
========================================

- FPM
  . Fixed bug #65933 (Cannot specify config lines longer than 1024 bytes).

========================================
4. Deprecated Functionality
========================================


========================================
5. Changed Functions
========================================

- parse_ini_file():
- parse_ini_string():
  Added scanner mode INI_SCANNER_TYPED to yield typed .ini values.


========================================
6. New Functions
========================================


========================================
7. New Classes and Interfaces
========================================


========================================
8. Removed Extensions
========================================


========================================
9. Other Changes to Extensions
========================================


========================================
10. New Global Constants
========================================

- Core
  . PHP_INT_MIN added.

========================================
11. Changes to INI File Handling
========================================

- Core
  . Removed asp_tags ini directive. Trying to enable it will result in a fatal
    error.

========================================
12. Windows Support
========================================

- Core
  . Support for native 64 bit integers in 64 bit builds
  . Support for large files in 64 bit builds

========================================
13. Other Changes
========================================

- Core
  . Instead of being undefined and platform-dependant, NaN and Infinity will
    always be zero when casted to integer.
  . Calling a method on a non-object no longer raises a fatal error; see
    also: https://wiki.php.net/rfc/catchable-call-to-member-of-non-object

- Standard
  . call_user_method() and call_user_method_array() no longer exists.
fix tag 2005-11-23 23:01:54 +08:00			$Id$
Added 5.1 upgrading notes. # Big thanks to Steph Fox for taking the time to make this list possible. 2005-11-23 07:49:13 +08:00
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`PHP X.Y UPGRADE NOTES`

			`1. Backward Incompatible Changes`
			`2. New Features`
Fixed numbering in UPGRADING file 2014-05-01 18:27:38 +08:00			`3. Changes in SAPI modules`
			`4. Deprecated Functionality`
			`5. Changed Functions`
			`6. New Functions`
			`7. New Classes and Interfaces`
			`8. Removed Extensions`
			`9. Other Changes to Extensions`
			`10. New Global Constants`
			`11. Changes to INI File Handling`
updated UPGRADING so far 2014-08-22 19:35:07 +08:00			`12. Windows Support`
			`13. Other Changes`
Reset this document 2010-03-25 00:23:50 +08:00
Added 5.1 upgrading notes. # Big thanks to Steph Fox for taking the time to make this list possible. 2005-11-23 07:49:13 +08:00
Reset this document 2010-03-25 00:23:50 +08:00			`========================================`
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`1. Backward Incompatible Changes`
Reset this document 2010-03-25 00:23:50 +08:00			`========================================`
Missing enhancements 2009-06-25 05:16:53 +08:00
UPGRADING for Integer Semantics 2014-09-21 07:47:25 +08:00			`- Core`
Add UPGRADING stubs for a number of recent changes 2014-10-06 04:06:34 +08:00			`. Added null coalesce operator (??).`
			`(RFC: https://wiki.php.net/rfc/isset_ternary)`
			`. list() now always supports ArrayAccess and never supports strings.`
			`Previously both were accepted in some situations and not in others.`
			`(RFC: https://wiki.php.net/rfc/fix_list_behavior_inconsistency)`
UPGRADING for Integer Semantics 2014-09-21 07:47:25 +08:00			`. Bitwise shifts by negative numbers of bits are disallowed (throws E_WARNING`
			`and gives FALSE, like a division by zero).`
			`. Left bitwise shifts by a number of bits beyond the bit width of an integer`
			`will always result in 0, even on CPUs which wrap around.`
			`. Right bitwise shifts by a number of bits beyond the bit width of an integer`
			`will always result in 0 or -1 (depending on sign), even on CPUs which wrap`
			`around.`
Add UPGRADING stubs for a number of recent changes 2014-10-06 04:06:34 +08:00			`. Removed ASP (<%) and script (<script language=php>) tags.`
			`(RFC: https://wiki.php.net/rfc/remove_alternative_php_tags)`
UPGRADING for Integer Semantics 2014-09-21 07:47:25 +08:00
BFN 2013-12-05 18:30:52 +08:00			`- DBA`
Make gmp_setbit and gmp_clrbit return values consistent 2014-09-25 05:55:13 +08:00			`. dba_delete() now returns false if the key was not found for the inifile`
BFN 2013-12-05 18:30:52 +08:00			`handler, too.`
- Skeleton version taken directly from the scratchpad and tidied. @Lukas, Johannes: This is nowhere near complete, and may contain entries that would be happier in NEWS, but it's OK for the beta IMHO. 2009-01-29 01:23:28 +08:00
Make gmp_setbit and gmp_clrbit return values consistent 2014-09-25 05:55:13 +08:00			`- GMP`
Drop support for GMP 4.1 * Consistent base conversion support (max: 62) * mpz_remroot always available * Use gmp_randinit_mt instead of LCG 2014-09-29 02:39:19 +08:00			`. Requires libgmp version 4.2 or newer now.`
Make gmp_setbit and gmp_clrbit return values consistent 2014-09-25 05:55:13 +08:00			`. gmp_setbit() and gmp_clrbit() now return FALSE for negative indices, making`
			`them consistent with other GMP functions.`

Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
			`2. New Features`
			`========================================`
- Skeleton version taken directly from the scratchpad and tidied. @Lukas, Johannes: This is nowhere near complete, and may contain entries that would be happier in NEWS, but it's OK for the beta IMHO. 2009-01-29 01:23:28 +08:00
updated UPGRADING so far 2014-08-22 19:35:07 +08:00			`- Core`
			`. Support for strings with length >= 2^31 bytes in 64 bit builds`
Fixed Closure::call() NEWS/UPGRADING 2014-10-26 00:05:52 +08:00			`. Closure::call() method added`
updated UPGRADING so far 2014-08-22 19:35:07 +08:00
NEWS and UPGRADING for intdiv() 2014-08-07 02:56:32 +08:00			`- Standard`
			`. intdiv() function for integer division added.`
openssl NEWS,UPGRADING 2013-10-08 22:20:07 +08:00
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Fixed numbering in UPGRADING file 2014-05-01 18:27:38 +08:00			`3. Changes in SAPI modules`
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
- Skeleton version taken directly from the scratchpad and tidied. @Lukas, Johannes: This is nowhere near complete, and may contain entries that would be happier in NEWS, but it's OK for the beta IMHO. 2009-01-29 01:23:28 +08:00
NEWS and UPGRADING 2014-08-20 07:38:33 +08:00			`- FPM`
			`. Fixed bug #65933 (Cannot specify config lines longer than 1024 bytes).`
- Skeleton version taken directly from the scratchpad and tidied. @Lukas, Johannes: This is nowhere near complete, and may contain entries that would be happier in NEWS, but it's OK for the beta IMHO. 2009-01-29 01:23:28 +08:00
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Fixed numbering in UPGRADING file 2014-05-01 18:27:38 +08:00			`4. Deprecated Functionality`
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
- Skeleton version taken directly from the scratchpad and tidied. @Lukas, Johannes: This is nowhere near complete, and may contain entries that would be happier in NEWS, but it's OK for the beta IMHO. 2009-01-29 01:23:28 +08:00

Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Fixed numbering in UPGRADING file 2014-05-01 18:27:38 +08:00			`5. Changed Functions`
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Missing items 2009-06-24 03:40:31 +08:00
Updated UPGRADING for #38409 2014-09-01 22:30:09 +08:00			`- parse_ini_file():`
			`- parse_ini_string():`
			`Added scanner mode INI_SCANNER_TYPED to yield typed .ini values.`

fix bug #55285 XMLReader::getAttribute/No/Ns methods inconsistency 2013-10-03 21:23:05 +08:00
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Fixed numbering in UPGRADING file 2014-05-01 18:27:38 +08:00			`6. New Functions`
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
- Skeleton version taken directly from the scratchpad and tidied. @Lukas, Johannes: This is nowhere near complete, and may contain entries that would be happier in NEWS, but it's OK for the beta IMHO. 2009-01-29 01:23:28 +08:00
NEWS + UPGRADING 2013-11-04 20:32:45 +08:00
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Fixed numbering in UPGRADING file 2014-05-01 18:27:38 +08:00			`7. New Classes and Interfaces`
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
- Skeleton version taken directly from the scratchpad and tidied. @Lukas, Johannes: This is nowhere near complete, and may contain entries that would be happier in NEWS, but it's OK for the beta IMHO. 2009-01-29 01:23:28 +08:00

Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Fixed numbering in UPGRADING file 2014-05-01 18:27:38 +08:00			`8. Removed Extensions`
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
- Skeleton version taken directly from the scratchpad and tidied. @Lukas, Johannes: This is nowhere near complete, and may contain entries that would be happier in NEWS, but it's OK for the beta IMHO. 2009-01-29 01:23:28 +08:00

Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Fixed numbering in UPGRADING file 2014-05-01 18:27:38 +08:00			`9. Other Changes to Extensions`
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Add a __wakeup() method to SplFixedArray, thereby fixing serialising an SplFixedArray object and bug #60560 (SplFixedArray un-/serialize, getSize(), count() return 0, keys are strings). 2012-02-21 18:34:42 +08:00
Update UPGRADING and make typo fixes to OCI8 package.xml 2013-07-26 01:54:03 +08:00
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Fixed numbering in UPGRADING file 2014-05-01 18:27:38 +08:00			`10. New Global Constants`
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Reset this document 2010-03-25 00:23:50 +08:00
NEWS and UPGRADING 2014-08-01 23:28:20 +08:00			`- Core`
NEWS and UPGRADING for intdiv() 2014-08-07 02:56:32 +08:00			`. PHP_INT_MIN added.`
Reset this document 2010-03-25 00:23:50 +08:00
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Fixed numbering in UPGRADING file 2014-05-01 18:27:38 +08:00			`11. Changes to INI File Handling`
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
- use TSRMLS_CC instead of TSRMLS_FETCH in virtual_file_ex 2010-08-30 17:38:47 +08:00
Add UPGRADING stubs for a number of recent changes 2014-10-06 04:06:34 +08:00			`- Core`
			`. Removed asp_tags ini directive. Trying to enable it will result in a fatal`
			`error.`

updated UPGRADING so far 2014-08-22 19:35:07 +08:00			`========================================`
			`12. Windows Support`
			`========================================`

			`- Core`
			`. Support for native 64 bit integers in 64 bit builds`
			`. Support for large files in 64 bit builds`
- upgrading entry for binary number format 2011-07-27 08:18:35 +08:00
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
updated UPGRADING so far 2014-08-22 19:35:07 +08:00			`13. Other Changes`
Align section headings with the latest (5.4) migration on-line doc. This will aid future reuse of UPGRADING text. 2012-03-06 04:14:04 +08:00			`========================================`
Removed Logo GUIDs and replaced with Data URIs and div hidden with JS - removed php_logo_guid() - removed php_egg_logo_guid() - removed php_real_logo_guid() - removed zend_logo_guid() - removed logo GUID handling - removed logo GUIDs from source - added logo data URIs instead for phpinfo() - added credits to phpinfo() page, but hidden by default 2012-07-15 04:44:21 +08:00
UPGRADING for Integer Semantics 2014-09-21 07:47:25 +08:00			`- Core`
			`. Instead of being undefined and platform-dependant, NaN and Infinity will`
			`always be zero when casted to integer.`
Updated NEWS and UPGRADING PHP RFC: Catchable "call to a member function of a non-object" 2014-10-06 05:54:32 +08:00			`. Calling a method on a non-object no longer raises a fatal error; see`
			`also: https://wiki.php.net/rfc/catchable-call-to-member-of-non-object`
UPGRADING for Integer Semantics 2014-09-21 07:47:25 +08:00
Remove call_user_method() and call_user_method_array() from master, long time deprecated in favour of call_user_func*(). 2014-04-05 12:43:41 +08:00			`- Standard`
			`. call_user_method() and call_user_method_array() no longer exists.`