From 335ead65e1fbd86f6b2f1efd54038e330652386a Mon Sep 17 00:00:00 2001 From: Philip Olson Date: Mon, 19 Jul 2004 14:28:16 +0000 Subject: [PATCH] WS git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@163646 c90b9560-bf6c-de11-be94-00142212c4b1 --- appendices/migration5.xml | 595 +++++++++++++++++++++++++------------- 1 file changed, 388 insertions(+), 207 deletions(-) diff --git a/appendices/migration5.xml b/appendices/migration5.xml index 621bdb41f0..f1730467fe 100755 --- a/appendices/migration5.xml +++ b/appendices/migration5.xml @@ -1,5 +1,5 @@ - + Migrating from PHP 4 to PHP 5 @@ -24,68 +24,89 @@ pay attention to the following backward incompatible changes: - + + strrpos and strripos now use the entire string as a needle. - - + + + + Illegal use of string offsets causes E_ERROR instead of E_WARNING. - - + + + + array_merge was changed to accept only arrays. If a non-array variable is passed, a E_WARNING will be thrown for every such parameter. Be careful because your code may start emitting E_WARNING out of the blue. - - - PATH_TRANSLATED server variable is no longer set implicitly under - Apache2 SAPI in contrast to the situation in PHP 4, where it is set to - the same value as the SCRIPT_FILENAME server variable when it is not - populated by Apache. This change was made to comply with the + + + + PATH_TRANSLATED server variable is no longer set implicitly under + Apache2 SAPI in contrast to the situation in PHP 4, where it is set to + the same value as the SCRIPT_FILENAME server variable when it is not + populated by Apache. This change was made to comply with the CGI specification. Please refer to bug #23610 for further information. - - - The T_ML_CONSTANT constant is no longer defined by - the Tokenizer extension. If - error_reporting is set to E_ALL, PHP will generate a - notice. Although the T_ML_CONSTANT was never used - at all, it was defined in PHP 4. In both PHP 4 and PHP 5 // and /* */ - are resolved as the T_COMMENT constant. However the - PHPDoc style comments /** */ ,which starting PHP 5 are parsed by PHP, are - recognized as T_DOC_COMMENT. - - + + + + + The T_ML_CONSTANT constant is no longer defined by + the Tokenizer extension. If + error_reporting is set to E_ALL, PHP will + generate a notice. Although the T_ML_CONSTANT was + never used at all, it was defined in PHP 4. In both PHP 4 and PHP 5 + // and /* */ are resolved as the T_COMMENT + constant. However the PHPDoc style comments /** */ ,which starting PHP + 5 are parsed by PHP, are recognized as + T_DOC_COMMENT. + + + + $_SERVER should be populated with argc and argv if variables_order includes "S". If + linkend="ini.variables-order">variables_order includes "S". If you have specifically configured your system to not create $_SERVER, then of course it shouldn't be there. The change was to always make argc and argv available in the CLI version regardless of the variables_order setting. As in, + linkend="ini.variables-order">variables_order setting. As in, the CLI version will now always populate the global $argc and $argv variables. - - + + + + An object with no properties is no longer considered "empty". - - - In some cases classes must be declared before used. It only happens only - if some of the new features of PHP 5 are used. Otherwise the behaviour is - the old. - - + + + + + In some cases classes must be declared before used. It only happens + only if some of the new features of PHP 5 are used. Otherwise the + behaviour is the old. + + + + get_class starting PHP 5 returns the name of the class as it was declared which may lead to problems in older scripts that rely on the previous behaviour (the class name was lowercased). A possible solution is to search for get_class in all your scripts and use strtolower. - - + + + + ip2long now returns FALSE when an invalid IP address is passed as argument to the function, and no longer -1. - + + @@ -223,308 +244,458 @@ Action application/x-httpd-php "/php/php-cgi.exe" Arrays: - + + array_combine - Creates an array by using one array for keys and another for its values - - + + + + array_diff_uassoc - Computes the difference of arrays with additional index check which is performed by a user supplied callback function - - + + + + array_udiff - Computes the difference of arrays by using a callback function for data comparison - - + + + + array_udiff_assoc - Computes the difference of arrays with additional index check. The data is compared by using a callback function - - + + + + array_udiff_uassoc - Computes the difference of arrays with additional index check. The data is compared by using a callback function. The index check is done by a callback function also - - + + + + array_walk_recursive - Apply a user function recursively to every member of an array - + + InterBase: - + + ibase_affected_rows - Return the number of rows that were affected by the previous query - - + + + + ibase_backup - Initiates a backup task in the service manager and returns immediately - - + + + + ibase_commit_ret - Commit a transaction without closing it - - + + + + ibase_db_info - Request statistics about a database - - + + + + ibase_drop_db - Drops a database - - + + + + ibase_errcode - Return an error code - - + + + + ibase_free_event_handler - Cancels a registered event handler - - + + + + ibase_gen_id - Increments the named generator and returns its new value - - + + + + ibase_maintain_db - Execute a maintenance command on the database server - - + + + + ibase_name_result - Assigns a name to a result set - - + + + + ibase_num_params - Return the number of parameters in a prepared query - - + + + + ibase_param_info - Return information about a parameter in a prepared query - - + + + + ibase_restore - Initiates a restore task in the service manager and returns immediately - - + + + + ibase_rollback_ret - Rollback transaction and retain the transaction context - - + + + + ibase_server_info - Request statistics about a database - - + + + + ibase_service_attach - Connect to the service manager - - - ibase_service_detach - Disconnect from the service manager - - + + + + + ibase_service_detach - Disconnect from the + service manager + + + + ibase_set_event_handler - Register a callback function to be called when events are posted - - + + + + ibase_wait_event - Wait for an event to be posted by the database - + + iconv: - + + iconv_mime_decode - Decodes a MIME header field - - + + + + iconv_mime_decode_headers - Decodes multiple MIME header fields at once - - + + + + iconv_mime_encode - Composes a MIME header field - - + + + + iconv_strlen - Returns the character count of string - - + + + + iconv_strpos - Finds position of first occurrence of a needle within a haystack - - + + + + iconv_strrpos - Finds the last occurrence of a needle within the specified range of haystack - - + + + + iconv_substr - Cut out part of a string - + + Streams: - + + stream_copy_to_stream - Copies data from one stream to another - - + + + + stream_get_line - Gets line from stream resource up to a given delimiter - - + + + + stream_socket_accept - Accept a connection on a socket created by stream_socket_server - - + + + + stream_socket_client - Open Internet or Unix domain socket connection - - + + + + stream_socket_get_name - Retrieve the name of the local or remote sockets - - + + + + stream_socket_recvfrom - Receives data from a socket, connected or not - - + + + + stream_socket_sendto - Sends a message to a socket, whether it is connected or not - - + + + + stream_socket_server - Create an Internet or Unix domain server socket - + + Other: - + + convert_uudecode - decode a uuencoded string - - + + + + convert_uuencode - uuencode a string - - + + + + curl_copy_handle - Copy a cURL handle along with all of it's preferences - - + + + + dba_key_split - Splits a key in string representation into array representation - - + + + + dbase_get_header_info - Get the header info of a dBase database - - + + + + dbx_fetch_row - Fetches rows from a query-result that had the DBX_RESULT_UNBUFFERED flag set - - - fbsql_set_password - Change the password for a given user - - + + + + + fbsql_set_password - Change the password for a + given user + + + + file_put_contents - Write a string to a file - - + + + + ftp_alloc - Allocates space for a file to be uploaded - - + + + + get_declared_interfaces - Returns an array of all declared interfaces - - + + + + get_headers - Fetches all the headers sent by the server in response to a HTTP request - - + + + + headers_list - Returns a list of response headers sent (or ready to send) - - + + + + http_build_query - Generate URL-encoded query string - - + + + + idate - Format a local time/date as integer - - + + + + image_type_to_extension - Get file extension for image-type returned by getimagesize, exif_read_data, exif_thumbnail, exif_imagetype - - + + + + imagefilter - Applies Filter an image using a custom angle - - + + + + imap_getacl - Gets the ACL for a given mailbox - - + + + + ldap_sasl_bind - Bind to LDAP directory using SASL - - + + + + mb_list_encodings - Returns an array of all supported encodings - - + + + + pcntl_getpriority - Get the priority of any process - - + + + + pcntl_wait - Waits on or returns the status of a forked child as defined by the waitpid() system call - - + + + + pg_version - Returns an array with client, protocol and server version (when available) - - + + + + php_check_syntax - Check the syntax of the specified file - - + + + + php_strip_whitespace - Return source with stripped comments and whitespace - - + + + + proc_nice - Change the priority of the current process - - + + + + pspell_config_data_dir - Change location of language data files - - + + + + pspell_config_dict_dir - Change location of the main word list - - + + + + setrawcookie - Send a cookie with no url encoding of the value - - + + + + snmp_read_mib - Reads and parses a MIB file into the active MIB tree - - + + + + sqlite_fetch_column_types - Return an array of column types from a particular table - - + + + + str_split - Convert a string to an array - - + + + + strpbrk - Search a string for any of a set of characters - - + + + + substr_compare - Binary safe optionally case insensitive comparison of two strings from an offset, up to length characters - - + + + + time_nanosleep - Delay for a number of seconds and nano seconds - + + @@ -542,30 +713,40 @@ Action application/x-httpd-php "/php/php-cgi.exe" list of them: - - mail.force_extra_parameters - Force the addition of the specified - parameters to be passed as extra parameters to the sendmail binary. These - parameters will always replace the value of the 5th parameter to - mail, even in safe mode - - - register_long_arrays - - allow/disallow PHP to register the deprecated long $HTTP_*_VARS - - + + + mail.force_extra_parameters - Force the addition of the specified + parameters to be passed as extra parameters to the sendmail binary. + These parameters will always replace the value of the 5th parameter to + mail, even in safe mode + + + + + register_long_arrays - + allow/disallow PHP to register the deprecated long $HTTP_*_VARS + + + + session.hash_function - select a hash function (MD5 or SHA-1) - - + + + + session.hash_bits_per_character + linkend="ini.session.hash-bits-per-character">session.hash_bits_per_character - define how many bits are stored in each character when converting the binary hash data to something readable (from 4 to 6) - - - zend.ze1_compatibility_mode - - Enable compatibility mode with Zend Engine 1 (PHP 4) - + + + + + zend.ze1_compatibility_mode + - Enable compatibility mode with Zend Engine 1 (PHP 4) + +