cvs: phpdoc-ar /language control-structures.xml
[email protected] ("Hafid Benhadria") Thu, 01 Jan 2004 20:28:12 -0000
| Newsgroups | php.doc.ar |
|---|---|
| Message-ID | <cvshafid1072988892@cvsserver> |
hafid Thu Jan 1 15:28:12 2004 EDT
Modified files:
/phpdoc-ar/language control-structures.xml
Log:
Final Partial Translation.
hafid-20040101152812.txt
(text/plain, 67.8 KB)
Index: phpdoc-ar/language/control-structures.xml
diff -u phpdoc-ar/language/control-structures.xml:1.1 phpdoc-ar/language/control-structures.xml:1.2
--- phpdoc-ar/language/control-structures.xml:1.1 Fri Dec 26 19:08:32 2003
+++ phpdoc-ar/language/control-structures.xml Thu Jan 1 15:28:12 2004
@@ -1,15 +1,15 @@
<?xml version="1.0" encoding="ISO-8859-6"?>
-<!-- $Revision: 1.1 $ -->
-<!-- EN-Revision: 1.83 Maintainer: hafid Status: working -->
+<!-- $Revision: 1.2 $ -->
+<!-- EN-Revision: 1.83 Maintainer: hafid Status: ready -->
<chapter id="control-structures">
- <title>Control Structures</title>
+ <title>Èïæé ÇäÊñîÍãñïå</title>
<simpara>
êÊÃäá Ãê ÎÇ×è× PHP åæ åÌåèÙÉ åæ ÇäÈäÇÚÇÊ. ÇäÈäÇÚ
êåãæ Ãæ êãèæ ÊÙêêæÇë¬ æÏÇÁ ÏÇäɬ Íäâɬ ÈäÇÚÇ
ÔÑ×êñÇ Ãè ÍÊé ÈäÇÚÇ äÇ êâèå ÈÃêñ ÔêÁ (ÈäÇÚ
- áÇÑÚ). ÚÇÏÉ åÇ ÊæÊçê ÇäÈäÇÚÇÊ ÈáÇÕäÉ åæâè×É. ãÐäã¬
- áÅæñîç êåãæ ÊÌåêÙ ÇäÈäÇÚÇÊ Öåæ åÌåèÙÉ ÈäÇÚêñîÉ åæ ÎäÇä ÊÚäêá
+ áÇÑÚ). ÙÇÏÉ åÇ ÊæÊçê ÇäÈäÇÚÇÊ ÈáÇÕäÉ åæâè×É. ãÐäã¬
+ áÅæñîç êåãæ ÊÌåêÙ ÇäÈäÇÚÇÊ Öåæ åÌåèÙÉ ÈäÇÚêñîÉ èÇÍÏÉ åæ ÎäÇä ÊÚäêá
åÌåèÙÉ ÈäÇÚÇÊ ÈÍÇÖæÊêæ åÙâèáÊêæ ("<literal>{}</literal>"). åÌåèÙÉ ÈäÇÚêñîÉ ÊïÙÊÈÑ
áê ÍÏ ÐÇÊçÇ ÈäÇÚÇë ÃêÖÇ. Åæñî åÎÊäá ÃæèÇÙ ÇäÈäÇÚÇÊ çê åÍä
èÕá áê çÐÇ ÇäáÕä.
@@ -476,14 +476,14 @@
</informalexample>
</para>
<para>
- Other languages have a <literal>foreach</literal> statement to
- traverse an array or hash. PHP 3 has no such construct; PHP 4 does
- (see <link
- linkend="control-structures.foreach">foreach</link>). In PHP 3, you
- can combine <link linkend="control-structures.while">while</link>
- with the <function>list</function> and <function>each</function>
- functions to achieve the same effect. See the documentation for
- these functions for an example.
+ ÊÊèáÑ ÈÙÖ ÇääñïÚÇÊ ÇäÃÎÑé Ùäé ÈäÇÚ <literal>foreach</literal>
+ äÙÈèÑ åÕáèáÉ Ãè ÊÌÒÆÉ. äÇ ÊÊèáÑ PHP 3 Ùäé åËä çÐÇ ÇäÈæÇÁ áê Íêæ êÊèáÑ Ùäêç PHP 4
+ (ÇÓÊÙÑÖ <link
+ linkend="control-structures.foreach">foreach</link>). áê PHP 3¬
+ êåãæã ÅÔÑÇã <link linkend="control-structures.while">while</link>
+ ÈÏèÇä <function>list</function> è <function>each</function>
+ ÈÚÑÖ ÅæÌÇÒ æáÓ ÇäÊñîÇËêÑ. ÇÓÊÙÑÖ ÇäÊñîèËêâ ÇäÎÇÕ
+ ÈçÐç ÇäÏñîèÇä äÃÌä ÇäÍÕèä Ùäé åËÇä.
</para>
</sect1>
@@ -491,70 +491,70 @@
<sect1 id="control-structures.foreach">
<title><literal>foreach</literal></title>
<para>
- PHP 4 (not PHP 3) includes a <literal>foreach</literal> construct, much
- like Perl and some other languages. This simply gives an easy way to
- iterate over arrays. <literal>foreach</literal> works only on arrays, and
- will issue an error when you try to use it on a variable with a different
- data type or an uninitialized variable. There are two syntaxes; the
- second is a minor but useful extension of the first:
+ ÊÊÖåæ PHP 4 (äêÓ PHP 3) ÈæÇÁ <literal>foreach</literal>¬ åËäåÇ
+ ÇäÍÇä åÙ Perl èÈÖÙ äÚÇÊ ÃÎÑé. êïÙò×ê çÐÇ ×ÑêâÉ ÓçäÉ
+ äÅÊåÇå ÊãÑÇÑÇÊ Ùäé ÇäåÕáèáÇÊ. ÊÙåä <literal>foreach</literal> áâ× Ùäé ÇäåÕáèáÇÊ èçê
+ ÊÓÊÕÏÑ Î×Ãë ÍêæåÇ ÊÍÇèä ÇÓÊÎÏÇåçÇ Ùäé åïÊÚêñðÑ Ðê æèÙ ÈêÇæêñ
+ åÚÇêÑ Ãè åïÊÚêñðÑ ÚêÑ åïÓÊçñîä. çæÇã ÕêÚÊêæ æÍèêÊêæ»
+ ÊïÙòÊîÈîÑï ÇäËñîÇæêÉ ÊèÓÙÇë ×áêáÇë äãæ åáêÏÇë ääÃèäé:
<informalexample>
<programlisting>
<![CDATA[
-foreach (array_expression as $value) statement
-foreach (array_expression as $key => $value) statement
+foreach (array_expression as $value) ÈäÇÚ
+foreach (array_expression as $key => $value) ÈäÇÚ
]]>
</programlisting>
</informalexample>
</para>
<simpara>
- The first form loops over the array given by
- <literal>array_expression</literal>. On each loop, the value of
- the current element is assigned to <literal>$value</literal> and
- the internal array pointer is advanced by one (so on the next
- loop, you'll be looking at the next element).
+ êïÊåðåï ÇäÔñîãäï ÇäÃèä ÍäâÇÊ Ùäé ÇäåÕáèáÉ ÇäåïÙò×îÇÉ åæ âðÈîä
+ <literal>array_expression</literal>. ÙæÏ ãäñ Íäâɬ ÊïÙêñîæ âêåÉ
+ ÇäÙæÕÑ ÇäÑñîÇçæ ÈÇÊÌÇç <literal>$value</literal>
+ èêÊå ÊâÏêå åÄÔÑ ÇäåÕáèáÉ ÇäÏñîÇÎäêñ ÈèÇÍÏ (ÈÍêË Ãæñîç ÙæÏ
+ ÇäÍäâÉ ÇäÂÊêñîɬ ÓÊãèæ ÈÕÏÏ ÇäæñîØÑ Åäé ÇäÙæÕÑ ÇäåèÇäêñ).
</simpara>
<simpara>
- The second form does the same thing, except that the current
- element's key will be assigned to the variable
- <literal>$key</literal> on each loop.
+ êâèå ÇäÔñîãä ÇäËñîÇæêñ ÈæáÓ ÇäÔñîêÁ áêåÇ ÙÏÇ Ãæñî
+ åáÊÇÍ ÇäÙæÕÑ ÇäÑñîÇçæ êïÙêñîæ ÈÇÊÌÇç ÇäåïÊÚêñðÑ
+ <literal>$key</literal>¬ ÙæÏ ãäñ ÍäâÉ.
</simpara>
<para>
<note>
<para>
- When <literal>foreach</literal> first starts executing, the
- internal array pointer is automatically reset to the first element
- of the array. This means that you do not need to call
- <function>reset</function> before a <literal>foreach</literal>
- loop.
+ ÙæÏ Ãè ÈÏÇêÉ äà <literal>foreach</literal> áê ÇäÊñîæáêЬ
+ ÊÊå ÅÙÇÏÉ ÊÙêêæ åÄÔÑ ÇäåÕáèáÉ ÇäÏñîÇÎäê ÈÔãä Âäêñ ÈÍÓÈ ÙæÕÑ
+ ÇäåÕáèáÉ ÇäÃèä. êÙæê çÐÇ Ãæñîã äÓÊ ÈÍÇÌÉ äåæÇÏÇÉ
+ <function>reset</function> âÈä ÍäâÉ <literal>foreach</literal>
+ .
</para>
</note>
</para>
<para>
<note>
<para>
- Also note that <literal>foreach</literal> operates on a copy of
- the specified array and not the array itself. Therefore, the
- array pointer is not modified as with the
- <function>each</function> construct, and changes to the array
- element returned are not reflected in the original array.
- However, the internal pointer of the original array
- <emphasis>is</emphasis> advanced with the processing of the
- array. Assuming the foreach loop runs to completion, the
- array's internal pointer will be at the end of the array.
+ ãÐä㬠äÇÍØ Ãæ <literal>foreach</literal> êÙåä Ùäé æÓÎÉ åæ
+ ÇäåÕáèáÉ ÇäåïÍÏñîÏîÉ èäêÓ ÇäåÕáèáÉ æáÓçÇ. äÐä㬠áÅæñîç
+ äÇ êÊå ÊÙÏêä åÄÔÑ ÇäåÕáèáÉ åËäåÇ êÊå åÙ
+ ÈæÇÁ <function>each</function> èÇäÊñîÚêêÑÇÊ Çä×ñîÇÑÆÉ Ùäé ÙæÕÑ ÇäåÕáèáÉ
+ äÇ êÊå¬ ÙæÏ ÅÙÇÏÊçǬ ÃÎÐçÇ ÈÙêæ ÇäÇÙÊÈÇÑ áê ÇäåÕáèáÉ ÇäÃÕäêñîÉ.
+ åÙ Ðä㬠áÅæñî ÇäåÄÔÑ ÇäÏñîÇÎäêñ ääåÕáèáÉ ÇäÃÕäêñîÉ
+ <emphasis>êÊå</emphasis> ÊâÏêåç ÈÑáâÉ åÙÇäÌÉ
+ ÇäåÕáèáÉ. åÙ ÇáÊÑÇÖ Ãæ ÍäâÉ foreach ÊÔÊÚä äÚÇêÉ ÇäÇãÊåÇä¬ áÅæñî
+ ÇäåÄÔÑ ÇäÏñîÇÎäêñ ÇäÎÇÕ ÈÇäåÕáèáÉ Óêãèæ ÙæÏ æçÇêÉ ÇäåÕáèáÉ.
</para>
</note>
</para>
<para>
<note>
<para>
- <literal>foreach</literal> does not support the ability to
- suppress error messages using '@'.
+ äÇ ÊÏÙå <literal>foreach</literal> âÇÈäêÉ
+ ÅÒÇäÉ ÑÓÇÆä ÇäÃÎ×ÇÁ ÈÇÓÊÎÏÇå '@'.
</para>
</note>
</para>
<para>
- You may have noticed that the following are functionally
- identical:
+ êåãæ Ãæñîã äÇÍØÊ Ãæñî åÇ êäê¬ çè åæ ÇäæñîÇÍêÉ ÇäèØêáêñîɬ
+ åÊåÇËä:
<informalexample>
<programlisting role="php">
<![CDATA[
@@ -572,7 +572,7 @@
]]>
</programlisting>
</informalexample>
- The following are also functionally identical:
+ åÇ êäê çè ÃêÖǬ åæ ÇäæñîÇÍêÉ ÇäèØêáêñîɬ åÊåÇËä:
<informalexample>
<programlisting role="php">
<![CDATA[
@@ -591,31 +591,31 @@
</informalexample>
</para>
<para>
- Some more examples to demonstrate usages:
+ ÈÙÖ ÇäÃåËäÉ ÇäÃÎÑé äÊÈêÇæ ÇäÅÓÊÎÏÇåÇÊ:
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
-/* foreach example 1: value only */
+/* åËÇä Ñâå 1 Ùæ foreach: ÇäâêåÉ áâ× */
$a = array (1, 2, 3, 17);
foreach ($a as $v) {
- print "Current value of \$a: $v.\n";
+ print "ÇäâêåÉ ÇäÍÇäêñîÉ äà \$a: $v.\n";
}
-/* foreach example 2: value (with key printed for illustration) */
+/* åËÇä Ñâå 2 Ùæ foreach: âêåÉ (åïÑòáîâ ÈåáÊÇÍ å×ÈèÙ äÃÌä ÇäÅêÖÇÍ) */
$a = array (1, 2, 3, 17);
-$i = 0; /* for illustrative purposes only */
+$i = 0; /* äÃÚÑÇÖ ÊèÖêÍêñîÉ áâ× */
foreach ($a as $v) {
print "\$a[$i] => $v.\n";
$i++;
}
-/* foreach example 3: key and value */
+/* åËÇä Ñâå 3 Ùæ foreach: åáÊÇÍ èâêåÉ */
$a = array (
"one" => 1,
@@ -628,7 +628,7 @@
print "\$a[$k] => $v.\n";
}
-/* foreach example 4: multi-dimensional arrays */
+/* åËÇä Ñâå 4 Ùæ foreach: åÕáèáÇÊ åïÊÙÏñðÏîÉ ÇäÃÈÙÇÏ */
$a[0][0] = "a";
$a[0][1] = "b";
@@ -641,7 +641,7 @@
}
}
-/* foreach example 5: dynamic arrays */
+/* åËÇä Ñâå 5 Ùæ foreach: åÕáèáÇÊ ÍêèêñîÉ */
foreach (array(1, 2, 3, 4, 5) as $v) {
print "$v\n";
@@ -656,15 +656,15 @@
<sect1 id="control-structures.break">
<title><literal>break</literal></title>
<simpara>
- <literal>break</literal> ends execution of the current
- <literal>for</literal>, <literal>foreach</literal>
- <literal>while</literal>, <literal>do..while</literal> or
- <literal>switch</literal> structure.
+ Êïæçðê <literal>break</literal> ÊæáêÐ ÈæêÉ
+ <literal>for</literal>¬ <literal>foreach</literal>¬
+ <literal>while</literal>¬ <literal>do..while</literal> Ãè
+ <literal>switch</literal> ÇäÍÇäêñîÉ.
</simpara>
<simpara>
- <literal>break</literal> accepts an optional numeric argument
- which tells it how many nested enclosing structures are to be
- broken out of.
+ ÊâÈä <literal>break</literal> ÏäêäÇë ÑâåêñÇ ÇÎÊêÇÑêñÇ
+ êïÎÈðÑïçÇ Ùæ ÙÏÏ ÇäÈïæé ÇäåïÍðê×îÉ ÇäåïÊîÔîÇÈðãîÉ
+ ÇäÂêäÉ ääÇÙÇâÉ.
</simpara>
<para>
<informalexample>
@@ -674,22 +674,22 @@
$arr = array ('one', 'two', 'three', 'four', 'stop', 'five');
while (list (, $val) = each ($arr)) {
if ($val == 'stop') {
- break; /* You could also write 'break 1;' here. */
+ break; /* êåæãã ÃêÖÇ ãÊÇÈÉ 'break 1;' çæÇ. */
}
echo "$val<br>\n";
}
-/* Using the optional argument. */
+/* ÇÓÊÎÏÇå ÇäÏñîäêä ÇäÇÎÊêÇÑêñ. */
$i = 0;
while (++$i) {
switch ($i) {
case 5:
echo "At 5<br>\n";
- break 1; /* Exit only the switch. */
+ break 1; /* ÇäÎÑèÌ áâ× åæ switch. */
case 10:
- echo "At 10; quitting<br>\n";
- break 2; /* Exit the switch and the while. */
+ echo "ÙæÏ 10; ÇäåïÚÇÏîÑîÉ<br>\n";
+ break 2; /* ÇäÎÑèÌ åæ switch è while. */
default:
break;
}
@@ -704,22 +704,22 @@
<sect1 id="control-structures.continue">
<title><literal>continue</literal></title>
<simpara>
- <literal>continue</literal> is used within looping structures to
- skip the rest of the current loop iteration and continue execution
- at the beginning of the next iteration.
+ ÊïÓÊÎÏîå <literal>continue</literal> ÏÇÎä ÇäÈæé ÇäÍäâêñîÉ ÈÚÑÖ
+ ÊÎ×ê ÈâêÉ ÊãÑÇÑ ÇäÍäâÉ ÇäÍÇäêñîÉ èåèÇÕäÉ ÇäÊñîæáêÐ
+ ÙæÏ ÈÏÇêÉ ÇäÊñðãÑÇÑ ÇäåïâÈðä.
</simpara>
<note>
<simpara>
- Note that in PHP the
- <link linkend="control-structures.switch">switch</link> statement is
- considered a looping structure for the purposes of
+ äÇÍØ Ãæñîç áê PHP¬
+ êïÙÊîÈîÑ ÈäÇÚï <link linkend="control-structures.switch">switch</link>
+ ÈåËÇÈÉ ÈæêÉ ÍäâêñîÉ äÃÚÑÇÖ
<literal>continue</literal>.
</simpara>
</note>
<simpara>
- <literal>continue</literal> accepts an optional numeric argument
- which tells it how many levels of enclosing loops it should skip
- to the end of.
+ ÊâÈä <literal>continue</literal> ÏäêäÇ ÑâåêñÇ ÇÎÊêÇÑêñÇ
+ êïÎÈðÑïçÇ Ùæ ÙÏÏ ÇäåÓÊèêÇÊ ÇäÎÇÕÉ ÈÇäÍäâÇÊ ÇäåïÍðê×É ÇäåÊèÌÈ ÙäêçÇ ÊÎ×êçÇ
+ Åäé æçÇêÊçÇ.
</simpara>
<para>
<informalexample>
@@ -727,7 +727,7 @@
<![CDATA[
<?php
while (list ($key, $value) = each ($arr)) {
- if (!($key % 2)) { // skip odd members
+ if (!($key % 2)) { // ÊÎ×ê ÇäÃÙÖÇÁ ÇäáïÑÇÏîé
continue;
}
do_something_odd ($value);
@@ -737,14 +737,14 @@
while ($i++ < 5) {
echo "Outer<br>\n";
while (1) {
- echo " Middle<br>\n";
+ echo " èÓ×<br>\n";
while (1) {
- echo " Inner<br>\n";
+ echo " ÏÇÎä<br>\n";
continue 3;
}
- echo "This never gets output.<br>\n";
+ echo "äÇ êÍÕä çÐÇ ÃÈÏÇ Ùäé åïÎòÑîÌ.<br>\n";
}
- echo "Neither does this.<br>\n";
+ echo "èäÇ çÐÇ.<br>\n";
}
?>
]]>
@@ -752,8 +752,8 @@
</informalexample>
</para>
<para>
- Omitting the semicolon after <literal>continue</literal> can lead to
- confusion. Here's an example of what you shouldn't do.
+ êåãæ äÇÚáÇä Çäæñïâ×É ÇäáÇÕðäîÉ ÈÙÏ <literal>continue</literal> Ãæ êÄÏê
+ ääÇäÊÈÇÓ. ÌðÏ çæÇ åËÇäÇ ÙåÇ êÌÈ Ãæ äÇ Êâèå Èç.
</para>
<para>
<informalexample>
@@ -769,7 +769,7 @@
]]>
</programlisting>
<para>
- One can expect the result to be :
+ êåãæ ääåÑÁ Ãæ êÊèâÙ Ãæ Êãèæ ÇäæñîÊêÌÉ çê:
</para>
<screen>
<![CDATA[
@@ -780,7 +780,7 @@
]]>
</screen>
<para>
- but this script will output :
+ äãæ çÐÇ ÇäÎÇ×è× ÓêÓÊÕÏÑ:
</para>
<screen>
<![CDATA[
@@ -788,9 +788,9 @@
]]>
</screen>
<para>
- because the return value of the <function>print</function>
- call is <literal>int(1)</literal>, and it will look like the
- optional numeric argument mentioned above.
+ äÃæñî âêåÉ ÇäÇÑÌÇÙ ÇäÎÇÕÉ ÈåæÇÏÇÉ <function>print</function>
+ çê <literal>int(1)</literal> èÓîÊîØòçîÑ åËä
+ ÇäÏñîäêä ÇäÑñîâåêñ ÇäÇÎÊêÇÑêñ ÇäåïÔÇÑ Åäêç áê ÇäÃÙäé.
</para>
</informalexample>
</para>
@@ -799,48 +799,48 @@
<sect1 id="control-structures.switch">
<title><literal>switch</literal></title>
<simpara>
- The <literal>switch</literal> statement is similar to a series of
- IF statements on the same expression. In many occasions, you may
- want to compare the same variable (or expression) with many
- different values, and execute a different piece of code depending
- on which value it equals to. This is exactly what the
- <literal>switch</literal> statement is for.
+ êïÔÈðçï ÈäÇÚ <literal>switch</literal> åÌåèÙÉ
+ ÈäÇÚÇÊ IF áê æáÓ ÇäÙÈÇÑÉ. áê ÙÏÉ åæÇÓÈÇʬ êåãæ
+ Ãæ ÊÑÚÈ áê åâÇÑæÉ æáÓ ÇäåïÊÚêñðÑ (Ãè ÇäÙÈÇÑÉ) åÙ ÙÏÉ
+ âêå åÎÊäáÉ èÊæáêÐ åâ×Ù ÔêáÑÉ ÈÍÓÈ
+ ÇäâêåÉ ÇäÊñðê êÓÇèêçÇ. çÐÇ çè ÈÇäÖñîÈ× ÚÑÖ
+ ÈäÇÚ <literal>switch</literal>.
</simpara>
<note>
<simpara>
- Note that unlike some other languages, the
- <link linkend="control-structures.continue">continue</link> statement
- applies to switch and acts similar to <literal>break</literal>. If you
- have a switch inside a loop and wish to continue to the next iteration of
- the outer loop, use <literal>continue 2</literal>.
+ äÇÍØ Ãæñîç ÈÙãÓ ÈÙÖ ÇääñïÚÇÊ ÇäÃÎÑé¬ áÅæñî
+ ÈäÇÚ <link linkend="control-structures.continue">continue</link>
+ êæ×äÈâ Ùäé switch èêÊÕÑá åËä <literal>break</literal>. ÅÐÇ ãÇæ
+ äÏêã switch ÏÇÎä ÍäâÉ èãæÊ ÊÑÚÈ áê ÇäÇÓÊåÑÇÑ äÚÇêÉ ÇäÊñðãÑÇÑ ÇäåïâÈðä
+ ÇäÎÇÕ ÈÇäÍäâÉ ÇäÎÇÑÌêñîɬ áÇÓÊÎÏå <literal>continue 2</literal>.
</simpara>
</note>
<para>
- The following two examples are two different ways to write the
- same thing, one using a series of <literal>if</literal>
- statements, and the other using the <literal>switch</literal>
- statement:
+ êïÙÊÈÑ ÇäåËÇäêæ ÇäÊñîÇäêñêæ ×ÑêâÊêæ åÎÊäáÊêæ äãÊÇÈÉ
+ æáÓ ÇäÔñîêÁ¬ êÓÊÎÏå ÃÍÏçåÇ åÌåèÙÉ åæ ÈäÇÚÇÊ <literal>if</literal>
+ áê Íêæ êÓÊÎÏå ÇäÂÎÑ ÈäÇÚ <literal>switch</literal>
+ :
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
if ($i == 0) {
- print "i equals 0";
+ print "i êÓÇèê 0";
} elseif ($i == 1) {
- print "i equals 1";
+ print "i êÓÇèê 1";
} elseif ($i == 2) {
- print "i equals 2";
+ print "i êÓÇèê 2";
}
switch ($i) {
case 0:
- print "i equals 0";
+ print "i êÓÇèê 0";
break;
case 1:
- print "i equals 1";
+ print "i êÓÇèê 1";
break;
case 2:
- print "i equals 2";
+ print "i êÓÇèê 2";
break;
}
?>
@@ -849,30 +849,30 @@
</informalexample>
</para>
<para>
- It is important to understand how the <literal>switch</literal>
- statement is executed in order to avoid mistakes. The
- <literal>switch</literal> statement executes line by line
- (actually, statement by statement). In the beginning, no code is
- executed. Only when a <literal>case</literal> statement is found
- with a value that matches the value of the
- <literal>switch</literal> expression does PHP begin to execute the
- statements. PHP continues to execute the statements until the end
- of the <literal>switch</literal> block, or the first time it sees
- a <literal>break</literal> statement. If you don't write a
- <literal>break</literal> statement at the end of a case's
- statement list, PHP will go on executing the statements of the
- following case. For example:
+ Åæñîç äåæ ÇäÃçåêÉ áçå Çä×ÑêâÉ ÇäÊñðê êïæáñîÐï ÈçÇ ÈäÇÚ <literal>switch</literal>
+ ÈÚÑÖ ÊÌæÈ ÇäÃÎ×ÇÁ. êïæáñîÐï
+ ÈäÇÚ <literal>switch</literal> Ó×ÑÇ ÈÓ×Ñ
+ (ÍÇäêÇë¬ ÈäÇÚ ÈÈäÇÚ). áê ÇäÈÏÇêɬ äÇ ÊïæáñîÐï ÃêñîÉ
+ ÔêáÑÉ. áâ× ÙæÏåÇ êÊå ÅêÌÇÏ ÈäÇÚ <literal>case</literal>
+ åÑáèâÇë ÈâêåÉ ÊÊ×ÇÈâ åÙ âêåÉ
+ ÇäÙÈÇÑÉ <literal>switch</literal>¬ ÊÈÏà PHP áê ÊæáêÐ
+ ÇäÈäÇÚÇÊ. ÊÓÊåÑ PHP áê ÊæáêÐ ÇäÈäÇÚÇÊ äÚÇêÉ ÇæÊçÇÁ
+ ãÊäÉ <literal>switch</literal> Ãè ÈåÌÑÏ Ãæ ÊâÙ ääèçäÉ ÇäÃèäé
+ Ùäé ÈäÇÚ <literal>break</literal>. ÅÐÇ äå ÊãÊÈ
+ ÈäÇÚ <literal>break</literal> ÙæÏ æçÇêÉ äÇÆÍÉ ÈäÇÚÇÊ case¬
+ áÅæñî PHP ÓÊèÇÕä ÊæáêÐ ÇäÈäÇÚÇÊ ÇäÎÇÕÉ Èà
+ case ÇääÇÍâÉ. Ùäé ÓÈêä ÇäåËÇä:
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
switch ($i) {
case 0:
- print "i equals 0";
+ print "i êïÓÇèê 0";
case 1:
- print "i equals 1";
+ print "i êïÓÇèê 1";
case 2:
- print "i equals 2";
+ print "i êïÓÇèê 2";
}
?>
]]>
@@ -880,25 +880,25 @@
</informalexample>
</para>
<simpara>
- Here, if $i is equal to 0, PHP would execute all of the print
- statements! If $i is equal to 1, PHP would execute the last two
- print statements. You would get the expected behavior ('i equals 2'
- would be displayed) only if $i is equal to 2. Thus,
- it is important not to forget <literal>break</literal> statements
- (even though you may want to avoid supplying them on purpose under
- certain circumstances).
+ çæÇ: ÅÐÇ ãÇæÊ $i åÓÇèêñîÉ äà 0¬ áÅæñî PHP ÓÊñïæáñðÐ åïÌåîäî ÈäÇÚÇÊ print !
+ ÅÐÇ ãÇæÊ $i åïÓÇèêñîÉ äà 1¬ áÅæñî PHP ÓÊïæáñðÐï ÂÎÑ ÈäÇÚêæ åæ
+ print. ÓÊÍÕïä Ùäé ÇäÓñïäèã ÇäåïÊèâÙ ('i êïÓÇèê 2'
+ Êãèæ åÍä ÇäÙÑÖ) áâ× ÅÐÇ ãÇæÊ $i åïÓÇèêñîÉ äà 2. çãÐÇ ÅÐæ¬
+ êãèæ åæ ÇäÃçåêÉ ÙÏå æÓêÇæ ÈäÇÚÇÊ <literal>break</literal>
+ (ÍÊé èÅæ èÏðÏÊ ÊÌæÈ ÊèáêÑçǬ âÕÏÇë¬
+ áê ØÑèá åïÙêñîæÉ).
</simpara>
<simpara>
- In a <literal>switch</literal> statement, the condition is
- evaluated only once and the result is compared to each
- <literal>case</literal> statement. In an <literal>elseif</literal>
- statement, the condition is evaluated again. If your condition is
- more complicated than a simple compare and/or is in a tight loop,
- a <literal>switch</literal> may be faster.
+ áê ÈäÇÚ <literal>switch</literal>¬ êïâêñîåï ÇäÔñîÑ×ï
+ áâ× äåÑÉ èÇÍÏÉ èÊïâÇÑîæï ÇäæñîÊêÌÉï åÙ ãäñ ÈäÇÚí åæ
+ <literal>case</literal>. áê ÈäÇÚ <literal>elseif</literal>¬
+ êïâêñîåï ÇäÔñîÑ×ï åæ ÌÏêÏ. ÅÐÇ ãÇæ ÔÑ×ã
+ ÃÙâÏ åæ åâÇÑæÉ ÈÓê×É è/Ãè ÅÐÇ ãÇæ áê ÍäâÉ åÔÏèÏɬ
+ áÅæñî <literal>switch</literal> êåãæ Ãæ Êãèæ ÃÓÑÙ.
</simpara>
<para>
- The statement list for a case can also be empty, which simply
- passes control into the statement list for the next case.
+ êåãæ ääÇÆÍÉ ÇäÈäÇÚÇÊ ÇäÎÇÕÉ Èà case Ãæ Êãèæ áÇÑÚÉ ååÇ êïåÑñðÑï
+ ÈÈÓÇ×É ÇäÊñîÍãñïå ÏÇÎä äÇÆÍÉ ÇäÈäÇÚÇÊ Åäé case ÇääÇÍâÉ.
<informalexample>
<programlisting role="php">
<![CDATA[
@@ -907,10 +907,10 @@
case 0:
case 1:
case 2:
- print "i is less than 3 but not negative";
+ print "i ÃÕÚÑ åæ 3 äãæñîç äêÓ ÓÇäÈÇë";
break;
case 3:
- print "i is 3";
+ print "i çè 3";
}
?>
]]>
@@ -918,25 +918,25 @@
</informalexample>
</para>
<para>
- A special case is the <literal>default</literal> case. This case matches
- anything that wasn't matched by the other cases, and should be the last
- <literal>case</literal> statement. For example:
+ "case" ÇäÎÇÕ (special case) çè "case" <literal>ÇäÇáÊÑÇÖêñ</literal>. êÊ×ÇÈâ çÐÇ Çäà "case"
+ åÙ Ãêñ ÔêÁ äå êãæ åÍä Ê×ÇÈâ åæ ×Ñá Çäà "cases" ÇäÃÎÑé èêÌÈ Ãæ ÂÎÑ
+ ÈäÇÚ <literal>case</literal>. Ùäé ÓÈêä ÇäåËÇä:
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
switch ($i) {
case 0:
- print "i equals 0";
+ print "i êïÓÇèê 0";
break;
case 1:
- print "i equals 1";
+ print "i êïÓÇèê 1";
break;
case 2:
- print "i equals 2";
+ print "i êïÓÇèê 2";
break;
default:
- print "i is not equal to 0, 1 or 2";
+ print "i äÇ êïÓÇèê 0¬ 1 Ãè 2";
}
?>
]]>
@@ -944,32 +944,32 @@
</informalexample>
</para>
<para>
- The <literal>case</literal> expression may be any expression that
- evaluates to a simple type, that is, integer or floating-point
- numbers and strings. Arrays or objects cannot be used here unless
- they are dereferenced to a simple type.
+ êåãæ äÙÈÇÑÉ <literal>case</literal> Ãæ Êãèæ ÃêÉ ÙÈÇÑÉ Êïâêñîå
+ ÈÍÓÈ æèÙ ÈÓê׬ ÓèÇÁ à ãÇæ ÙÏÏÇ ÕÍêÍÇ Ãè ÃÙÏÇÏÇ Ðê æâÇ× ÙÇÆåÉ
+ èÓäÇÓä æÕêñîÉ. äÇ êåãæ ÇÓÊÎÏÇå ÇäåÕáèáÇÊ Ãè ÇäãÇÆæÇÊ çæÇ ÅäÇ ÅÐÇ
+ ÃÒêäÊ ÅÍÇäÊçÇ äÊÕÈÍ ÐÇÊ æèÙ ÈÓê×.
</para>
<para>
- The alternative syntax for control structures is supported with
- switches. For more information, see <link
- linkend="control-structures.alternative-syntax">Alternative syntax
- for control structures</link> .
+ ÊÊÓå ÇäÕñðêÚÉ ÇäæñîÍèêñîÉ ÇäÈÏðêäÉ ÇäÎÇÕÉ ÈÇäÈïæé ÇäÊñîÍãñïåêñîÉ ÈãèæçÇ åÏÙèåÉë åÙ
+ Çäàswitches. äåÒêÏ åæ ÇäåÙäèåÇʬ ÇÓÊÙÑÖ <link
+ linkend="control-structures.alternative-syntax">ÇäÕñðêÚÉ ÇäæñîÍèêñîÉ ÇäÈÏðêäÉ
+ ÇäÎÇÕÉ ÈÇäÈïæé ÇäÊñîÍãñïåêñîÉ</link> .
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
switch ($i):
case 0:
- print "i equals 0";
+ print "i êïÓÇèê 0";
break;
case 1:
- print "i equals 1";
+ print "i êïÓÇèê 1";
break;
case 2:
- print "i equals 2";
+ print "i êïÓÇèê 2";
break;
default:
- print "i is not equal to 0, 1 or 2";
+ print "i äêÓ åÓÇèêñÇ äà 0¬ 1 Ãè 2";
endswitch;
?>
]]>
@@ -981,52 +981,52 @@
<sect1 id="control-structures.declare">
<title><literal>declare</literal></title>
<para>
- The <literal>declare</literal> construct is used to
- set execution directives for a block of code.
- The syntax of <literal>declare</literal> is similar to
- the syntax of other flow control constructs:
+ êïÓÊÎÏå ÈæÇÁ <literal>declare</literal> ÈÚÑÖ
+ ÅÙÏÇÏ ÊèÌêçÇÊ ÇäÊñîæáêÐ ÇäÎÇÕÉ ÈãÊäÉ åæ ÇäÔñðêáÑÉ.
+ ÊïÔòÈðçï ÇäÕñðêÚÉ ÇäæñîÍèêñîÉ ÇäÎÇÕÉ Èà <literal>declare</literal>
+ ÇäÕñðêÚÉî ÇäæñîÍèêñîÉî ÇäÎÇÕÉ ÈÈæÇÁÇÊ ÃÎÑé ääÊîÍãñïå ÈÇäÇæÓêÇÈ:
<informalexample>
<programlisting>
<![CDATA[
-declare (directive) statement
+declare (ÊèÌêç) ÈäÇÚ
]]>
</programlisting>
</informalexample>
</para>
<para>
- The <literal>directive</literal> section allows the
- behavior of the <literal>declare</literal> block to
- be set.
- Currently only one directive is recognized: the
- <literal>ticks</literal> directive. (See below for more
- information on the
- <link linkend="control-structures.declare.ticks">ticks</link>
- directive)
+ ÊÓåÍ áâÑÉ <literal>directive</literal> ÈÌÙä
+ Óäèã ãÊäÉ <literal>declare</literal> âÇÈäÇ
+ ääÅÙÏÇÏ.
+ ÍÇäêÇë¬ êïÊÙÑñîáï áâ× Ùäé ÊèÌêç èÇÍÏ:
+ ÊèÌêç <literal>ticks</literal>. (ÇÓÊÙÑÖ åÇ áê ÇäÃÓáä äÃÌä åÒêÏ åæ
+ ÇäåÙäèåÇÊ ÈÎÕèÕ
+ ÊèÌêç <link linkend="control-structures.declare.ticks">ticks</link>
+ )
</para>
<para>
- The <literal>statement</literal> part of the
- <literal>declare</literal> block will be executed -- how
- it is executed and what side effects occur during execution
- may depend on the directive set in the
- <literal>directive</literal> block.
+ Åæñî ÌÒÁ <literal>statement</literal> åæ
+ ãïÊäÉ <literal>declare</literal> ÓÊñïæáñîÐ - ãêá
+ êÊå ÊæáêÐçÇ¿ èåÇ çê ÇäÊñîÃËêÑÇÊ ÇäÌÇæÈêñîÉ ÇäÊñðê Ê×Ñà ÃËæÇÁ ÇäÊñîæáêп
+ çÐç åÓÇÆä ÊÑÊÈ× ÈÇäÊñîèÌêç ÇäåïÙñîÏ áê
+ ãïÊäÉ <literal>directive</literal>.
</para>
<para>
- The <literal>declare</literal> construct can also be used in the global
- scope, affecting all code following it.
+ êåãæ äÈæÇÁ <literal>declare</literal> Ãæ êïÓÊÎÏîå ÃêÖÇë áê
+ ÇäåÏé ÇäÔñîÇåðä¬ ååÇ êÄËðÑï áê åÌåä ÇäÔñðêáÑÉ ÇääÇÍâÉ Èç.
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
-// these are the same:
+// ÊåËä çÐç æáÓ ÇäÔñîêÁ :
-// you can use this:
+// êåãæã ÇÓÊÎÏÇå çÐÇ:
declare(ticks=1) {
- // entire script here
+ // ãÇåä ÇäÎÇ×è× çæÇ
}
-// or you can use this:
+// Ãè êåãæã ÇÓÊÎÏÇå çÐÇ:
declare(ticks=1);
-// entire script here
+// ãÇåä ÇäÎÇ×è× çæÇ
?>
]]>
</programlisting>
@@ -1034,32 +1034,32 @@
</para>
<sect2 id="control-structures.declare.ticks">
<title>Ticks</title>
- <para>A tick is an event that occurs for every
- <replaceable>N</replaceable> low-level statements executed
- by the parser within the <literal>declare</literal> block.
- The value for <replaceable>N</replaceable> is specified
- using <literal>ticks=<replaceable>N</replaceable></literal>
- within the <literal>declare</literal> blocks's
- <literal>directive</literal> section.
+ <para>"tick" çè ÍÏË ê×Ñà ÙæÏ ãäñð
+ <replaceable>N</replaceable> ÈäÇÚÇÊ åæÎáÖÉ ÇäåÓÊèé êÊå ÊæáêÐçÇ
+ åæ âðÈä ÇäåïáÓñðÑ Öåæ ãÊäÉ <literal>declare</literal>.
+ ÊïÍÏñîÏï âêåÉï <replaceable>N</replaceable>
+ ÈÇÓÊÎÏÇå <literal>ticks=<replaceable>N</replaceable></literal>
+ Öåæ ãïÊä <literal>declare</literal>
+ èåÇ ÈçÇ åæ áâÑÉ <literal>directive</literal>.
</para>
<para>
- The event(s) that occur on each tick are specified using the
- <function>register_tick_function</function>. See the example
- below for more details. Note that more than one event can occur
- for each tick.
+ Åæñî ÇäÍÏË (ÇäÃÍÏÇË) ÇäÊñðê Ê×Ñà Ùäé ãäñ "tick" êÊå ÊÍÏêÏç ÈÇÓÊÎÏÇå
+ <function>register_tick_function</function>. ÇÓÊÙÑÖ ÇäåËÇä
+ ÇäÐê ÈÇäÃÓáä äåÒêÏ åæ ÇäÊñîáÇÕêä. äÇÍØ Ãæñîç êåãæ äÃãËÑ åæ ÍÏË èÇÍÏ Ãæ ê×ÑÃ
+ ÈÇäæñðÓÈÉ äãäñ "tick".
</para>
<para>
<example>
- <title>Profile a section of PHP code</title>
+ <title>ÅÊåÇå profile Ùäé áâÑÉí åæ ÔêáÑÉð PHP</title>
<programlisting role="php">
<![CDATA[
<?php
-// A function that records the time when it is called
+// ÏÇäÉ ÊïÓÌñðäï ÇäèâÊ ÇäÐê ÊåÊ åæÇÏÇÊçÇ áêç
function profile ($dump = FALSE)
{
static $profile;
- // Return the times stored in profile, then erase it
+ // ÊïÑÌðÙï ÇäÃÒåæÉ ÇäåïÎÒñîæëÉ áê profile¬ èåæ Ëå ÊåÍèçÇ
if ($dump) {
$temp = $profile;
unset ($profile);
@@ -1069,39 +1069,39 @@
$profile[] = microtime ();
}
-// Set up a tick handler
+// ÊæÕêÈ åðâÈÖ "tick"
register_tick_function("profile");
-// Initialize the function before the declare block
+// ÇÓÊçäÇä ÇäÏñîÇäÉ âÈä ãÊäÉ "declare"
profile ();
-// Run a block of code, throw a tick every 2nd statement
+// ÊÔÚêä ãÊäÉ ÔêáÑɬ ÅäâÇÁ "tick" ÙæÏ ãäñ ÈäÇÚ ËÇæêñ
declare (ticks=2) {
for ($x = 1; $x < 50; ++$x) {
echo similar_text (md5($x), md5($x*$x)), "<br />;";
}
}
-// Display the data stored in the profiler
+// ÇØçÇÑ ÇäÈêÇæÇÊ ÇäåïÎÒñîæîÉ áê ÇäåïÔãñðä ÇäÌÇæÈêñ (profiler)
print_r (profile (TRUE));
?>
]]>
</programlisting>
</example>
- The example profiles the PHP code within the 'declare'
- block, recording the time at which every second low-level
- statement in the block was executed. This information can
- then be used to find the slow areas within particular
- segments of code. This process can be performed using other
- methods: using ticks is more convenient and easier to
- implement.
+ êÑÊÓå ÇäåËÇä ÊÔãêä ÔêáÑÉ PHP ÏÇÎä ãÊäÉ 'declare'¬
+ åïÓÌñðäÇë ÇäÒñîåæ ÇäÐê æïáñðÐî áêç ãäñï ÈäÇÚ ËÇæí åæ åÓÊèé åæÎáÖ
+ áê ÇäãïÊäÉ. ÍêæÆЬ êåãæ äçÐç ÇäåÙäèåÇÊ
+ Ãæ ÊïÓÊÎÏîå äÇêÌÇÏ ÇäÈïâÙ ÇäÈ×êÆÉ Öåæ åâÇ×Ù
+ åïÍÏñîÏîÉ åæ ÇäÔñðêáÑÉ. êåãæ ÇÊåÇå çÐç ÇäåïÙÇäîÌÉ ÈÇÓæÎÏÇå åæÇçÌ
+ ÃÎÑé: êÓÊå ÇÓÊÎÏÇå "ticks" Èãèæç ÃãËÑ åäÇÁåÉ èÃÓçä
+ ääÊÖåêæ.
</para>
<simpara>
- Ticks are well suited for debugging, implementing simple
- multitasking, backgrounded I/O and many other tasks.
+ ÊÊÓå Çäà "Ticks" Èãèæç åäÇÆåÉ ÌêÏÉ äåÓÇÆÉ ÇÒÇäÉ ÇäÙðää¬ ÊÖåêæ
+ ÊÙÏñïÏ-åçÇå ÈÓê׬ ÅÏÎÇä/ÅÎÑÇÌ áê ÇäÎäáêÉ èåçÇå ÃÎÑé ÙÏêÏÉ.
</simpara>
<simpara>
- See also <function>register_tick_function</function> and
+ ÇÓÊÙÑÖ ÃêÖÇ <function>register_tick_function</function> è
<function>unregister_tick_function</function>.
</simpara>
</sect2>
@@ -1110,38 +1110,38 @@
<sect1 id="function.return">
<title>return</title>
<simpara>
- If called from within a function, the <function>return</function>
- statement immediately ends execution of the current function, and
- returns its argument as the value of the function
- call. <function>return</function> will also end the execution of
- an <function>eval</function> statement or script file.
- </simpara>
- <simpara>
- If called from the global scope, then execution of the current
- script file is ended. If the current script file was
- <function>include</function>ed or <function>require</function>ed,
- then control is passed back to the calling file. Furthermore, if
- the current script file was <function>include</function>ed, then
- the value given to <function>return</function> will be returned as
- the value of the <function>include</function> call. If
- <function>return</function> is called from within the main script
- file, then script execution ends. If the current script file was
- named by the <link
- linkend="ini.auto-prepend-file">auto_prepend_file</link> or <link
+ ÅÐÇ æèÏðêîÊ Çæ×äÇâÇë åæ ÏÇäɬ áÅæñî ÈäÇÚ <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> Çæ×äÇâÇë åæ åäá ÇäÎÇ×è×
+ ÇäÑñîÆêÓêñ¬ êæÊçê ÍêæçÇ ÊæáêÐ ÇäÎÇ×è×. ÅÐÇ ÇÓÊïÏòÙðêî åäá ÇäÎÇ×è× ÇäÍÇäêñ
+ åæ âÈä ÎêÇÑÇÊ ÊçêÆÉ <link
+ linkend="ini.auto-prepend-file">auto_prepend_file</link> Ãè <link
linkend="ini.auto-append-file">auto_append_file</link>
- configuration options in &php.ini;,
- then that script file's execution is ended.
+ áê &php.ini;¬
+ êïæòçîé ÍêæçÇ ÊæáêÐ çÐÇ Çäåäá ÇäÎÇ×è×.
</simpara>
- <simpara>For more information, see <link
- linkend="functions.returning-values">Returning values</link>.
+ <simpara>äåÒêÏ åæ ÇäåÙäèåÇʬ ÇÓÊÙÑÖ <link
+ linkend="functions.returning-values">ÇÑÌÇÙ Çäâðêîå</link>.
</simpara>
<para>
<note>
<simpara>
- Note that since <function>return</function> is a language
- construct and not a function, the parentheses surrounding its
- arguments are <emphasis>only</emphasis> required if the argument
- contains an expression. It is common to leave them out while returning a variable.
+ äÇÍØ Ãæñîç æØÑÇ äÃæñî <function>return</function> çê ÙÈÇÑÉ Ùæ ÈæÇÁ äÚèêñ
+ èäêÓÊ ÏÇäÉë¬ áÅæî ÇäÃâèÇÓ ÇäåïÍðê×îÉ
+ ÈÃÏäÊçÇ çê <emphasis>áâ×</emphasis> å×äèÈÉ ÅÐÇ ãÇæ ÇäÏñîäêä
+ êÍÊèê Ùäé ÙÈÇÑÉ. åæ ÇäåïÙÊÇÏ ÇçåÇäçÇ ÙæÏ ÇÑÌÇÙ åÊÚêñðÑ.
</simpara>
</note>
</para>
@@ -1152,29 +1152,29 @@
<title><function>require</function></title>
<simpara>
- The <function>require</function> statement includes and evaluates
- the specific file.
+ êÊÖåæ ÈäÇÚ <function>require</function> èêïâêñðå
+ Çäåäá ÇäåïÍÏñîÏ.
</simpara>
<simpara>
- <function>require</function> includes and evaluates a specific file.
- Detailed information on how this inclusion works is described in the
- documentation for <function>include</function>.
- </simpara>
- <simpara>
- <function>require</function> and <function>include</function>
- are identical in every way except how they handle failure.
- <function>include</function> produces a
- <link linkend="internal.e-warning">Warning</link> while
- <function>require</function> results in a <link linkend="internal.e-error">
- Fatal Error</link>. In other words, don't hesitate to use
- <function>require</function> if you want a missing file to halt processing
- of the page. <function>include</function> does not behave this way, the
- script will continue regardless. Be sure to have an appropriate
- <link linkend="ini.include-path">include_path</link> setting as well.
+ ÊÊÖåæ <function>require</function> èÊïâêñðå åäáÇë åïÍÏñîÏÇë.
+ åÙäèåÇÊ åïáÕñîäîÉ Ùæ ãêáêÉ Ùåä çÐÇ ÇäÊñîÖåêæ çê åÍä èÕá áê
+ ÇäÊñîèËêâ ÇäÎÇÕ Èà<function>include</function>.
+ </simpara>
+ <simpara>
+ ÊÊÓðå <function>require</function> è <function>include</function>
+ êÊåÇËäçåÇ åæ ãäñ ÇäÌçÇÊ áêåÇ ÙÏÇ Çä×ñîÑêâÉ ÇäÊñðê ÊÊÙÇåäÇæ ÈçÇ åÙ ÇäÇÎáÇâÇÊ.
+ ÊïæÊðÌï <function>include</function>
+ <link linkend="internal.e-warning">ÊÍÐêÑÇë - Warning</link> áê Íêæ Ãæñî
+ <function>require</function> ÊïÄÏðê Åäé <link linkend="internal.e-error">
+ Î×à áÇÏðÍ - Fatal Error</link>. ÈãäåÇÊ ÃÎÑé¬ äÇ ÊÊÑÏÏ áê ÇÓÊÎÏÇå
+ <function>require</function> ÅÐÇ ãæÊ ÊÑÚÈ åæ åäá åáâèÏ Ãæ êèâá åÙÇäÌÉ
+ ÇäÕñîáÍÉ. äÇ ÊÊÕÑá <function>include</function> ÈçÐç Çä×Ñêâɬ ÅÐ Ãæñî
+ ÇäÎÇ×è× ÓêÓÊåѬ åçåÇ êãïæ. ÊÃãñîÏ åæ ÊèáÑã Ùäé ÅÙÏÇÏ
+ <link linkend="ini.include-path">include_path</link> åæÇÓÈ ãåÇ êäÒå ÇäÍÇä.
</simpara>
<para>
<example>
- <title>Basic <function>require</function> examples</title>
+ <title>ÃåËäÉ âÇÙÏêñîÉ Ùæ <function>require</function></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -1183,7 +1183,7 @@
require $somefile;
-require ('somefile.txt');
+require ('ismoumilef.txt');
?>
]]>
@@ -1191,20 +1191,20 @@
</example>
</para>
<simpara>
- See the <function>include</function> documentation for more examples.
+ ÇÓÊÙÑÖ ÊèËêâ <function>include</function> äåÒêÏ åæ ÇäÃåËäÉ.
</simpara>
<para>
<note>
<simpara>
- Prior to PHP 4.0.2, the following applies: <function>require</function>
- will always attempt to read the target file, even if the line it's on
- never executes. The conditional statement won't affect
- <function>require</function>. However, if the line on which the
- <function>require</function> occurs is not executed, neither will any of
- the code in the target file be executed. Similarly, looping structures
- do not affect the behaviour of <function>require</function>. Although
- the code contained in the target file is still subject to the loop, the
- <function>require</function> itself happens only once.
+ âÈä PHP 4.0.2¬ ãÇæ åÇ êäê ÓÇÑê ÇäåáÙèä: ÓÊâèå <function>require</function>
+ ÏèåÇ ÈåÍÇèäÉ âÑÇÁÉ Çäåäá ÇäåïÓÊçÏîá ÍÊé èÅæ ãÇæ ÇäÓñî×Ñ ÇäÐê ÊÊèÇÌÏ Èç
+ êÓÊÍêä ÊæáêÐç. äæ êÄËÑ ÇäÈäÇÚ ÇäÔñîÑ×êñ áê
+ <function>require</function>. åÙ Ðä㬠ÅÐÇ äå êÊå ÊæáêÐ ÇäÓñî×Ñ ÇäÐê Ê×Ñà áêç
+ <function>require</function>¬ áäæ êÊå ÊæáêÐ Ãêñ åæ
+ ÇäÔñðêáÑÉ áê Çäåäá ÇäåïÓÊçÏîá. ãÐä㬠äÇ ÊïÄîËðÑï ÇäÈïæé ÇäÍäâêñîÉ
+ áê Óäèã <function>require</function>. ÈÇäÑñîÚå åæ Ãæñî
+ ÇäÔñðêáÑÉ ÇäåïÍÊèÇÉ áê Çäåäá ÇäåïÓÊçÏîá äÇ ÊÒÇä ÙïÑòÖîÉ äÃæ Êãèæ Íäâɬ ÅäÇ Ãæñî
+ <function>require</function> æáÓçÇ ÊÍÏË áâ× åÑÉ èÇÍÏÉ.
</simpara>
</note>
</para>
@@ -1214,58 +1214,58 @@
&warn.no-win32-fopen-wrapper;
<simpara>
- See also <function>include</function>, <function>require_once</function>,
- <function>include_once</function>, <function>eval</function>,
- <function>file</function>, <function>readfile</function>,
- <function>virtual</function> and <link linkend="ini.include-path">include_path</link>.
+ ÇÓÊÙÑÖ ÃêÖÇ <function>include</function>¬ <function>require_once</function>¬
+ <function>include_once</function>¬ <function>eval</function>¬
+ <function>file</function>¬ <function>readfile</function>¬
+ <function>virtual</function> è <link linkend="ini.include-path">include_path</link>.
</simpara>
</sect1>
<sect1 id="function.include">
<title><function>include</function></title>
<simpara>
- The <function>include</function> statement includes and evaluates
- the specified file.
+ êÊÖåæ ÈäÇÚ <function>include</function> èêïâêñðå
+ Çäåäá ÇäåïÍÏñîÏ.
</simpara>
<simpara>
- The documentation below also applies to <function>require</function>.
- The two constructs are identical in every way except how they handle
- failure. <function>include</function> produces a
- <link linkend="internal.e-warning">Warning</link> while <function>require</function>
- results in a <link linkend="internal.e-error">Fatal Error</link>.
- In other words, use <function>require</function> if you want
- a missing file to halt processing of the page. <function>include</function> does
- not behave this way, the script will continue regardless. Be sure to have an
- appropriate <link linkend="ini.include-path">include_path</link> setting as well.
- </simpara>
- <simpara>
- When a file is included, the code it contains inherits the
- <link linkend="language.variables.scope">variable scope</link> of the
- line on which the include occurs. Any variables available at that line
- in the calling file will be available within the called file, from that
- point forward.
+ åÇ êÃÊê åæ ÊèËêâ êæ×Èâ ÃêÖÇ Ùäé <function>require</function>.
+ ÇäÈæÇÁÇæ åÊåÇËäÇæ áê ãäñ ÇäæñîèÇÍê áêåÇ ÙÏÇ Çä×ñîÑêâÉ ÇäÊê êÊÙÇåäÇæ ÈçÇ
+ åÙ ÇäÇÎáÇâÇÊ. ÊïæÊðÌï <function>include</function>
+ <link linkend="internal.e-warning">ÊÍÐêÑÇë - Warning</link> áê Íêæ Ãæñî <function>require</function>
+ ÊïÄÏðê Åäé <link linkend="internal.e-error">Î×à áÇÏðÍ - Fatal Error</link>.
+ ÈãäåÇÊ ÃÎÑé¬ ÇÓÊÎÏå <function>require</function> ÅÐÇ ãïæÊî ÊÑÚÈ
+ åæ åäá åáâèÏ Ãæ êèâðáî åÙÇäÌÉ ÇäÕñîáÍÉ. äÇ ÊÊÕÑá <function>include</function>
+ ÈçÐç Çä×ñîÑêâɬ ÅÐ Ãæñî ÇäÎÇ×è× ÓêÓÊåѬ åçåÇ êãïæ. ÊÃãñîÏ åæ ÊèáÑã Ùäé ÅÙÏÇÏ
+ appropriate <link linkend="ini.include-path">include_path</link> åïæÇÓÈ ãåÇ êäÒå.
+ </simpara>
+ <simpara>
+ ÙæÏåÇ êÊå ÊÖåêæ åäá åǬ áÅæñî ÇäÔñðêáÑÉ ÇäÊñðê êÍÊèêçÇ ÊîÑðËï
+ <link linkend="language.variables.scope">åÏé ÇäåïÊÚêñðÑÇÊ</link> ÇäÎÇÕ
+ ÈÇäÓñî×Ñ ÇäÐê ×Ñà áêç ÇäÊñîÖåêæ. ÃêñîÉ åÊÚêñðÑÇÊ Êãèæ åïÊÇÍîÉ ÙæÏ çÐÇ ÇäÓñî×Ñ
+ áê Çäåäá ÇäåïæÇÏðê ÓÊãèæ ãÐäã áê Çäåäá ÇäåïæÇÏîé¬ Çæ×äÇâÇ åæ çÐç
+ ÇäèçäÉ áåÇ ÈÙÏ.
</simpara>
<para>
<example>
- <title>Basic <function>include</function> example</title>
+ <title>åËÇä âÇÙÏêñ Ùæ <function>include</function></title>
<programlisting role="php">
<![CDATA[
vars.php
<?php
-$color = 'green';
-$fruit = 'apple';
+$color = 'ÎÖÑÇÁ';
+$fruit = 'ÊáÇÍÉ';
?>
test.php
<?php
-echo "A $color $fruit"; // A
+echo "Çäà $color $fruit"; // Çä
include 'vars.php';
-echo "A $color $fruit"; // A green apple
+echo "Çäà $color $fruit"; // Çäà ÎÖÑÇÁ ÊáÇÍÉ
?>
]]>
@@ -1273,14 +1273,14 @@
</example>
</para>
<simpara>
- If the include occurs inside a function within the calling file,
- then all of the code contained in the called file will behave as
- though it had been defined inside that function. So, it will follow
- the variable scope of that function.
+ ÅÐÇ ×Ñà ÇäÊñîÖåêæ áê Å×ÇÑ ÏÇäÉ ÏÇÎä Çäåäá ÇäåïæÇÏðê¬
+ ÍêæçǬ ÓêÊÕÑá åïÌåîäï ÇäÔñðêáÑÉ ÇäåïÍÊèÇÉ áê Çäåäá ÇäåïæÇÏîé èãÃæñîç
+ âÏ Êå ÊÙÑêáç Öåæ Êäã ÇäÏñîÇäÉ. äÐä㬠áÅæñîç ÓêÊÈÙ
+ åÏé ÇäåïÊÚêñðÑÇÊ ÇäÎÇÕ ÈÊäã ÇäÏñîÇäÉ.
</simpara>
<para>
<example>
- <title>Including within functions</title>
+ <title>ÇäÊñîÖåêæ áê Å×ÇÑ ÇäÏñîèÇä</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -1291,16 +1291,16 @@
include 'vars.php';
- echo "A $color $fruit";
+ echo "Çäà $color $fruit";
}
-/* vars.php is in the scope of foo() so *
- * $fruit is NOT available outside of this *
- * scope. $color is because we declared it *
- * as global. */
+/* ÊâÙ vars.php áê åÏé foo() ÈÍêË Ãæñî *
+ * $fruit äêÓÊ åïÊÇÍÉ ÎÇÑÌ çÐÇ *
+ * ÇäåÏé. $color çê ãÐäã äÃæñîæÇ ÕÑñîÍæÇ ÈçÇ *
+ * Ùäé ÃæñîçÇ ÔÇåäÉ. */
-foo(); // A green apple
-echo "A $color $fruit"; // A green
+foo(); // Çäà ÎÖÑÇÁ ÊáÇÍÉ
+echo "A $color $fruit"; // Çäà ÎÖÑÇÁ
?>
]]>
@@ -1308,25 +1308,25 @@
</example>
</para>
<simpara>
- When a file is included, parsing drops out of PHP mode and
- into HTML mode at the beginning of the target file, and resumes
- again at the end. For this reason, any code inside the target
- file which should be executed as PHP code must be enclosed within
- <link linkend="language.basic-syntax.phpmode">valid PHP start
- and end tags</link>.
- </simpara>
- <simpara>
- If "<link linkend="ini.allow-url-fopen">URL fopen wrappers</link>"
- are enabled in PHP (which they are in the default configuration),
- you can specify the file to be included using an URL (via HTTP or
- other supported wrapper - see <xref linkend="wrappers"/> for a list
- of protocols) instead of a local pathname. If the target server interprets
- the target file as PHP code, variables may be passed to the included
- file using an URL request string as used with HTTP GET. This is
- not strictly speaking the same thing as including the file and having
- it inherit the parent file's variable scope; the script is actually
- being run on the remote server and the result is then being
- included into the local script.
+ ÙæÏåÇ êïÊîÖîåîæï åäá åǬ áÅæñî ÇäÊñîáÓêÑ êÊåäÕ åæ èÖÙ 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¬ áÅæñîç êåãæ ÊåÑêÑ ÇäåïÊÚêñðÑÇÊ ÈÇÊÌÇç Çäåäá
+ ÇäåïÊÖñîåîæ ÈÇÓÊÎÏÇå ÓäÓäÉ ×äÈêÇÊ åïÍÏñðÏÇÊ ÇäåèÇÑÏ ÇäåïÊÔÇãðäîÉ "URL request string" åËäåÇ êïÓÊîÎÏîå åÙ HTTP GET. äÇ êÙæê çÐÇ
+ ÇäãäÇå¬ â×ÙÇë¬ æáÓ ÇäÔñîêÁ åËäåÇ ÇäÍÇä ÙæÏ ÊÖåêæ Çäåäá èÌÙäç
+ êîÑðËï åÏé ÇäåÊÚêñðÑÇÊ ÇäÎÇÕ ÈÇäåäá ÇäâÑêÈ» ÇäÎÇ×è× çè ÇäÂæ
+ åÍä ÊÔÚêä Ùäé ÇäÎÇÏå ÇäÈñïÙÏêñ èÇäæñîÊêÌÉ ÍêæçÇ êÊå
+ ÊÖåêæçÇ Öåæ ÇäÎÇ×è× ÇäåÍäêñ.
</simpara>
&warn.no-win32-fopen-wrapper;
<para>
@@ -1336,53 +1336,53 @@
<![CDATA[
<?php
-/* This example assumes that www.example.com is configured to parse .php
- * files and not .txt files. Also, 'Works' here means that the variables
- * $foo and $bar are available within the included file. */
-
-// Won't work; file.txt wasn't handled by www.example.com as PHP
-include 'http://www.example.com/file.txt?foo=1&bar=2';
-
-// Won't work; looks for a file named 'file.php?foo=1&bar=2' on the
-// local filesystem.
-include 'file.php?foo=1&bar=2';
+/* êáÊÑñðÖï çÐÇ ÇäåËÇä Ãæñî www.example.com âÏ çïêÆ äÊáÓêÑ åäáÇÊ .php
+ * èäêÓ åäáÇÊ .txt . ãÐä㬠êïâÕîÏ Èà 'êÙåä' çæÇ Ãæñî ÇäåïÊÚêñðÑÇÊ
+ * $foo è $bar åïÊÇÍÉ áê Å×ÇÑ Çäåäá ÇäåïÊîÖîåîæ. */
+
+// äæ êÙåä» äå êÊå ÇäÊñîÙÇåä åÙ milef.txt åæ âÈä www.example.com Ùäé Ãæñîç PHP
+include 'http://www.example.com/milef.txt?foo=1&bar=2';
+
+// äæ êÙåä» êÈÍË Ùæ åäá êïÏòÙîé 'file.php?foo=1&bar=2' Ùäé
+// æØÇå ÇäåäáÇÊ ÇäåÍäêñ.
+include 'milef.php?foo=1&bar=2';
-// Works.
-include 'http://www.example.com/file.php?foo=1&bar=2';
+// êÙåä.
+include 'http://www.example.com/milef.php?foo=1&bar=2';
$foo = 1;
$bar = 2;
-include 'file.txt'; // Works.
-include 'file.php'; // Works.
+include 'milef.txt'; // êÙåä.
+include 'milef.php'; // êÙåä.
?>
]]>
</programlisting>
</example>
- See also <link linkend="features.remote-files">Remote files</link>,
- <function>fopen</function> and <function>file</function> for related
- information.
+ ÇÓÊÙÑÖ ÃêÖÇë <link linkend="features.remote-files">ÇäåäáÇÊ ÇäÈñïÙÏêñîÉ</link>¬
+ <function>fopen</function> è <function>file</function> ääÍÕèä Ùäé åÙäèåÇÊ
+ ÐÇÊ ÕðäÉ.
</para>
<para>
- Because <function>include</function> and <function>require</function>
- are special language constructs, you must enclose them within a statement
- block if it's inside a conditional block.
+ æØÑÇë äÃæñî <function>include</function> è <function>require</function>
+ ÊïÙòÊîÈîÑ ÈæÇÁÇÊ äïÚèêñîÉ ÎÇÕɬ áÅæñîç êÌÈ Ùäêã Ê×èêâçÇ Öåæ ãÊäÉ
+ ÈäÇÚêñîÉ ÅÐÇ ãÇæÊ Öåæ ãïÊäÉ ÔîÑ×êñîÉ.
</para>
<para>
<example>
- <title>include() and conditional blocks</title>
+ <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 {
@@ -1395,24 +1395,24 @@
</example>
</para>
<simpara>
- Handling Returns: It is possible to execute a <function>return</function>
- statement inside an included file in order to terminate processing in that
- file and return to the script which called it. Also, it's possible to return
- values from included files. You can take the value of the include call as
- you would a normal function.
+ ÇäÊñîÙÇåä åÙ ÇäÇÑÌÇÙÇÊ: ÅÐÇ ãÇæ åæ Çäååãæ ÊæáêÐ ÈäÇÚ <function>return</function>
+ Öåæ åäá åïÊîÖîåñîæ èÐäã ÈÚÑÖ ÅêâÇá ÇäåÙÇäÌÉ áê Ðäã
+ Çäåäá èÇäÑñïÌèÙ Åäé ÇäÎÇ×è× ÇäÐê æÇÏÇç. ãÐä㬠áÅæñîç åæ Çäååãæ ÇÑÌÇÙ
+ âêå Çæ×äÇâÇë åæ ÇäåäáÇÊ ÇäåïÊÖîåñîæîÉ. êåãæã ÃÎÐ âêåÉ æÏÇÁ "include" åËäåÇ
+ ÊáÙä åÙ ÏÇäÉ ÙÇÏêñîÉ.
</simpara>
<para>
<note>
<simpara>
- In PHP 3, the return may not appear inside a block unless it's
- a function block, in which case the <function>return</function> applies
- to that function and not the whole file.
+ áê PHP 3¬ êåãæ ääÇÑÌÇÙ Ãæ äÇ êØçÑ Öåæ ãïÊäÉ ÅäÇ ÅÐÇ ãÇæ ÙÈÇÑÉ Ùæ
+ ãÊäÉ ÏÇäɬ ÍêË Êæ×Èâ <function>return</function>
+ Ùäé Êäã ÇäÏñîÇäÉ èäêÓ Ùäé åïÌåîä Çäåäá.
</simpara>
</note>
</para>
<para>
<example>
- <title><function>include</function> and the <function>return</function> statement</title>
+ <title><function>include</function> èÈäÇÚ <function>return</function></title>
<programlisting role="php">
<![CDATA[
return.php
@@ -1436,11 +1436,11 @@
$foo = include 'return.php';
-echo $foo; // prints 'PHP'
+echo $foo; // ê×ÈÙ 'PHP'
$bar = include 'noreturn.php';
-echo $bar; // prints 1
+echo $bar; // ê×ÈÙ 1
?>
]]>
@@ -1448,21 +1448,21 @@
</example>
</para>
<simpara>
- <literal>$bar</literal> is the value <literal>1</literal> because the include
- was successful. Notice the difference between the above examples. The first uses
- <function>return</function> within the included file while the other does not.
- A few other ways to "include" files into variables are with
- <function>fopen</function>, <function>file</function> or by using
- <function>include</function> along with
- <link linkend="ref.outcontrol">Output Control Functions</link>.
+ <literal>$bar</literal> çê ÇäâêåÉ <literal>1</literal> äÃæñî ÇäÊñîÖåêæ
+ ãÇæ æÇÌÍÇ. äÇÍØ ÇäáÑâ Èêæ ÇäÃåËäÉ ÇäÙïäêÇ. êÓÊÎÏå ÇäåËÇä ÇäÃèäï
+ <function>return</function> Öåæ Çäåäá ÇäåïÊîÖîåñîæ áê Íêæ Ãæñî ÇäÃåËäÉ ÇäÃÎÑé äÇ Êâèå ÈÐäã.
+ çæÇã ÈÖÙÉ ×Ñâ ÃÎÑé äà "ÊÖåêæ - include" åäáÇÊ Öåæ åÊÚêñîÑÇÊ èÊÊåËä áê
+ <function>fopen</function>¬ <function>file</function> Ãè ÈÇÓÊÎÏÇå
+ <function>include</function> ÈÑáâÉ
+ <link linkend="ref.outcontrol">ÏèÇä ÇäÊñîÍãñïå áê ÇäåïÎÑÌÇÊ</link>.
</simpara>
¬e.language-construct;
<simpara>
- See also <function>require</function>, <function>require_once</function>,
- <function>include_once</function>, <function>readfile</function>,
- <function>virtual</function>, and
+ ÇÓÊÙÑÖ ÃêÖÇ <function>require</function>, <function>require_once</function>¬
+ <function>include_once</function>¬ <function>readfile</function>¬
+ <function>virtual</function> è
<link linkend="ini.include-path">include_path</link>.
</simpara>
</sect1>
@@ -1470,47 +1470,47 @@
<sect1 id="function.require-once">
<title><function>require_once</function></title>
<para>
- The <function>require_once</function> statement includes and evaluates
- the specified file during the execution of the script.
- This is a behavior similar to the <function>require</function> statement,
- with the only difference being that if the code from a file has already
- been included, it will not be included again. See the documentation for
- <function>require</function> for more information on how this statement
- works.
- </para>
- <para>
- <function>require_once</function> should be used in cases where
- the same file might be included and evaluated more than once during a
- particular execution of a script, and you want to be sure that it is
- included exactly once to avoid problems with function redefinitions,
- variable value reassignments, etc.
- </para>
- <para>
- For examples on using <function>require_once</function> and
- <function>include_once</function>, look at the
- <ulink url="&url.php.pear;">PEAR</ulink> code included in the
- latest PHP source code distributions.
+ êÊÖåæ ÈäÇÚï <function>require_once</function> èêïâêñðåï
+ Çäåäá ÇäåïÍÏñîÏ ÎäÇä ÊæáêÐ ÇäÎÇ×è×.
+ êïÙÊîÈîÑï çÐÇ ÓäèãÇ ÔÈêçÇ ÈÓäèã ÈäÇÚ <function>require</function>
+ åÙ áÑâ èÍêÏ êÊåËä áê Ãæñî ÔðêáÑÉ Çäåäá ÅÐÇ ÓÈâ èÃæ Êåñî
+ ÊÖåêæçǬ áÅæñîç äæ êÊå ÊÖåêæçÇ åïÌÏÏÇë. ÇÓÊÙÑÖ ÇäÊñîèËêâ ÇäÎÇÕ Èà
+ <function>require</function> äÃÌä åÒêÏ åæ ÇäåÙäèåÇÊ Ùæ ÇäãêáêÉ ÇäÊñðê êÙåä ÈçÇ çÐÇ
+ ÇäÈäÇÚ.
+ </para>
+ <para>
+ êÌÈ ÇÓÊÎÏÇå <function>require_once</function> áê ÍÇäÇÊ êåãæ ÎäÇäçÇ
+ ÊÖåêæ èÊâêêå æáÓ Çäåäá ÃãËÑ åæ åÑÉ áê ÃËæÇÁ
+ ÊæáêÐ ÎÇÕ äÎÇ×è× åÇ èÙæÏåÇ ÊÑÚÈ áê ÇäÊñîàÃãñïÏ åæ Ãæñîç âÏ Êåñî
+ ÊÖåêæç¬ ÊÏâêâÇë¬ åÑÉ èÇÍÏÉ äÊÌæÈ ÍÏèË åÔÇãä ÙæÏ ÅÙÇÏÉ ÊÙÑêá ÇäÏñîèÇä¬
+ ÅÙÇÏÉ ÊÙêêæ âêå ÇäåÊÚêñðÑÇʬ ÇäÎ.
+ </para>
+ <para>
+ ääÍÕèä Ùäé ÃåËäÉ ÈÎÕèÕ ÇÓÊÎÏÇå <function>require_once</function> è
+ <function>include_once</function>¬ Ç×äÙ Ùäé
+ ÔðàêáÑÉ <ulink url="&url.php.pear;">PEAR</ulink> ÇäåïÊÖîåñîæîÉ áê
+ ÊèÒêÙÇÊ ÔðêáÑÉ PHP ÇäåÕÏÑêñîÉ ÇäÃÎêÑÉ.
</para>
<para>
<note>
<para>
- <function>require_once</function> was added in PHP 4.0.1pl2
+ ÃÖêáÊ <function>require_once</function> áê PHP 4.0.1pl2
</para>
</note>
</para>
<para>
<note>
<para>
- Be aware, that the behaviour of <function>require_once</function>
- and <function>include_once</function> may not be what you expect
- on a non case sensitive operating system (such as Windows).
+ ÇÍÐÑ äÃæñî Óäèã <function>require_once</function>
+ è <function>include_once</function> êåãæ Ãæ äÇ êãèæ åËäåÇ ÊÊèâÙ
+ áê æØÇå ÊÔÚêä ÚêÑ åïÊÍÓñðÓ äÍÇäÉ ÇäÍÑèá (åËä Windows).
<example>
- <title><function>require_once</function> is case insensitive on 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"); // Óêâèå çÐÇ ÈÊîÖîåñïæ a.php
+require_once("A.php"); // Óêâèå çÐÇ ÈÊîÖîåñïæ a.php åæ ÌÏêÏ Ùäé Windows!
?>
]]>
</programlisting>
@@ -1520,10 +1520,10 @@
</para>
&warn.no-win32-fopen-wrapper;
<para>
- See also <function>require</function>,
- <function>include</function>, <function>include_once</function>,
- <function>get_required_files</function>,
- <function>get_included_files</function>, <function>readfile</function>, and
+ ÇÓÊÙÑÖ ÃêÖÇ <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>
@@ -1531,46 +1531,46 @@
<sect1 id="function.include-once">
<title><function>include_once</function></title>
<para>
- The <function>include_once</function> statement includes and evaluates
- the specified file during the execution of the script.
- This is a behavior similar to the <function>include</function> statement,
- with the only difference being that if the code from a file has already
- been included, it will not be included again. As the name suggests,
- it will be included just once.
- </para>
- <para>
- <function>include_once</function> should be used in cases where
- the same file might be included and evaluated more than once during a
- particular execution of a script, and you want to be sure that it is
- included exactly once to avoid problems with function redefinitions,
- variable value reassignments, etc.
- </para>
- <para>
- For more examples on using <function>require_once</function> and
- <function>include_once</function>, look at the
- <ulink url="&url.php.pear;">PEAR</ulink> code included in the latest
- PHP source code distributions.
+ êÊÖåæ ÈäÇÚ <function>include_once</function> èêïâêñðåï
+ Çäåäá ÇäåïÍÏñîÏ ÎäÇä ÊæáêÐ ÇäÎÇ×è×.
+ êïÙÊîÈîÑï çÐÇ ÓäèãÇ ÔÈêçÇ ÈÓäèã ÈäÇÚ <function>include</function>
+ åÙ áÑâ èÍêÏ êÊåËä áê Ãæñî ÔðêáÑÉ Çäåäá ÅÐÇ ÓÈâ èÃæ Êåñî
+ ÊÖåêæçǬ áÅæñîç äæ êÊå ÊÖåêæçÇ åïÌÏÏÇë. åËäåÇ êèÍê Èç ÇäÅÓå¬
+ áäæ êÊå ÊÖåêæç ÅäÇ åÑÉ èÇÍÏÉ.
+ </para>
+ <para>
+ êÌÈ ÇÓÊÎÏÇå <function>include_once</function> áê ÍÇäÇÊ êåãæ ÎäÇäçÇ
+ ÊÖåêæ èÊâêêå æáÓ Çäåäá ÃãËÑ åæ åÑÉ áê ÃËæÇÁ
+ ÊæáêÐ ÎÇÕ äÎÇ×è× åÇ èÙæÏåÇ ÊÑÚÈ áê ÇäÊñîàÃãñïÏ åæ Ãæñîç âÏ Êåñî
+ ÊÖåêæç¬ ÊÏâêâÇë¬ åÑÉ èÇÍÏÉ äÊÌæÈ ÍÏèË åÔÇãä ÙæÏ ÅÙÇÏÉ ÊÙÑêá ÇäÏñîèÇä¬
+ ÅÙÇÏÉ ÊÙêêæ âêå ÇäåÊÚêñðÑÇʬ ÇäÎ.
+ </para>
+ <para>
+ äåÒêÏ åæ ÇäÃåËäÉ ÈÎÕèÕ ÇÓÊÎÏÇå <function>require_once</function> è
+ <function>include_once</function>¬ Ç×äÙ Ùäé
+ ÔðêáÑÉ <ulink url="&url.php.pear;">PEAR</ulink> ÇäåïÊÖîåñîæîÉ áê ÊèÒêÙÇÊ
+ ÔðêáÑÉ PHP ÇäåÕÏÑêñîÉ ÇäÃÎêÑÉ.
</para>
<para>
<note>
<para>
- <function>include_once</function> was added in PHP 4.0.1pl2
+ ÃÖêáÊ <function>include_once</function> áê PHP 4.0.1pl2
</para>
</note>
</para>
<para>
<note>
<para>
- Be aware, that the behaviour of <function>include_once</function>
- and <function>require_once</function> may not be what you expect
- on a non case sensitive operating system (such as Windows).
+ ÇÍÐÑ äÃæñî Óäèã <function>include_once</function>
+ è <function>require_once</function> êåãæ Ãæ äÇ êãèæ åËäåÇ ÊÊèâÙ
+ áê æØÇå ÊÔÚêä ÚêÑ åïÊÍÓñðÓ äÍÇäÉ ÇäÍÑèá (åËä Windows).
<example>
- <title><function>include_once</function> is case insensitive on 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!
+include_once("a.php"); // Óêâèå çÐÇ ÈÊîÖîåñïæ a.php
+include_once("A.php"); // Óêâèå çÐÇ ÈÊîÖîåñïæ a.php åæ ÌÏêÏ Ùäé Windows!
?>
]]>
</programlisting>
@@ -1580,11 +1580,11 @@
</para>
&warn.no-win32-fopen-wrapper;
<para>
- See also <function>include</function>,
- <function>require</function>, <function>require_once</function>,
- <function>get_required_files</function>,
- <function>get_included_files</function>, <function>readfile</function>,
- and <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>