cvs: phpdoc-zh /language control-structures.xml

From: Date: Thu, 25 Dec 2008 01:16:47 +0000
Subject: cvs: phpdoc-zh /language control-structures.xml
Groups: php.doc.zh 
Request: Send a blank email to doc-zh+get-3134@lists.php.net to get a copy of this message
eniac2008 Thu Dec 25 01:16:47 2008 UTC Modified files: /phpdoc-zh/language control-structures.xml Log: Sync with EN-Revision 1.131

http://cvs.php.net/viewvc.cgi/phpdoc-zh/language/control-structures.xml?r1=1.29&r2=1.30&diff_format=u Index: phpdoc-zh/language/control-structures.xml diff -u phpdoc-zh/language/control-structures.xml:1.29 phpdoc-zh/language/control-structures.xml:1.30 --- phpdoc-zh/language/control-structures.xml:1.29 Mon Dec 22 02:48:55 2008 +++ phpdoc-zh/language/control-structures.xml Thu Dec 25 01:16:47 2008 @@ -1,20 +1,21 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.29 $ --> -<!-- $Author: haohappy $ --> -<!-- EN-Revision: 1.131 Maintainer: dallas Status: ready --> +<?xml version="1.0" encoding="gb2312"?> +<!-- $Revision: 1.30 $ --> +<!-- $Author: eniac2008 $ --> +<!-- EN-Revision: 1.131 Maintainer: Altair Status: ready --> +<!-- CREDITS: dallas --> <chapter xml:id="language.control-structures" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>控制结构</title> + <title>¿ØÖƽṹ</title> <simpara> - 任何 PHP 脚本都是由一系列语句构成的。一条语句可以是一个赋值语句,一个函数调用,一个循环,一个条件语句或者甚至是一个什么也不做的语句(空语句)。语句通常以分号结束。此外,还可以用花括号将一组语句封装成一个语句组。语句组本身可以当作是一行语句。本章讲述了各种语句类型。 + ÈκΠPHP ½Å±¾¶¼ÊÇÓÉһϵÁÐÓï¾ä¹¹³ÉµÄ¡£Ò»ÌõÓï¾ä¿ÉÒÔÊÇÒ»¸ö¸³ÖµÓï¾ä£¬Ò»¸öº¯Êýµ÷Óã¬Ò»¸öÑ­»·£¬Ò»¸öÌõ¼þÓï¾ä»òÕßÉõÖÁÊÇÒ»¸öʲôҲ²»×öµÄÓï¾ä£¨¿ÕÓï¾ä£©¡£Óï¾äͨ³£ÒԷֺŽáÊø¡£´ËÍ⣬»¹¿ÉÒÔÓû¨À¨ºÅ½«Ò»×éÓï¾ä·â×°³ÉÒ»¸öÓï¾ä×é¡£Óï¾ä×é±¾Éí¿ÉÒÔµ±×÷ÊÇÒ»ÐÐÓï¾ä¡£±¾Õ½²ÊöÁ˸÷ÖÖÓï¾äÀàÐÍ¡£ </simpara> <sect1 xml:id="control-structures.if"> <title><literal>if</literal></title> <para> - <literal>if</literal> 结构是很多语言包括 PHP - 在内最重要的特性之一,它允许按照条件执行代码片段。PHP 的 - <literal>if</literal> 结构和 C 语言相似: + <literal>if</literal> ½á¹¹ÊǺܶàÓïÑÔ°üÀ¨ PHP + ÔÚÄÚ×îÖØÒªµÄÌØÐÔÖ®Ò»£¬ËüÔÊÐí°´ÕÕÌõ¼þÖ´ÐдúÂëÆ¬¶Î¡£PHP µÄ + <literal>if</literal> ½á¹¹ºÍ C ÓïÑÔÏàËÆ£º <informalexample> <programlisting> <![CDATA[ @@ -27,17 +28,17 @@ </informalexample> </para> <simpara> - 如同在<link - linkend="language.expressions">表达式</link>一章中定义的,<replaceable>expr</replaceable> - 按照布尔求值。如果 <replaceable>expr</replaceable> - 的值为 &true;,PHP 将执行 <replaceable>statement</replaceable>,如果值为 - &false; - 将忽略 <replaceable>statement</replaceable>。有关哪些值被视为 - &false; 的更多信息参见<link - linkend="language.types.boolean.casting">转换为布尔值</link>一节。 + ÈçͬÔÚ<link + linkend="language.expressions">±í´ïʽ</link>Ò»ÕÂÖж¨ÒåµÄ£¬<replaceable>expr</replaceable> + °´ÕÕ²¼¶ûÇóÖµ¡£Èç¹û <replaceable>expr</replaceable> + µÄֵΪ &true;£¬PHP ½«Ö´ÐÐ <replaceable>statement</replaceable>£¬Èç¹ûֵΪ + &false; £­ ½«ºöÂÔ <replaceable>statement</replaceable>¡£ÓйØÄÄЩֵ±»ÊÓΪ + &false; µÄ¸ü¶àÐÅÏ¢²Î¼û<link + linkend="language.types.boolean.casting">ת»»Îª²¼¶ûÖµ</link>Ò»½Ú¡£ </simpara> <para> - 如果 <varname>$a</varname> 大于 <varname>$b</varname>,则以下例子将显示 - <computeroutput>a is bigger than b</computeroutput>: + Èç¹û <varname>$a</varname> ´óÓÚ <varname>$b</varname>£¬ÔòÒÔÏÂÀý×Ó½«ÏÔʾ + <computeroutput>a is bigger than b</computeroutput>£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -50,11 +51,11 @@ </informalexample> </para> <para> - 经常需要按照条件执行不止一条语句,当然并不需要给每条语句都加上一个 - <literal>if</literal> 子句。可以将这些语句放入语句组中。例如,如果 - <varname>$a</varname> 大于 <varname>$b</varname>,以下代码将显示 - <computeroutput>a is bigger than b</computeroutput> 并且将 - <varname>$a</varname> 的值赋给 <varname>$b</varname>: + ¾­³£ÐèÒª°´ÕÕÌõ¼þÖ´Ðв»Ö¹Ò»ÌõÓï¾ä£¬µ±È»²¢²»ÐèÒª¸øÃ¿ÌõÓï¾ä¶¼¼ÓÉÏÒ»¸ö + <literal>if</literal> ×Ӿ䡣¿ÉÒÔ½«ÕâЩÓï¾ä·ÅÈëÓï¾ä×éÖС£ÀýÈ磬Èç¹û + <varname>$a</varname> ´óÓÚ <varname>$b</varname>£¬ÒÔÏ´úÂ뽫ÏÔʾ + <computeroutput>a is bigger than b</computeroutput> ²¢ÇÒ½« + <varname>$a</varname> µÄÖµ¸³¸ø <varname>$b</varname>£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -69,21 +70,21 @@ </informalexample> </para> <simpara> - <literal>if</literal> 语句可以无限层地嵌套在其它 - <literal>if</literal> 语句中,这给程序的不同部分的条件执行提供了充分的弹性。 + <literal>if</literal> Óï¾ä¿ÉÒÔÎÞÏÞ²ãµØÇ¶Ì×ÔÚÆäËü + <literal>if</literal> Óï¾äÖУ¬Õâ¸ø³ÌÐòµÄ²»Í¬²¿·ÖµÄÌõ¼þÖ´ÐÐÌṩÁ˳ä·ÖµÄµ¯ÐÔ¡£ </simpara> </sect1> <sect1 xml:id="control-structures.else"> <title><literal>else</literal></title> <para> - 经常需要在满足某个条件时执行一条语句,而在不满足该条件时执行其它语句,这正是 - <literal>else</literal> 的功能。<literal>else</literal> 延伸了 - <literal>if</literal> 语句,可以在 <literal>if</literal> - 语句中的表达式的值为 &false; 时执行语句。例如以下代码在 - <varname>$a</varname> 大于 <varname>$b</varname> 时显示 - <computeroutput>a is bigger than b</computeroutput>,反之则显示 - <computeroutput>a is NOT bigger than b</computeroutput>: + ¾­³£ÐèÒªÔÚÂú×ãij¸öÌõ¼þʱִÐÐÒ»ÌõÓï¾ä£¬¶øÔÚ²»Âú×ã¸ÃÌõ¼þʱִÐÐÆäËüÓï¾ä£¬ÕâÕýÊÇ + <literal>else</literal> µÄ¹¦ÄÜ¡£<literal>else</literal> ÑÓÉìÁË + <literal>if</literal> Óï¾ä£¬¿ÉÒÔÔÚ <literal>if</literal> + Óï¾äÖеıí´ïʽµÄֵΪ &false; ʱִÐÐÓï¾ä¡£ÀýÈçÒÔÏ´úÂëÔÚ + <varname>$a</varname> ´óÓÚ <varname>$b</varname> ʱÏÔʾ + <computeroutput>a is bigger than b</computeroutput>£¬·´Ö®ÔòÏÔʾ + <computeroutput>a is NOT bigger than b</computeroutput>£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -97,26 +98,26 @@ ]]> </programlisting> </informalexample> - <literal>else</literal> 语句仅在 <literal>if</literal> 以及 - <literal>elseif</literal>(如果有的话)语句中的表达式的值为 - &false; 时执行(参见 <link - linkend="control-structures.elseif">elseif</link>)。 + <literal>else</literal> Óï¾ä½öÔÚ <literal>if</literal> ÒÔ¼° + <literal>elseif</literal>£¨Èç¹ûÓеϰ£©Óï¾äÖеıí´ïʽµÄֵΪ + &false; ʱִÐУ¨²Î¼û <link + linkend="control-structures.elseif">elseif</link>£©¡£ </para> </sect1> <sect1 xml:id="control-structures.elseif"> - <title><literal>elseif</literal></title> + <title><literal>elseif</literal>/<literal>else if</literal></title> <para> - <literal>elseif</literal>,和此名称暗示的一样,是 - <literal>if</literal> 和 <literal>else</literal> 的组合。和 - <literal>else</literal> 一样,它延伸了 <literal>if</literal> - 语句,可以在原来的 <literal>if</literal> 表达式值为 &false; - 时执行不同语句。但是和 <literal>else</literal> 不一样的是,它仅在 - <literal>elseif</literal> 的条件表达式值为 &true; - 时执行语句。例如以下代码将根据条件分别显示 - <computeroutput>a is bigger than b</computeroutput>,<computeroutput>a - equal to b</computeroutput> 或者 - <computeroutput>a is smaller than b</computeroutput>: + <literal>elseif</literal>£¬ºÍ´ËÃû³Æ°µÊ¾µÄÒ»Ñù£¬ÊÇ + <literal>if</literal> ºÍ <literal>else</literal> µÄ×éºÏ¡£ºÍ + <literal>else</literal> Ò»Ñù£¬ËüÑÓÉìÁË <literal>if</literal> + Óï¾ä£¬¿ÉÒÔÔÚÔ­À´µÄ <literal>if</literal> ±í´ïʽֵΪ &false; + ʱִÐв»Í¬Óï¾ä¡£µ«ÊÇºÍ <literal>else</literal> ²»Ò»ÑùµÄÊÇ£¬Ëü½öÔÚ + <literal>elseif</literal> µÄÌõ¼þ±í´ïʽֵΪ &true; + ʱִÐÐÓï¾ä¡£ÀýÈçÒÔÏ´úÂ뽫¸ù¾ÝÌõ¼þ·Ö±ðÏÔʾ + <computeroutput>a is bigger than b</computeroutput>£¬<computeroutput>a + equal to b</computeroutput> »òÕß + <computeroutput>a is smaller than b</computeroutput>£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -134,28 +135,67 @@ </informalexample> </para> <simpara> - 在同一个 <literal>if</literal> 结构中可以有多个 - <literal>elseif</literal> 语句。第一个表达式值为 &true; 的 - <literal>elseif</literal> 语句(如果有的话)将会执行。在 - PHP 中,也可以写成“else - if”(两个单词),它和“elseif”(一个单词)的行为完全一样。句法分析的含义有少许区别(如果你熟悉 - C 语言的话,这是同样的行为),但是底线是两者会产生完全一样的行为。 - </simpara> - <simpara> - <literal>elseif</literal> 的语句仅在之前的 <literal>if</literal> 或 - <literal>elseif</literal> 的表达式值为 &false;,而当前的 - <literal>elseif</literal> 表达式值为 &true; 时执行。 - </simpara> + ÔÚͬһ¸ö <literal>if</literal> ½á¹¹ÖпÉÒÔÓжà¸ö + <literal>elseif</literal> Óï¾ä¡£µÚÒ»¸ö±í´ïʽֵΪ &true; µÄ + <literal>elseif</literal> Óï¾ä£¨Èç¹ûÓеϰ£©½«»áÖ´ÐС£ÔÚ + PHP ÖУ¬Ò²¿ÉÒÔд³É¡°else + if¡±£¨Á½¸öµ¥´Ê£©£¬ËüºÍ¡°elseif¡±£¨Ò»¸öµ¥´Ê£©µÄÐÐΪÍêȫһÑù¡£¾ä·¨·ÖÎöµÄº¬ÒåÓÐÉÙÐíÇø±ð£¨Èç¹ûÄãÊìϤ + C ÓïÑԵϰ£¬ÕâÊÇͬÑùµÄÐÐΪ£©£¬µ«Êǵ×ÏßÊÇÁ½Õß»á²úÉúÍêȫһÑùµÄÐÐΪ¡£ + </simpara> + <simpara> + <literal>elseif</literal> µÄÓï¾ä½öÔÚ֮ǰµÄ <literal>if</literal> »ò + <literal>elseif</literal> µÄ±í´ïʽֵΪ &false;£¬¶øµ±Ç°µÄ + <literal>elseif</literal> ±í´ïʽֵΪ &true; ʱִÐС£ + </simpara> + <note> + <simpara> + ±ØÐëҪעÒâµÄÊÇ <literal>elseif</literal> Óë <literal>else if</literal> Ö»ÓÐÔÚÀàËÆÉÏÀýÖÐʹÓôóÀ¨ºÅµÄÇé¿öϲÅÈÏΪÊÇÍêÈ«Ïàͬ + Note that <literal>elseif</literal> and <literal>else if</literal> + will only be considered exactly the same when using curly brackets + as in the above example. When using a colon to define your + <literal>if</literal>/<literal>elseif</literal> conditions, you must + not separate <literal>else if</literal> into two words, or PHP will + fail with a parse error. + </simpara> + </note> + <para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + +/* Incorrect Method: */ +if($a > $b): + echo $a." is greater than ".$b; +else if($a == $b): // Will not compile. + echo "The above line causes a parse error."; +endif; + + +/* Correct Method: */ +if($a > $b): + echo $a." is greater than ".$b; +elseif($a == $b): // Note the combination of the words. + echo $a." equals ".$b; +else: + echo $a." is neither greater than or equal to ".$b; +endif; + +?> +]]> + </programlisting> + </informalexample> + </para> </sect1> <sect1 xml:id="control-structures.alternative-syntax"> - <title>流程控制的替代语法</title> + <title>Á÷³Ì¿ØÖƵÄÌæ´úÓï·¨</title> <para> - PHP 提供了一些流程控制的替代语法,包括 - <literal>if</literal>,<literal>while</literal>,<literal>for</literal>,<literal>foreach</literal> - 和 <literal>switch</literal>。替代语法的基本形式是把左花括号({)换成冒号(:),把右花括号(})分别换成 - <literal>endif;</literal>,<literal>endwhile;</literal>,<literal>endfor;</literal>,<literal>endforeach;</literal> - 以及 <literal>endswitch;</literal>。 + PHP ÌṩÁËһЩÁ÷³Ì¿ØÖƵÄÌæ´úÓï·¨£¬°üÀ¨ + <literal>if</literal>£¬<literal>while</literal>£¬<literal>for</literal>£¬<literal>foreach</literal> + ºÍ <literal>switch</literal>¡£Ìæ´úÓï·¨µÄ»ù±¾ÐÎʽÊǰÑ×ó»¨À¨ºÅ£¨{£©»»³ÉðºÅ£¨:£©£¬°ÑÓÒ»¨À¨ºÅ£¨}£©·Ö±ð»»³É + <literal>endif;</literal>£¬<literal>endwhile;</literal>£¬<literal>endfor;</literal>£¬<literal>endforeach;</literal> + ÒÔ¼° <literal>endswitch;</literal>¡£ <informalexample> <programlisting role="php"> <![CDATA[ @@ -167,15 +207,15 @@ </informalexample> </para> <simpara> - 在上面的例子中,HTML 内容“A is equal to 5”用替代语法嵌套在 - <literal>if</literal> 语句中。该 HTML 的内容仅在 - <varname>$a</varname> 等于 5 时显示。 + ÔÚÉÏÃæµÄÀý×ÓÖУ¬HTML ÄÚÈÝ¡°A is equal to 5¡±ÓÃÌæ´úÓ﷨ǶÌ×ÔÚ + <literal>if</literal> Óï¾äÖС£¸Ã HTML µÄÄÚÈݽöÔÚ + <varname>$a</varname> µÈÓÚ 5 ʱÏÔʾ¡£ </simpara> <para> - 替代语法同样可以用在 <literal>else</literal> 和 - <literal>elseif</literal> 中。下面是一个包括 - <literal>elseif</literal> 和 <literal>else</literal> - 的 <literal>if</literal> 结构用替代语法格式写的例子: + Ìæ´úÓ﷨ͬÑù¿ÉÒÔÓÃÔÚ <literal>else</literal> ºÍ + <literal>elseif</literal> ÖС£ÏÂÃæÊÇÒ»¸ö°üÀ¨ + <literal>elseif</literal> ºÍ <literal>else</literal> + µÄ <literal>if</literal> ½á¹¹ÓÃÌæ´úÓï·¨¸ñʽдµÄÀý×Ó£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -195,18 +235,18 @@ </informalexample> </para> <para> - 更多例子参见 <link linkend="control-structures.while">while</link>,<link - linkend="control-structures.for">for</link> 和 - <link linkend="control-structures.if">if</link>。 + ¸ü¶àÀý×Ӳμû <link linkend="control-structures.while">while</link>£¬<link + linkend="control-structures.for">for</link> ºÍ + <link linkend="control-structures.if">if</link>¡£ </para> </sect1> <sect1 xml:id="control-structures.while"> <title><literal>while</literal></title> <para> - <literal>while</literal> 循环是 PHP 中最简单的循环类型。它和 - C 语言中的 <literal>while</literal> 表现得一样。<literal>while</literal> - 语句的基本格式是: + <literal>while</literal> Ñ­»·ÊÇ PHP ÖÐ×î¼òµ¥µÄÑ­»·ÀàÐÍ¡£ËüºÍ + C ÓïÑÔÖÐµÄ <literal>while</literal> ±íÏÖµÃÒ»Ñù¡£<literal>while</literal> + Óï¾äµÄ»ù±¾¸ñʽÊÇ£º <informalexample> <programlisting> <![CDATA[ @@ -217,14 +257,14 @@ </informalexample> </para> <simpara> - <literal>while</literal> 语句的含意很简单,它告诉 PHP 只要 - <literal>while</literal> 表达式的值为 &true; - 就重复执行嵌套中的循环语句。表达式的值在每次开始循环时检查,所以即使这个值在循环语句中改变了,语句也不会停止执行,直到本次循环结束。有时候如果 - <literal>while</literal> 表达式的值一开始就是 &false;,则循环语句一次都不会执行。 + <literal>while</literal> Óï¾äµÄº¬ÒâºÜ¼òµ¥£¬Ëü¸æËß PHP Ö»Òª + <literal>while</literal> ±í´ïʽµÄֵΪ &true; + ¾ÍÖØ¸´Ö´ÐÐǶÌ×ÖеÄÑ­»·Óï¾ä¡£±í´ïʽµÄÖµÔÚÿ´Î¿ªÊ¼Ñ­»·Ê±¼ì²é£¬ËùÒÔ¼´Ê¹Õâ¸öÖµÔÚÑ­»·Óï¾äÖиıäÁË£¬Óï¾äÒ²²»»áÍ£Ö¹Ö´ÐУ¬Ö±µ½±¾´ÎÑ­»·½áÊø¡£ÓÐʱºòÈç¹û + <literal>while</literal> ±í´ïʽµÄÖµÒ»¿ªÊ¼¾ÍÊÇ &false;£¬ÔòÑ­»·Óï¾äÒ»´Î¶¼²»»áÖ´ÐС£ </simpara> <para> - 和 <literal>if</literal> 语句一样,可以在 <literal>while</literal> - 循环中用花括号括起一个语句组,或者用替代语法: + ºÍ <literal>if</literal> Óï¾äÒ»Ñù£¬¿ÉÒÔÔÚ <literal>while</literal> + Ñ­»·ÖÐÓû¨À¨ºÅÀ¨ÆðÒ»¸öÓï¾ä×飬»òÕßÓÃÌæ´úÓï·¨£º <informalexample> <programlisting> <![CDATA[ @@ -237,7 +277,7 @@ </informalexample> </para> <para> - 下面两个例子完全一样,都显示数字 1 到 10: + ÏÂÃæÁ½¸öÀý×ÓÍêȫһÑù£¬¶¼ÏÔʾÊý×Ö 1 µ½ 10£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -268,15 +308,15 @@ <sect1 xml:id="control-structures.do.while"> <title><literal>do-while</literal></title> <simpara> - <literal>do-while</literal> 和 <literal>while</literal> - 循环非常相似,区别在于表达式的值是在每次循环结束时检查而不是开始时。和正规的 - <literal>while</literal> 循环主要的区别是 <literal>do-while</literal> - 的循环语句保证会执行一次(表达式的真值在每次循环结束后检查),然而在正规的 - <literal>while</literal> 循环中就不一定了(表达式真值在循环开始时检查,如果一开始就为 - &false; 则整个循环立即终止)。 + <literal>do-while</literal> ºÍ <literal>while</literal> + Ñ­»··Ç³£ÏàËÆ£¬Çø±ðÔÚÓÚ±í´ïʽµÄÖµÊÇÔÚÿ´ÎÑ­»·½áÊøÊ±¼ì²é¶ø²»ÊÇ¿ªÊ¼Ê±¡£ºÍÕý¹æµÄ + <literal>while</literal> Ñ­»·Ö÷ÒªµÄÇø±ðÊÇ <literal>do-while</literal> + µÄÑ­»·Óï¾ä±£Ö¤»áÖ´ÐÐÒ»´Î£¨±í´ïʽµÄÕæÖµÔÚÿ´ÎÑ­»·½áÊøºó¼ì²é£©£¬È»¶øÔÚÕý¹æµÄ + <literal>while</literal> Ñ­»·ÖоͲ»Ò»¶¨ÁË£¨±í´ïÊ½ÕæÖµÔÚÑ­»·¿ªÊ¼Ê±¼ì²é£¬Èç¹ûÒ»¿ªÊ¼¾ÍΪ + &false; ÔòÕû¸öÑ­»·Á¢¼´ÖÕÖ¹£©¡£ </simpara> <para> - <literal>do-while</literal> 循环只有一种语法: + <literal>do-while</literal> Ñ­»·Ö»ÓÐÒ»ÖÖÓï·¨£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -291,14 +331,14 @@ </informalexample> </para> <simpara> - 以上循环将正好运行一次,因为经过第一次循环后,当检查表达式的真值时,其值为 - &false;($i 不大于 0)而导致循环终止。 + ÒÔÉÏÑ­»·½«ÕýºÃÔËÐÐÒ»´Î£¬ÒòΪ¾­¹ýµÚÒ»´ÎÑ­»·ºó£¬µ±¼ì²é±í´ïʽµÄÕæÖµÊ±£¬ÆäֵΪ + &false;£¨$i ²»´óÓÚ 0£©¶øµ¼ÖÂÑ­»·ÖÕÖ¹¡£ </simpara> <para> - 资深的 C 语言用户可能熟悉另一种不同的 <literal>do-while</literal> - 循环用法,把语句放在 <literal>do-while</literal>(0) 之中,在循环内部用 + ×ÊÉîµÄ C ÓïÑÔÓû§¿ÉÄÜÊìϤÁíÒ»ÖÖ²»Í¬µÄ <literal>do-while</literal> + Ñ­»·Ó÷¨£¬°ÑÓï¾ä·ÅÔÚ <literal>do-while</literal>(0) Ö®ÖУ¬ÔÚÑ­»·ÄÚ²¿Óà <link linkend="control-structures.break"><literal>break</literal></link> - 语句来结束执行循环。以下代码片段示范了此方法: + Óï¾äÀ´½áÊøÖ´ÐÐÑ­»·¡£ÒÔÏ´úÂëÆ¬¶Îʾ·¶ÁË´Ë·½·¨£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -323,15 +363,15 @@ </informalexample> </para> <simpara> - 如果还不能立刻理解也不用担心。即使不用此“特性”也照样可以写出强大的代码来。 + Èç¹û»¹²»ÄÜÁ¢¿ÌÀí½âÒ²²»Óõ£ÐÄ¡£¼´Ê¹²»Óôˡ°ÌØÐÔ¡±Ò²ÕÕÑù¿ÉÒÔд³öÇ¿´óµÄ´úÂëÀ´¡£ </simpara> </sect1> <sect1 xml:id="control-structures.for"> <title><literal>for</literal></title> <para> - <literal>for</literal> 循环是 PHP 中最复杂的循环结构。它的行为和 - C 语言的相似。 <literal>for</literal> 循环的语法是: + <literal>for</literal> Ñ­»·ÊÇ PHP ÖÐ×ÔÓµÄÑ­»·½á¹¹¡£ËüµÄÐÐΪºÍ + C ÓïÑÔµÄÏàËÆ¡£ <literal>for</literal> Ñ­»·µÄÓï·¨ÊÇ£º <informalexample> <programlisting> <![CDATA[ @@ -342,24 +382,25 @@ </informalexample> </para> <simpara> - 第一个表达式(<varname>expr1</varname>)在循环开始前无条件求值一次。 + µÚÒ»¸ö±í´ïʽ£¨<varname>expr1</varname>£©ÔÚÑ­»·¿ªÊ¼Ç°ÎÞÌõ¼þÇóÖµÒ»´Î¡£ </simpara> <simpara> - <varname>expr2</varname> 在每次循环开始前求值。如果值为 - &true;,则继续循环,执行嵌套的循环语句。如果值为 &false;,则终止循环。 + <varname>expr2</varname> ÔÚÿ´ÎÑ­»·¿ªÊ¼Ç°ÇóÖµ¡£Èç¹ûֵΪ + &true;£¬Ôò¼ÌÐøÑ­»·£¬Ö´ÐÐǶÌ×µÄÑ­»·Óï¾ä¡£Èç¹ûֵΪ &false;£¬ÔòÖÕֹѭ»·¡£ </simpara> <simpara> - <varname>expr3</varname> 在每次循环之后被求值(执行)。 + <varname>expr3</varname> ÔÚÿ´ÎÑ­»·Ö®ºó±»ÇóÖµ£¨Ö´ÐУ©¡£ </simpara> <simpara> - 每个表达式都可以为空。<varname>expr2</varname> - 为空意味着将无限循环下去(和 C 一样,PHP 认为其值为 - &true;)。这可能不像想象中那样没有用,因为经常会希望用 <link + ÿ¸ö±í´ïʽ¶¼¿ÉÒÔΪ¿Õ»ò°üÀ¨¶ººÅ·Ö¸ôµÄ¶à¸ö±í´ïʽ¡£±í´ïʽ <varname>expr2</varname> + ÖУ¬ËùÓÐÓöººÅ·Ö¸ôµÄ±í´ïʽ¶¼»á¼ÆË㣬µ«Ö»È¡×îºóÒ»¸ö½á¹û¡£<varname>expr2</varname> + Ϊ¿ÕÒâζ׎«ÎÞÏÞÑ­»·ÏÂÈ¥£¨ºÍ C Ò»Ñù£¬PHP ÈÏΪÆäֵΪ + &true;£©¡£Õâ¿ÉÄܲ»ÏñÏëÏóÖÐÄÇÑùûÓÐÓã¬ÒòΪ¾­³£»áÏ£ÍûÓà <link linkend="control-structures.break"><literal>break</literal></link> - 语句来结束循环而不是用 <literal>for</literal> 的表达式真值判断。 + Óï¾äÀ´½áÊøÑ­»·¶ø²»ÊÇÓà <literal>for</literal> µÄ±í´ïÊ½ÕæÖµÅжϡ£ </simpara> <para> - 考虑以下的例子,它们都显示数字 1 到 10: + ¿¼ÂÇÒÔϵÄÀý×Ó£¬ËüÃǶ¼ÏÔʾÊý×Ö 1 µ½ 10£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -392,18 +433,18 @@ /* example 4 */ -for ($i = 1; $i <= 10; echo $i, $i++); +for ($i = 1, $j = 0; $i <= 10; $j += $i, print $i, $i++); ?> ]]> </programlisting> </informalexample> </para> <simpara> - 当然,第一个例子看上去最正常(或者第四个),但用户可能会发现在 - <literal>for</literal> 循环中用空的表达式在很多场合下会很方便。 + µ±È»£¬µÚÒ»¸öÀý×Ó¿´ÉÏÈ¥×îÕý³££¨»òÕßµÚËĸö£©£¬µ«Óû§¿ÉÄܻᷢÏÖÔÚ + <literal>for</literal> Ñ­»·ÖÐÓÿյıí´ïʽÔںܶೡºÏÏ»áºÜ·½±ã¡£ </simpara> <para> - PHP 也支持用冒号的 <literal>for</literal> 循环的替代语法。 + PHP Ò²Ö§³ÖÓÃðºÅµÄ <literal>for</literal> Ñ­»·µÄÌæ´úÓï·¨¡£ <informalexample> <programlisting> <![CDATA[ @@ -415,14 +456,67 @@ </programlisting> </informalexample> </para> + <simpara> + Its a common thing to many users to iterate though arrays like in the + example below. + </simpara> + <para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +/* + * This is an array with some data we want to modify + * when running through the for loop. + */ +$people = Array( + Array('name' => 'Kalle', 'salt' => 856412), + Array('name' => 'Pierre', 'salt' => 215863) + ); + +for($i = 0; $i < sizeof($people); ++$i) +{ + $people[$i]['salt'] = rand(000000, 999999); +} +?> +]]> + </programlisting> + </informalexample> + </para> + <simpara> + The problem lies in the second for expression. This code can be slow + because it has to calculate the size of the array on each iteration. + Since the size never change, it can be optimized easily using an + intermediate variable to store the size and use in the loop instead + of sizeof. The example below illustrates this: + </simpara> + <para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +$people = Array( + Array('name' => 'Kalle', 'salt' => 856412), + Array('name' => 'Pierre', 'salt' => 215863) + ); + +for($i = 0, $size = sizeof($people); $i < $size; ++$i) +{ + $people[$i]['salt'] = rand(000000, 999999); +} +?> +]]> + </programlisting> + </informalexample> + </para> </sect1> <sect1 xml:id="control-structures.foreach"> <title><literal>foreach</literal></title> <para> - PHP 4 引入了 <literal>foreach</literal> 结构,和 - Perl 以及其他语言很像。这只是一种遍历数组简便方法。<literal>foreach</literal> - 仅能用于数组,当试图将其用于其它数据类型或者一个未初始化的变量时会产生错误。有两种语法,第二种比较次要但却是第一种的有用的扩展。 + PHP 4 ÒýÈëÁË <literal>foreach</literal> ½á¹¹£¬ºÍ + Perl ÒÔ¼°ÆäËûÓïÑÔºÜÏñ¡£ÕâÖ»ÊÇÒ»ÖÖ±éÀúÊý×é¼ò±ã·½·¨¡£<literal>foreach</literal> + ½öÄÜÓÃÓÚÊý×飬µ±ÊÔͼ½«ÆäÓÃÓÚÆäËüÊý¾ÝÀàÐÍ»òÕßÒ»¸öδ³õʼ»¯µÄ±äÁ¿Ê±»á²úÉú´íÎó¡£ÓÐÁ½ÖÖÓï·¨£¬µÚ¶þÖֱȽϴÎÒªµ«È´ÊǵÚÒ»ÖÖµÄÓÐÓõÄÀ©Õ¹¡£ <informalexample> <programlisting> <![CDATA[ @@ -435,36 +529,39 @@ </informalexample> </para> <simpara> - 第一种格式遍历给定的 <literal>array_expression</literal> - 数组。每次循环中,当前单元的值被赋给 <literal>$value</literal> - 并且数组内部的指针向前移一步(因此下一次循环中将会得到下一个单元)。 + µÚÒ»ÖÖ¸ñʽ±éÀú¸ø¶¨µÄ <literal>array_expression</literal> + Êý×顣ÿ´ÎÑ­»·ÖУ¬µ±Ç°µ¥ÔªµÄÖµ±»¸³¸ø <literal>$value</literal> + ²¢ÇÒÊý×éÄÚ²¿µÄÖ¸ÕëÏòÇ°ÒÆÒ»²½£¨Òò´ËÏÂÒ»´ÎÑ­»·Öн«»áµÃµ½ÏÂÒ»¸öµ¥Ôª£©¡£ </simpara> <simpara> - 第二种格式做同样的事,只除了当前单元的键名也会在每次循环中被赋给变量 - <literal>$key</literal>。 + µÚ¶þÖÖ¸ñʽ×öͬÑùµÄÊ£¬Ö»³ýÁ˵±Ç°µ¥ÔªµÄ¼üÃûÒ²»áÔÚÿ´ÎÑ­»·Öб»¸³¸ø±äÁ¿ + <literal>$key</literal>¡£ </simpara> <simpara> - 自PHP 5 起,还可能<link linkend="language.oop5.iterations">遍历对象</link>。 + ×ÔPHP 5 Æð£¬»¹¿ÉÄÜ<link linkend="language.oop5.iterations">±éÀú¶ÔÏó</link>¡£ </simpara> + <para> <note> <para> - 当 <literal>foreach</literal> - 开始执行时,数组内部的指针会自动指向第一个单元。这意味着不需要在 - <literal>foreach</literal> 循环之前调用 <function>reset</function>。 + µ± <literal>foreach</literal> + ¿ªÊ¼Ö´ÐÐʱ£¬Êý×éÄÚ²¿µÄÖ¸Õë»á×Ô¶¯Ö¸ÏòµÚÒ»¸öµ¥Ôª¡£ÕâÒâζ×Ų»ÐèÒªÔÚ + <literal>foreach</literal> Ñ­»·Ö®Ç°µ÷Óà <function>reset</function>¡£ </para> </note> + </para> + <para> <note> <para> - 除非数组是被<link linkend="language.references">引用</link>,<literal>foreach</literal> - 所操作的是指定数组的一个拷贝,而不是该数组本身。因此数组指针不会被 - <function>each</function> - 结构改变,对返回的数组单元的修改也不会影响原数组。不过原数组的内部指针<emphasis>的确</emphasis>在处理数组的过程中向前移动了。假定 - foreach 循环运行到结束,原数组的内部指针将指向数组的结尾。 + ³ý·ÇÊý×éÊDZ»<link linkend="language.references">ÒýÓÃ</link>£¬<literal>foreach</literal> + Ëù²Ù×÷µÄÊÇÖ¸¶¨Êý×éµÄÒ»¸ö¿½±´£¬¶ø²»ÊǸÃÊý×é±¾Éí¡£<literal>foreach</literal>¶ÔÊý×éÖ¸ÕëÓÐЩ¸±×÷Óᣳý·Ç¶ÔÆäÖØÖã¬ÔÚ + foreach Ñ­»·ÖлòÑ­»·ºó¶¼²»ÒªÒÀÀµÊý×éÖ¸ÕëµÄÖµ¡£ </para> + </note> + </para> <para> - 自 PHP 5 起,可以很容易地通过在 <literal>$value</literal> 之前加上 - &amp; 来修改数组的单元。此方法将以<link - linkend="language.references">引用</link>赋值而不是拷贝一个值。 + ×Ô PHP 5 Æð£¬¿ÉÒÔºÜÈÝÒ×µØÍ¨¹ýÔÚ <literal>$value</literal> ֮ǰ¼ÓÉÏ + &amp; À´ÐÞ¸ÄÊý×éµÄÔªËØ¡£´Ë·½·¨½«ÒÔ<link + linkend="language.references">ÒýÓÃ</link>¸³Öµ¶ø²»ÊÇ¿½±´Ò»¸öÖµ¡£ <informalexample> <programlisting role="php"> <![CDATA[ @@ -478,16 +575,24 @@ ]]> </programlisting> </informalexample> - 此方法仅在被遍历的数组可以被引用时才可用(例如是个变量)。 + ´Ë·½·¨½öÔÚ±»±éÀúµÄÊý×é¿ÉÒÔ±»ÒýÓÃʱ²Å¿ÉÓã¨ÀýÈçÊǸö±äÁ¿£©¡£ </para> - </note> + <warning> + <para> + Reference of a <literal>$value</literal> and the last array element + remain even after the <literal>foreach</literal> loop. It is recommended + to destroy it by <function>unset</function>. + </para> + </warning> + <para> <note> <para> - <literal>foreach</literal> 不支持用“@”来抑制错误信息的能力。 + <literal>foreach</literal> ²»Ö§³ÖÓá°@¡±À´ÒÖÖÆ´íÎóÐÅÏ¢µÄÄÜÁ¦¡£ </para> </note> + </para> <para> - 用户可能注意到了以下的代码功能完全相同: + Óû§¿ÉÄÜ×¢Òâµ½ÁËÒÔϵĴúÂ빦ÄÜÍêÈ«Ïàͬ£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -505,7 +610,7 @@ ]]> </programlisting> </informalexample> - 以下代码功能也完全相同: + ÒÔÏ´úÂ빦ÄÜÒ²ÍêÈ«Ïàͬ£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -525,7 +630,7 @@ </informalexample> </para> <para> - 示范用法的更多例子: + ʾ·¶Ó÷¨µÄ¸ü¶àÀý×Ó£º <informalexample> <programlisting role="php"> <![CDATA[ @@ -538,7 +643,7 @@ echo "Current value of \$a: $v.\n"; } -/* foreach example 2: value (with key printed for illustration) */ +/* foreach example 2: value (with its manual access notation printed for illustration) */ $a = array(1, 2, 3, 17); @@ -590,12 +695,12 @@ <sect1 xml:id="control-structures.break"> <title><literal>break</literal></title> <simpara> - <literal>break</literal> 结束当前 - <literal>for</literal>,<literal>foreach</literal>,<literal>while</literal>,<literal>do-while</literal> - 或者 <literal>switch</literal> 结构的执行。 + <literal>break</literal> ½áÊøµ±Ç° + <literal>for</literal>£¬<literal>foreach</literal>£¬<literal>while</literal>£¬<literal>do-while</literal> + »òÕß <literal>switch</literal> ½á¹¹µÄÖ´ÐС£ </simpara> <simpara> - <literal>break</literal> 可以接受一个可选的数字参数来决定跳出几重循环。 + <literal>break</literal> ¿ÉÒÔ½ÓÊÜÒ»¸ö¿ÉÑ¡µÄÊý×Ö²ÎÊýÀ´¾ö¶¨Ìø³ö¼¸ÖØÑ­»·¡£ </simpara> <para> <informalexample> @@ -636,17 +741,17 @@ <title><literal>continue</literal></title> <simpara> <literal>continue</literal> - 在循环结构用用来跳过本次循环中剩余的代码并在条件求值为真时开始执行下一次循环。 + ÔÚÑ­»·½á¹¹ÓÃÓÃÀ´Ìø¹ý±¾´ÎÑ­»·ÖÐÊ£ÓàµÄ´úÂë²¢ÔÚÌõ¼þÇóÖµÎªÕæÊ±¿ªÊ¼Ö´ÐÐÏÂÒ»´ÎÑ­»·¡£ </simpara> <note> <simpara> - 注意在 PHP 中 + ×¢ÒâÔÚ PHP ÖÐ <link linkend="control-structures.switch">switch</link> - 语句被认为是可以使用 <literal>continue</literal> 的一种循环结构。 + Óï¾ä±»ÈÏΪÊÇ¿ÉÒÔʹÓà <literal>continue</literal> µÄÒ»ÖÖÑ­»·½á¹¹¡£ </simpara> </note> <simpara> - <literal>continue</literal> 接受一个可选的数字参数来决定跳过几重循环到循环结尾。 + <literal>continue</literal> ½ÓÊÜÒ»¸ö¿ÉÑ¡µÄÊý×Ö²ÎÊýÀ´¾ö¶¨Ìø¹ý¼¸ÖØÑ­»·µ½Ñ­»·½áβ¡£ </simpara> <para> <informalexample> @@ -679,8 +784,8 @@ </informalexample> </para> <para> - 省略 <literal>continue</literal> - 后面的分号会导致混淆。以下例子示意了不应该这样做。 + Ê¡ÂÔ <literal>continue</literal> + ºóÃæµÄ·ÖºÅ»áµ¼Ö»ìÏý¡£ÒÔÏÂÀý×ÓʾÒâÁ˲»Ó¦¸ÃÕâÑù×ö¡£ </para> <para> <informalexample> @@ -696,7 +801,7 @@ ]]> </programlisting> <para> - 希望得到的结果是: + Ï£ÍûµÃµ½µÄ½á¹ûÊÇ£º </para> <screen> <![CDATA[ @@ -707,7 +812,7 @@ ]]> </screen> <para> - 可实际的输出是: + ¿Éʵ¼ÊµÄÊä³öÊÇ£º </para> <screen> <![CDATA[ @@ -715,8 +820,8 @@ ]]> </screen> <para> - 因为 <function>print</function> 调用的返回值是 - <literal>int(1)</literal>,看上去作为了上述可选的数字参数。 + ÒòΪ <function>print</function> µ÷Óõķµ»ØÖµÊÇ + <literal>int(1)</literal>£¬¿´ÉÏÈ¥×÷ΪÁËÉÏÊö¿ÉÑ¡µÄÊý×Ö²ÎÊý¡£ </para> </informalexample> </para> @@ -725,22 +830,28 @@ <sect1 xml:id="control-structures.switch"> <title><literal>switch</literal></title> <simpara> - <literal>switch</literal> 语句和具有同样表达式的一系列的 IF - 语句相似。很多场合下需要把同一个变量(或表达式)与很多不同的值比较,并根据它等于哪个值来执行不同的代码。这正是 - <literal>switch</literal> 语句的用途。 + <literal>switch</literal> Óï¾äºÍ¾ßÓÐͬÑù±í´ïʽµÄһϵÁÐµÄ IF + Óï¾äÏàËÆ¡£ºÜ¶à³¡ºÏÏÂÐèÒª°Ñͬһ¸ö±äÁ¿£¨»ò±í´ïʽ£©ÓëºÜ¶à²»Í¬µÄÖµ±È½Ï£¬²¢¸ù¾ÝËüµÈÓÚÄĸöÖµÀ´Ö´Ðв»Í¬µÄ´úÂë¡£ÕâÕýÊÇ + <literal>switch</literal> Óï¾äµÄÓÃ;¡£ </simpara> <note> <simpara> - 注意和其它语言不同,<link linkend="control-structures.continue">continue</link> - 语句作用到 switch 上的作用类似于 <literal>break</literal>。如果在循环中有一个 - switch 并希望 continue 到外层循环中的下一个轮回,用 <literal>continue 2</literal>。 + ×¢ÒâºÍÆäËüÓïÑÔ²»Í¬£¬<link linkend="control-structures.continue">continue</link> + Óï¾ä×÷Óõ½ switch ÉϵÄ×÷ÓÃÀàËÆÓÚ <literal>break</literal>¡£Èç¹ûÔÚÑ­»·ÖÐÓÐÒ»¸ö + switch ²¢Ï£Íû continue µ½Íâ²ãÑ­»·ÖеÄÏÂÒ»¸öÂֻأ¬Óà <literal>continue 2</literal>¡£ </simpara> </note> + <note> + <para> + Note that switch/case does + <link linkend="types.comparisions-loose">loose comparision</link>. + </para> + </note> <para> - 下面两个例子使用两种不同方法实现同样的事,一个用一系列的 - <literal>if</literal> 语句,另一个用 <literal>switch</literal> 语句: + ÏÂÃæÁ½¸öÀý×ÓʹÓÃÁ½ÖÖ²»Í¬·½·¨ÊµÏÖͬÑùµÄÊ£¬Ò»¸öÓÃһϵÁÐµÄ + <literal>if</literal> Óï¾ä£¬ÁíÒ»¸öÓà <literal>switch</literal> Óï¾ä£º <example> - <title><literal>switch</literal> 结构</title> + <title><literal>switch</literal> ½á¹¹</title> <programlisting role="php"> <![CDATA[ <?php @@ -768,7 +879,7 @@ </programlisting> </example> <example> - <title><literal>switch</literal> 结构可以用字符串</title> + <title><literal>switch</literal> ½á¹¹¿ÉÒÔÓÃ×Ö·û´®</title> <programlisting role="php"> <![CDATA[ <?php @@ -789,13 +900,13 @@ </example> </para> <para> - 为避免错误,理解 <literal>switch</literal> 是怎样执行的非常重要。<literal>switch</literal> - 语句一行接一行地执行(实际上是语句接语句)。开始时没有代码被执行。仅当一个 - <literal>case</literal> 语句中的值和 <literal>switch</literal> - 表达式的值匹配时 PHP 才开始执行语句,直到 <literal>switch</literal> - 的程序段结束或者遇到第一个 <literal>break</literal> - 语句为止。如果不在 case 的语句段最后写上 <literal>break</literal> - 的话,PHP 将继续执行下一个 case 中的语句段。例如: + Ϊ±ÜÃâ´íÎó£¬Àí½â <literal>switch</literal> ÊÇÔõÑùÖ´Ðеķdz£ÖØÒª¡£<literal>switch</literal> + Óï¾äÒ»ÐнÓÒ»ÐеØÖ´ÐУ¨Êµ¼ÊÉÏÊÇÓï¾ä½ÓÓï¾ä£©¡£¿ªÊ¼Ê±Ã»ÓдúÂë±»Ö´ÐС£½öµ±Ò»¸ö + <literal>case</literal> Óï¾äÖеÄÖµºÍ <literal>switch</literal> + ±í´ïʽµÄֵƥÅäʱ PHP ²Å¿ªÊ¼Ö´ÐÐÓï¾ä£¬Ö±µ½ <literal>switch</literal> + µÄ³ÌÐò¶Î½áÊø»òÕßÓöµ½µÚÒ»¸ö <literal>break</literal> + Óï¾äΪֹ¡£Èç¹û²»ÔÚ case µÄÓï¾ä¶Î×îºóдÉÏ <literal>break</literal> + µÄ»°£¬PHP ½«¼ÌÐøÖ´ÐÐÏÂÒ»¸ö case ÖеÄÓï¾ä¶Î¡£ÀýÈ磺 <informalexample> <programlisting role="php"> <![CDATA[ @@ -814,19 +925,19 @@ </informalexample> </para> <simpara> - 这里如果 <varname>$i</varname> 等于 0,PHP 将执行所有的 print 语句!如果 - <varname>$i</varname> 等于 1,PHP 将执行后面两条 print 语句。只有当 - <varname>$i</varname> 等于 2 时,才会得到“预期”的结果——只显示“i equals 2”。所以,别忘了 - <literal>break</literal> 语句就很重要(即使在某些情况下故意想避免提供它们时)。 + ÕâÀïÈç¹û <varname>$i</varname> µÈÓÚ 0£¬PHP ½«Ö´ÐÐËùÓÐµÄ print Óï¾ä£¡Èç¹û + <varname>$i</varname> µÈÓÚ 1£¬PHP ½«Ö´ÐкóÃæÁ½Ìõ print Óï¾ä¡£Ö»Óе± + <varname>$i</varname> µÈÓÚ 2 ʱ£¬²Å»áµÃµ½¡°Ô¤ÆÚ¡±µÄ½á¹û¡ª¡ªÖ»ÏÔʾ¡°i equals 2¡±¡£ËùÒÔ£¬±ðÍüÁË + <literal>break</literal> Óï¾ä¾ÍºÜÖØÒª£¨¼´Ê¹ÔÚijЩÇé¿öϹÊÒâÏë±ÜÃâÌṩËüÃÇʱ£©¡£ </simpara> <simpara> - 在 <literal>switch</literal> 语句中条件只求值一次并用来和每个 - <literal>case</literal> 语句比较。在 <literal>elseif</literal> - 语句中条件会再次求值。如果条件比一个简单的比较要复杂得多或者在一个很多次的循环中,那么用 - <literal>switch</literal> 语句可能会快一些。 + ÔÚ <literal>switch</literal> Óï¾äÖÐÌõ¼þÖ»ÇóÖµÒ»´Î²¢ÓÃÀ´ºÍÿ¸ö + <literal>case</literal> Óï¾ä±È½Ï¡£ÔÚ <literal>elseif</literal> + Óï¾äÖÐÌõ¼þ»áÔÙ´ÎÇóÖµ¡£Èç¹ûÌõ¼þ±ÈÒ»¸ö¼òµ¥µÄ±È½ÏÒª¸´Ôӵöà»òÕßÔÚÒ»¸öºÜ¶à´ÎµÄÑ­»·ÖУ¬ÄÇôÓà + <literal>switch</literal> Óï¾ä¿ÉÄÜ»á¿ìһЩ¡£ </simpara> <para> - 在一个 case 中的语句也可以为空,这样只不过将控制转移到了下一个 case 中的语句。 + ÔÚÒ»¸ö case ÖеÄÓï¾äÒ²¿ÉÒÔΪ¿Õ£¬ÕâÑùÖ»²»¹ý½«¿ØÖÆ×ªÒƵ½ÁËÏÂÒ»¸ö case ÖеÄÓï¾ä¡£ <informalexample> <programlisting role="php"> <![CDATA[ @@ -846,8 +957,8 @@ </informalexample> </para> <para> - 一个 case 的特例是 <literal>default</literal>。它匹配了任何和其它 - case 都不匹配的情况,并且应该是最后一条 <literal>case</literal> 语句。例如: + Ò»¸ö case µÄÌØÀýÊÇ <literal>default</literal>¡£ËüÆ¥ÅäÁËÈÎºÎºÍÆäËü + case ¶¼²»Æ¥ÅäµÄÇé¿ö¡£ÀýÈ磺 <informalexample> <programlisting role="php"> <![CDATA[ @@ -872,11 +983,11 @@ </para> <para> <literal>case</literal> - 表达式可以是任何求值为简单类型的表达式,即整型或浮点数以及字符串。不能用数组或对象,除非它们被解除引用成为简单类型。 + ±í´ïʽ¿ÉÒÔÊÇÈκÎÇóֵΪ¼òµ¥ÀàÐ͵ıí´ïʽ£¬¼´ÕûÐÍ»ò¸¡µãÊýÒÔ¼°×Ö·û´®¡£²»ÄÜÓÃÊý×é»ò¶ÔÏ󣬳ý·ÇËüÃDZ»½â³ýÒýÓóÉΪ¼òµ¥ÀàÐÍ¡£ </para> <para> - <literal>switch</literal> 支持替代语法的流程控制。更多信息见<link - linkend="control-structures.alternative-syntax">流程控制的替代语法</link>一节。 + <literal>switch</literal> Ö§³ÖÌæ´úÓï·¨µÄÁ÷³Ì¿ØÖÆ¡£¸ü¶àÐÅÏ¢¼û<link + linkend="control-structures.alternative-syntax">Á÷³Ì¿ØÖƵÄÌæ´úÓï·¨</link>Ò»½Ú¡£ <informalexample> <programlisting role="php"> <![CDATA[ @@ -899,13 +1010,35 @@ </programlisting> </informalexample> </para> + <para> + ÔÊÐíʹÓ÷ֺÅ(;)´úÌæcaseÓï¾äºóµÄðºÅ(:)£¬ÀýÈ磺 + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +switch($beer) +{ + case 'tuborg'; + case 'carlsberg'; + case 'heineken'; + echo 'Good choice'; + break; + default; + echo 'Please make a new selection...'; + break; +} +?> +]]> + </programlisting> + </informalexample> + </para> </sect1> <sect1 xml:id="control-structures.declare"> <title><literal>declare</literal></title> <para> - <literal>declare</literal> 结构用来设定一段代码的执行指令。<literal>declare</literal> - 的语法和其它流程控制结构相似: + <literal>declare</literal> ½á¹¹ÓÃÀ´É趨һ¶Î´úÂëµÄÖ´ÐÐÖ¸Áî¡£<literal>declare</literal> + µÄÓï·¨ºÍÆäËüÁ÷³Ì¿ØÖƽṹÏàËÆ£º <informalexample> <programlisting> <![CDATA[ @@ -916,17 +1049,25 @@ </informalexample> </para> <para> - <literal>directive</literal> 部分允许设定 <literal>declare</literal> - 代码段的行为。目前只认识一个指令:<literal>ticks</literal>(更多信息见下面 - <link linkend="control-structures.declare.ticks">ticks</link> 指令)。 + <literal>directive</literal> ²¿·ÖÔÊÐíÉ趨 <literal>declare</literal> + ´úÂë¶ÎµÄÐÐΪ¡£Ä¿Ç°Ö»ÈÏʶÁ½¸öÖ¸Á<literal>ticks</literal>£¨¸ü¶àÐÅÏ¢¼ûÏÂÃæ + <link linkend="control-structures.declare.ticks">ticks</link> Ö¸ÁÒÔ¼° + <literal>encoding</literal>(¸ü¶àÐÅÏ¢¼ûÏÂÃæ <link + linkend="control-structures.declare.encoding">encoding</link>Ö¸Áî)¡£ </para> - <para> - <literal>declare</literal> 代码段中的 <literal>statement</literal> - 部分将被执行——怎样执行以及执行中有什么副作用出现取决于 - <literal>directive</literal> 中设定的指令。 + <note> + <simpara> + encoding ÊÇ PHP 5.3.0 ÐÂÔöÖ¸Áî¡£ + </simpara> + </note> + <para> + <literal>declare</literal> ´úÂë¶ÎÖÐµÄ <literal>statement</literal> + ²¿·Ö½«±»Ö´ÐСª¡ªÔõÑùÖ´ÐÐÒÔ¼°Ö´ÐÐÖÐÓÐʲô¸±×÷ÓóöÏÖÈ¡¾öÓÚ + <literal>directive</literal> ÖÐÉ趨µÄÖ¸Áî¡£ </para> <para> - <literal>declare</literal> 结构也可用于全局范围,影响到其后的所有代码。 + <literal>declare</literal> ½á¹¹Ò²¿ÉÓÃÓÚÈ«¾Ö·¶Î§£¬Ó°Ïìµ½ÆäºóµÄËùÓдúÂë(µ«Èç¹ûÓÐ + <literal>declare</literal> ½á¹¹µÄÎļþ±»ÆäËüÎļþ°üº¬£¬Ëü¶Ô°üº¬ËüµÄÎļþ²»Æð×÷ÓÃ)¡£ <informalexample> <programlisting role="php"> <![CDATA[ @@ -949,19 +1090,24 @@ <sect2 xml:id="control-structures.declare.ticks"> <title>Ticks</title> + <caution> + <simpara> + ticks Ö¸ÁîÔÚ PHP 5.3.0 ÖÐÊǹýʱָÁ½«»á´Ó PHP 6.0.0 ÒÆ³ý¡£ + </simpara> + </caution> <para> - Tick 是一个在 <literal>declare</literal> 代码段中解释器每执行 - <varname>N</varname> 条低级语句就会发生的事件。<varname>N</varname> - 的值是在 <literal>declare</literal> 中的 <literal>directive</literal> 部分用 - <literal>ticks=N</literal> 来指定的。 + Tick ÊÇÒ»¸öÔÚ <literal>declare</literal> ´úÂë¶ÎÖнâÊÍÆ÷ÿִÐÐ + <varname>N</varname> ÌõµÍ¼¶Óï¾ä¾Í»á·¢ÉúµÄʼþ¡£<varname>N</varname> + µÄÖµÊÇÔÚ <literal>declare</literal> ÖÐµÄ <literal>directive</literal> ²¿·ÖÓà + <code>ticks=N</code> À´Ö¸¶¨µÄ¡£ </para> <para> - 在每个 tick 中出现的事件是由 <function>register_tick_function</function> - 来指定的。更多细节见下面的例子。注意每个 tick 中可以出现多个事件。 + ÔÚÿ¸ö tick ÖгöÏÖµÄʼþÊÇÓÉ <function>register_tick_function</function> + À´Ö¸¶¨µÄ¡£¸ü¶àϸ½Ú¼ûÏÂÃæµÄÀý×Ó¡£×¢Òâÿ¸ö tick ÖпÉÒÔ³öÏÖ¶à¸öʼþ¡£ </para> <para> <example> - <title>评估一段 PHP 代码的执行时间</title> + <title>ÆÀ¹ÀÒ»¶Î PHP ´úÂëµÄÖ´ÐÐʱ¼ä</title> <programlisting role="php"> <![CDATA[ <?php @@ -999,53 +1145,85 @@ ]]> </programlisting> </example> - 这个例子评估“declare”中的 PHP - 代码,每执行两条低级语句就记录一次时间。此信息可以用来找到一段特定代码中速度慢的部分。这个过程也可以用其它方法完成,但用 - tick 更方便也更容易实现。 + Õâ¸öÀý×ÓÆÀ¹À¡°declare¡±ÖÐµÄ PHP + ´úÂ룬ÿִÐÐÁ½ÌõµÍ¼¶Óï¾ä¾Í¼Ç¼һ´Îʱ¼ä¡£´ËÐÅÏ¢¿ÉÒÔÓÃÀ´ÕÒµ½Ò»¶ÎÌØ¶¨´úÂëÖÐËÙ¶ÈÂýµÄ²¿·Ö¡£Õâ¸ö¹ý³ÌÒ²¿ÉÒÔÓÃÆäËü·½·¨Íê³É£¬µ«Óà + tick ¸ü·½±ãÒ²¸üÈÝÒ×ʵÏÖ¡£ </para> <simpara> - Ticks 很适合用来做调试,以及实现简单的多任务,后台 I/O 和很多其它任务。 + Ticks ºÜÊʺÏÓÃÀ´×öµ÷ÊÔ£¬ÒÔ¼°ÊµÏÖ¼òµ¥µÄ¶àÈÎÎñ£¬ºǫ́ I/O ºÍºÜ¶àÆäËüÈÎÎñ¡£ </simpara> <simpara> - 参见 <function>register_tick_function</function> 和 - <function>unregister_tick_function</function>。 + ²Î¼û <function>register_tick_function</function> ºÍ + <function>unregister_tick_function</function>¡£ </simpara> </sect2> + <sect2 xml:id="control-structures.declare.encoding"> + <title>Encoding</title> + <para> + A script's encoding can be specified per-script using the encoding directive. + <example> + <title>Declaring an encoding for the script.</title> + <programlisting role="php"> +<![CDATA[ +<?php +declare(encoding='ISO-8859-1'); +// code here +?> +]]> + </programlisting> + </example> + </para> + + <caution> + <simpara> + When combined with namespaces, the only legal syntax for declare + is <literal>declare(encoding='...');</literal> where <literal>...</literal> + is the encoding value. <literal>declare(encoding='...') {}</literal> + will result in a parse error when combined with namespaces. + </simpara> + </caution> + <para> + The encoding declare value is ignored in PHP 5.3 unless php is compiled with + <literal>--enable-zend-multibyte</literal>. In PHP 6.0, the <literal>encoding</literal> + directive will be used to inform the scanner what encoding the file is created in. Legal + values are encoding names such as <literal>UTF-8</literal>. + </para> + </sect2> </sect1> <sect1 xml:id="function.return"> <title>return</title> <simpara> - 如果在一个函数中调用 <function>return</function> - 语句,将立即结束此函数的执行并将它的参数作为函数的值返回。<function>return</function> - 也会终止 <function>eval</function> 语句或者脚本文件的执行。 - </simpara> - <simpara> - 如果在全局范围中调用,则当前脚本文件中止运行。如果当前脚本文件是被 - <function>include</function> 的或者 <function>require</function> - 的,则控制交回调用文件。此外,如果当前脚本是被 <function>include</function> - 的,则 <function>return</function> 的值会被当作 <function>include</function> - 调用的返回值。如果在主脚本文件中调用 - <function>return</function>,则脚本中止运行。如果当前脚本文件是在 &php.ini; - 中的配置选项 <link - linkend="ini.auto-prepend-file">auto_prepend_file</link> 或者 <link - linkend="ini.auto-append-file">auto_append_file</link> 所指定的,则此脚本文件中止运行。 + Èç¹ûÔÚÒ»¸öº¯ÊýÖе÷Óà <function>return</function> + Óï¾ä£¬½«Á¢¼´½áÊø´Ëº¯ÊýµÄÖ´Ðв¢½«ËüµÄ²ÎÊý×÷Ϊº¯ÊýµÄÖµ·µ»Ø¡£<function>return</function> + Ò²»áÖÕÖ¹ <function>eval</function> Óï¾ä»òÕ߽ű¾ÎļþµÄÖ´ÐС£ + </simpara> + <simpara> + Èç¹ûÔÚÈ«¾Ö·¶Î§Öе÷Óã¬Ôòµ±Ç°½Å±¾ÎļþÖÐÖ¹ÔËÐС£Èç¹ûµ±Ç°½Å±¾ÎļþÊDZ» + <function>include</function> µÄ»òÕß <function>require</function> + µÄ£¬Ôò¿ØÖƽ»»Øµ÷ÓÃÎļþ¡£´ËÍ⣬Èç¹ûµ±Ç°½Å±¾ÊDZ» <function>include</function> + µÄ£¬Ôò <function>return</function> µÄÖµ»á±»µ±×÷ <function>include</function> + µ÷Óõķµ»ØÖµ¡£Èç¹ûÔÚÖ÷½Å±¾ÎļþÖе÷Óà + <function>return</function>£¬Ôò½Å±¾ÖÐÖ¹ÔËÐС£Èç¹ûµ±Ç°½Å±¾ÎļþÊÇÔÚ &php.ini; + ÖеÄÅäÖÃÑ¡Ïî <link + linkend="ini.auto-prepend-file">auto_prepend_file</link> »òÕß <link + linkend="ini.auto-append-file">auto_append_file</link> ËùÖ¸¶¨µÄ£¬Ôò´Ë½Å±¾ÎļþÖÐÖ¹ÔËÐС£ </simpara> <simpara> - 更多信息见<link linkend="functions.returning-values">返回值</link>。 + ¸ü¶àÐÅÏ¢¼û<link linkend="functions.returning-values">·µ»ØÖµ</link>¡£ </simpara> <note> <simpara> - 注意既然 <function>return</function> - 是语言结构而不是函数,<emphasis>仅在</emphasis>参数包含表达式时才需要用括号将其括起来。当返回一个变量时通常不用括号,也建议不要用,这样可以降低 - PHP 的负担。 + ×¢Òâ¼ÈÈ» <function>return</function> + ÊÇÓïÑԽṹ¶ø²»ÊǺ¯Êý£¬Òò´ËÆä²ÎÊýûÓбØÒªÓÃÀ¨ºÅ½«ÆäÀ¨ÆðÀ´¡£Í¨³£¶¼²»ÓÃÀ¨ºÅ£¬Êµ¼ÊÉÏÒ²Ó¦¸Ã²»Óã¬ÕâÑù¿ÉÒÔ½µµÍ + PHP µÄ¸ºµ£¡£ </simpara> </note> <note> <simpara> - 当用引用返回值时<emphasis>永远不要</emphasis>使用括号,这样行不通。只能通过引用返回变量,而不是语句的结果。如果使用 - <literal>return ($a);</literal> 时其实不是返回一个变量,而是表达式 - <literal>($a)</literal> 的值(当然,此时该值也正是 <varname>$a</varname> 的值)。 + µ±ÓÃÒýÓ÷µ»ØÖµÊ±<emphasis>ÓÀÔ¶²»Òª</emphasis>ʹÓÃÀ¨ºÅ£¬ÕâÑùÐв»Í¨¡£Ö»ÄÜͨ¹ýÒýÓ÷µ»Ø±äÁ¿£¬¶ø²»ÊÇÓï¾äµÄ½á¹û¡£Èç¹ûʹÓà + <literal>return ($a);</literal> ʱÆäʵ²»ÊÇ·µ»ØÒ»¸ö±äÁ¿£¬¶øÊDZí´ïʽ + <literal>($a)</literal> µÄÖµ£¨µ±È»£¬´Ëʱ¸ÃÖµÒ²ÕýÊÇ <varname>$a</varname> µÄÖµ£©¡£ </simpara> </note> </sect1> @@ -1055,24 +1233,24 @@ <title><function>require</function></title> <simpara> - <function>require</function> 语句包含并运行指定文件。 + <function>require</function> Óï¾ä°üº¬²¢ÔËÐÐÖ¸¶¨Îļþ¡£ </simpara> <simpara> - <function>require</function> 语句包含并运行指定文件。有关包括如何工作的详细信息见 - <function>include</function> 的文档。 + <function>require</function> Óï¾ä°üº¬²¢ÔËÐÐÖ¸¶¨Îļþ¡£ÓйذüÀ¨ÈçºÎ¹¤×÷µÄÏêϸÐÅÏ¢¼û + <function>include</function> µÄÎĵµ¡£ </simpara> <simpara> - <function>require</function> 和 <function>include</function> - 几乎完全一样,除了处理失败的方式不同之外。<function>include</function> 产生一个<link linkend="errorfunc.constants.errorlevels.e-warning">Warning</link>而 <function>require</function> - 则导致一个<link linkend="errorfunc.constants.errorlevels.e-error"> - Fatal Error</link>。换句话说,如果想在丢失文件时停止处理页面,那就别犹豫了,用 - <function>require</function> 吧。<function>include</function> - 就不是这样,脚本会继续运行。同时也要确认设置了合适的<link - linkend="ini.include-path">include_path</link>。 + <function>require</function> ºÍ <function>include</function> + ¼¸ºõÍêȫһÑù£¬³ýÁË´¦Àíʧ°ÜµÄ·½Ê½²»Í¬Ö®Íâ¡£<function>include</function> ²úÉúÒ»¸ö<link linkend="errorfunc.constants.errorlevels.e-warning">Warning</link>¶ø <function>require</function> + Ôòµ¼ÖÂÒ»¸ö<link linkend="errorfunc.constants.errorlevels.e-error"> + Fatal Error</link>¡£»»¾ä»°Ëµ£¬Èç¹ûÏëÔÚ¶ªÊ§Îļþʱֹͣ´¦ÀíÒ³Ãæ£¬ÄǾͱðÓÌÔ¥ÁË£¬Óà + <function>require</function> °É¡£<function>include</function> + ¾Í²»ÊÇÕâÑù£¬½Å±¾»á¼ÌÐøÔËÐС£Í¬Ê±Ò²ÒªÈ·ÈÏÉèÖÃÁ˺ÏÊʵÄ<link + linkend="ini.include-path">include_path</link>¡£ </simpara> <para> <example> - <title>基本的 <function>require</function> 例子</title> + <title>»ù±¾µÄ <function>require</function> Àý×Ó</title> <programlisting role="php"> <![CDATA[ <?php @@ -1089,62 +1267,72 @@ </example> </para> <simpara> - 更多例子参见 <function>include</function> 文档。 + ¸ü¶àÀý×Ӳμû <function>include</function> Îĵµ¡£ </simpara> <note> <simpara> - 在 PHP 4.0.2 之前适用以下规则:<function>require</function> - 总是会尝试读取目标文件,即使它所在的行根本就不会执行。条件语句不会影响 - <function>require</function>。不过如果 <function>require</function> - 所在的行没有执行,则目标文件中的代码也不会执行。同样,循环结构也不影响 - <function>require</function> 的行为。尽管目标文件中包含的代码仍然是循环的主体,但 - <function>require</function> 本身只会运行一次。 + ÔÚ PHP 4.0.2 ֮ǰÊÊÓÃÒÔϹæÔò£º<function>require</function> + ×ÜÊǻ᳢ÊÔ¶ÁȡĿ±êÎļþ£¬¼´Ê¹ËüËùÔÚµÄÐиù±¾¾Í²»»áÖ´ÐС£Ìõ¼þÓï¾ä²»»áÓ°Ïì + <function>require</function>¡£²»¹ýÈç¹û <function>require</function> + ËùÔÚµÄÐÐûÓÐÖ´ÐУ¬ÔòÄ¿±êÎļþÖеĴúÂëÒ²²»»áÖ´ÐС£Í¬Ñù£¬Ñ­»·½á¹¹Ò²²»Ó°Ïì + <function>require</function> µÄÐÐΪ¡£¾¡¹ÜÄ¿±êÎļþÖаüº¬µÄ´úÂëÈÔÈ»ÊÇÑ­»·µÄÖ÷Ì壬µ« + <function>require</function> ±¾ÉíÖ»»áÔËÐÐÒ»´Î¡£ </simpara> </note> &note.language-construct; &warn.no-win32-fopen-wrapper; <simpara> - 参见 <function>include</function>,<function>require_once</function>,<function>include_once</function>,<function>get_included_files</function>,<function>eval</function>,<function>file</function>,<function>readfile</function>,<function>virtual</function> - 和 <link linkend="ini.include-path">include_path</link>。 + ²Î¼û <function>include</function>£¬<function>require_once</function>£¬<function>include_once</function>£¬<function>get_included_files</function>£¬<function>eval</function>£¬<function>file</function>£¬<function>readfile</function>£¬<function>virtual</function> + ºÍ <link linkend="ini.include-path">include_path</link>¡£ </simpara> </sect1> <sect1 xml:id="function.include"> <title><function>include</function></title> <simpara> - <function>include</function> 语句包含并运行指定文件。 + <function>include</function> Óï¾ä°üº¬²¢ÔËÐÐÖ¸¶¨Îļþ¡£ </simpara> <simpara> - 以下文档也适用于 - <function>require</function>。这两种结构除了在如何处理失败之外完全一样。<function>include</function> - 产生一个<link - linkend="errorfunc.constants.errorlevels.e-warning">警告</link>而 <function>require</function> 则导致一个<link - linkend="errorfunc.constants.errorlevels.e-error">致命错误</link>。换句话说,如果想在遇到丢失文件时停止处理页面就用 - <function>require</function>。<function>include</function> - 就不是这样,脚本会继续运行。同时也要确认设置了合适的 <link - linkend="ini.include-path">include_path</link>。注意在 - PHP 4.3.5 之前,包含文件中的语法错误不会导致程序停止,但从此版本之后会。 - </simpara> - <simpara> - 寻找包含文件的顺序先是在当前工作目录的相对的 include_path - 下寻找,然后是当前运行脚本所在目录相对的 include_path 下寻找。例如 - include_path 是 <literal>.</literal>,当前工作目录是 - <filename class="directory">/www/</filename>,脚本中要 include 一个 - <filename>include/a.php</filename> 并且在该文件中有一句 - <literal>include "b.php"</literal>,则寻找 - <filename>b.php</filename> 的顺序先是 - <filename class="directory">/www/</filename>,然后是 - <filename class="directory">/www/include/</filename>。如果文件名以 - <literal>./</literal> 或者 <literal>../</literal> 开始,则只在当前工作目录相对的 - include_path 下寻找。 + ÒÔÏÂÎĵµÒ²ÊÊÓÃÓÚ + <function>require</function>¡£ÕâÁ½Öֽṹ³ýÁËÔÚÈçºÎ´¦Àíʧ°ÜÖ®ÍâÍêȫһÑù¡£<function>include</function> + ²úÉúÒ»¸ö<link + linkend="errorfunc.constants.errorlevels.e-warning">¾¯¸æ</link>¶ø <function>require</function> Ôòµ¼ÖÂÒ»¸ö<link + linkend="errorfunc.constants.errorlevels.e-error">ÖÂÃü´íÎó</link>¡£»»¾ä»°Ëµ£¬Èç¹ûÏëÔÚÓöµ½¶ªÊ§Îļþʱֹͣ´¦ÀíÒ³Ãæ¾ÍÓà + <function>require</function>¡£<function>include</function> + ¾Í²»ÊÇÕâÑù£¬½Å±¾»á¼ÌÐøÔËÐС£Í¬Ê±Ò²ÒªÈ·ÈÏÉèÖÃÁ˺ÏÊ浀 <link + linkend="ini.include-path">include_path</link>¡£×¢ÒâÔÚ + PHP 4.3.5 ֮ǰ£¬°üº¬ÎļþÖеÄÓï·¨´íÎ󲻻ᵼÖ³ÌÐòÍ£Ö¹£¬µ«´Ó´Ë°æ±¾Ö®ºó»á¡£ + </simpara> + <simpara> + Files for including are first looked for in each include_path entry + relative to the current working directory, and then in the directory of + current script. + E.g. if your include_path + is <literal>libraries</literal>, current working directory is <filename class="directory">/www/</filename>, + you included <filename>include/a.php</filename> and there is <literal>include "b.php"</literal> + in that file, <filename>b.php</filename> is first looked in <filename class="directory">/www/libraries/</filename> + and then in <filename class="directory">/www/include/</filename>. + If filename begins with <literal>./</literal> or <literal>../</literal>, it + is looked only in the current working directory. +++++ ѰÕÒ°üº¬ÎļþµÄ˳ÐòÏÈÊÇÔÚµ±Ç°¹¤×÷Ŀ¼µÄÏà¶ÔµÄ include_path + ÏÂѰÕÒ£¬È»ºóÊǵ±Ç°ÔËÐнű¾ËùÔÚĿ¼Ïà¶ÔµÄ include_path ÏÂѰÕÒ¡£ÀýÈç + include_path ÊÇ <literal>.</literal>£¬µ±Ç°¹¤×÷Ŀ¼ÊÇ + <filename class="directory">/www/</filename>£¬½Å±¾ÖÐÒª include Ò»¸ö + <filename>include/a.php</filename> ²¢ÇÒÔÚ¸ÃÎļþÖÐÓÐÒ»¾ä + <literal>include "b.php"</literal>£¬ÔòѰÕÒ + <filename>b.php</filename> µÄ˳ÐòÏÈÊÇ + <filename class="directory">/www/</filename>£¬È»ºóÊÇ + <filename class="directory">/www/include/</filename>¡£Èç¹ûÎļþÃûÒÔ + <literal>./</literal> »òÕß <literal>../</literal> ¿ªÊ¼£¬ÔòÖ»ÔÚµ±Ç°¹¤×÷Ŀ¼Ïà¶ÔµÄ + include_path ÏÂѰÕÒ¡£ </simpara> <simpara> - 当一个文件被包含时,其中所包含的代码继承了 include 所在行的<link - linkend="language.variables.scope">变量范围</link>。从该处开始,调用文件在该行处可用的任何变量在被调用的文件中也都可用。不过所有在包含文件中定义的函数和类都具有全局作用域。 + µ±Ò»¸öÎļþ±»°üº¬Ê±£¬ÆäÖÐËù°üº¬µÄ´úÂë¼Ì³ÐÁË include ËùÔÚÐеÄ<link + linkend="language.variables.scope">±äÁ¿·¶Î§</link>¡£´Ó¸Ã´¦¿ªÊ¼£¬µ÷ÓÃÎļþÔÚ¸ÃÐд¦¿ÉÓõÄÈκαäÁ¿ÔÚ±»µ÷ÓõÄÎļþÖÐÒ²¶¼¿ÉÓᣲ»¹ýËùÓÐÔÚ°üº¬ÎļþÖж¨ÒåµÄº¯ÊýºÍÀà¶¼¾ßÓÐÈ«¾Ö×÷ÓÃÓò¡£ </simpara> <para> <example> - <title>基本的 <function>include</function> 例子</title> + <title>»ù±¾µÄ <function>include</function> Àý×Ó</title> <programlisting role="php"> <![CDATA[ vars.php @@ -1170,11 +1358,14 @@ </example> </para> <simpara> - 如果 include 出现于调用文件中的一个函数里,则被调用的文件中所包含的所有代码将表现得如同它们是在该函数内部定义的一样。所以它将遵循该函数的变量范围。 + Èç¹û include ³öÏÖÓÚµ÷ÓÃÎļþÖеÄÒ»¸öº¯ÊýÀÔò±»µ÷ÓõÄÎļþÖÐËù°üº¬µÄËùÓдúÂ뽫±íÏÖµÃÈçͬËüÃÇÊÇÔڸú¯ÊýÄÚ²¿¶¨ÒåµÄÒ»Ñù¡£ËùÒÔËü½«×ñÑ­¸Ãº¯ÊýµÄ±äÁ¿·¶Î§¡£ + An exception to this rule are <link + linkend="language.constants.predefined">magic constants</link> which are + evaluated by the parser before the include occurs. </simpara> <para> <example> - <title>函数中的包含</title> + <title>º¯ÊýÖеİüº¬</title> <programlisting role="php"> <![CDATA[ <?php @@ -1202,22 +1393,22 @@ </example> </para> <simpara> - 当一个文件被包含时,语法解析器在目标文件的开头脱离 PHP 模式并进入 HTML - 模式,到文件结尾处恢复。由于此原因,目标文件中应被当作 - PHP 代码执行的任何代码都必须被包括在<link - linkend="language.basic-syntax.phpmode">有效的 PHP 起始和结束标记</link>之中。 + µ±Ò»¸öÎļþ±»°üº¬Ê±£¬Óï·¨½âÎöÆ÷ÔÚÄ¿±êÎļþµÄ¿ªÍ·ÍÑÀë PHP ģʽ²¢½øÈë HTML + ģʽ£¬µ½Îļþ½áβ´¦»Ö¸´¡£ÓÉÓÚ´ËÔ­Òò£¬Ä¿±êÎļþÖÐÓ¦±»µ±×÷ + PHP ´úÂëÖ´ÐеÄÈκδúÂë¶¼±ØÐë±»°üÀ¨ÔÚ<link + linkend="language.basic-syntax.phpmode">ÓÐЧµÄ PHP ÆðʼºÍ½áÊø±ê¼Ç</link>Ö®ÖС£ </simpara> <simpara> - 如果“<link linkend="ini.allow-url-fopen">URL fopen wrappers</link>”在 - PHP 中被激活(默认配置),可以用 URL(通过 HTTP - 或者其它支持的封装协议——所支持的协议见<xref linkend="wrappers"/>)而不是本地文件来指定要被包含的文件。如果目标服务器将目标文件作为 - PHP 代码解释,则可以用适用于 HTTP GET 的 URL - 请求字符串来向被包括的文件传递变量。严格的说这和包含一个文件并继承父文件的变量空间并不是一回事;该脚本文件实际上已经在远程服务器上运行了,而本地脚本则包括了其结果。 + Èç¹û¡°<link linkend="ini.allow-url-fopen">URL fopen wrappers</link>¡±ÔÚ + PHP Öб»¼¤»î£¨Ä¬ÈÏÅäÖã©£¬¿ÉÒÔÓà URL£¨Í¨¹ý HTTP + »òÕ߯äËüÖ§³ÖµÄ·âװЭÒ顪¡ªËùÖ§³ÖµÄЭÒé¼û<xref linkend="wrappers"/>£©¶ø²»ÊDZ¾µØÎļþÀ´Ö¸¶¨Òª±»°üº¬µÄÎļþ¡£Èç¹ûÄ¿±ê·þÎñÆ÷½«Ä¿±êÎļþ×÷Ϊ + PHP ´úÂë½âÊÍ£¬Ôò¿ÉÒÔÓÃÊÊÓÃÓÚ HTTP GET µÄ URL + ÇëÇó×Ö·û´®À´Ïò±»°üÀ¨µÄÎļþ´«µÝ±äÁ¿¡£ÑϸñµÄ˵ÕâºÍ°üº¬Ò»¸öÎļþ²¢¼Ì³Ð¸¸ÎļþµÄ±äÁ¿¿Õ¼ä²¢²»ÊÇÒ»»ØÊ£»¸Ã½Å±¾Îļþʵ¼ÊÉÏÒѾ­ÔÚÔ¶³Ì·þÎñÆ÷ÉÏÔËÐÐÁË£¬¶ø±¾µØ½Å±¾Ôò°üÀ¨ÁËÆä½á¹û¡£ </simpara> &warn.no-win32-fopen-wrapper; <para> <example> - <title>通过 HTTP 进行的 <function>include</function></title> + <title>ͨ¹ý HTTP ½øÐÐµÄ <function>include</function></title> <programlisting role="php"> <![CDATA[ <?php @@ -1247,61 +1438,31 @@ </example> </para> <warning> - <title>安全警告</title> + <title>°²È«¾¯¸æ</title> <para> - 远程文件可能会经远程服务器处理(根据文件后缀以及远程服务器是否在运行 - PHP 而定),但必须产生出一个合法的 PHP - 脚本,因为其将被本地服务器处理。如果来自远程服务器的文件应该在远端运行而只输出结果,那用 + Ô¶³ÌÎļþ¿ÉÄܻᾭԶ³Ì·þÎñÆ÷´¦Àí£¨¸ù¾ÝÎļþºó׺ÒÔ¼°Ô¶³Ì·þÎñÆ÷ÊÇ·ñÔÚÔËÐÐ + PHP ¶ø¶¨£©£¬µ«±ØÐë²úÉú³öÒ»¸öºÏ·¨µÄ PHP + ½Å±¾£¬ÒòΪÆä½«±»±¾µØ·þÎñÆ÷´¦Àí¡£Èç¹ûÀ´×ÔÔ¶³Ì·þÎñÆ÷µÄÎļþÓ¦¸ÃÔÚÔ¶¶ËÔËÐжøÖ»Êä³ö½á¹û£¬ÄÇÓà <function>readfile</function> - 函数更好。另外还要格外小心以确保远程的脚本产生出合法并且是所需的代码。 + º¯Êý¸üºÃ¡£ÁíÍ⻹Ҫ¸ñÍâСÐÄÒÔÈ·±£Ô¶³ÌµÄ½Å±¾²úÉú³öºÏ·¨²¢ÇÒÊÇËùÐèµÄ´úÂë¡£ </para> </warning> <para> - 相关信息参见<link - linkend="features.remote-files">使用远程文件</link>,<function>fopen</function> - 和 <function>file</function>。 - </para> - <para> - 因为 <function>include</function> 和 <function>require</function> - 是特殊的语言结构,在条件语句中使用必须将其放在语句组中(花括号中)。 - </para> - <para> - <example> - <title>include() 与条件语句组</title> - <programlisting role="php"> -<![CDATA[ -<?php - -// This is WRONG and will not work as desired. -if ($condition) - include $file; -else - include $other; - - -// This is CORRECT. -if ($condition) { - include $file; -} else { - include $other; -} - -?> -]]> - </programlisting> - </example> + Ïà¹ØÐÅÏ¢²Î¼û<link + linkend="features.remote-files">ʹÓÃÔ¶³ÌÎļþ</link>£¬<function>fopen</function> + ºÍ <function>file</function>¡£ </para> <simpara> - 处理返回值:可以在被包括的文件中使用 <function>return</function> - 语句来终止该文件中程序的执行并返回调用它的脚本。同样也可以从被包含的文件中返回值。可以像普通函数一样获得 - include 调用的返回值。不过这在包含远程文件时却不行,除非远程文件的输出具有<link - linkend="language.basic-syntax.phpmode">合法的 PHP - 开始和结束标记</link>(如同任何本地文件一样)。可以在标记内定义所需的变量,该变量在文件被包含的位置之后就可用了。 + ´¦Àí·µ»ØÖµ£º¿ÉÒÔÔÚ±»°üÀ¨µÄÎļþÖÐʹÓà <function>return</function> + Óï¾äÀ´ÖÕÖ¹¸ÃÎļþÖгÌÐòµÄÖ´Ðв¢·µ»Øµ÷ÓÃËüµÄ½Å±¾¡£Í¬ÑùÒ²¿ÉÒÔ´Ó±»°üº¬µÄÎļþÖзµ»ØÖµ¡£¿ÉÒÔÏñÆÕͨº¯ÊýÒ»Ñù»ñµÃ + include µ÷Óõķµ»ØÖµ¡£²»¹ýÕâÔÚ°üº¬Ô¶³ÌÎļþʱȴ²»ÐУ¬³ý·ÇÔ¶³ÌÎļþµÄÊä³ö¾ßÓÐ<link + linkend="language.basic-syntax.phpmode">ºÏ·¨µÄ PHP + ¿ªÊ¼ºÍ½áÊø±ê¼Ç</link>£¨ÈçͬÈκα¾µØÎļþÒ»Ñù£©¡£¿ÉÒÔÔÚ±ê¼ÇÄÚ¶¨ÒåËùÐèµÄ±äÁ¿£¬¸Ã±äÁ¿ÔÚÎļþ±»°üº¬µÄλÖÃÖ®ºó¾Í¿ÉÓÃÁË¡£ </simpara> <para> - 因为 <function>include</function> 是一个特殊的语言结构,其参数不需要括号。在比较其返回值时要注意。 + ÒòΪ <function>include</function> ÊÇÒ»¸öÌØÊâµÄÓïÑԽṹ£¬Æä²ÎÊý²»ÐèÒªÀ¨ºÅ¡£ÔÚ±È½ÏÆä·µ»ØÖµÊ±Òª×¢Òâ¡£ <example> - <title>比较 include 的返回值</title> + <title>±È½Ï include µÄ·µ»ØÖµ</title> <programlisting role="php"> <![CDATA[ <?php @@ -1319,15 +1480,9 @@ </programlisting> </example> </para> - <note> - <simpara> - 在 PHP 3 中,除非是在函数中调用否则被包含的文件中不能出现 - return。在此情况下 <function>return</function> 作用于该函数而不是整个文件。 - </simpara> - </note> <para> <example> - <title><function>include</function> 和 <function>return</function> 语句</title> + <title><function>include</function> ºÍ <function>return</function> Óï¾ä</title> <programlisting role="php"> <![CDATA[ return.php @@ -1363,26 +1518,26 @@ </example> </para> <simpara> - <literal>$bar</literal> 的值为 <literal>1</literal> 是因为 include - 成功运行了。注意以上例子中的区别。第一个在被包含的文件中用了 - <function>return</function> 而另一个没有。如果文件不能被包含,则返回 - &false; 并发出一个 <literal>E_WARNING</literal> 警告。 - </simpara> - <para> - 如果在包含文件中定义有函数,这些函数可以独立于是否在 - <function>return</function> 之前还是之后在主文件中使用。如果文件被包含两次,PHP - 5 发出致命错误因为函数已经被定义,但是 PHP 在 - <function>return</function> 之后不会抱怨函数已定义。推荐使用 - <function>include_once</function> 而不是检查文件是否已包含并在包含文件中有条件返回。 - </para> - <simpara> - 另一个将 PHP 文件“包含”到一个变量中的方法是用<link - linkend="ref.outcontrol">输出控制函数</link>结合 - <function>include</function> 来捕获其输出,例如: + <literal>$bar</literal> µÄֵΪ <literal>1</literal> ÊÇÒòΪ include + ³É¹¦ÔËÐÐÁË¡£×¢ÒâÒÔÉÏÀý×ÓÖеÄÇø±ð¡£µÚÒ»¸öÔÚ±»°üº¬µÄÎļþÖÐÓÃÁË + <function>return</function> ¶øÁíÒ»¸öûÓС£Èç¹ûÎļþ²»Äܱ»°üº¬£¬Ôò·µ»Ø + &false; ²¢·¢³öÒ»¸ö <literal>E_WARNING</literal> ¾¯¸æ¡£ + </simpara> + <para> + Èç¹ûÔÚ°üº¬ÎļþÖж¨ÒåÓк¯Êý£¬ÕâЩº¯Êý¿ÉÒÔ¶ÀÁ¢ÓÚÊÇ·ñÔÚ + <function>return</function> ֮ǰ»¹ÊÇÖ®ºóÔÚÖ÷ÎļþÖÐʹÓá£Èç¹ûÎļþ±»°üº¬Á½´Î£¬PHP + 5 ·¢³öÖÂÃü´íÎóÒòΪº¯ÊýÒѾ­±»¶¨Ò壬µ«ÊÇ PHP ÔÚ + <function>return</function> Ö®ºó²»»á±§Ô¹º¯ÊýÒѶ¨Òå¡£ÍÆ¼öʹÓà + <function>include_once</function> ¶ø²»ÊǼì²éÎļþÊÇ·ñÒѰüº¬²¢ÔÚ°üº¬ÎļþÖÐÓÐÌõ¼þ·µ»Ø¡£ + </para> + <simpara> + ÁíÒ»¸ö½« PHP Îļþ¡°°üº¬¡±µ½Ò»¸ö±äÁ¿Öеķ½·¨ÊÇÓÃ<link + linkend="ref.outcontrol">Êä³ö¿ØÖƺ¯Êý</link>½áºÏ + <function>include</function> À´²¶»ñÆäÊä³ö£¬ÀýÈ磺 </simpara> <para> <example> - <title>使用输出缓冲来将 PHP 文件包含入一个字符串</title> + <title>ʹÓÃÊä³ö»º³åÀ´½« PHP Îļþ°üº¬ÈëÒ»¸ö×Ö·û´®</title> <programlisting role="php"> <![CDATA[ <?php @@ -1405,117 +1560,117 @@ </example> </para> <para> - 要在脚本中自动包含文件,参见 &php.ini; 中的 - <link linkend="ini.auto-prepend-file">auto_prepend_file</link> 和 + ÒªÔڽű¾ÖÐ×Ô¶¯°üº¬Îļþ£¬²Î¼û &php.ini; ÖÐµÄ + <link linkend="ini.auto-prepend-file">auto_prepend_file</link> ºÍ <link linkend="ini.auto-append-file">auto_append_file</link> - 配置选项。 + ÅäÖÃÑ¡Ïî¡£ </para> &note.language-construct; <simpara> - 参见 <function>require</function>,<function>require_once</function>,<function>include_once</function>,<function>get_included_files</function>,<function>readfile</function>,<function>virtual</function> 和 <link linkend="ini.include-path">include_path</link>。 + ²Î¼û <function>require</function>£¬<function>require_once</function>£¬<function>include_once</function>£¬<function>get_included_files</function>£¬<function>readfile</function>£¬<function>virtual</function> ºÍ <link linkend="ini.include-path">include_path</link>¡£ </simpara> </sect1> <sect1 xml:id="function.require-once"> <title><function>require_once</function></title> <para> - <function>require_once</function> 语句在脚本执行期间包含并运行指定文件。此行为和 + <function>require_once</function> Óï¾äÔڽű¾Ö´ÐÐÆÚ¼ä°üº¬²¢ÔËÐÐÖ¸¶¨Îļþ¡£´ËÐÐΪºÍ <function>require</function> - 语句类似,唯一区别是如果该文件中的代码已经被包含了,则不会再次包含。有关此语句怎样工作参见 - <function>require</function> 的文档。 + Óï¾äÀàËÆ£¬Î¨Ò»Çø±ðÊÇÈç¹û¸ÃÎļþÖеĴúÂëÒѾ­±»°üº¬ÁË£¬Ôò²»»áÔٴΰüº¬¡£ÓйشËÓï¾äÔõÑù¹¤×÷²Î¼û + <function>require</function> µÄÎĵµ¡£ </para> <para> <function>require_once</function> - 应该用于在脚本执行期间同一个文件有可能被包含超过一次的情况下,想确保它只被包含一次以避免函数重定义,变量重新赋值等问题。 + Ó¦¸ÃÓÃÓÚÔڽű¾Ö´ÐÐÆÚ¼äͬһ¸öÎļþÓпÉÄܱ»°üº¬³¬¹ýÒ»´ÎµÄÇé¿öÏ£¬ÏëÈ·±£ËüÖ»±»°üº¬Ò»´ÎÒÔ±ÜÃ⺯ÊýÖØ¶¨Ò壬±äÁ¿ÖØÐ¸³ÖµµÈÎÊÌâ¡£ </para> <para> - 使用 <function>require_once</function> 和 <function>include_once</function> - 的例子见最新的 PHP 源程序发行包中的 <link xlink:href="&url.php.pear;">PEAR</link> 代码。 + ʹÓà <function>require_once</function> ºÍ <function>include_once</function> + µÄÀý×Ó¼û×îÐ嵀 PHP Ô´³ÌÐò·¢ÐаüÖÐµÄ <link xlink:href="&url.php.pear;">PEAR</link> ´úÂë¡£ </para> <para> - 返回值和 <function>include</function> 相同。如果文件已被包含,本函数返回 &true;。 + ·µ»ØÖµºÍ <function>include</function> Ïàͬ¡£Èç¹ûÎļþÒѱ»°üº¬£¬±¾º¯Êý·µ»Ø &true;¡£ </para> <note> <para> - <function>require_once</function> 是 PHP 4.0.1pl2 中新加入的。 + <function>require_once</function> ÊÇ PHP 4.0.1 ÖÐмÓÈëµÄ¡£ </para> </note> <note> <para> - 要注意 <function>require_once</function> 和 <function>include_once</function> - 在大小写不敏感的操作系统中(例如 Windows)的行为可能不是所期望的。 + ҪעÒâ <function>require_once</function> ºÍ <function>include_once</function> + ÔÚ´óСд²»Ãô¸ÐµÄ²Ù×÷ϵͳÖУ¨ÀýÈç Windows£©µÄÐÐΪ¿ÉÄܲ»ÊÇËùÆÚÍûµÄ¡£ <example> - <title><function>require_once</function> 在 Windows 下不区分大小写</title> + <title><function>require_once</function> ÔÚ Windows ϲ»Çø·Ö´óСд</title> <programlisting role="php"> <![CDATA[ <?php -require_once("a.php"); // this will include a.php -require_once("A.php"); // this will include a.php again on Windows! +require_once "a.php"; // this will include a.php +require_once "A.php"; // this will include a.php again on Windows! ?> ]]> </programlisting> </example> - 此行为在 PHP 5 中改了,路径先被规格化,因此 - <filename>C:\PROGRA~1\A.php</filename> 和 - <filename>C:\Program Files\a.php</filename> 的实现一样,文件只会被包含一次。 + ´ËÐÐΪÔÚ PHP 5 ÖиÄÁË£¬Â·¾¶Ïȱ»¹æ¸ñ»¯£¬Òò´Ë + <filename>C:\PROGRA~1\A.php</filename> ºÍ + <filename>C:\Program Files\a.php</filename> µÄʵÏÖÒ»Ñù£¬ÎļþÖ»»á±»°üº¬Ò»´Î¡£ </para> </note> &warn.no-win32-fopen-wrapper; <para> - 参见 - <function>require</function>,<function>include</function>,<function>include_once</function>,<function>get_required_files</function>,<function>get_included_files</function>,<function>readfile</function> - 和 <function>virtual</function>。 + ²Î¼û + <function>require</function>£¬<function>include</function>£¬<function>include_once</function>£¬<function>get_required_files</function>£¬<function>get_included_files</function>£¬<function>readfile</function> + ºÍ <function>virtual</function>¡£ </para> </sect1> <sect1 xml:id="function.include-once"> <title><function>include_once</function></title> <para> - The <function>include_once</function> 语句在脚本执行期间包含并运行指定文件。此行为和 + The <function>include_once</function> Óï¾äÔڽű¾Ö´ÐÐÆÚ¼ä°üº¬²¢ÔËÐÐÖ¸¶¨Îļþ¡£´ËÐÐΪºÍ <function>include</function> - 语句类似,唯一区别是如果该文件中的代码已经被包含了,则不会再次包含。如同此语句名字暗示的那样,只会包含一次。 + Óï¾äÀàËÆ£¬Î¨Ò»Çø±ðÊÇÈç¹û¸ÃÎļþÖеĴúÂëÒѾ­±»°üº¬ÁË£¬Ôò²»»áÔٴΰüº¬¡£Èçͬ´ËÓï¾äÃû×Ö°µÊ¾µÄÄÇÑù£¬Ö»»á°üº¬Ò»´Î¡£ </para> <para> <function>include_once</function> - 应该用于在脚本执行期间同一个文件有可能被包含超过一次的情况下,想确保它只被包含一次以避免函数重定义,变量重新赋值等问题。 + Ó¦¸ÃÓÃÓÚÔڽű¾Ö´ÐÐÆÚ¼äͬһ¸öÎļþÓпÉÄܱ»°üº¬³¬¹ýÒ»´ÎµÄÇé¿öÏ£¬ÏëÈ·±£ËüÖ»±»°üº¬Ò»´ÎÒÔ±ÜÃ⺯ÊýÖØ¶¨Ò壬±äÁ¿ÖØÐ¸³ÖµµÈÎÊÌâ¡£ </para> <para> - 使用 <function>require_once</function> 和 <function>include_once</function> - 的更多例子见最新的 PHP 源程序发行包中的 <link xlink:href="&url.php.pear;">PEAR</link> 代码。 + ʹÓà <function>require_once</function> ºÍ <function>include_once</function> + µÄ¸ü¶àÀý×Ó¼û×îÐ嵀 PHP Ô´³ÌÐò·¢ÐаüÖÐµÄ <link xlink:href="&url.php.pear;">PEAR</link> ´úÂë¡£ </para> <para> - 返回值和 <function>include</function> 相同。如果文件已被包含,本函数返回 &true;。 + ·µ»ØÖµºÍ <function>include</function> Ïàͬ¡£Èç¹ûÎļþÒѱ»°üº¬£¬±¾º¯Êý·µ»Ø &true;¡£ </para> <note> <para> - <function>include_once</function> 是 PHP 4.0.1pl2 中新加入的。 + <function>include_once</function> ÊÇ PHP 4.0.1pl2 ÖÐмÓÈëµÄ¡£ </para> </note> <note> <para> - 要注意 <function>include_once</function> 和 <function>require_once</function> - 在大小写不敏感的操作系统中(例如 Windows)的行为可能不是所期望的。 + ҪעÒâ <function>include_once</function> ºÍ <function>require_once</function> + ÔÚ´óСд²»Ãô¸ÐµÄ²Ù×÷ϵͳÖУ¨ÀýÈç Windows£©µÄÐÐΪ¿ÉÄܲ»ÊÇËùÆÚÍûµÄ¡£ <example> - <title><function>include_once</function> 在 Windows 下不区分大小写</title> + <title><function>include_once</function> ÔÚ Windows ϲ»Çø·Ö´óСд</title> <programlisting role="php"> <![CDATA[ <?php -include_once("a.php"); // this will include a.php -include_once("A.php"); // this will include a.php again on Windows! (PHP 4 only) +include_once "a.php"; // this will include a.php +include_once "A.php"; // this will include a.php again on Windows! (PHP 4 only) ?> ]]> </programlisting> </example> - 此行为在 PHP 5 中改了,路径先被规格化,因此 - <filename>C:\PROGRA~1\A.php</filename> 和 - <filename>C:\Program Files\a.php</filename> 的实现一样,文件只会被包含一次。 + ´ËÐÐΪÔÚ PHP 5 ÖиÄÁË£¬Â·¾¶Ïȱ»¹æ¸ñ»¯£¬Òò´Ë + <filename>C:\PROGRA~1\A.php</filename> ºÍ + <filename>C:\Program Files\a.php</filename> µÄʵÏÖÒ»Ñù£¬ÎļþÖ»»á±»°üº¬Ò»´Î¡£ </para> </note> &warn.no-win32-fopen-wrapper; <para> - 参见 <function>include</function>,<function>require</function>,<function>require_once</function>,<function>get_required_files</function>,<function>get_included_files</function>,<function>readfile</function> 和 <function>virtual</function>。 + ²Î¼û <function>include</function>£¬<function>require</function>£¬<function>require_once</function>£¬<function>get_required_files</function>£¬<function>get_included_files</function>£¬<function>readfile</function> ºÍ <function>virtual</function>¡£ </para> </sect1>
« previous php.doc.zh (#3134) next »