2005-11-23 23:01:54 +08:00
|
|
|
$Id$
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
PHP 5.4 UPGRADE NOTES
|
|
|
|
|
|
|
|
===========
|
|
|
|
0. Contents
|
|
|
|
===========
|
|
|
|
|
|
|
|
1. Changes to INI directives
|
|
|
|
2. Changes to reserved words and classes
|
|
|
|
3. Changes to engine behavior
|
|
|
|
4. Changes to existing functions
|
|
|
|
5. Changes to existing classes
|
|
|
|
6. Changes to existing methods
|
|
|
|
7. Deprecated Functionality
|
|
|
|
8. Removed Functionality
|
|
|
|
a. Removed features
|
|
|
|
b. Removed functions
|
|
|
|
c. Removed syntax
|
|
|
|
d. Removed hash algorithms
|
|
|
|
9. Extension Changes:
|
|
|
|
a. Extensions no longer maintained
|
|
|
|
b. Extensions with changed behavior
|
2011-01-01 00:57:45 +08:00
|
|
|
10. Changes in SAPI support
|
2012-03-02 04:42:12 +08:00
|
|
|
11. Windows support
|
|
|
|
12. New in PHP 5.4:
|
|
|
|
a. New features
|
|
|
|
b. Syntax additions
|
|
|
|
c. New functions
|
|
|
|
d. New global constants
|
|
|
|
e. New classes
|
|
|
|
f. New methods
|
|
|
|
g. New class constants
|
|
|
|
h. New hash algorithms
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
=============================
|
|
|
|
1. Changes to INI directives
|
|
|
|
=============================
|
2009-06-25 05:16:53 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- The php.ini default_charset directive now defaults to UTF-8. If you
|
|
|
|
were relying on the previous default of ISO-88590-1, you will need
|
|
|
|
to add:
|
2009-06-15 03:15:57 +08:00
|
|
|
|
2010-03-25 00:23:50 +08:00
|
|
|
default_charset = iso-8859-1
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
to your php.ini to preserve pre-PHP 5.4 behavior.
|
2010-04-01 02:03:17 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- PHP 5.4 now checks at compile time if /dev/urandom or /dev/arandom
|
|
|
|
are present. If either is available, session.entropy_file now
|
|
|
|
defaults to that file and session.entropy_length defaults to 32.
|
|
|
|
This provides non-blocking entropy to session id generation. If you
|
|
|
|
do not want extra entropy for your session ids, add:
|
2010-04-01 02:03:17 +08:00
|
|
|
|
|
|
|
session.entropy_file=
|
|
|
|
session.entropy_length=0
|
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
to your php.ini to preserve pre-PHP 5.4 behavior.
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- Deprecated php.ini directives will now throw an E_CORE_WARNING's
|
2010-04-29 09:03:21 +08:00
|
|
|
instead of the previous E_WARNING's.
|
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- The following php.ini directives are marked as deprecated:
|
2010-04-29 09:03:21 +08:00
|
|
|
- magic_quotes_gpc
|
|
|
|
- magic_quotes_runtime
|
|
|
|
- magic_quotes_sybase
|
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- The following php.ini directives are no longer available in PHP 5.4
|
|
|
|
and will now throw an E_CORE_ERROR upon startup:
|
2010-04-29 09:03:21 +08:00
|
|
|
- allow_call_time_pass_reference
|
|
|
|
- define_syslog_variables
|
|
|
|
- highlight.bg
|
|
|
|
- register_globals
|
|
|
|
- register_long_arrays
|
|
|
|
- safe_mode
|
|
|
|
- safe_mode_gid
|
|
|
|
- safe_mode_include_dir
|
|
|
|
- safe_mode_exec_dir
|
|
|
|
- safe_mode_allowed_env_vars
|
|
|
|
- safe_mode_protected_env_vars
|
2012-03-02 04:42:12 +08:00
|
|
|
- session.bug_compat42
|
|
|
|
- session.bug_compat_warn
|
|
|
|
- y2k_compliance
|
2010-04-29 09:03:21 +08:00
|
|
|
- zend.ze1_compatibility_mode
|
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- the following new php.ini directives were added:
|
|
|
|
- max_input_vars - specifies how many GET/POST/COOKIE input
|
|
|
|
variables may be accepted. The default value is 1000.
|
2011-09-13 22:57:58 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
- E_ALL now includes E_STRICT.
|
|
|
|
|
|
|
|
- The recommended production value for error_reporting changed to E_ALL &
|
|
|
|
~E_DEPRECATED & ~E_STRICT.
|
|
|
|
|
|
|
|
- Added new session support directives:
|
|
|
|
session.upload_progress.enabled
|
|
|
|
session.upload_progress.cleanup
|
|
|
|
session.upload_progress.prefix
|
|
|
|
session.upload_progress.name
|
|
|
|
session.upload_progress.freq
|
|
|
|
session.upload_progress.min_freq
|
|
|
|
|
|
|
|
- Added a zend.multibyte directive as a replacement of the PHP compile time
|
|
|
|
configuration option --enable-zend-multibyte. Now the Zend Engine always
|
|
|
|
contains code for multibyte support, which can be enabled or disabled at
|
|
|
|
runtime. Note: It doesn't make a lot of sense to enable this option if
|
|
|
|
ext/mbstring is not enabled, because most functionality is implemented by
|
|
|
|
mbstrings callbacks.
|
|
|
|
|
|
|
|
- Added zend.script_encoding. This value will be used unless a
|
|
|
|
"declare(encoding=...)" directive appears at the top of the script.
|
|
|
|
|
|
|
|
- Added enable_post_data_reading, which is enabled by default. When it's
|
|
|
|
disabled, the POST data is not read (or processed); the behavior is similar
|
|
|
|
to that of other request methods with body, like PUT. This allows reading
|
|
|
|
the raw POST data in multipart requests and reading/processing the POST data
|
|
|
|
in a stream fashion (through php://input) without having it copied in memory
|
|
|
|
multiple times.
|
|
|
|
|
|
|
|
- Added windows_show_crt_warning. This directive shows the CRT warnings when
|
|
|
|
enabled. These warnings were displayed by default until now. It is disabled
|
|
|
|
by default.
|
|
|
|
|
|
|
|
- Added cli.pager to set a pager for CLI interactive shell output.
|
|
|
|
|
|
|
|
- Added cli.prompt to configure the CLI interactive shell prompt.
|
|
|
|
|
|
|
|
- Added cli_server.color to enable the CLI web server to use ANSI color coding
|
|
|
|
in terminal outout.
|
|
|
|
|
|
|
|
========================================
|
|
|
|
2. Changes to reserved words and classes
|
|
|
|
========================================
|
2009-06-25 15:57:05 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- "callable", "insteadof" and "trait" are now reserved words.
|
2009-06-25 15:57:05 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
=============================
|
|
|
|
3. Changes to engine behavior
|
|
|
|
=============================
|
2011-01-01 00:57:45 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- The __construct arguments of an extended abstract constructor must
|
|
|
|
now match:
|
2011-08-06 23:57:36 +08:00
|
|
|
|
|
|
|
abstract class Base
|
|
|
|
{
|
|
|
|
abstract public function __construct();
|
|
|
|
}
|
|
|
|
class Foo extends Base
|
|
|
|
{
|
|
|
|
public function __construct($bar) {}
|
|
|
|
}
|
2011-12-19 10:05:03 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
This now emits a Fatal error due the incompatible declaration.
|
2011-01-01 00:57:45 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- In previous versions, superglobal names could be used for parameter
|
|
|
|
names, thereby shadowing the corresponding superglobal. In PHP 5.4
|
|
|
|
this now causes a fatal error such as "Cannot re-assign auto-global
|
|
|
|
variable GLOBALS".
|
2011-09-07 23:28:12 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- Turning null, false or an empty string into an object by adding a
|
|
|
|
property will now emit a warning instead of an E_STRICT error.
|
2011-11-24 05:21:10 +08:00
|
|
|
|
|
|
|
$test = null;
|
|
|
|
$test->baz = 1;
|
|
|
|
|
|
|
|
To create a generic object you can use StdClass:
|
2012-03-02 02:27:47 +08:00
|
|
|
|
2011-11-24 05:21:10 +08:00
|
|
|
$test = new StdClass;
|
|
|
|
$test->baz = 1;
|
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- Converting an array to a string now will cause an E_NOTICE warning.
|
|
|
|
|
|
|
|
- Non-numeric string offsets, e.g. $a['foo'] where $a is a string, now
|
|
|
|
return false on isset() and true on empty(), and produce warning if
|
|
|
|
trying to use them. Offsets of types double, bool and null produce
|
|
|
|
notice. Numeric strings ($a['2']) still work as before.
|
2011-10-23 14:38:42 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
Note that offsets like '12.3' and '5 and a half' are considered
|
|
|
|
non-numeric and produce warning, but are converted to 12 and 5
|
2012-03-02 04:42:12 +08:00
|
|
|
respectively for backwards compatibility reasons.
|
2011-11-24 05:21:10 +08:00
|
|
|
|
|
|
|
- Closures now support scopes and $this and can be rebound to
|
|
|
|
objects using Closure::bind() and Closure::bindTo().
|
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- <?= is now always available regardless of the short_open_tag
|
|
|
|
setting.
|
2011-10-23 14:38:42 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- Parse error messages are changed to contain more information about
|
|
|
|
the error.
|
2011-10-23 14:38:42 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
================================
|
|
|
|
4. Changes to existing functions
|
|
|
|
================================
|
2009-06-26 02:01:08 +08:00
|
|
|
|
2010-08-27 11:54:10 +08:00
|
|
|
- array_combine now returns array() instead of FALSE when two empty arrays are
|
|
|
|
provided as parameters.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
|
|
|
- dns_get_record() has an extra parameter which allows requesting DNS records
|
|
|
|
by numeric type and makes the result include only the raw data of the
|
|
|
|
response.
|
|
|
|
|
|
|
|
- call_user_func_array() no longer allows call-time pass by reference.
|
|
|
|
|
|
|
|
- htmlentities() and htmlspecialchars() are stricter in the code units they
|
|
|
|
accept for the asian encodings. For Big5-HKSCS, the octets 0x80 and 0xFF are
|
|
|
|
rejected. For GB2312/EUC-CN, the octets 0x8E, 0x8F, 0xA0 and 0xFF are
|
|
|
|
rejected. For SJIS, the octets 0x80, 0xA0, 0xFD, 0xFE and 0xFF are rejected,
|
|
|
|
except maybe after a valid starting byte. For EUC-JP, the octets 0xA0 and
|
|
|
|
0xFF are rejected.
|
|
|
|
|
|
|
|
- htmlentities() now emits an E_STRICT warning when used with asian characters,
|
2010-10-25 00:21:15 +08:00
|
|
|
as in that case htmlentities has (and already had before this version) the
|
|
|
|
same functionality as htmlspecialchars.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
|
|
|
- htmlentities() no longer numerically encodes high characters for single-byte
|
2010-10-25 00:21:15 +08:00
|
|
|
encodings (except when there's actually a corresponding named entity). This
|
|
|
|
behavior was not documented and was inconsistent with that for "UTF-8".
|
2012-03-02 04:42:12 +08:00
|
|
|
|
|
|
|
- html_entity_decode() and htmlspecialchars_decode() behave more consistently,
|
|
|
|
now decoding entities in malformed strings such as "&&" or "&#&".
|
|
|
|
|
|
|
|
- htmlentities(), htmlspecialchars(), html_entity_decode(), and
|
|
|
|
htmlspecialchars_decode: Added the flags ENT_HTML401, ENT_XML1, ENT_XHTML,
|
|
|
|
and ENT_HTML5. The behavior of these functions including, but not limited to,
|
|
|
|
the characters that are encoded and the entities that are decoded depend on
|
|
|
|
the document type that is specified by those flags.
|
|
|
|
|
|
|
|
- htmlentities() and htmlspecialchars() with !$double_encode do more strict
|
|
|
|
checks on the validity of the entities. Numerical entities are checked for a
|
|
|
|
valid range (0 to 0x10FFFF); if the flag ENT_DISALLOWED is given, the
|
|
|
|
validity of such numerical entity in the target document type is also
|
|
|
|
checked. Named entities are checked for necessary existence in the target
|
|
|
|
document type instead of only checking whether they were constituted by
|
|
|
|
alphanumeric characters.
|
|
|
|
|
2011-01-20 06:41:01 +08:00
|
|
|
- The flag ENT_DISALLOWED was added. In addition to the behavior described in
|
2012-03-02 04:42:12 +08:00
|
|
|
the item before, it also makes htmlentities() and htmlspecialchars()
|
|
|
|
substitute characters that appear literally in the argument string and which
|
|
|
|
are not allowed in the target document type with U+FFFD (UTF-8) or �.
|
|
|
|
|
2010-10-25 00:21:15 +08:00
|
|
|
- The flag ENT_SUBSTITUTE was added. This flag makes invalid multibyte
|
2012-03-02 04:42:12 +08:00
|
|
|
sequences be replaced by U+FFFD (UTF-8) or &#FFFD; by htmlspecialchars() and
|
|
|
|
htmlentities(). It is an alternative to the default behavior, which just
|
2010-10-25 00:21:15 +08:00
|
|
|
returns an empty string and to ENT_IGNORE, which is a security risk. The
|
|
|
|
behavior follows the recommendations of Unicode Technical Report #36.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
|
|
|
- htmlspecialchars_decode() and html_entity_decode() now decode ' if the
|
|
|
|
document type is ENT_XML1, ENT_XHTML, or ENT_HTML5.
|
|
|
|
|
2011-01-25 18:57:07 +08:00
|
|
|
- Charset detection with $charset == '' no longer turns to mbstring's
|
|
|
|
internal encoding defined through mb_internal_encoding(). Only the encoding
|
2012-03-02 02:27:47 +08:00
|
|
|
defined through the php.ini setting mbstring.internal_encoding is considered.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2010-12-03 18:10:08 +08:00
|
|
|
- number_format() no longer truncates multibyte decimal points and thousand
|
|
|
|
separators to the first byte.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2010-11-05 12:37:27 +08:00
|
|
|
- The third parameter ($matches) to preg_match_all() is now optional. If
|
|
|
|
omitted, the function will simply return the number of times the pattern was
|
|
|
|
matched in the subject and will have no other side effects.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2010-11-26 17:52:28 +08:00
|
|
|
- The second argument of scandir() now accepts SCANDIR_SORT_NONE (2) as a
|
|
|
|
possible value. This value results in scandir() performing no sorting: on
|
|
|
|
local filesystems, this allows files to be returned in native filesystem
|
|
|
|
order.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2010-12-01 00:22:48 +08:00
|
|
|
- stream_select() now preserves the keys of the passed array, be they numeric or
|
|
|
|
strings. This breaks code that iterated the resulting stream array using a
|
|
|
|
numeric index, but makes easier to identify which of the passed streams are
|
|
|
|
present in the result.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-02-19 09:28:37 +08:00
|
|
|
- stream_set_write_buffer() no longer disables the read buffer of a plain
|
|
|
|
stream when 0 is given as the second argument.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-02-19 09:28:37 +08:00
|
|
|
- stream_set_write_buffer() no longer changes the chunk size in socket streams.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-03-21 10:58:54 +08:00
|
|
|
- fclose() closes streams with resource refcount > 1; it doesn't merely
|
|
|
|
decrement the resource refcount.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-04-06 18:17:52 +08:00
|
|
|
- socket_set_options() and socket_get_options() now support multicast options.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
|
|
|
- The raw data parameter in openssl_encrypt() and openssl_decrypt() is now an
|
|
|
|
options integer rather than a boolean. A value of true produces the same
|
|
|
|
behavior.
|
|
|
|
|
2011-07-12 12:58:38 +08:00
|
|
|
- Write operations within XSLT (for example with the extension sax:output) are
|
|
|
|
disabled by default. You can define what is forbidden with the method
|
2011-10-23 14:38:42 +08:00
|
|
|
XsltProcess::setSecurityPrefs($options).
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-10-23 14:38:42 +08:00
|
|
|
- Added AES support to OpenSSL.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-09-13 01:23:10 +08:00
|
|
|
- openssl_csr_new() expects the textual data to be in UTF-8.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
|
|
|
- Added no-padding option to openssl_encrypt() and openssl_decrypt().
|
|
|
|
|
2011-12-19 10:05:03 +08:00
|
|
|
- Added a "no_ticket" SSL context option to disable the SessionTicket TLS
|
2011-10-23 14:38:42 +08:00
|
|
|
extension.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-12-19 10:05:03 +08:00
|
|
|
- Added new json_encode() options: JSON_PRETTY_PRINT, JSON_UNESCAPED_SLASHES,
|
2011-10-23 14:38:42 +08:00
|
|
|
JSON_NUMERIC_CHECK, JSON_BIGINT_AS_STRING, JSON_UNESCAPED_UNICODE.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-10-23 14:38:42 +08:00
|
|
|
- Added Tokyo Cabinet and Berkley DB 5 support to DBA extension.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-10-23 14:38:42 +08:00
|
|
|
- Added support for CURLOPT_MAX_SEND_SPEED_LARGE and CURLOPT_MAX_RECV_SPEED_LARGE
|
|
|
|
to cURL.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-12-19 10:05:03 +08:00
|
|
|
- Added optional argument to debug_backtrace() and debug_print_backtrace()
|
2011-10-23 14:38:42 +08:00
|
|
|
to limit the amount of stack frames returned.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-11-25 06:45:50 +08:00
|
|
|
- Fixed crypt_blowfish handling of 8-bit characters. crypt() in Blowfish mode
|
2011-12-19 10:05:03 +08:00
|
|
|
now supports hashes marked $2a$, $2x$, $2y$ and $2z$.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-12-19 10:05:03 +08:00
|
|
|
- mbstring now supports following encodings: Shift_JIS/UTF-8 Emoji,
|
|
|
|
JIS X0213:2004 (Shift_JIS-2004, EUC-JP-2004, ISO-2022-JP-2004),
|
2011-10-23 14:38:42 +08:00
|
|
|
MacJapanese (Shift_JIS), gb18030.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
|
|
|
- Added encode and decode in hex format to mb_encode_numericentity() and
|
|
|
|
mb_decode_numericentity().
|
|
|
|
|
|
|
|
- Added support for SORT_NATURAL and SORT_FLAG_CASE in array sort functions:
|
|
|
|
sort(), rsort(), ksort(), krsort(), asort(), arsort() and array_multisort().
|
|
|
|
|
2011-11-10 05:43:07 +08:00
|
|
|
- is_a() and is_subclass_of() now have third boolean parameter, which specifies
|
|
|
|
if the first argument can be a string class name. Default if false for is_a
|
|
|
|
and true for is_subclass_of() for BC reasons.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-11-11 21:13:16 +08:00
|
|
|
- ob_start() will now treat a chunk size of 1 as meaning 1 byte, rather than
|
2012-03-02 04:42:12 +08:00
|
|
|
the previous special case behavior of treating it as 4096 bytes.
|
|
|
|
|
2011-11-25 06:45:50 +08:00
|
|
|
- idn_to_ascii() and idn_to_utf8() now take two extra parameters, one indicating
|
|
|
|
the variant (IDNA 2003 or UTS #46) and another, passed by reference, to return
|
|
|
|
details about the operation in case UTS #46 is chosen.
|
2009-06-26 02:01:08 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
- gzencode() used with FORCE_DEFLATE now generates RFC1950 compliant data.
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
- ob_start() no longer starts multiple output buffers when passed
|
|
|
|
array("callback1", "callback2", "callback3", ...).
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
==============================
|
|
|
|
5. Changes to existing classes
|
|
|
|
==============================
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2011-02-17 08:25:32 +08:00
|
|
|
- Classes that implement stream wrappers can define a method called
|
|
|
|
stream_truncate that will respond to truncation, e.g. through ftruncate.
|
|
|
|
Strictly speaking, this is an addition to the user-space stream wrapper
|
|
|
|
template, not a change to an actual class.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
|
|
|
- Classes that implement stream wrappers can define a method called
|
|
|
|
stream_metadata that will be called on touch(), chmod(), chgrp(), chown().
|
|
|
|
|
2011-10-23 14:38:42 +08:00
|
|
|
- Arrays cast from SimpleXMLElement now always contain all nodes instead of
|
|
|
|
just the first matching node.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-10-23 14:38:42 +08:00
|
|
|
- All SimpleXMLElement children are now always printed when using var_dump(),
|
|
|
|
var_export(), and print_r().
|
2012-03-02 04:42:12 +08:00
|
|
|
|
2011-10-23 14:38:42 +08:00
|
|
|
- Added iterator support in MySQLi. mysqli_result implements Traversable.
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
==============================
|
|
|
|
6. Changes to existing methods
|
|
|
|
==============================
|
|
|
|
|
|
|
|
- DateTime::parseFromFormat() now has a "+" modifier to allow trailing text in
|
|
|
|
the string to parse without throwing an error.
|
|
|
|
|
|
|
|
- Added the ability to pass options to DOMDocument::loadHTML().
|
|
|
|
|
|
|
|
- FilesystemIterator, GlobIterator and (Recursive)DirectoryIterator now use
|
|
|
|
the default stream context.
|
|
|
|
|
|
|
|
===========================
|
|
|
|
7. Deprecated Functionality
|
|
|
|
===========================
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
- The following functions are deprecated in PHP 5.4:
|
2012-03-02 04:42:12 +08:00
|
|
|
- get_magic_quotes_gpc(): now always returns false
|
|
|
|
- get_magic_quotes_runtime(): now always returns false
|
|
|
|
- mcrypt_generic_end(): use mcrypt_generic_deinit() instead
|
2012-03-02 02:27:47 +08:00
|
|
|
- mysql_list_dbs()
|
2011-10-23 14:38:42 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
========================
|
|
|
|
8. Removed Functionality
|
|
|
|
========================
|
|
|
|
|
|
|
|
a. Removed features
|
|
|
|
|
|
|
|
The following features have been removed from PHP 5.4:
|
|
|
|
|
|
|
|
- Magic quotes
|
|
|
|
- Register globals
|
|
|
|
- Safe mode
|
|
|
|
- Session extension bug compatibility mode
|
|
|
|
- Y2K compliance mode
|
|
|
|
|
|
|
|
b. Removed functions
|
|
|
|
|
|
|
|
The following functions are no longer available in PHP 5.4:
|
|
|
|
|
|
|
|
- define_syslog_variables()
|
|
|
|
- import_request_variables()
|
|
|
|
- session_is_registered()
|
|
|
|
- session_register()
|
|
|
|
- session_unregister()
|
|
|
|
- set_magic_quotes_runtime()
|
|
|
|
- mysqli_bind_param() (alias of mysqli_stmt_bind_param())
|
|
|
|
- mysqli_bind_result() (alias of mysqli_stmt_bind_result())
|
|
|
|
- mysqli_client_encoding() (alias of mysqli_character_set_name())
|
|
|
|
- mysqli_fetch() (alias of mysqli_stmt_fetch())
|
|
|
|
- mysqli_param_count() (alias of mysqli_stmt_param_count())
|
|
|
|
- mysqli_get_metadata() (alias of mysqli_stmt_result_metadata())
|
|
|
|
- mysqli_send_long_data() (alias of mysqli_stmt_send_long_data())
|
|
|
|
- mysqli::client_encoding() (alias of mysqli::character_set_name)
|
|
|
|
- mysqli_stmt::stmt() (never worked/always throws, undocumented)
|
|
|
|
|
|
|
|
c. Removed syntax
|
|
|
|
|
|
|
|
- break $var;
|
|
|
|
- continue $var;
|
|
|
|
|
|
|
|
d. Removed hash algorithms
|
|
|
|
|
|
|
|
- Salsa10 and Salsa20, which are actually stream ciphers
|
|
|
|
|
|
|
|
====================
|
|
|
|
9. Extension Changes
|
|
|
|
====================
|
|
|
|
|
|
|
|
a. Extensions no longer maintained
|
|
|
|
|
2012-03-02 05:08:56 +08:00
|
|
|
- ext/sqlite is no longer part of the base distribution and has been moved
|
|
|
|
to PECL. Use sqlite3 or PDO_SQLITE instead.
|
2012-03-02 04:42:12 +08:00
|
|
|
|
|
|
|
b. Extensions with changed behavior
|
|
|
|
|
|
|
|
- The MySQL extensions (ext/mysql, mysqli and PDO_MYSQL) use mysqlnd
|
|
|
|
as the default library now. It is still possible to use libmysql by
|
|
|
|
specifying a path to the configure options.
|
|
|
|
|
|
|
|
- PDO_MYSQL: Support for linking with MySQL client libraries older
|
|
|
|
than 4.1 is removed.
|
|
|
|
|
|
|
|
- The session extension now can hook into the file upload feature
|
|
|
|
in order to provide upload progress information through session
|
|
|
|
variables.
|
|
|
|
|
|
|
|
- SNMP extension
|
|
|
|
- Functions in SNMP extension now returns FALSE on every error
|
|
|
|
condition including SNMP-related (no such instance, end of MIB,
|
|
|
|
etc). Thus, in patricular, breaks previous behavior of get/walk
|
|
|
|
functions returning an empty string on SNMP-related errors.
|
|
|
|
- Multi OID get/getnext/set queries are now supported.
|
|
|
|
- New constants added for use in snmp_set_oid_output_format()
|
|
|
|
function.
|
|
|
|
- Function snmp_set_valueretrieval() changed it's behavior:
|
|
|
|
SNMP_VALUE_OBJECT can be combined with one of
|
|
|
|
SNMP_VALUE_PLAIN or SNMP_VALUE_LIBRARY resulting OID value
|
|
|
|
changes. When no SNMP_VALUE_PLAIN or SNMP_VALUE_LIBRARY
|
|
|
|
is supplied with SNMP_VALUE_OBJECT, SNMP_VALUE_LIBRARY is used.
|
|
|
|
Prior to 5.4.0 when no SNMP_VALUE_PLAIN or SNMP_VALUE_LIBRARY
|
|
|
|
was supplied with SNMP_VALUE_OBJECT, SNMP_VALUE_PLAIN was used.
|
|
|
|
- Added feature-rich OO API (SNMP class)
|
|
|
|
- Dropped UCD-SNMP compatibility code. Consider upgrading to
|
|
|
|
net-snmp v5.3+. Net-SNMP v5.4+ is required for Windows version.
|
|
|
|
- In sake of adding support for IPv6 DNS name resolution of
|
|
|
|
remote SNMP agent (peer) is done by extension now, not by Net-SNMP
|
|
|
|
library anymore.
|
|
|
|
|
|
|
|
- Date extension
|
|
|
|
- Setting the timezone with the TZ environment variable is no longer
|
|
|
|
supported, instead date.timezone and/or date_default_timezone_set()
|
|
|
|
have to be used.
|
|
|
|
- The extension will no longer guess the default timezone if none
|
|
|
|
is set with date.timezone and/or date_default_timezone_set().
|
|
|
|
Instead it will always fall back to "UTC".
|
2009-06-26 02:17:52 +08:00
|
|
|
|
2012-03-02 02:27:47 +08:00
|
|
|
===========================
|
2011-01-01 00:57:45 +08:00
|
|
|
10. Changes in SAPI support
|
2012-03-02 02:27:47 +08:00
|
|
|
===========================
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
- A REQUEST_TIME_FLOAT value returns a floating point number indicating the
|
|
|
|
time with microsecond precision. All SAPIs providing this value should be
|
|
|
|
returning float and not time_t.
|
|
|
|
|
2011-12-19 10:05:03 +08:00
|
|
|
- apache_child_terminate(), getallheaders(), apache_request_headers()
|
2012-03-02 04:42:12 +08:00
|
|
|
and apache_response_headers() are now supported on FastCGI.
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
- The interactive shell allows a shortcut #inisetting=value to change php.ini
|
|
|
|
settings at run-time.
|
2005-11-23 07:49:13 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
- The interactive shell now works with the shared readline extension.
|
2009-06-27 21:23:03 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
- The interactive shell no longer terminates on fatal errors.
|
|
|
|
|
|
|
|
- A new PHP CLI command line option --rz <name> shows information about the
|
|
|
|
named Zend extension.
|
2011-10-23 14:38:42 +08:00
|
|
|
|
2009-01-29 01:23:28 +08:00
|
|
|
===================
|
2012-03-02 04:42:12 +08:00
|
|
|
11. Windows support
|
2009-01-29 01:23:28 +08:00
|
|
|
===================
|
|
|
|
|
2011-12-19 10:05:03 +08:00
|
|
|
- is_link now works properly for symbolic links on Windows Vista
|
2010-09-01 18:23:58 +08:00
|
|
|
or later. Earlier systems do not support symbolic links.
|
2009-01-29 01:23:28 +08:00
|
|
|
|
2012-03-02 04:42:12 +08:00
|
|
|
==================
|
|
|
|
12. New in PHP 5.4
|
|
|
|
==================
|
|
|
|
|
|
|
|
a. New Features
|
|
|
|
|
|
|
|
- A built-in CLI web server for testing purposes is now available:
|
|
|
|
$ php -S 127.0.0.1:8888
|
|
|
|
|
|
|
|
b. Syntax additions
|
|
|
|
|
|
|
|
- Traits:
|
|
|
|
trait HelloWorld {
|
|
|
|
public function sayHello() {
|
|
|
|
echo 'Hello World!';
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
class CanIGetHello {
|
|
|
|
use HelloWorld;
|
|
|
|
}
|
|
|
|
|
|
|
|
$hello = new CanIGetHello();
|
|
|
|
$hello->sayHello();
|
|
|
|
|
|
|
|
- Function call result array access, e.g.:
|
|
|
|
foo()[0]
|
|
|
|
$foo->bar()[0]
|
|
|
|
|
|
|
|
- Callable typehint indicating argument must be callable:
|
|
|
|
function foo(callable $do) {
|
|
|
|
}
|
|
|
|
foo("strcmp");
|
|
|
|
foo(function() {});
|
|
|
|
$o = new ArrayObject();
|
|
|
|
foo(array($o, "count"));
|
|
|
|
|
|
|
|
- Short array syntax:
|
|
|
|
$a = [1, 2, 3, 4];
|
|
|
|
$a = ['one' => 1, 'two' => 2, 'three' => 3, 'four' => 4];
|
|
|
|
$a = ['one' => 1, 2, 'three' => 3, 4];
|
|
|
|
|
|
|
|
- Binary number format:
|
|
|
|
0b00100 0b010101
|
|
|
|
|
|
|
|
- Chained string array offsets now work.
|
|
|
|
$a = "abc";
|
|
|
|
echo $a[0][0];
|
|
|
|
|
|
|
|
- Anonymous functions now support using $this and class scope.
|
|
|
|
Anonymous function can be declared as "static" to ignore the scope.
|
|
|
|
|
|
|
|
- Class::{expr}() syntax is now supported:
|
|
|
|
class A {
|
|
|
|
static function foo() {
|
|
|
|
echo "Hello world!\n";
|
|
|
|
}
|
|
|
|
}
|
|
|
|
$x = "f";
|
|
|
|
$y = "o";
|
|
|
|
A::{$x.$y.$y}();
|
|
|
|
|
|
|
|
- Class member access on instantiation:
|
|
|
|
(new foo)->method()
|
|
|
|
(new foo)->property
|
|
|
|
(new foo)[0]
|
|
|
|
|
|
|
|
|
|
|
|
c. New functions
|
|
|
|
|
|
|
|
- Core:
|
|
|
|
- get_declared_traits()
|
|
|
|
- getimagesizefromstring()
|
|
|
|
- hex2bin()
|
|
|
|
- header_register_callback()
|
|
|
|
- http_response_code()
|
|
|
|
- stream_set_chunk_size()
|
|
|
|
- socket_import_stream()
|
|
|
|
- trait_exists()
|
|
|
|
|
|
|
|
- Intl:
|
|
|
|
- transliterator_create()
|
|
|
|
- transliterator_create_from_rules()
|
|
|
|
- transliterator_create_inverse()
|
|
|
|
- transliterator_get_error_code()
|
|
|
|
- transliterator_get_error_message()
|
|
|
|
- transliterator_list_ids()
|
|
|
|
- transliterator_transliterate()
|
|
|
|
|
|
|
|
- LDAP:
|
|
|
|
- ldap_control_paged_results()
|
|
|
|
- ldap_control_paged_results_response()
|
|
|
|
|
|
|
|
- libxml:
|
|
|
|
- libxml_set_external_entity_loader()
|
|
|
|
|
|
|
|
- mysqli:
|
|
|
|
- mysqli_error_list()
|
|
|
|
- mysqli_stmt_error_list()
|
|
|
|
|
|
|
|
- Session:
|
|
|
|
- session_register_shutdown()
|
|
|
|
- session_status()
|
|
|
|
|
|
|
|
- SPL
|
|
|
|
- class_uses()
|
|
|
|
|
|
|
|
d. New global constants
|
|
|
|
|
|
|
|
- CURLOPT_MAX_RECV_SPEED_LARGE
|
|
|
|
- CURLOPT_MAX_SEND_SPEED_LARGE
|
|
|
|
- ENT_DISALLOWED
|
|
|
|
- ENT_HTML401
|
|
|
|
- ENT_HTML5
|
|
|
|
- ENT_SUBSTITUTE
|
|
|
|
- ENT_XHTML
|
|
|
|
- ENT_XML1
|
|
|
|
- IPPROTO_IP
|
|
|
|
- IPPROTO_IPV6
|
|
|
|
- IPV6_MULTICAST_HOPS
|
|
|
|
- IPV6_MULTICAST_IF
|
|
|
|
- IPV6_MULTICAST_LOOP
|
|
|
|
- IP_MULTICAST_IF
|
|
|
|
- IP_MULTICAST_LOOP
|
|
|
|
- IP_MULTICAST_TTL
|
|
|
|
- JSON_BIGINT_AS_STRING
|
|
|
|
- JSON_OBJECT_AS_ARRAY
|
|
|
|
- JSON_PRETTY_PRINT
|
|
|
|
- JSON_UNESCAPED_SLASHES
|
|
|
|
- JSON_UNESCAPED_UNICODE
|
|
|
|
- LIBXML_HTML_NODEFDTD
|
|
|
|
- LIBXML_HTML_NOIMPLIED
|
|
|
|
- LIBXML_PEDANTIC
|
|
|
|
- MCAST_JOIN_GROUP
|
|
|
|
- MCAST_LEAVE_GROUP
|
|
|
|
- MCAST_BLOCK_SOURCE
|
|
|
|
- MCAST_UNBLOCK_SOURCE
|
|
|
|
- MCAST_JOIN_SOURCE_GROUP
|
|
|
|
- MCAST_LEAVE_SOURCE_GROUP
|
|
|
|
- OPENSSL_CIPHER_AES_128_CBC
|
|
|
|
- OPENSSL_CIPHER_AES_192_CBC
|
|
|
|
- OPENSSL_CIPHER_AES_256_CBC
|
|
|
|
- OPENSSL_RAW_DATA
|
|
|
|
- OPENSSL_ZERO_PADDING
|
|
|
|
- PHP_OUTPUT_HANDLER_CLEAN
|
|
|
|
- PHP_OUTPUT_HANDLER_CLEANABLE
|
|
|
|
- PHP_OUTPUT_HANDLER_DISABLED
|
|
|
|
- PHP_OUTPUT_HANDLER_FINAL
|
|
|
|
- PHP_OUTPUT_HANDLER_FLUSH
|
|
|
|
- PHP_OUTPUT_HANDLER_FLUSHABLE
|
|
|
|
- PHP_OUTPUT_HANDLER_REMOVABLE
|
|
|
|
- PHP_OUTPUT_HANDLER_STARTED
|
|
|
|
- PHP_OUTPUT_HANDLER_STDFLAGS
|
|
|
|
- PHP_OUTPUT_HANDLER_WRITE
|
|
|
|
- PHP_QUERY_RFC1738
|
|
|
|
- PHP_QUERY_RFC3986
|
|
|
|
- PHP_SESSION_ACTIVE
|
|
|
|
- PHP_SESSION_DISABLED
|
|
|
|
- PHP_SESSION_NONE
|
|
|
|
- SCANDIR_SORT_ASCENDING
|
|
|
|
- SCANDIR_SORT_DESCENDING
|
|
|
|
- SCANDIR_SORT_NONE
|
|
|
|
- SORT_FLAG_CASE
|
|
|
|
- SORT_NATURAL
|
|
|
|
- STREAM_META_ACCESS
|
|
|
|
- STREAM_META_GROUP
|
|
|
|
- STREAM_META_GROUP_NAME
|
|
|
|
- STREAM_META_OWNER
|
|
|
|
- STREAM_META_OWNER_NAME
|
|
|
|
- STREAM_META_TOUCH
|
|
|
|
- T_CALLABLE
|
|
|
|
- T_INSTEADOF
|
|
|
|
- T_TRAIT
|
|
|
|
- T_TRAIT_C
|
|
|
|
- ZLIB_ENCODING_DEFLATE
|
|
|
|
- ZLIB_ENCODING_GZIP
|
|
|
|
- ZLIB_ENCODING_RAW
|
|
|
|
- U_IDNA_DOMAIN_NAME_TOO_LONG_ERROR
|
|
|
|
- IDNA_CHECK_BIDI
|
|
|
|
- IDNA_CHECK_CONTEXTJ
|
|
|
|
- IDNA_NONTRANSITIONAL_TO_ASCII
|
|
|
|
- IDNA_NONTRANSITIONAL_TO_UNICODE
|
|
|
|
- INTL_IDNA_VARIANT_2003
|
|
|
|
- INTL_IDNA_VARIANT_UTS46
|
|
|
|
- IDNA_ERROR_EMPTY_LABEL
|
|
|
|
- IDNA_ERROR_LABEL_TOO_LONG
|
|
|
|
- IDNA_ERROR_DOMAIN_NAME_TOO_LONG
|
|
|
|
- IDNA_ERROR_LEADING_HYPHEN
|
|
|
|
- IDNA_ERROR_TRAILING_HYPHEN
|
|
|
|
- IDNA_ERROR_HYPHEN_3_4
|
|
|
|
- IDNA_ERROR_LEADING_COMBINING_MARK
|
|
|
|
- IDNA_ERROR_DISALLOWED
|
|
|
|
- IDNA_ERROR_PUNYCODE
|
|
|
|
- IDNA_ERROR_LABEL_HAS_DOT
|
|
|
|
- IDNA_ERROR_INVALID_ACE_LABEL
|
|
|
|
- IDNA_ERROR_BIDI
|
|
|
|
- IDNA_ERROR_CONTEXTJ
|
|
|
|
|
|
|
|
e. New classes
|
|
|
|
|
|
|
|
- Reflection:
|
|
|
|
- ReflectionZendExtension
|
|
|
|
|
|
|
|
- Intl:
|
|
|
|
- Transliterator
|
|
|
|
- Spoofchecker
|
|
|
|
|
|
|
|
- JSON:
|
|
|
|
- JsonSerializable
|
|
|
|
|
|
|
|
- Session:
|
|
|
|
- SessionHandler
|
|
|
|
|
|
|
|
- SNMP:
|
|
|
|
- SNMP
|
|
|
|
|
|
|
|
- SPL:
|
|
|
|
- CallbackFilterIterator
|
|
|
|
- RecursiveCallbackFilterIterator
|
|
|
|
|
|
|
|
f. New methods
|
|
|
|
|
|
|
|
- Closure:
|
|
|
|
- Closure::bind()
|
|
|
|
- Closure::bindTo()
|
|
|
|
|
|
|
|
- Reflection:
|
|
|
|
- ReflectionClass::getTraitAliases()
|
|
|
|
- ReflectionClass::getTraitNames()
|
|
|
|
- ReflectionClass::getTraits()
|
|
|
|
- ReflectionClass::isCloneable()
|
|
|
|
- ReflectionClass::isTrait()
|
|
|
|
- ReflectionClass::newInstanceWithoutConstructor()
|
|
|
|
- ReflectionExtension::isPersistent()
|
|
|
|
- ReflectionExtension::isTemporary()
|
|
|
|
- ReflectionFunction::getClosure()
|
|
|
|
- ReflectionFunction::getClosureScopeClass()
|
|
|
|
- ReflectionFunction::getClosureThis()
|
|
|
|
- ReflectionFunctionAbstract::getClosureScopeClass()
|
|
|
|
- ReflectionFunctionAbstract::getClosureThis()
|
|
|
|
- ReflectionMethod::getClosure()
|
|
|
|
- ReflectionMethod::getClosureScopeClass()
|
|
|
|
- ReflectionMethod::getClosureThis()
|
|
|
|
- ReflectionObject::getTraitAliases()
|
|
|
|
- ReflectionObject::getTraitNames()
|
|
|
|
- ReflectionObject::getTraits()
|
|
|
|
- ReflectionObject::isCloneable()
|
|
|
|
- ReflectionObject::isTrait()
|
|
|
|
- ReflectionObject::newInstanceWithoutConstructor()
|
|
|
|
- ReflectionParameter::canBePassedByValue()
|
|
|
|
- ReflectionParameter::isCallable()
|
|
|
|
|
|
|
|
- PDO_DBLIB:
|
|
|
|
- PDO::newRowset()
|
|
|
|
|
|
|
|
- SPL:
|
|
|
|
- DirectoryIterator::getExtension()
|
|
|
|
- RegexIterator::getRegex()
|
|
|
|
- SplDoublyLinkedList::serialize()
|
|
|
|
- SplDoublyLinkedList::unserialize()
|
|
|
|
- SplFileInfo::getExtension()
|
|
|
|
- SplFileObject::fputcsv()
|
|
|
|
- SplObjectStorage::getHash()
|
|
|
|
- SplQueue::serialize
|
|
|
|
- SplQueue::unserialize
|
|
|
|
- SplStack::serialize
|
|
|
|
- SplStack::unserialize
|
|
|
|
- SplTempFileObject::fputcsv
|
|
|
|
|
|
|
|
- XSLT:
|
|
|
|
- XsltProcessor::setSecurityPrefs()
|
|
|
|
- XsltProcessor::getSecurityPrefs()
|
|
|
|
|
|
|
|
g. New class constants
|
|
|
|
|
|
|
|
- PDO:
|
|
|
|
- PDO::MYSQL_ATTR_SSL_CA
|
|
|
|
- PDO::MYSQL_ATTR_SSL_CAPATH
|
|
|
|
- PDO::MYSQL_ATTR_SSL_CERT
|
|
|
|
- PDO::MYSQL_ATTR_SSL_CIPHER
|
|
|
|
- PDO::MYSQL_ATTR_SSL_KEY
|
|
|
|
|
|
|
|
h. New Hash algorithms
|
|
|
|
|
|
|
|
- fnv132
|
|
|
|
- fnv164
|
|
|
|
- joaat
|