php-src/UPGRADING

PHP 8.5 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 and SAPIs
9. Other Changes to Extensions
10. New Global Constants
11. Changes to INI File Handling
12. Windows Support
13. Other Changes
14. Performance Improvements

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

- BZ2:
  . bzcompress() now throws a ValueError when $block_size is not between
    1 and 9.
  . bzcompress() now throws a ValueError when work_factor is not between
    0 and 250.

- LDAP:
  . ldap_get_option() and ldap_set_option() now throw a ValueError when
    passing an invalid option.

- SPL:
  . ArrayObject no longer accepts enums, as modifying the $name or $value
    properties can break engine assumptions.

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

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

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

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

- PDO_PGSQL:
  . PDO::pgsqlCopyFromArray also supports inputs as Iterable.

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

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

========================================
8. Removed Extensions and SAPIs
========================================

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

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

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

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

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

========================================
14. Performance Improvements
========================================
Prepare for PHP 8.4 2024-09-24 23:03:39 +08:00			`PHP 8.5 UPGRADE NOTES`
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`
			`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`
updated UPGRADING 2015-02-10 15:56:18 +08:00			`8. Removed Extensions and SAPIs`
Fixed numbering in UPGRADING file 2014-05-01 18:27:38 +08:00			`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`
Clear NEWS, UPGRADING and UPGRADING.INTERNALS 2019-01-28 17:34:31 +08:00			`13. Other Changes`
			`14. Performance Improvements`
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			`========================================`
Forbid dynamic calls to scope introspection functions Per RFC: https://wiki.php.net/rfc/forbid_dynamic_scope_introspection 2016-04-25 05:49:52 +08:00
ext/bz2: Check int params of bzcompress() are correct (#16108) Also add a TODO to check the length of the source strings 2024-09-29 05:38:53 +08:00			`- BZ2:`
			`. bzcompress() now throws a ValueError when $block_size is not between`
			`1 and 9.`
			`. bzcompress() now throws a ValueError when work_factor is not between`
			`0 and 250.`

ext/ldap: Throw a ValueError when passing an unknown option 2024-09-28 07:33:53 +08:00			`- LDAP:`
			`. ldap_get_option() and ldap_set_option() now throw a ValueError when`
			`passing an invalid option.`

Disallow enums in ArrayObject Closes GH-15775 2024-09-06 18:31:06 +08:00			`- SPL:`
			`. ArrayObject no longer accepts enums, as modifying the $name or $value`
			`properties can break engine assumptions.`

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
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
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
ext/pdo_pgsql: Expanding COPY input from an array to an iterable close GH-15893 2024-09-15 15:57:18 +08:00			`- PDO_PGSQL:`
			`. PDO::pgsqlCopyFromArray also supports inputs as Iterable.`

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`
[ci skip] Fix formatting in UPGRADING - Remove `k` typo that was accidentally added in a headline separator. - Remove premature hard break after very short line length. - Remove dots at the end of constant lists (not used in 8.2). 2022-09-05 02:59:26 +08:00			`========================================`
[ci skip] NEWS UPGRADING 2022-09-05 02:52:21 +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			`========================================`
updated UPGRADING 2015-02-10 15:56:18 +08:00			`8. Removed Extensions and SAPIs`
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			`========================================`
Update NEWS and UPGRADING 2016-07-03 18:43:30 +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
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
updated UPGRADING so far 2014-08-22 19:35:07 +08:00			`========================================`
			`12. Windows Support`
			`========================================`

Document pkg-config related changes Creating a separate section in UPGRADING for this, as there are a lot of these, and there's going to be more of them. 2019-01-15 17:13:39 +08:00			`========================================`
Clear NEWS, UPGRADING and UPGRADING.INTERNALS 2019-01-28 17:34:31 +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			`========================================`
Add performance improvement section to UPGRADING [ci skip] 2018-12-27 05:26:01 +08:00
			`========================================`
Clear NEWS, UPGRADING and UPGRADING.INTERNALS 2019-01-28 17:34:31 +08:00			`14. Performance Improvements`
Add performance improvement section to UPGRADING [ci skip] 2018-12-27 05:26:01 +08:00			`========================================`