cvs: phpdoc-he /appendices migration.xml

Index: phpdoc-he/appendices/migration.xml
+++ phpdoc-he/appendices/migration.xml
<?xml version="1.0" encoding="WINDOWS-1255"?>
<!-- $Revision: 1.1 $ -->
<!-- HE-Revision: 1.00 Maintainer: hadar_p Status: complete -->
<appendix id="migration">
 <title>îòáø î- PHP/FI 2 àì PHP 3</title>

 <section id="migration.about">
  <title>àåãåú àé-úàéîåéåú á- 3.0</title>

  <simpara>
   PHP 3.0 ðëúáä îä÷ø÷òéú. éù ìä îàôééðé ðéúåç èåáéí éåúø àùø
   éåúø äâéåðééí åò÷áééí îàùø àìä ù÷ééí á- 2.0. 3.0 âí îäéø áöåøä
   îùîòåúéú, åîùúîù áôçåú æéëøåï. ìîøåú æàú, çì÷ îäùéôåøéí äììå ìà
   äéå éëåìéí ìäúáöò ììà ùéðåéé úàéîåú, âí áúçáéø åâí áúô÷åãéåú.
  </simpara>

  <simpara>
   áðåñó ìëê, îôúçé PHP ðéñå ìð÷åú âí àú äúçáéø åâí àú äñîðèé÷ä ùì
   PHP áâøñàú PHP 3.0, åæä âí éöø áòéåú úàéîåú ëìùäï. áîøåöú äæîï,
   àðçðå îàîéðéí ùùéðåééí àìä äí ìèåáä.
  </simpara>

  <simpara>
   äôø÷ äæä éðñä ìëååï àåúê ãøê äàé-äúàéîåéåú ùàåìé úú÷ì áäí ëàùø àúä òåáø
   î- PHP/FI 2.0 àì PHP 3.0 åéòæåø ìê ìôúåà àåúí. úëåðåú çãùåú ìà îåæëøéí
   ëàï, àìà àí ëï æä äëøçé.
  </simpara>

  <simpara>
  úåëðéú ääñáä ùéëåìä ìäôåê áàåôï àåèåîèé ùì äñ÷øéôèéí äéùðí ùìê ùì 
  PHP/FI 2.0 ÷ééîú. äéà éëåìä ìäéîöà áúé÷ééú <filename
  class="directory">convertor</filename> áúåê äôöú PHP 3.0. úåëðéú
  æàú ø÷ îåöàú àú ùéðåéé äúçáéø, åìëï áëì àåôï àúä öøéê ì÷øåà àú äôø÷ äæä
  áæäéøåú.
  </simpara>
 </section>

 <section id="migration.old-function">
  <title><literal>old_function</literal></title>
  <simpara>
   äåøàú <literal>old_function</literal> îàôùøú ìê ì÷øåà ìôåð÷öéä
   áòæøú äúçáéø äúåàí ì- PHP/FI2 (çåõ îäòåáãä ùàúä çééá ìäçìéó
   àú 'function' òí 'old_function').
  </simpara>
  <simpara>
   æä îàôééï îéåùï, åöøéê ìäéåú áùéîåù ø÷ ò"é îîéø 
   PHP/FI2->PHP 3.
  </simpara>
  <warning>
   <para>
    ôåð÷öéåú ùð÷øàå ò"é <literal>old_function</literal> ìà éëåìåú
    ìäé÷øà ò"é ÷åã äôðéîé ùì PHP. áéï äéúø, æä àåîø ùàúä ìà éëåì
    ìäùúîù áäí áôåð÷öéåú ëîå <function>usort</function>, 
    <function>array_walk</function>, å-
    <function>register_shutdown_function</function>.
    àúä éëåì ìò÷åó àú äâáìä æàú ò"é ëúéáú ôåð÷öéä òåèôú (áúáðéú
    PHP 3 øâéìä) àùø ú÷øà àì <literal>old_function</literal>.
   </para>
  </warning>
 </section>
 
 <section id="migration.startendtags">
  <title>úâéåú äúçìä/ñåó</title>

  <para>
   äãáø äøàùåï ùàúä ëðøàä úøàä äåà ùúâéåú ääúçìä åäñéó ùì PHP
   äùúðå. úáðéú <literal>&lt;? &gt;</literal> äéùðä äåçìôä
   ò"é ùìåù úáðéåú àôùøéåú çãùåú:
   <example>
    <title>îòáø: úâéåú äúçìä/ñéåí éùðåú</title>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
