cvs: phpdoc-zh /language control-structures.xml
| From: | Gang Chen | 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> ä¹åå ä¸ - & æ¥ä¿®æ¹æ°ç»çåå ãæ¤æ¹æ³å°ä»¥<link - linkend="language.references">å¼ç¨</link>èµå¼è䏿¯æ·è´ä¸ä¸ªå¼ã + ×Ô PHP 5 Æð£¬¿ÉÒÔºÜÈÝÒ×µØÍ¨¹ýÔÚ <literal>$value</literal> ֮ǰ¼ÓÉÏ + & À´ÐÞ¸ÄÊý×éµÄÔªËØ¡£´Ë·½·¨½«ÒÔ<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> ¬e.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> ¬e.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>
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> ä¹åå ä¸ - & æ¥ä¿®æ¹æ°ç»çåå ãæ¤æ¹æ³å°ä»¥<link - linkend="language.references">å¼ç¨</link>èµå¼è䏿¯æ·è´ä¸ä¸ªå¼ã + ×Ô PHP 5 Æð£¬¿ÉÒÔºÜÈÝÒ×µØÍ¨¹ýÔÚ <literal>$value</literal> ֮ǰ¼ÓÉÏ + & À´ÐÞ¸ÄÊý×éµÄÔªËØ¡£´Ë·½·¨½«ÒÔ<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> ¬e.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> ¬e.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>