php-src/UPGRADING.INTERNALS

$Id$

UPGRADE NOTES - PHP X.Y

1. Internal API changes
  a. Addition of do_operation and compare object handlers
  b. return_value_ptr now always available, RETVAL_ZVAL_FAST macros
  c. POST data handling
  d. Arginfo changes

2. Build system changes
  a. Unix build system changes
  b. Windows build system changes


========================
1. Internal API changes
========================

  a. zend_set_memory_limit() now takes the TSRMLS_CC macro as its last argument


========================
2. Build system changes
========================
- initial import, internals upgrade guide 2010-08-30 18:26:31 +08:00			$Id$

			`UPGRADE NOTES - PHP X.Y`

			`1. Internal API changes`
Update NEWS, UPGRADING and UPGRADING.INTERNALS 2013-06-18 00:27:22 +08:00			`a. Addition of do_operation and compare object handlers`
Always pass return_value_ptr to internal functions Previous some places passed return_value_ptr only if the function returned by reference. Now return_value_ptr is always set, even for functions returning by-value. This allows you to return zvals without copying their contents. For this purpose two new macros RETVAL_ZVAL_FAST and RETURN_ZVAL_FAST are added: RETVAL_ZVAL_FAST(zv); /* Analog to RETVAL_ZVAL(zv, 1, 0) / RETURN_ZVAL_FAST(zv); / Analog to RETURN_ZVAL(zv, 1, 0) */ These macros behave similarly to the non-FAST versions with copy=1 and dtor=0, with the difference that the FAST versions will try return the zval without copying by utilizing return_value_ptr. 2013-08-27 01:06:36 +08:00			`b. return_value_ptr now always available, RETVAL_ZVAL_FAST macros`
NEWS/UPGRADING{,.INTERNALS} notes about temp POST stream 2013-09-17 17:08:23 +08:00			`c. POST data handling`
Implement variadic function syntax As per RFC: https://wiki.php.net/rfc/variadics 2013-09-27 00:39:17 +08:00			`d. Arginfo changes`
- drop TSRMLS_FETCH in sapi_register_* (won't bring much at runtime :) ) and cleanup/group the upgrade guide, no need of twenty titles for the same change 2010-09-17 16:42:12 +08:00
- Added section for build system changes in UPGRADING.INTERNALS 2010-11-18 18:43:01 +08:00			`2. Build system changes`
			`a. Unix build system changes`
			`b. Windows build system changes`


- initial import, internals upgrade guide 2010-08-30 18:26:31 +08:00			`========================`
			`1. Internal API changes`
			`========================`

Eliminated the TSRMLS_FETCH() in zend_set_memory_limit() 2013-11-18 08:36:17 +08:00			`a. zend_set_memory_limit() now takes the TSRMLS_CC macro as its last argument`

Implement variadic function syntax As per RFC: https://wiki.php.net/rfc/variadics 2013-09-27 00:39:17 +08:00
- Added section for build system changes in UPGRADING.INTERNALS 2010-11-18 18:43:01 +08:00			`========================`
			`2. Build system changes`
			`========================`