bjori Tue Oct 24 20:54:08 2006 UTC
Modified files: (Branch: PHP_5_2)
/php-src README.UPDATE_5_2
Log:
Add sections: backwards incompatible error messages & new
functions/methods/classes/constants/optional parameters
http://cvs.php.net/viewvc.cgi/php-src/README.UPDATE_5_2?r1=1.1.2.16&r2=1.1.2.17&diff_format=u
Index: php-src/README.UPDATE_5_2
diff -u php-src/README.UPDATE_5_2:1.1.2.16 php-src/README.UPDATE_5_2:1.1.2.17
--- php-src/README.UPDATE_5_2:1.1.2.16 Fri Oct 6 21:03:35 2006
+++ php-src/README.UPDATE_5_2 Tue Oct 24 20:54:07 2006
@@ -175,4 +175,380 @@
warning messages, instead retuning an un-expected return value of false.
As of PHP 5.2 this operation will emit E_WARNING as is the case in all
other instance where division by zero is performed.
-
\ No newline at end of file
+
+==============================
+Backwards incompatible changes
+==============================
+
+<?php
+/* PHP Warning: bzopen(): filename cannot be empty in
/usr/src/php/examples/bzopen.no.filename.php on line 3 */
+bzopen("", "w");
+?>
+
+<?php
+/* PHP Warning: bzopen(): 'a' is not a valid mode for bzopen(). Only 'w' and
'r' are supported. in /usr/src/php/examples/bzopen.wrong.stream.mode.php on
line 3 */
+bzopen("foo", "a");
+
+$fp = fopen("foo", "a");
+/* PHP Warning: bzopen(): cannot read from a stream opened in write only mode
in /usr/src/php/examples/bzopen.wrong.stream.mode.php on line 7 */
+bzopen($fp, "r");
+?>
+
+<?php
+/* PHP Warning: Invalid access mode -1 in
/usr/src/php/examples/dbase.invalid.access.mode.php on line 3 */
+dbase_open("foo", -1);
+?>
+
+<?php
+/* PHP Fatal error: Class bar cannot implement previously implemented
interface foo in /usr/src/php/examples/impliment.implemented.php on line 4 */
+interface foo {
+}
+class bar implements foo, foo {
+}
+?>
+
+<?php
+class foo {
+ public $bar;
+ function __get($var)
+ {
+ return $this->bar;
+ }
+}
+
+$foo = new foo;
+/* PHP Notice: Indirect modification of overloaded property foo::$prop has no
effect in
/usr/src/php/examples/indirect.modification.of.overloaded.property.php on line
12 */
+$bar =& $foo->prop;
+?>
+
+<?php
+class foo implements iterator {
+ public function current() {
+
+ }
+ public function next() {
+
+ }
+ public function key() {
+
+ }
+ public function valid() {
+
+ }
+ public function rewind() {
+
+ }
+}
+
+$foo = new foo();
+/* PHP Fatal error: An iterator cannot be used with foreach by reference in
/usr/src/php/examples/iterator.foreach.by_ref.php on line 22 */
+foreach($foo as &$ref) {
+}
+?>
+
+<?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);
+/* PHP Warning: An empty string was passed in
/usr/src/php/examples/mcrypt.generic.empty.string.php on line 8 */
+$encrypted_data = mcrypt_generic($td, "");
+?>
+
+<?php
+/* PHP Warning: Division by zero in /usr/src/php/examples/modulus.by.zero.php
on line 3 */
+print 10%0;
+
+?>
+
+<?php
+/* PHP Warning: Invalid character set name: bogus_charset in
/usr/src/php/examples/oci.bogus.charset.php on line 3 */
+oci_connect("user", "pass", "db", "bogus_charset");
+?>
+
+<?php
+$oci = oci_connect("user", "pass", "db");
+/* PHP Warning: username cannot be empty in
/usr/src/php/examples/oci.no.empty.username.php on line 4 */
+oci_password_change($oci, "", "old", "new");
+/* PHP Warning: old password cannot be empty in
/usr/src/php/examples/oci.no.empty.username.php on line 6 */
+oci_password_change($oci, "user", "", "new");
+/* PHP Warning: new password cannot be empty in
/usr/src/php/examples/oci.no.empty.username.php on line 8 */
+oci_password_change($oci, "user", "old", "");
+?>
+
+<?php
+class foo {
+ private function __construct() {
+ }
+}
+class bar extends foo {
+ public function __construct() {
+ /* PHP Fatal error: Cannot call private foo::__construct() in
/usr/src/php/examples/private.ctor.php on line 9 */
+ parent::__construct();
+ }
+}
+new bar;
+?>
+
+<?php
+echo " ";
+/* PHP Warning: session_regenerate_id(): Cannot regenerate session id -
headers already sent in /usr/src/php/examples/session.cannot.regenerate.id.php
on line 4 */
+session_regenerate_id();
+
+?>
+
+<?php
+$obj = new SplFileObject(__FILE__);
+/* PHP Warning: SplFileObject::fgetcsv(): delimiter must be a character in
/usr/src/php/examples/splfileobj.csv.must.be.char.php on line 4 */
+$obj->fgetcsv("foo");
+/* PHP Warning: SplFileObject::fgetcsv(): enclosure must be a character in
/usr/src/php/examples/splfileobj.csv.must.be.char.php on line 6 */
+$obj->fgetcsv(",", "foo");
+
+?>
+
+<?php
+/* PHP Strict Standards: Static function foo::bar() should not be abstract in
/usr/src/php/examples/static.abstract.method.php on line 3 */
+abstract class foo {
+ abstract static function bar();
+}
+
+?>
+
+<?php
+/* PHP Warning: stream_filter_register(): Filter name cannot be empty in
/usr/src/php/examples/stream.filter.cannot.be.empty.php on line 3 */
+stream_filter_register("", "class");
+/* PHP Warning: stream_filter_register(): Class name cannot be empty in
/usr/src/php/examples/stream.filter.cannot.be.empty.php on line 5 */
+stream_filter_register("filter", "");
+?>
+
+<?php
+/* PHP Warning: str_word_count(): Invalid format value 4 in
/usr/src/php/examples/string.wordcount.invalid.format.value.php on line 3 */
+str_word_count("string", 4);
+?>
+
+<?php
+/* PHP Notice: strripos(): Offset is greater than the length of haystack
string in /usr/src/php/examples/strripos.offset.greater.than.heystrack.php on
line 3 */
+strripos("foo", "f", 4);
+?>
+
+<?php
+/* PHP Notice: strrpos(): Offset is greater than the length of haystack
string in /usr/src/php/examples/strrpos.offset.greater.than.heystrack.php on
line 3 */
+strrpos("foo", "f", 4);
+?>
+
+<?php
+class foo {
+ public function __toString() {
+ throw new Exception;
+ }
+}
+try {
+ /* PHP Fatal error: Method foo::__toString() must not throw an exception
in /usr/src/php/examples/tostring.exception.php on line 9 */
+ print new foo;
+} catch(Exception $e) {
+
+}
+?>
+
+============
+NEW FEATURES
+============
+
+New Classess:
+=============
+ RegexIterator extends FilterIterator implements Iterator, Traversable,
OuterIterator
+ Constants:
+ RecursiveRegexIterator::USE_KEY
+ RecursiveRegexIterator::MATCH
+ RecursiveRegexIterator::GET_MATCH
+ RecursiveRegexIterator::ALL_MATCHES
+ RecursiveRegexIterator::SPLIT
+ RecursiveRegexIterator::REPLACE
+ Properties:
+ public $replacement
+ Methods:
+ RegexIterator::__construct(Iterator it, string regex [, int mode [, int
flags [, int preg_flags]]])
+ - Create an RegexIterator from another iterator and a regular
expression
+ bool RegexIterator::accept()
+ - Match (string)current() against regular expression
+ bool RegexIterator::getMode()
+ - Returns current operation mode
+ bool RegexIterator::setMode(int new_mode)
+ - Set new operation mode
+ bool RegexIterator::getFlags()
+ - Returns current operation flags
+ bool RegexIterator::setFlags(int new_flags)
+ - Set operation flags
+ bool RegexIterator::getPregFlags()
+ - Returns current PREG flags (if in use or NULL)
+ bool RegexIterator::setFlags(int new_flags)
+ - Set PREG flags
+
+ RecursiveRegexIterator extends RegexIterator implements OuterIterator,
Traversable, Iterator, RecursiveIterator
+ Methods:
+ RecursiveRegexIterator::__construct(RecursiveIterator it, string regex
[, int mode [, int flags [, int preg_flags]]])
+ Create an RecursiveRegexIterator from another recursive iterator and a
regular expression
+ RecursiveRegexIterator RecursiveRegexIterator::getChildren()
+ Return the inner iterator's children contained in a
RecursiveRegexIterator
+ bool RecursiveRegexIterator::hasChildren()
+ Check whether the inner iterator's current element has children
+
+
+New methods:
+============
+ ext/dom
+ DOMDocument:
+ DOMDocument::registerNodeClass(string baseclass, string extendedclass)
+ - Register extended class used to create base node type
+
+ DOMElement:
+ DOMElement::setIDAttribute(string name, boolean isId)
+ - Declares the attribute specified by name to be of type ID
+ DOMElement::setIDAttributeNS(string namespaceURI, string localName,
boolean isId)
+ - Declares the attribute specified by local name and namespace URI to
be of type ID
+ DOMElement::setIDAttributeNode(DOMAttr idAttr, boolean isId)
+ - Declares the attribute specified by node to be of type ID
+
+ DOMNode:
+ DOMNode::getNodePath()
+ - Gets an xpath for a node
+ DOMNode::C14N([bool exclusive [, bool with_comments [, array xpath [,
array ns_prefixes]]]])
+ - Canonicalize nodes to a string
+ DOMNode::C14NFile(string uri [, bool exclusive [, bool with_comments [,
array xpath [, array ns_prefixes]]]])
+ - Canonicalize nodes to a file
+
+ ext/soap
+ SoapServer:
+ SoapServer::setObject(object obj)
+ - Sets object which will handle SOAP requests
+
+ ext/spl
+ ArrayObject:
+ int ArrayObject::asort(void)
+ - Sort the entries by values
+ int ArrayObject::ksort(void)
+ - Sort the entries by key
+ int ArrayObject::uasort(callback cmp_function)
+ - Sort the entries by values user defined function
+ int ArrayObject::uksort(callback cmp_function)
+ - Sort the entries by key using user defined function.
+ int ArrayObject::natsort(void)
+ - Sort the entries by values using "natural order" algorithm.
+ int ArrayObject::natcasesort(void)
+ - Sort the entries by key using case insensitive "natural order"
algorithm.
+
+ SplFileObject
+ void SplFileObject::setCsvControl([string delimiter = ',' [, string
enclosure = '"']])
+ - Set the delimiter and enclosure character used in fgetcsv
+ array("delimiter" =>, "enclosure" =>) SplFileObject::getCsvControl(void)
+ - Get the delimiter and enclosure character used in fgetcsv
+
+ CachingIterator
+ void CachingIterator::offsetSet(mixed index, mixed newval)
+ - Set given index in cache
+ string CachingIterator::offsetGet(mixed index)
+ - Return the internal cache if used
+ void CachingIterator::offsetUnset(mixed index)
+ - Unset given index in cache
+ bool CachingIterator::offsetExists(mixed index)
+ Return whether the requested index exists
+ bool CachingIterator::getCache()
+ Return the cache
+ int CachingIterator::getFlags()
+ Return the internal flags
+ void CachingIterator::setFlags()
+ Set the internal flags
+ int AppendIterator::getIteratorIndex()
+ Get index of iterator
+ ArrayIterator AppendIterator::getArrayIterator()
+ Get access to inner ArrayIterator
+ boolean XMLReader::setSchema(string filename)
+ Use W3C XSD schema to validate the document as it is processed.
Activation is only possible before the first Read()
+
+
+New class constants:
+====================
+ SplFileObject::READ_AHEAD
+ SplFileObject::SKIP_EMPTY
+ SplFileObject::READ_CSV
+
+ CachingIterator::TOSTRING_USE_INNER
+ CachingIterator::FULL_CACHE
+
+
+New functions:
+==============
+ ext/mbstring
+ int mb_stripos(string haystack, string needle [, int offset [, string
encoding]])
+ - Finds position of first occurrence of a string within another, case
insensitive
+ int mb_strripos(string haystack, string needle [, int offset [, string
encoding]])
+ - Finds position of last occurrence of a string within another, case
insensitive
+ string mb_strstr(string haystack, string needle[, bool part[, string
encoding]])
+ - Finds first occurrence of a string within another
+ string mb_strrchr(string haystack, string needle[, bool part[, string
encoding]])
+ - Finds the last occurrence of a character in a string within another
+ string mb_stristr(string haystack, string needle[, bool part[, string
encoding]])
+ - Finds first occurrence of a string within another, case insensitive
+ string mb_strrichr(string haystack, string needle[, bool part[, string
encoding]])
+ - Finds the last occurrence of a character in a string within another,
case insensitive
+ array mb_list_encodings_alias_names([string encoding])
+ - Returns an array of all supported entity encodings
+ mixed mb_list_mime_names([string encoding])
+ - Returns an array or string of all supported mime names
+
+ ext/openssl
+ array openssl_csr_get_subject(mixed csr [, bool use_short_names])
+ - Returns the subject of a CERT
+ resource openssl_csr_get_public_key(mixed csr)
+ - Returns the subject of a CERT
+ array openssl_pkey_get_details(resource key)
+ - returns an array with the key details (bits, pkey, type)
+
+ ext/spl
+ string spl_object_hash(object obj)
+ - Return hash id for given object
+ int iterator_apply(Traversable it, mixed function [, mixed params])
+ - Calls a function for every element in an iterator
+
+ ext/pcre
+ int preg_last_error(void)
+ - Returns the error code of the last regexp execution.
+
+ ext/pgsql
+ mixed pg_field_table(resource result, int field_number[, bool oid_only])
+ - Returns the name of the table field belongs to, or table's oid if
oid_only is true
+
+ ext/posix
+ bool posix_initgroups(string name, int base_group_id)
+ - Calculate the group access list for the user specified in name
+
+ ext/standard
+ array array_fill_keys(array keys, mixed val)
+ - Create an array using the elements of the first parameter as keys each
initialized to val
+ int memory_get_peak_usage([real_usage])
+ - Returns the peak allocated by PHP memory
+ array error_get_last()
+ - Get the last occurred error as associative array. Returns NULL if
there hasn't been an error yet
+
+
+New optional parameters:
+========================
+ - array curl_multi_info_read(resource mh [, long msgs_in_queue])
(msgs_in_queue)
+ - int mb_strrpos(string haystack, string needle [, int offset [, string
encoding]]) (offset)
+ - int openssl_verify(string data, string signature, mixed key [, int
signature_algo]) (signature_algo)
+ - string pg_escape_string([resource connection,] string data) (connection)
+ - string pg_escape_bytea([resource connection,] string data) (connection)
+ - object SimpleXMLElement::children([string ns [, bool is_prefix]])
(is_prefix)
+ - array SimpleXMLElement::attributes([string ns [, bool is_prefix]])
(is_prefix)
+ - SimpleXMLElement simplexml_load_file(string filename [, string class_name
[, int options [, string ns [, bool is_prefix]]]]) (ns && is_prefix)
+ - SimpleXMLElement simplexml_load_string(string data [, string class_name [,
int options [, string ns [, bool is_prefix]]]]) (ns && is_prefix)
+ - SimpleXMLElement::__construct(string data [, int options [, bool
data_is_url [, string ns [, bool is_prefix]]]]) (ns && is_prefix)
+ - string base64_decode(string str[, bool strict=false]) (strict)
+ - bool setcookie(string name [, string value [, int expires [, string path
[, string domain [, bool secure[, bool httponly=false]]]]]] (httponly)
+ - bool setrawcookie(string name [, string value [, int expires [, string
path [, string domain [, bool secure[, bool httponly=false]]]]]] (httponly)
+ - int memory_get_usage([bool real_usage=false]) (real_usage)
+ - boolean XMLReader::open(string URI [, string encoding [, int options]])
(encoding, options)
+ - boolean XMLReader::XML(string source [, string encoding [, int options]])
(encoding, options)
+
+
--
PHP CVS Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
