Source

php-src / UPGRADING

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
$Id$

UPGRADE NOTES - PHP 5.3

1. Reserved words and classes
2. Changes made to existing functions
3. Changes made to existing methods
4. Changes made to existing classes
5. Deprecated
6. Undeprecated
7. Extensions:
     a. moved out to PECL and actively maintained there
     b. no longer maintained
     c. with changed behaviour
     d. no longer possible to disable
8. Changes in SAPI support
9. Changes in INI directives
10. Syntax additions
11. Windows support
12. New in PHP 5.3:
     a. New libraries
     b. New extensions
     c. New stream wrappers
     d. New stream filters
     e. New functions
     f. New global constants
     g. New classes
     h. New methods
     i. New class constants

=============================
1. Reserved words and classes
=============================

- **namespace** and **goto** are now reserved keywords.

- **Closure** is now a reserved class. (Used by lambda and closure.)

=====================================
2. Changes made to existing functions
=====================================

- The HTTP stream wrapper now considers all status codes from 200 to 399 to be
  successful.

- The array functions natsort(), natcasesort(), usort(), uasort(), uksort(),
  array_flip(), and array_unique() no longer accept objects passed as arguments.
  If you need to use them to access an object's properties, you must cast the
  object to an array first.

- var_dump() output now includes private object members.

- session_start() now returns FALSE when the session startup fails.

- property_exists() now checks the existence of a property independent of
  accessibility (like method_exists()).

- The $initial parameter for array_reduce can now be of any type.

- clearstatcache() no longer clears the realpath cache by default.

- realpath() is no longer system-dependent and works identically on all
  platforms.

- call_user_func() now propagates $this even if the callee is the parent class.

- The filesystem functions opendir(), scandir(), and dir() now use the default
  context if no context argument is passed.

- The behaviour of functions with by-reference parameters called by value has
  changed. Where previously the function would accept the by-value argument, a
  warning is now emitted and all by-ref parameters are set to NULL.

- There is now native support for the following math functions: asinh(),
  acosh(), atanh(), log1p(), and expm1().

- In the GD extension, there is now pixelation support available through
  the imagefilter() function.

- crypt() now has Blowfish and extended DES support, and crypt() features are
  now 100% portable. PHP has its own internal crypt implementation which drops
  into place when system support for crypt or crypt_r() is not found.

- get_cfg_var() is now able to return "array" INI options.

- Stream wrappers can now be used by the include_path INI directive.

- These functions now take new parameters:
     clearstatcache(): $clear_realpath_cache and $filename.
     copy(): $context
     fgetcsv(): $escape
     ini_get_all(): $details
     json_encode(): $options
     json_decode(): $depth
     nl2br(): $is_xhtml
     parse_ini_file(): $scanner_mode
     round(): $mode
     stream_context_create(): $params
     strstr(), stristr(): $before_needle
     sybase_connect(): $new

- And new mode option for fopen: 'n' (O_NONBLOCK)

- The new mysqlnd library necessitates using MySQL's newer 41-byte password
  format. Continued use of the old 16 byte passwords will cause mysql_connect()
  and other related functions to produce the following error message:
  "mysqlnd cannot connect to MySQL 4.1+ using old authentication"

- The dl() function is now disabled by default, and only available under the
  cli, cgi, and embed SAPIs.

- mail() now supports the logging of sent mail.

- stream_select(), stream_set_blocking(), stream_set_timeout(), and 
  stream_set_write_buffer() now work with user-space stream wrappers.

- getopt() accepts "long options" now on all platforms.
  Optional values and using = as a separator for short options are now
  supported.


===================================
3. Changes made to existing methods
===================================

- The magic methods __get(), __set(), __isset(), __unset(), and __call() should
  always be public and can no longer be static. Method signatures are enforced.

- The __call() magic method is now invoked on access to private and protected
  methods.

- The __toString() magic method can no longer accept arguments.

- There is a new magic method, __callStatic().

- Internal count() vs. count_elements() handler resolution rules have changed.
  (This could potentially break custom PHP extensions.)

- The trailing / has been removed from SplFileInfo and other related directory
  classes.

