rfc:linking_in_stream_wrappers

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
rfc:linking_in_stream_wrappers [2014/11/30 20:20] – mikey179rfc:linking_in_stream_wrappers [2021/03/27 14:47] (current) – Move to inactive ilutov
Line 4: Line 4:
   * Author: Timm Friebe, thekid@php.net   * Author: Timm Friebe, thekid@php.net
   * Contributor: Frank Kleine, https://github.com/mikey179/   * Contributor: Frank Kleine, https://github.com/mikey179/
-  * Status: Draft+  * Status: Inactive
   * First Published at: https://wiki.php.net/rfc/linking_in_stream_wrappers   * First Published at: https://wiki.php.net/rfc/linking_in_stream_wrappers
  
Line 82: Line 82:
    *    *
    * @param  string $link    * @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) {   function url_readlink($link) {
Line 90: Line 90:
 </PHP> </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> <PHP>
 symlink('foo://some/resource', 'bar://another/resource'); // will yield a PHP_WARNING and return false symlink('foo://some/resource', 'bar://another/resource'); // will yield a PHP_WARNING and return false
Line 132: Line 136:
 ===== Patches and Tests ===== ===== Patches and Tests =====
 TODO: Implement and submit GitHub pull request. TODO: Implement and submit GitHub pull request.
 +https://github.com/thekid/php-src/compare/rfc/linking_in_stream_wrappers
  
 ===== References ===== ===== 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]]
rfc/linking_in_stream_wrappers.txt · Last modified: 2021/03/27 14:47 by ilutov

Page Tools