<? echo "This is PHP/FI 2.0 code.\n"; >
</div>
]]>
    </programlisting>
   </example>
   îâøñú 2.0, PHP/FI âí úåîê áååøéàöéä äáàä:
   <example>
    <title>îòáø: úâéåú äúçìä/ñéåí øàùåðåú</title>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
<? echo "This is PHP 3.0 code!\n"; ?>
</div>
]]>
    </programlisting>
   </example>

   ùéí ìá ùúâéú äñéåí òëùéå îåøëáú îñéîï ùàìä åñéîï âãåì éåúø
   áî÷åí ø÷ îñéîï âãåì éåúø. ìîøåú æàú, àí àúä îúëðï ìäùúîù
   á- XML òì äùøú ùìê, àúä ú÷áì áòéåú òí äîùúðä äøàùåï ùìê, îùåí
   ù- PHP àåìé éðñä ìäøéõ àú ÷åã ä- XML áîñîëé ä- XML ë÷åã ùì PHP.
   áâìì æä, äååøéàöéä äáàä äåöâä:

   <example>
    <title>îòáø: úâéåú äúçìä/ñéåí ùðéåú</title>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
<?php echo "This is PHP 3.0 code!\n"; ?>
</div>
]]>
    </programlisting>
   </example>

   ìîñôø àðùéí äéå áòéåú òí òåøëéí ùìà äáéðå àú úâéåú ääåøàä
   áëìì. Microsoft FrontPagr äåà òåøê ëæä, åòì îðú ìò÷åó
   àú áòéä æàú, äååøéàöéä äáàä äåöâä âí äéà: 

   <example>
    <title>îòáø: ,úâéåú äúçìä/ñéåí ùìéùéåú</title>
    <programlisting role="php">
<![CDATA[
<script language="php">

  echo "This is PHP 3.0 code!\n";

</script>
]]>
    </programlisting>
   </example>
  </para>
 </section>

 <section id="migration.if-endif">
  <title>úçáéø if..endif</title>

  <para>
   äãøê äçìåôéú ìëúåá îùôèé if/elseif/else, áòæøú if(); elseif();
   else; endif; ìà äéúä éëåìä ìäéåú îáåöòú áéòéìåú îáìé ìäåñéó
   ñéáåê âãåì ìîðúç ùì 3.0. áâìì æàú, äúçáéø ùåðä:
   <example>
    <title>îòáø: úçáéø if..endif éùï</title>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
if ($foo);
    echo "yep\n";
elseif ($bar);
    echo "almost\n";
else;
    echo "nope\n";
endif;
</div>
]]>
    </programlisting>
   </example>
   <example>
    <title>îòáø: úçáéø if..endif çãù</title>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
if ($foo):
    echo "yep\n";
elseif ($bar):
    echo "almost\n";
else:
    echo "nope\n";
endif;
</div>
]]>
    </programlisting>
   </example>

   ùéí ìá ùñéîï äð÷åãä ôñé÷ (;) äåçìó áð÷åãúééí áëì äîùôèéí, çåõ
   îäáéèåé äîñééí (endif).
  </para>
 </section>

 <section id="migration.while">
  <title>úçáéø while</title>
  <para>
   áãéå÷ ëîå òí if..endif, äúçáéø ùì while..endwhile äùúðä âí ëï:
   <example>
    <title>îòáø: úçáéø while..endwhile éùï</title>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
while ($more_to_come);
    ...
endwhile;
</div>
]]>
    </programlisting>
   </example>
   <example>
    <title>îòáø: úçáéø while..endwhile çãù</title>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
while ($more_to_come):
    ...