- SplFileInfo::getpathinfo() now returns information about the path name.

- There are new parameters in:
     Exception::__construct(): $previous

===================================
4. Changes made to existing classes
===================================

- SplObjectStorage now has ArrayAccess support. It is also now possible to
  store associative information with objects in SplObjectStorage.

=============
5. Deprecated
=============

- define_syslog_variables() is deprecated.

- set_socket_blocking() is deprecated.

- call_user_method() and call_user_method_array() are now deprecated. Use
  call_user_func() and call_user_func_array() instead.

- dl() is deprecated.

- The set_magic_quotes_runtime() function is now deprecated.

- mysql_listtables(), mysql_dropdb(), mysql_createdb(), mysql_list_tables(),
  mysql_drop_db(), and mysql_create_db() are now deprecated.

- All ereg functions are now deprecated and emit E_DEPRECATED errors:
  sql_regcase(), spliti(), split(), ereg_replace(), eregi(),
  ereg_replace(), and ereg().
  Use the PCRE family of functions (preg_*()) instead.

- mcrypt_generic_end() is deprecated.

- mysql_db_query() is deprecated.

- mysql_escape_string() is deprecated.

- session_register(), session_unregister(), and session_is_registered() are now
  deprecated. Use the $_SESSION superglobal array instead.

- Comments starting with '#' are now deprecated in .INI files.

- The following INI directives will now emit an E_DEPRECATED warning 
  upon startup if they are activated:

        - define_syslog_variables
        - register_globals
        - register_long_arrays
        - safe_mode
        - magic_quotes_gpc
        - magic_quotes_runtime
        - magic_quotes_sybase

- The is_dst parameter to mktime() is deprecated.

- Assigning the return value of "new" by reference is deprecated

- Call-time pass-by-reference has been deprecated

- Usage of {} to access string offsets is deprecated

- Passing locale category name as string to setlocale() is deprecated.

===============
6. Undeprecated
===============

- By popular request, is_a() is no longer deprecated.

==============
7. Extensions:
==============

     a. moved out to PECL and actively maintained there

        - fdf
        - ming
        - ncurses

     b. no longer maintained

        - dbase
        - fbsql
        - msql
        - sybase (use sybase_ct, which is still in PHP core)
        - mhash (hash has full BC layer)
        - mime_magic (use fileinfo, has full BC layer)

     c. with changed behaviour

        - dns: dns_check_record() will now return an extra "entries" index,
          containing the TXT elements.

        - datetime: date/time functions will no longer use the TZ environment
          variable to guess which timezone should be used.

        - cURL now supports SSH

        - hash: The SHA-224 and salsa hash algorithms are now supported.

        - mbstring: Now supports CP850 encoding.

        - oci8: Database Resident Connection Pooling (DRCP) and Fast Application
          Notification (FAN) are now supported.

          Oracle External Authentication is now supported (except on Windows).

          The oci8 function oci_bind_by_name() now supports SQLT_AFC (aka the
          CHAR datatype).

          Calling oci_close() on a persistent connection, or when the variable
          that references a persistent connection goes out of scope, will now
          trigger a roll back of an uncommitted transaction. To avoid unexpected
          behavior explicitly issue a commit or roll back as needed. The old
          behavior can be enabled with the INI directive
          oci8.old_oci_close_semantics.

        - openssl: OpenSSL digest and cipher functions are now supported.
          It is also now possible to access the internal values of DSA, RSA and
          DH keys.

        - session: Sessions will no longer store session-files in "/tmp" when
          open_basedir restrictions apply, unless "/tmp" is explicitly added to
          the list of allowed paths.

        - SOAP: Now supports sending user-supplied HTTP headers.

        - MySQLi: Now supports persistent connections by prepending the hostname 
          with "p:".

     d. no longer possible to disable

        - PCRE
        - Reflection
        - SPL

==========================
8. Changes in SAPI support
==========================

- A new "litespeed" SAPI is now available.

- FastCGI is now always enabled and can not be disabled. See sapi/cgi/CHANGES
  for more details.

- A new CGI SAPI option, -T, can be used to measure execution time of a script
  repeated several times.
 
