Doc #55143 [NEW]: Missing documentation for Phar::mount()

From: Operating system: Ubuntu Linux PHP version: 5.3.6 Package: PHAR related Bug Type: Documentation Problem Bug description:Missing documentation for Phar::mount() Description: ------------ Hi, on the manual page for Phar::mount some information is missing that may confuse users when using this method. 1. Unlike unix mount it is not possible to mount an external location to an existing path inside the phar. $pharpath must not exist or mount will fail. 2. When calling from inside a phar it not only may be a relative path, it MUST be a relative path or mount will fail. Mounting to foreign pahr locations inside a phar is not possible. --- From manual page: http://www.php.net/phar.mount%23Description --- Test script: --------------- <?php $phar = new Phar('file.phar'); $phar->startBuffering(); $phar->addStub('<?php require_once "phar://file.phar/index.php"; __HALT_COMPILER();'); $phar->addEmptyDir('foo'); $phar->addFromString('index.php', '<?php // This will Fail! Phar::mount("foo", "/etc/foo"); // This Will also fail: Phar::mount('phar:///home/www/some.other.phar/bar', '/tmp/info'); '); $phar->stopBuffering(); Expected result: ---------------- As documented I expected both mounts to work, but they don't Actual result: -------------- Code is throwing PharException -- Edit bug report at https://bugs.php.net/bug.php?id=55143&edit=1 -- Try a snapshot (PHP 5.2): https://bugs.php.net/fix.php?id=55143&r=trysnapshot52 Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=55143&r=trysnapshot53 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=55143&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=55143&r=fixed Fixed in SVN and need be documented: https://bugs.php.net/fix.php?id=55143&r=needdocs Fixed in release: https://bugs.php.net/fix.php?id=55143&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=55143&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=55143&r=needscript Try newer version: https://bugs.php.net/fix.php?id=55143&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=55143&r=support Expected behavior: https://bugs.php.net/fix.php?id=55143&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=55143&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=55143&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=55143&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=55143&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=55143&r=dst IIS Stability: https://bugs.php.net/fix.php?id=55143&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=55143&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=55143&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=55143&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=55143&r=mysqlcfg Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=55143&r=trysnapshot54