endwhile;
</div>
]]>
    </programlisting>
   </example>
  </para>
  <warning>
   <simpara>
    àí àúä úùúîù áúçáéø while..endwhile äéùï á- PHP 3.0,
    àúä ú÷áì ìåìàä àéï-ñåôéú.
   </simpara>
  </warning>
 </section>

 <section id="migration.expr">
  <title>ñåâé áéèåééí</title>
  <simpara>
  
  PHP/FI 2.0 äùúîù áöã äùîàìé ùì äáéèåééí ì÷áåò îä ñåâ äúåöàä
  öøéëä ìäéåú. PHP 3.0 ìå÷ç áçùáåï àú ùðé äöããéí ëàùø äåà ÷åáò
  àú ñåâé äúåöàä, åæä éëåì ìâøåí ìñ÷øéôèéí ùì 2.0 ìäúðäâ áàåôï
  áìúé öôåé á- 3.0.
  </simpara>
  <para>
   äúééçñ ìãåâîà äáàä:
   <informalexample>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
$a[0]=5;
$a[1]=7;

$key = key($a);
while ("" != $key) {
    echo "$keyn";
    next($a);
}
</div>
]]>
    </programlisting>
   </informalexample>
   
   á- PHP/FI 2.0, æä äéä îöéâ àú äàéðã÷ñéí ùì $a. á- PHP 3.0,
   æä ìà éöéâ ùåí ãáø. äñéáä äéà ùá- PHP 2.0, îùåí ùäàøâåîðè äùîàìé
   äåà îçøåæú, äùååàú îçøåæåú ðòùúä, åàåîðí, <literal>""</literal>
   ìà ùååä ì- <literal>"0"</literal>, åäñ÷øéôè ééëðñ ììåìàä. á- PHP 3.0,
   ëàùø îçøåæú îùååä ìîñôø ùìí, äùååàú îñôøéí ùìîéí ðòùéú (äîçøåæú
   îåîøú ìîñôø ùìí). äúåöàä áäùååàä ùì <literal>atoi("")</literal>
   àùø äåà <literal>0</literal> å- <literal>variablelist</literal>
   àùø äåà âí <literal>0</literal>, åîëéååï ù- <literal>0==0</literal>,
   äñ÷øéôè ìà äåìê ãøê äìåìàä àôéìå ôòí àçú.
  </para>
  <para>
   äúé÷åï ìæä ôùåè. äçìó àú îùôè ä- While áæä:
   <informalexample>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
while ((string)$key != "") {
</div>
]]>
    </programlisting>
   </informalexample>
  </para>
 </section>

 <section id="migration.errors">
  <title>äåãòåú ùâéàä äùúðå</title>
  <simpara>
   äåãòåú äùâéàä ùì PHP 3.0 áãøê ëìì éåúø îãåéé÷åú îùì ääåãòåú ùì 2.0,
   àáì àúä ëáø ìà ú÷áì ìøàåú àú ÷èò ä÷åã ùâåøí àú äùâéàä.
   éñåô÷ ìê ùí ÷åáõ åîñôø ùåøä ùì äùâéàä, ìîøåú æàú.
  </simpara>
 </section>

 <section id="migration.booleval">
  <title>äùååàä áåàìééàðéú</title>
  <simpara>
   á- PHP 3.0 äùååàä áåìééàðéú äéà úìåéä áä÷ùø áä äéà ÷ééîú. æä àåîø ùáéèåé ëîå
   <literal>(1 || test_me())</literal>, äôåð÷öéä <function>test_me</function>
   ìà úúáöò îëéååï ùùåí ãáø ìà éëåì ìùðåú àú úåöàú äáéèåé àçøé
   <literal>1</literal>.
  </simpara>

  <simpara>
   æäå ðåùà úàéîåú ùåìé, àáì äåà òãééï éëåì ìéöåø úåôòåú ìååàé
   ìà öôåéåú.
  </simpara>
 </section>

 <section id="migration.truefalse">
  <title>äòøëéí äîåçæøéí &true;/&false; ùì ôåð÷öéä</title>
  <simpara>
   øåá äôåð÷öéåú äôðéîéåú ðëúáå îçãù òì îðú ùéåëìå ìäçæéø &true;
   ëàùø äï äúáöòå áäöìçä, å- &false; ëàùø äï ðëùìå, æä äîðåâã àì
   0 å- -1 á- PHP/FI 2.0, áäúàîä. ääúðäâåú äçãùä îàôùøú ÷åã éåúø
   ìåâé, ëîå <literal>$fp = fopen("/your/file") or
   fail("darn!");</literal>. îùåí ùì- PHP/FI 2.0 àéï ùåí çå÷éí
   áøåøéí ìâáé àéæä òøëéí ôåð÷öéåú öøéëåú ìäçæéø îúé ùäí ëåùìåú,
   ÷øåá ìååãàé ùàú øåá äñ÷øéôèéí àúä úöèøê ìáãå÷ éãðéú àçøé ùéîåù
   áîîéø î- 2.0 àì 3.0.
  </simpara>
  <para>
   <example>
    <title>îòáø î- 2.0: òøëéí îåçæøéí, ÷åã éùï</title>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
