com doc/zh: 更新 realpath() Close php/d oc-zh#24: reference/filesystem/functions/realpath.x ml
[email protected] (Dai Jie) Tue, 09 Mar 2021 06:53:58 +0000
| Newsgroups | php.doc.zh |
|---|---|
| Message-ID | <[email protected]> |
Commit: 1480266d126e2579a165707e3e51daef751dd43c=0AAuthor: =E8=92= =8B=E6=96=87=E5=81=A5 <[email protected]> Tue, 9 Mar 2021 11:14:35 += 0800=0ACommitter: daijie <[email protected]> Tue, 9 Mar 2021 14:53:58 +08= 00=0AParents: 3bbc58b1d5c60829a3e0fbb63723ca400d170ae1=0ABranches: maste= r=0A=0ALink: http://git.php.net/?p=3Ddoc/zh.git;a=3Dcommitdiff;h=3D14= 80266d126e2579a165707e3e51daef751dd43c=0A=0ALog:=0A=E6=9B=B4=E6=96=B0 realp= ath()=0AClose php/doc-zh#24=0A=0ABugs:=0Ahttps://bugs.php.net/24=0A=0AChang= ed paths:=0A M reference/filesystem/functions/realpath.xml=0A=0A=0ADiff:= =0Adiff --git a/reference/filesystem/functions/realpath.xml b/reference/fil= esystem/functions/realpath.xml=0Aindex 7ef8bd06..5663d471 100644=0A--- a/re= ference/filesystem/functions/realpath.xml=0A+++ b/reference/filesystem/func= tions/realpath.xml=0A@@ -1,28 +1,27 @@=0A <?xml version=3D"1.0" encoding=3D= "utf-8"?>=0A <!-- $Revision$ -->=0A <!-- $Author$ -->=0A-<!-- EN-Revision: = 71895e9afbfad9767d53f4f37b8573744aedaf96 Maintainer: dallas Status: ready -= ->=0A+<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer= : dallas Status: ready -->=0A <refentry xml:id=3D"function.realpath" xmlns= =3D"http://docbook.org/ns/docbook">=0A <refnamediv>=0A <refname>realpath= </refname>=0A <refpurpose>=E8=BF=94=E5=9B=9E=E8=A7=84=E8=8C=83=E5=8C= =96=E7=9A=84=E7=BB=9D=E5=AF=B9=E8=B7=AF=E5=BE=84=E5=90=8D</refpurpose>=0A = </refnamediv>=0A =0A- <refsect1 role=3D"description">=0A+ <refsect1 role= =3D"description">=0A &reftitle.description;=0A <methodsynopsis>=0A- <= type>string</type><methodname>realpath</methodname>=0A+ <type class=3D"un= ion"><type>string</type><type>false</type></type><methodname>realpath</meth= odname>=0A <methodparam><type>string</type><parameter>path</parameter></= methodparam>=0A </methodsynopsis>=0A <para>=0A- <function>realpath</f= unction> =E6=89=A9=E5=B1=95=E6=89=80=E6=9C=89=E7=9A=84=E7=AC=A6=E5=8F=B7= =E8=BF=9E=E6=8E=A5=E5=B9=B6=E4=B8=94=E5=A4=84=E7=90=86=E8=BE=93=E5=85=A5= =E7=9A=84=0A- <parameter>path</parameter> =E4=B8=AD=E7=9A=84 '/./', '/../= ' =E4=BB=A5=E5=8F=8A=E5=A4=9A=E4=BD=99=E7=9A=84 '/'=0A- =E5=B9=B6= =E8=BF=94=E5=9B=9E=E8=A7=84=E8=8C=83=E5=8C=96=E5=90=8E=E7=9A=84=E7=BB=9D= =E5=AF=B9=E8=B7=AF=E5=BE=84=E5=90=8D=E3=80=82=E8=BF=94=E5=9B=9E=E7=9A=84= =E8=B7=AF=E5=BE=84=E4=B8=AD=E6=B2=A1=E6=9C=89=E7=AC=A6=E5=8F=B7=E8=BF=9E= =E6=8E=A5=EF=BC=8C'/./'=0A- =E6=88=96 '/../' =E6=88=90=E5=88=86=E3=80= =82=0A+ <function>realpath</function> =E6=89=A9=E5=B1=95=E6=89=80= =E6=9C=89=E7=AC=A6=E5=8F=B7=E8=BF=9E=E6=8E=A5=EF=BC=8C=E5=B9=B6=E5=A4=84= =E7=90=86=E8=BE=93=E5=85=A5=0A+ <parameter>path</parameter> =E4=B8=AD= =E7=9A=84 <literal>/./</literal>=E3=80=81<literal>/../</literal> =E5=92= =8C=E5=A4=9A=E4=BD=99=E7=9A=84=0A+ <literal>/</literal>=EF=BC=8C=E5=B9= =B6=E8=BF=94=E5=9B=9E=E8=A7=84=E8=8C=83=E5=8C=96=E7=9A=84=E7=BB=9D=E5=AF= =B9=E8=B7=AF=E5=BE=84=E5=90=8D=E3=80=82=0A </para>=0A </refsect1>=0A- = =0A- <refsect1 role=3D"parameters">=0A+=0A+ <refsect1 role=3D"parameters">= =0A &reftitle.parameters;=0A <para>=0A <variablelist>=0A@@ -30,11 +2= 9,11 @@=0A <term><parameter>path</parameter></term>=0A <listitem>= =0A <para>=0A- =E8=A6=81=E6=A3=80=E6=9F=A5=E7=9A=84=E8=B7=AF= =E5=BE=84=E3=80=82=0A+ =E8=A6=81=E5=A4=84=E7=90=86=E7=9A=84=E8=B7= =AF=E5=BE=84=E3=80=82=0A <note>=0A <para>=0A- Whilst= a path must be supplied, the value can be blank or &null;=0A- In t= hese cases, the value is interpreted as the current directory.=0A+ = =E8=99=BD=E7=84=B6=E5=BF=85=E9=A1=BB=E6=8F=90=E4=BE=9B=E8=B7=AF=E5=BE=84= =EF=BC=8C=E4=BD=86=E8=AF=A5=E5=80=BC=E5=8F=AF=E4=BB=A5=E6=98=AF=E4=B8=80= =E4=B8=AA=E7=A9=BA=E5=AD=97=E7=AC=A6=E4=B8=B2=E3=80=82=0A+ = =E5=9C=A8=E8=BF=99=E7=A7=8D=E6=83=85=E5=86=B5=E4=B8=8B=EF=BC=8C=E8=AF=A5= =E5=80=BC=E5=B0=86=E8=A2=AB=E8=A7=A3=E9=87=8A=E4=B8=BA=E5=BD=93=E5=89=8D= =E7=9B=AE=E5=BD=95=E3=80=82=0A </para>=0A </note>=0A <= /para>=0A@@ -44,57 +43,38 @@=0A </para>=0A </refsect1>=0A =0A- <refsec= t1 role=3D"returnvalues">=0A+ <refsect1 role=3D"returnvalues">=0A &reftit= le.returnvalues;=0A <para>=0A- Returns the canonicalized absolute pathn= ame on success. The resulting path =0A- will have no symbolic link, '/./'= or '/../' components.=0A+ =E6=88=90=E5=8A=9F=E6=97=B6=E8=BF=94=E5=9B= =9E=E8=A7=84=E8=8C=83=E5=8C=96=E7=9A=84=E7=BB=9D=E5=AF=B9=E8=B7=AF=E5=BE= =84=E5=90=8D=E3=80=82=E8=BF=94=E5=9B=9E=E7=9A=84=E8=B7=AF=E5=BE=84=E4=B8= =AD=E6=B2=A1=E6=9C=89=E7=AC=A6=E5=8F=B7=E8=BF=9E=E6=8E=A5=EF=BC=88symbolic = link=EF=BC=89=E3=80=81<literal>/./</literal> =E6=88=96 <literal>/../</liter= al> =E6=88=90=E5=88=86=E3=80=82=0A+ =E4=BE=8B=E5=A6=82 <literal>\</litera= l> =E5=92=8C <literal>/</literal> =E8=BF=99=E6=A0=B7=E7=9A=84=E5=B0=BE= =E9=9A=8F=E5=88=86=E9=9A=94=E7=AC=A6=E4=B9=9F=E5=B0=86=E8=A2=AB=E5=88=A0= =E9=99=A4=E3=80=82=0A </para>=0A <para>=0A- <function>realpath</funct= ion> =E5=A4=B1=E8=B4=A5=E6=97=B6=E8=BF=94=E5=9B=9E &false;=EF=BC=8C= =E6=AF=94=E5=A6=82=E8=AF=B4=E6=96=87=E4=BB=B6=E4=B8=8D=E5=AD=98=E5=9C=A8= =E7=9A=84=E8=AF=9D=E3=80=82=0A+ <function>realpath</function> =E5=A4= =B1=E8=B4=A5=E6=97=B6=E8=BF=94=E5=9B=9E &false;=EF=BC=8C=E4=BE=8B=E5=A6= =82=E6=96=87=E4=BB=B6=E4=B8=8D=E5=AD=98=E5=9C=A8=E3=80=82=0A </para>=0A = <note>=0A <para>=0A- The running script must have executable permiss= ions on all directories in=0A- the hierarchy, otherwise <function>realpa= th</function> will return=0A- &false;.=0A+ =E5=BD=93=E5=89=8D= =E8=BF=90=E8=A1=8C=E7=9A=84=E8=84=9A=E6=9C=AC=E5=BF=85=E9=A1=BB=E5=AF=B9= =E8=A6=81=E5=A4=84=E7=90=86=E7=9A=84=E8=B7=AF=E5=BE=84=E4=B8=AD=E7=9A=84= =E6=AF=8F=E5=B1=82=E7=9B=AE=E5=BD=95=E9=83=BD=E5=85=B7=E6=9C=89=E5=8F=AF= =E6=89=A7=E8=A1=8C=E6=9D=83=E9=99=90=EF=BC=8C=E5=90=A6=E5=88=99=0A+ <fun= ction>realpath</function> =E5=B0=86=E8=BF=94=E5=9B=9E &false;=E3=80=82=0A+ = </para>=0A+ </note>=0A+ <note>=0A+ <para>=0A+ =E5=AF=B9=E4=BA= =8E=E4=B8=8D=E5=8C=BA=E5=88=86=E5=A4=A7=E5=B0=8F=E5=86=99=E7=9A=84=E6=96= =87=E4=BB=B6=E7=B3=BB=E7=BB=9F=EF=BC=8C<function>realpath</function> = =E4=B8=8D=E4=B8=80=E5=AE=9A=E4=BC=9A=E8=A7=84=E8=8C=83=E5=AD=97=E7=AC=A6= =E5=A4=A7=E5=B0=8F=E5=86=99=E3=80=82=0A+ </para>=0A+ </note>=0A+ <note>= =0A+ <para>=0A+ <function>realpath</function> =E5=87=BD=E6=95=B0= =E4=B8=8D=E9=80=82=E7=94=A8=E4=BA=8E Phar =E5=86=85=E7=9A=84=E6=96=87= =E4=BB=B6=EF=BC=8C=E5=9B=A0=E4=B8=BA=E8=AF=A5=E8=B7=AF=E5=BE=84=E6=98=AF= =E8=99=9A=E6=8B=9F=E8=B7=AF=E5=BE=84=EF=BC=8C=E8=80=8C=E4=B8=8D=E6=98=AF= =E7=9C=9F=E5=AE=9E=E8=B7=AF=E5=BE=84=E3=80=82=0A+ </para>=0A+ </note>=0A= + <note>=0A+ <para>=0A+ =E5=9C=A8 Windows =E4=B8=8A=EF=BC=8C=E7=9B= =AE=E5=BD=95=E7=9A=84=E7=BB=93=E7=82=B9=E5=92=8C=E7=AC=A6=E5=8F=B7=E9=93= =BE=E6=8E=A5=E4=BB=85=E6=89=A9=E5=B1=95=E4=B8=80=E7=BA=A7=E3=80=82=0A </= para>=0A </note>=0A &fs.file.32bit;=0A </refsect1>=0A- =0A- <refsect1 = role=3D"changelog">=0A- &reftitle.changelog;=0A- <para>=0A- <informalta= ble>=0A- <tgroup cols=3D"2">=0A- <thead>=0A- <row>=0A- <e= ntry>&Version;</entry>=0A- <entry>&Description;</entry>=0A- </ro= w>=0A- </thead>=0A- <tbody>=0A- <row>=0A- <entry>5.3.0</= entry>=0A- <entry>=0A- =E5=9C=A8=E4=B9=8B=E5=89=8D=E7=9A=84= =E7=89=88=E6=9C=AC=E4=B8=AD=EF=BC=8C=E5=9C=A8 *BSD=0A- =E7=B3=BB=E7=BB= =9F=E4=B8=8A=EF=BC=8C=E5=A6=82=E6=9E=9C=E4=BB=85=E4=BB=85=E6=98=AF <paramet= er>path</parameter> =E4=B8=8D=E5=AD=98=E5=9C=A8=E7=9A=84=E8=AF=9D=EF=BC= =8C<function>realpath</function>=0A- =E5=B9=B6=E4=B8=8D=E4=BC=9A=E5=83= =8F=E5=85=B6=E5=AE=83=E7=B3=BB=E7=BB=9F=E9=82=A3=E6=A0=B7=E8=BF=94=E5=9B= =9E &false;=E3=80=82=0A- </entry>=0A- </row>=0A- <row>=0A- = <entry>5.0.0</entry>=0A- <entry>=0A- =E5=9C=A8=E6=AD= =A4=E4=B9=8B=E5=89=8D=E7=9A=84=E7=89=88=E6=9C=AC=E4=B8=AD=EF=BC=8C=E5=A6= =82=E6=9E=9C <parameter>path</parameter> =E4=BC=A0=E5=85=A5=E4=BA=86= =E7=A9=BA=E6=88=96=E8=80=85 =0A- &null;=EF=BC=8C=E5=B0=86=E5=AF=BC=E8=87= =B4 <function>realpath</function> =E8=BF=94=E5=9B=9E=E8=84=9A=E6=9C=AC= =E5=BD=93=E5=89=8D=E7=9A=84=E7=9B=AE=E5=BD=95=E3=80=82=0A- </entry>= =0A- </row>=0A- </tbody>=0A- </tgroup>=0A- </informaltable>= =0A- </para>=0A- </refsect1>=0A =0A <refsect1 role=3D"examples">=0A &re= ftitle.examples;=0A@@ -105,7 +85,9 @@=0A <![CDATA[=0A <?php=0A chdir('/var/= www/');=0A-echo realpath('./../../etc/passwd');=0A+echo realpath('./../../e= tc/passwd') . PHP_EOL;=0A+=0A+echo realpath('/tmp/') . PHP_EOL;=0A ?>=0A ]]= >=0A </programlisting>=0A@@ -113,18 +95,21 @@ echo realpath('./../../et= c/passwd');=0A <screen>=0A <![CDATA[=0A /etc/passwd=0A+/tmp=0A ]]>=0A = </screen>=0A </example>=0A <example>=0A <title>Windows = =E4=B8=8A=E7=9A=84 <function>realpath</function></title>=0A <para>=0A- = =E5=9C=A8 Windows =E4=B8=8A=EF=BC=8C<function>realpath</function> = =E4=BC=9A=E5=B0=86 unix =E9=A3=8E=E6=A0=BC=E7=9A=84=E8=B7=AF=E5=BE=84= =E6=94=B9=E6=88=90 Windows =E9=A3=8E=E6=A0=BC=E7=9A=84=E3=80=82=0A+ = =E5=9C=A8 Windows =E4=B8=8A=EF=BC=8C<function>realpath</function> =E4=BC= =9A=E5=B0=86 unix =E9=A3=8E=E6=A0=BC=E7=9A=84=E8=B7=AF=E5=BE=84=E6=94=B9= =E6=88=90 Windows =E9=A3=8E=E6=A0=BC=E3=80=82=0A </para>=0A <progra= mlisting role=3D"php">=0A <![CDATA[=0A <?php=0A-echo realpath('/windows/sys= tem32');=0A+echo realpath('/windows/system32'), PHP_EOL;=0A+=0A+echo realpa= th('C:\Program Files\\'), PHP_EOL;=0A ?>=0A ]]>=0A </programlisting>=0A= @@ -132,13 +117,14 @@ echo realpath('/windows/system32');=0A <screen>= =0A <![CDATA[=0A C:\WINDOWS\System32=0A+C:\Program Files=0A ]]>=0A </sc= reen>=0A </example>=0A </para>=0A </refsect1>=0A- =0A- <refsect1 rol= e=3D"seealso">=0A+=0A+ <refsect1 role=3D"seealso">=0A &reftitle.seealso;= =0A <para>=0A <simplelist>=0A@@ -148,9 +134,8 @@ C:\WINDOWS\System32= =0A </simplelist>=0A </para>=0A </refsect1>=0A- =0A-</refentry>=0A = =0A+</refentry>=0A <!-- Keep this comment at the end of the file=0A Local v= ariables:=0A mode: sgml=0A