php-doc-en/reference/filesystem/functions
Christoph M. Becker 88c1f8d6c9 Fix/clarify dirname/basename docs wrt. locales
For basename(), we declare the behavior regarding invalid characters in
the path as being undefined, since that depends on the availability of
mblen, and also on the position of the invalid characters prior to PHP
8.0.0[1].

dirname() is actually not local-aware, but relies on an ASCII
compatible character encoding regarding the directory separator.  On
Windows, it is however, dependent on the currently set codepage
(although a fallback is still in place to use the Windows ANSI codepage
of the operating system[2], if the string is not valid for the current
codepage).

Again, we declared failure to comply to these assumptions as resulting
in undefined behavior.  Users should make sure to pass valid strings.

[1] <http://git.php.net/?p=php-src.git;a=commitdiff;h=90705d44e3da1d0aa7b8b4fd921ec597391eccb2>
[2] <5e01542526/win32/codepage.h (L95-L106)>
2021-02-19 15:12:33 +01:00
..
basename.xml Fix/clarify dirname/basename docs wrt. locales 2021-02-19 15:12:33 +01:00
chgrp.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
chmod.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
chown.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
clearstatcache.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
copy.xml Remove more changelog entries, mostly from PHP 5.3 era 2020-09-26 14:08:59 +00:00
delete.xml Reword description for delete placehold page. 2019-04-24 17:07:17 +00:00
dirname.xml Fix/clarify dirname/basename docs wrt. locales 2021-02-19 15:12:33 +01:00
disk-free-space.xml Fix return types 2020-11-02 15:52:35 +00:00
disk-total-space.xml Fix return types 2020-11-02 15:52:35 +00:00
diskfreespace.xml Converted to utf-8 2010-03-28 22:10:10 +00:00
fclose.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
feof.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
fflush.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
fgetc.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
fgetcsv.xml Revert revision 351727 from phpdoc/en/trunk: 2020-11-28 17:58:32 +00:00
fgets.xml fgets() can return false 2021-01-28 12:41:51 +01:00
fgetss.xml changed warning about deleted functions as of PHP 8.0.0. 2021-02-10 03:44:01 +09:00
file-exists.xml Link to SplFileInfo from is_file()/file_exists() docs 2021-01-10 13:37:52 +01:00
file-get-contents.xml file_get_contents() raises warning for directories 2021-01-22 14:43:22 +01:00
file-put-contents.xml Revert revision(s) 351724 from phpdoc/en/trunk: 2020-11-28 18:05:44 +00:00
file.xml Revert revision(s) 351724 from phpdoc/en/trunk: 2020-11-28 18:05:44 +00:00
fileatime.xml Fix return types 2020-11-02 15:52:35 +00:00
filectime.xml Fix return types 2020-11-02 15:52:35 +00:00
filegroup.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
fileinode.xml Fix return types 2020-11-02 15:52:35 +00:00
filemtime.xml Fix return types 2020-11-02 15:52:35 +00:00
fileowner.xml Fix return types 2020-11-02 15:52:35 +00:00
fileperms.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
filesize.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
filetype.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
flock.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
fnmatch.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
fopen.xml Revert revision(s) 351724 from phpdoc/en/trunk: 2020-11-28 18:05:44 +00:00
fpassthru.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
fputcsv.xml Fix return types 2020-11-02 15:52:35 +00:00
fputs.xml Converted to utf-8 2010-03-28 22:10:10 +00:00
fread.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
fscanf.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
fseek.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
fstat.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
ftell.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
ftruncate.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
fwrite.xml Revert revision(s) 351724 from phpdoc/en/trunk: 2020-11-28 18:05:44 +00:00
glob.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
is-dir.xml Remove safe_mode related information 2020-10-13 22:07:26 +00:00
is-executable.xml Remove changelogs for PHP 4 - 3rd round 2014-08-27 17:46:13 +00:00
is-file.xml Link to SplFileInfo from is_file()/file_exists() docs 2021-01-10 13:37:52 +01:00
is-link.xml Move the "emits E_WARNING" paragraph for functions that do so when an internal 2010-12-13 09:04:07 +00:00
is-readable.xml File functions with directories 2012-09-22 14:12:33 +00:00
is-uploaded-file.xml Fix typo in is-uploaded-file.xml (missing apostrophe) 2010-11-11 20:37:33 +00:00
is-writable.xml Move the "emits E_WARNING" paragraph for functions that do so when an internal 2010-12-13 09:04:07 +00:00
is-writeable.xml Converted to utf-8 2010-03-28 22:10:10 +00:00
lchgrp.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
lchown.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
link.xml Fix #80300: add "unlink" in "see also" section 2020-11-03 09:59:25 +00:00
linkinfo.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
lstat.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
mkdir.xml Remove safe_mode related information 2020-10-13 22:07:26 +00:00
move-uploaded-file.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
parse-ini-file.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
parse-ini-string.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
pathinfo.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
pclose.xml Fix #71804: proc_close does not return exit code 2016-06-29 18:23:56 +00:00
popen.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
readfile.xml Fix return types 2020-11-02 15:52:35 +00:00
readlink.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
realpath-cache-get.xml Replace _ by - in IDs 2012-01-12 12:40:04 +00:00
realpath-cache-size.xml Added more information about what the realpath_cache_size config option represents and added See Also link to the config option from the function of the same name 2013-09-05 10:24:19 +00:00
realpath.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
rename.xml Fix #71075: Update rename() docs to mention Windows-specific permissions issues 2020-11-05 15:49:38 +00:00
rewind.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
rmdir.xml Remove safe_mode related information 2020-10-13 22:07:26 +00:00
set-file-buffer.xml Converted to utf-8 2010-03-28 22:10:10 +00:00
stat.xml Improvements to stat() - document other file types 2021-02-15 16:37:42 +01:00
symlink.xml Fix #80300: add "unlink" in "see also" section 2020-11-03 09:59:25 +00:00
tempnam.xml Generate some standard methodsynopses based on stubs 2020-12-26 19:26:31 +00:00
tmpfile.xml Fix return types 2020-11-02 15:52:35 +00:00
touch.xml Remove more changelog entries, mostly from PHP 5.3 era 2020-09-26 14:08:59 +00:00
umask.xml Fixed spelling 2013-01-29 01:47:09 +00:00
unlink.xml Fix #79017: Can delete files in use by other processes 2019-12-29 12:46:35 +00:00