- CGI/FastCGI now has support for .htaccess style user-defined php.ini files.
  See the new user_ini.filename and user_ini.cache_ttl INI directives.

============================
9. Changes in INI directives
============================

- zend_extension_debug and zend_extension_ts have been removed. Always use the
  zend_extension directive to load Zend Extensions.

- zend.ze1_compatibility_mode has been removed. If this INI directive is set to
  on, then an E_ERROR is emitted at startup.

- There is now support for special sections: [PATH=/opt/httpd/www.example.com/]
  and [HOST=www.example.com]. Directives set in these sections cannot be
  overridden by user-defined INI files or at runtime.

- Added mbstring.http_output_conv_mimetype. This directive specifies the
  regex pattern of content types for which mb_output_handler() is activated.

- It is now possible to use the full path to load modules using the "extension"
  directive.

- "INI variables" can now be used almost anywhere in a php.ini file.

- It is now possible to use alphanumeric or variable indices in INI option
  arrays.

- open_basedir is now PHP_INI_ALL

- Runtime tightening of open_basedir restrictions is now possible.

- The default value of session.use_only_cookies has changed to "1".

- The default value of oci8.default_prefetch has been changed from 10 to 100.

- A new directive, request_order, controls the behavior of $_REQUEST
  independently of variables_order.

- New INI directives: 
  - mail.add_x_header
  - user_ini.filename
  - user_ini.cache_ttl
  - exit_on_timeout
  - mysqli.allow_persistent
  - mysqli.default_host
  - mysqli.default_socket
  - mysqli.allow_local_infile
  - mysqli.cache_size
  - oci8.connection_class
  - oci8.events
  - pdo_mysql.default_socket
  - pdo_mysql.cache_size
  - sqlite3.extension_dir
  - mysql.default_socket
  - mysql.allow_local_infile
  - mysql.cache_size
  - mysqlnd.collect_statistics
  - mysqlnd.collect_memory_statistics
  - mysqlnd.net_cmd_buffer_size
  - mysqlnd.net_read_buffer_size
  - mysqlnd.log_mask


====================
10. Syntax additions
====================

- NOWDOC: Similar to HEREDOC, but with single quotes:

      <<<'LABEL' ...

  Static HEREDOCs can be used to initialize static variables and class members
  or constants:

      static $foo = <<<LABEL
      No variables here...
      LABEL;

- HEREDOC now supports wrapping the identifier with double-quotes, to complement
  the NOWDOC syntax:

      <<<"LABEL" ...

- The ?: operator has been introduced:

      var_dump(0 ?: 'Hello!');

- Namespaces were added:

      namespace my\name;
      $obj = new \my\name\MyClass;

- Dynamic access to static methods is now possible:

      $foo::myFunc();

- Exceptions can now be nested:

      class MyCustomException extends Exception {}
      try {
          throw new MyCustomException("Something happend", 112);
      } catch(Exception $e) {
          throw new InvalidArgumentException("You are doing it wrong!", 911, $e);
      }

- Exceptions can now be handled in destructors.

- A garbage collector has been added and is enabled by default.

===================
11. Windows support
===================

- The minimum Windows version is now Windows 2000. (Windows 98, ME and NT4 are
  no longer supported).

- PHP Windows binaries target i586 or later. i386 and i486 are not supported.