$fp = fopen($file, "r");
if ($fp == -1);
    echo("Could not open $file for reading<br>\n");
endif;
</div>
]]>
    </programlisting>
   </example>
   <example>
    <title>îòáø î- 2.0: òøëéí îåçæøéí, ÷åã çãù</title>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
$fp = @fopen($file, "r") or print("Could not open $file for reading<br>\n");
</div>
]]>
    </programlisting>
   </example>
  </para>
 </section>

 <section id="migration.other">
  <title>àé äúàîåú ðåñôåú</title>

  <itemizedlist>
   <listitem><simpara>
    îåãåì PHP 3.0 ùì Apache àéðå úåîê éåúø áâøñàåú Apache ÷åãîåú
    ì- 1.2. Apache 1.2 àå çãù éåúø ðãøù.
   </simpara></listitem>

   <listitem><simpara>
    <function>echo</function> ëáø ìà úåîê áîçøåæú îòåöáú.
    äùúîù áôåð÷öéä <function>printf</function> áî÷åí.
   </simpara></listitem>

   <listitem><simpara>
    á- PHP/FI 2.0, úåöàú ìååàé ùì äééùåí âøîä ùì- 
    <literal>$foo[0]</literal> éäéä àú àåúå úåöàä ëîå ùì
    <literal>$foo</literal>. æä ìà ðëåï á- PHP 3.0.
   </simpara></listitem>

   <listitem>
    <simpara>
     ÷øéàú îòøëéí áòæøú <literal>$array[]</literal> ëáø ìà 
	ðúîëú.
    </simpara>
    <simpara>
     æàú àåîøú, àúä ìà éëåì ìòáåø òì îòøê áòæøú ìåìàä ùîáöòú
     <literal>$data = $array[]</literal>.  äùúîù á- <function>current</function>
     åá- <function>next</function> áî÷åí.
    </simpara>
    <simpara>
     âí ëï, <literal>$array1[] = $array2</literal> àéðå
	îåñéó àú äòøëéí ùì <literal>$array2</literal> àì
     <literal>$array1</literal>, àìà îöøó àú 
     <literal>$array2</literal> ëäàéáø äàçøåï áúåê
     <literal>$array1</literal>. øàä âí úîéëä áîòøëéí øá-îîãéí.
    </simpara>
   </listitem>

   <listitem>
    <simpara>
     <literal>"+"</literal> ëáø ìà òå÷ó àú àåôøèåø äçéáåø ùì îçøåæåú,
	î÷åí æàú äåà îòáéø àú äàøâåðèéí ìîñôøéí åîáöò çéáåø îñôøéí. äùúîù
	á- <literal>"."</literal> áî÷åí.
    </simpara>
   </listitem>
  </itemizedlist>

  <example>
   <title>îòáø î- 2.0: çéáåø ùì îçøåæåú</title>
   <programlisting role="php">
<![CDATA[
<div dir="ltr">
echo "1" + "1";
</div>
]]>
   </programlisting>
   <para> 
    á- PHP 2.0 æä éöéâ 11, á- PHP 3.0 æä 
    éöéâ 2. áî÷åí æàú äùîúù:
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
echo "1"."1";
</div>
]]>
    </programlisting>
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
$a = 1;
$b = 1;
echo $a + $b;
</div>
]]>
    </programlisting>
   </para>
   <para>
    æä éöéâ 2 âí áå PHP 2.0 åâí á- 3.0.
    <programlisting role="php">
<![CDATA[
<div dir="ltr">
$a = 1;
$b = 1;
echo $a.$b;
</div>
]]>
    </programlisting>
    æä éöéâ 11 á- PHP 3.0.
   </para>
  </example>
 </section>

</appendix>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->