Description:
------------
Could you please let the documentation for ZipArchive::addFile() reflect, that the function doesn't really add the added files content to the zip archive any longer?

As it seems, the files content is only read when storing the files now, as opposed to 5.2.8. So, if you delete a file directly after adding it to a zip archive, the archive won't be created any longer.

I'm not really sure, if this is a bug, since the return value of addFile() isn't true any longer, or if this is just a documentation problem.

Personaly, I don't care either way. I just spend about two hours, until I realized where the problem was. Having a reminder in the docs would have reduced this time down to about five minutes...

There is a bug report (#40494) talking about such information in the manual, but the bug was marked bogus, and the manual was never updated. Essentially, that's why I opened this one as a documentation problem.

Test script:
---------------
<?php
  // works in PHP 5.2.8:

  $zipArchive='/path/2/my/archive';
  $filesToAdd=array('/path/2/file1.ext',
                    '/path/2/file2.ext',
                    '/path/2/file3.ext');

  $zip=new ZipArchive();
  if(true===$zip->open($zipArchive,ZIPARCHIVE::CREATE))
    foreach($filesToAdd as $file)
      if($zip->addFile($file,basename($file)))
        unlink($file);
    
  $zip->close();

  /* Expected result:
   *   Zip archive exists and contains the right data
   *
   * Actual result:
   *   Version 5.2.8: 
   *     - Works flawlessly & as expected
   *   Version 5.3.99-dev
   *     - No zip archive created
   *     - ZipArchive::GetStatusString reports a read error, 
   *       but only after closing the file
   */
?>

Expected result:
----------------
Zip archive exists and contains the right data.

Actual result:
--------------
Version 5.2.8: 
  - Works flawlessly & as expected

Version 5.3.99-dev
  - No zip archive created
  - ZipArchive::GetStatusString reports a read error, 
    but only after closing the file