Bug->Doc #80724 [Opn]: FilesystemIterator::FOLLOW_SYMLINKS remove KEY_AS_FILE from bitmask

Edit report at https://bugs.php.net/bug.php?id=80724&edit=1 ID: 80724 Updated by: cmb@php.net Reported by: antonfedonyuk at gmail dot com Summary: FilesystemIterator::FOLLOW_SYMLINKS remove KEY_AS_FILE from bitmask Status: Open -Type: Bug +Type: Documentation Problem Package: SPL related Operating System: Any PHP Version: 7.3.27 Block user comment: N Private report: N New Comment: This behavior seems to be a deliberate design decision[1]; it actually makes some sense, since you don't want to get the basename only for symlinks, and mixing basenames and paths could be confusing an error prone. This needs to be documented, though. [1] <https://github.com/php/php-src/blob/php-7.4.15/ext/spl/spl_directory.h#L139-L143> Previous Comments: ------------------------------------------------------------------------ [2021-02-09 14:05:41] antonfedonyuk at gmail dot com Description: ------------ --- From manual page: https://php.net/class.filesystemiterator --- Flag FilesystemIterator::FOLLOW_SYMLINKS remove FilesystemIterator::KEY_AS_FILENAME from bitmask like this: FilesystemIterator::KEY_AS_FILENAME | FilesystemIterator::FOLLOW_SYMLINKS Test script: --------------- <?php // __DIR__ contains only self - 'test.php' $iterator = new FilesystemIterator(__DIR__, FilesystemIterator::KEY_AS_FILENAME); foreach ($iterator as $key => $value) { echo $key; } $iterator2 = new FilesystemIterator(__DIR__, FilesystemIterator::FOLLOW_SYMLINKS | FilesystemIterator::KEY_AS_FILENAME); foreach ($iterator2 as $key => $value) { echo $key; } Expected result: ---------------- iterator: 'test.php' iterator2: 'test.php' Actual result: -------------- iterator: 'test.php' iterator2: 'path/test.php' ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=80724&edit=1