文字
Backward Incompatible Changes
Although most existing PHP 5 code should work without changes, you should pay attention to the following backward incompatible changes:
- getrusage() returns
NULLwhen passed incompatible arguments as of PHP 5.2.1. - ZipArchive::setCommentName()
returns
TRUEon success as of PHP 5.2.1. - ZipArchive::setCommentIndex()
returns
TRUEon success as of PHP 5.2.1. - SplFileObject::getFilename() returns the filename, not relative/path/to/file, as of PHP 5.2.1.
- Changed priority of PHPRC environment variable on Win32 The PHPRC environment variable now takes priority over the path stored in the Windows registry.
- CLI SAPI no longer checks cwd for php.ini or the php-cli.ini file In PHP 5.1.x an undocumented feature was added that made the CLI binary check the current working directory for a PHP configuration file, potentially leading to unpredictable behavior if an unexpected configuration file were read. This functionality was removed in 5.2.0, and PHP will no longer search CWD for the presence of php.ini or php-cli.ini files. See also the command line section of the manual.
-
Added a warning when performing modulus 0 operations
In earlier versions of PHP, performing integer % 0 did not emit any
warning messages, instead returning an unexpected return value of
FALSE. As of PHP 5.2.0, this operation will emit anE_WARNING, as is the case in all other instances where division by zero is performed.<?php
print 10 % 0 ;
?> -
Changed __toString() to be called wherever
applicable.
The magic method __toString() will now be called
in a string context, that is, anywhere an object is used as a
string.
The fallback of returning a string that contains the
object identifier was dropped in PHP 5.2.0. It became
problematic because an object identifier cannot be considered
unique. This change will mean that your application is flawed if you
have relied on the object identifier as a return value. An attempt
to use that value as a string will now result in a catchable fatal
error.
Even with __toString(), objects cannot be used as array indices or keys. We may add built-in hash support for this at a later date, but as of PHP 5.2.x you will need to either provide your own hashing or use the new SPL function spl_object_hash() . Exceptions can not be thrown from __toString() methods.
<?php
class foo {}
$foo = new foo ;
print $foo ;
?><?php
class foo {
public function __toString () {
throw new Exception ;
}
}
try {
print new foo ;
} catch( Exception $e ) {}
?> -
Dropped abstract static class functions.
Due to an oversight, PHP 5.0.x and 5.1.x allowed abstract static
functions in classes. As of PHP 5.2.x, only interfaces can have them.
<?php
abstract class foo {
abstract static function bar ();
}
?> - Oracle extension requires at least Oracle 10 on Windows.
-
Added RFC2397 (data: stream) support.
The introduction of the 'data' URL scheme has the potential to lead to a
change of behavior under Windows. If you are working with a NTFS
file system and making use of meta streams in your application, and if you
just happen to be using a file with the name 'data:' that is accessed without
any path information - it won't work any more. The fix is to use the 'file:'
protocol when accessing it.
See also » RFC 2397
<?php
include "data:;base64,PD9waHAgcGhwaW5mbygpOz8+" ;
?> -
Regression in glob() patterns
In version 5.2.4 a security fix caused a regression for patterns of
the form "/foo
str_word_count ( "string" , 4 );
strripos ( "foo" , "f" , 4 );
strrpos ( "foo" , "f" , 4 );
include "php://input" ;
?>
Example #2 Object Oriented Code in PHP Core
<?php
interface foo {
}
class bar implements foo , foo {
}
class foo {
public $bar ;
function __get ( $var )
{
return $this -> bar ;
}
}
$foo = new foo ;
$bar =& $foo -> prop ;
class foo implements iterator {
public function current () {
}
public function next () {
}
public function key () {
}
public function valid () {
}
public function rewind () {
}
}
$foo = new foo ();
foreach( $foo as & $ref ) {}
class foo {
private function __construct () {
}
}
class bar extends foo {
public function __construct () {
parent :: __construct ();
}
}
new bar ;
stream_filter_register ( "" , "class" );
stream_filter_register ( "filter" , "" );
?>
Example #3 In the bzip2 Extension
<?php
bzopen ( "" , "w" );
bzopen ( "foo" , "a" );
$fp = fopen ( "foo" , "w" );
bzopen ( $fp , "r" );
?>
Example #4 In the datetime Extension
<?php
strtotime ( "today" , "now" );
new DateTime (new stdclass );
?>
Example #5 In the dBase Extension
<?php
dbase_open ( "foo" , - 1 );
dbase_open ( "foo" , null );
?>
Example #6 In the mcrypt Extension
<?php
$key = "this is a secret key" ;
$td = mcrypt_module_open ( 'tripledes' , '' , 'ecb' , '' );
$iv = mcrypt_create_iv ( mcrypt_enc_get_iv_size ( $td ),
MCRYPT_RAND );
mcrypt_generic_init ( $td , $key , $iv );
$encrypted_data = mcrypt_generic ( $td , "" );
?>
Example #7 In the oci8 Extension
<?php
oci_connect ( "user" , "pass" , "db" , "bogus_charset" );
$oci = oci_connect ( "user" , "pass" , "db" );
oci_password_change ( $oci , "" , "old" , "new" );
oci_password_change ( $oci , "user" , "" , "new" );
oci_password_change ( $oci , "user" , "old" , "" );
?>
Example #8 In the SPL Extension
<?php
$obj = new SplFileObject ( __FILE__ );
$obj -> fgetcsv ( "foo" );
$obj -> fgetcsv ( "," , "foo" );
?>
Example #9 In the Semaphore (sysvmsg) extension
<?php
?>
Example #10 A 5.2.1+ Zip Example
<?php
$obj = new ZipArchive ();
$obj -> open ( 'archive.zip' );
$obj -> setCommentName ( '' , 'comment' );
$obj -> getCommentName ( '' );
?>