- Support for the IIS SAPI has been dropped. Use the FastCGI SAPI instead 
  (available for IIS5 and later)). FastCGI is the recommended way to use PHP
  with IIS (see http://php.iis.net/).

- A new build is available based on the latest Visual C++ Compiler (VC9). 
  Its use is recommended with FastCGI or CLI. Apache's Windows binaries are not
  compatible with VC9; however, you can use Apache Lounge's build
  (http://apachelounge.com).

- The x64 binaries are for experimental usage only. They are not meant to be 
  used in production.

- A new site is available to download Windows releases as well as Windows-only
  releases: http://windows.php.net. Windows-specific releases will be made to
  fix security issues in the bundled libraries (libpng, openssl, etc.). Please
  note that this site does not replace the main PHP site as a source of PHP
  news, resources, or documentation.

- Windows support has been added for the following functions: getopt(),
  imagecolorclosesthwb(), mcrypt_create_iv(), inet_ntop(), inet_pton(), 
  getmxrr(), checkdnsrr(), dns_get_record(), linkinfo(), readlink(), 
  symlink(), link(), fnmatch(), stream_socket_pair(), time_nanosleep(), 
  time_sleep_until(), and socket_create_pair().

- Crypt supports now all available algorithms on Windows (blowfish included).

- Improved portability of stat(), touch(), filemtime(), filesize() and related
  functions (100% portable for the available data).

- It is now possible to create hard links on Windows using the link() function,
  and symbolic links using the symlink() function. Hard links are available
  as of Windows 2000 and symbolic links as of Windows Vista.

- The PDO_OCI php_pdo_oci8.dll library (for use with Oracle version 8 client
  libraries) is no longer being built. Instead, use php_pdo_oci.dll (note no
  '8') with Oracle 10 or 11 client libraries. Connection to other database
  versions is still supported.

- For the OCI8 extension, a new library php_oci8_11g.dll is available in
  addition to php_oci8.dll. Only one can be enabled at any time. Use
  php_oci8.dll with Oracle 10.2 client libraries. Use php_oci8_11g.dll with
  Oracle 11 client libraries. Connection to other database versions is still
  supported.

- Firebird and SNMP support are no longer available on Windows. Firebird support
  may be reintroduced in the future.

===================
12. New in PHP 5.3:
===================

     a. New libraries

       - mysqlnd is a new core library shipped with PHP. It is a PHP-specific
         replacement for libmysql and is recommended for all installations for
         increased performance.

     b. New extensions

       - enchant
       - fileinfo (replaces mime_magic)
       - intl
       - Phar
       - SQLite3

     c. New stream wrappers

       - glob:// stream wrapper
       - phar:// stream wrapper for accessing phar archives

     d. New stream filters

       - "dechunk" (HTTP/1.1 chunked transfer encoding)
       - The bz2.decompress filter now supports concatenation

     e. New functions

       - Core:    gc_collect_cycles()
                  gc_enabled()
                  gc_enable()
                  gc_disable()
                  class_alias()
                  get_called_class()
                  forward_static_call()
                  forward_static_call_array()
                  str_getcsv()
                  quoted_printable_encode()
                  lcfirst()
       - Array:   array_replace()
                  array_replace_recursive()
       - Date:    date_add()
                  date_sub()
                  date_diff()
                  date_parse_from_format()
                  date_create_from_format()
                  date_get_last_errors()
                  timezone_version_get()
       - INI:     parse_ini_string()
       - GMP:     gmp_testbit()
       - Hash:    hash_copy()
       - IMAP:    imap_gc()
                  imap_utf8_to_mutf7()
                  imap_mutf7_to_utf8()
       - JSON:    json_last_error()
       - libxml:  libxml_disable_entity_loader
       - MySQLi:  mysqli_fetch_all()
                  mysqli_get_connection_stats()
                  mysqli_poll()
                  mysqli_reap_async_query()
       - Network: gethostname()
                  header_remove()
       - OpenSSL: openssl_random_pseudo_bytes()
       - PCNTL:   pcntl_signal_dispatch()
                  pcntl_sigprocmask()
                  pcntl_sigwaitinfo()
                  pcntl_sigtimedwait()
       - PCRE:    preg_filter()
       - SHM:     msg_queue_exists()
                  shm_has_var()
       - Streams: stream_supports_lock()
                  stream_context_set_default()
                  stream_context_get_params()
       - Userspace stream wrappers:
                  stream_cast()
                  stream_set_options()

     f. New global constants

       - Core:    E_DEPRECATED
                  E_USER_DEPRECATED
                  __DIR__
                  __NAMESPACE__
                  PHP_MAXPATHLEN
                  PHP_WINDOWS_VERSION_MAJOR
                  PHP_WINDOWS_VERSION_MINOR
                  PHP_WINDOWS_VERSION_BUILD
                  PHP_WINDOWS_VERSION_PLATFORM
                  PHP_WINDOWS_VERSION_SP_MAJOR
                  PHP_WINDOWS_VERSION_SP_MINOR
                  PHP_WINDOWS_VERSION_SUITEMASK
                  PHP_WINDOWS_VERSION_PRODUCTTYPE
                  PHP_WINDOWS_NT_DOMAIN_CONTROLLER
                  PHP_WINDOWS_NT_SERVER
                  PHP_WINDOWS_NT_WORKSTATION
       - INI:     INI_SCANNER_NORMAL
                  INI_SCANNER_RAW
       - cURL     CURLOPT_PROGRESSFUNCTION
       - GD:      IMG_FILTER_PIXELATE
       - JSON:    JSON_ERROR_NONE
                  JSON_ERROR_DEPTH
                  JSON_ERROR_STATE_MISMATCH
                  JSON_ERROR_CTRL_CHAR
                  JSON_ERROR_SYNTAX
                  JSON_FORCE_OBJECT
                  JSON_HEX_TAG
                  JSON_HEX_AMP
                  JSON_HEX_APOS
                  JSON_HEX_QUOT
       - LDAP:    LDAP_OPT_NETWORK_TIMEOUT
       - libxml:  LIBXML_LOADED_VERSION 
       - PCRE:    PREG_BAD_UTF8_OFFSET_ERROR
       - PCNTL:   SIG_BLOCK
                  SIG_UNBLOCK
                  SIG_SETMASK
                  SI_USER
                  SI_NOINFO
                  SI_KERNEL
                  SI_QUEUE
                  SI_TIMER
                  SI_MESGQ
                  SI_ASYNCIO
                  SI_SIGIO
                  SI_TKILL
                  CLD_EXITED
                  CLD_KILLED
                  CLD_DUMPED
                  CLD_TRAPPED
                  CLD_STOPPED
                  CLD_CONTINUED
                  TRAP_BRKPT
                  TRAP_TRACE
                  POLL_IN
                  POLL_OUT
                  POLL_MSG
                  POLL_ERR
                  POLL_PRI
                  POLL_HUP
                  ILL_ILLOPC
                  ILL_ILLOPN
                  ILL_ILLADR
                  ILL_ILLTRP
                  ILL_PRVOPC
                  ILL_PRVREG
                  ILL_COPROC
                  ILL_BADSTK
                  FPE_INTDIV
                  FPE_INTOVF
                  FPE_FLTDIV
                  FPE_FLTOVF
                  FPE_FLTUND
                  FPE_FLTRES
                  FPE_FLTINV
                  FPE_FLTSUB
                  SEGV_MAPERR
                  SEGV_ACCERR
                  BUS_ADRALN
                  BUS_ADRERR
                  BUS_OBJERR

     g. New classes

       - Date:    DateInterval
                  DatePeriod
       - Phar:    Phar
                  PharData
                  PharFileInfo
                  PharException
       - SPL      SplDoublyLinkedList
                  SplStack
                  SplQueue
                  SplHeap
                  SplMinHeap
                  SplMaxHeap
                  SplPriorityQueue
                  SplFixedArray
                  FilesystemIterator
                  GlobIterator
                  RecursiveTreeIterator
                  MultipleIterator

     h. New methods

       - Date:         DateTime::diff()
                       DateTime::add()
                       DateTime::sub()
                       DateTime::createFromFormat()
                       DateTime::getLastErrors()
       - DOM:          DOMNode::getLineNo()
       - Exception:    Exception::getPrevious()
       - PDO_Firebird: PDO::setAttribute()
       - Reflection:   ReflectionProperty::setAccessible()
                       ReflectionFunction::inNamespace()
                       ReflectionFunction::getNamespaceName()
                       ReflectionFunction::getShortName()
                       ReflectionClass::inNamespace()
                       ReflectionClass::getNamespaceName()
                       ReflectionClass::getShortName()
       - SPL           SplObjectStorage::addAll()
                       SplObjectStorage::removeAll()
       - XSL:          XSLTProcessor::setProfiling()

     i. New class constants

       - PDO_Firebird: PDO::FB_ATTR_DATE_FORMAT
                       PDO::FB_ATTR_TIME_FORMAT
                       PDO::FB_ATTR_TIMESTAMP_FORMAT
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.