Differences

This shows you the differences between two versions of the page.

--- rfc:linking_in_stream_wrappers [2014/11/30 20:20] – mikey179
+++ rfc:linking_in_stream_wrappers [2017/09/22 13:28] – external edit 127.0.0.1
@@ Line 82: / Line 82: @@
    *
    * @param  string $link
-   * @return string The link target or NULL
+   * @return string The link target or FALSE if the does not exist
    */
   function url_readlink($link) {
@@ Line 90: / Line 90: @@
 </PHP>
-==== Proposal ====
+  * When url_readlink() returns a string, it will be used as readlink()'s return value.
+  * When url_readlink() returns FALSE, readlink() quietly returns FALSE
+  * For all other return values of url_readlink(), a warning is raised and readlink() returns FALSE
+  * When url_readlink() is not implemented, a warning is raised an readlink() returns FALSE.
-Decisions during implementation process, to be refined for documentation:
+==== Limitations ====
+It will not be possible to create links between two different stream wrappers like this:
-* It will not be possible to create links between two different stream wrappers like so:
 <PHP>
 symlink('foo://some/resource', 'bar://another/resource'); // will yield a PHP_WARNING and return false
@@ Line 132: / Line 136: @@
 ===== Patches and Tests =====
 TODO: Implement and submit GitHub pull request.
+https://github.com/thekid/php-src/compare/rfc/linking_in_stream_wrappers
 ===== References =====
-See http://php.net/manual/en/class.streamwrapper.php
+  * http://php.net/manual/en/class.streamwrapper.php
-See https://github.com/mikey179/vfsStream/wiki/Known-Issues
+  * [[https://github.com/mikey179/vfsStream/wiki/Known-Issues|List of known issues in vfsStream]]
+  * [[https://github.com/mikey179/vfsStream/tree/linking|vfsStream reference userland implementation]]

Differences

Page Tools