sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-16 00:48:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

dirname(): add warning about risk of infinite loop

Browse source 
Co-authored-by: jrfnl <jrfnl@users.noreply.github.com>

Closes GH-1005.
This commit is contained in:
Juliette 2021-11-08 13:20:57 +01:00 committed by GitHub
parent 41c8533ff5
commit 67ca0d930c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
reference/filesystem/functions/dirname.xml
View file

@ -82,6 +82,25 @@
<parameter>path</parameter> with any trailing
<literal>/component</literal> removed.
</para>
<caution>
<para>
Be careful when using this function in a loop that can reach the
top-level directory as this can result in an infinite loop.
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
dirname('.'); // Will return '.'.
dirname('/'); // Will return `\` on Windows and '/' on *nix systems.
dirname('\\'); // Will return `\` on Windows and '.' on *nix systems.
dirname('C:\\'); // Will return 'C:\' on Windows and '.' on *nix systems.
?>
]]>
</programlisting>
</informalexample>
</para>
</caution>
</refsect1>
<refsect1 role="changelog">