cvs: phpdoc /ar/language basic-syntax.xml constants.xml
| From: | Salah Faya | Date: | Mon, 25 Mar 2002 18:09:48 +0000 |
| Subject: | cvs: phpdoc /ar/language basic-syntax.xml constants.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969343471@lists.php.net to get a copy of this message | ||
visualmind Mon Mar 25 13:09:48 2002 EDT
Added files:
/phpdoc/ar/language basic-syntax.xml constants.xml
Log:
Translated to Arabic
Index: phpdoc/ar/language/basic-syntax.xml +++ phpdoc/ar/language/basic-syntax.xml <?xml version="1.0" encoding="iso-8859-6"?> <!-- $EN-Revision: 1.26 $ --> <chapter id="language.basic-syntax"> <title>ÇäÕêÚÉ ÇäÃÓÇÓêÉ</title> <!-- NOTE: Last modified: 2001-05-16 13:00 GMT the language part is currently under heavy revision. Please do not not make any heavy (i.e. structural) modifications to this part for a moment. You'd also better not start any translation yet. Comments are always welcome at phpdoc@lists.php.net Progress: intro : DOESN'T EXIST - yet? new chapter, with some introductionary remarks? Will be discussed on the ML soon. basic-syntax: FINISHED except maybe moving the 'advanced escaping' to a better place? TODO: - nada types : Being revised. Added all new types Boolean and Integer are more or less finished. The rest isn't. TODO: - why is $foo[bar] bad syntax? - what's the difference between unset($bla) and $bla = NULL; (it is different!) - $obj->{expr} syntax - (unset) cast????? - $bla = unset <== should've been nuked, don't mention it - $str{offset} syntax, rather than $str[offset] - read notes and apply when any of them are useful - remove notes which have been included here. - ... the rest: Not yet started with. TODO: - ? oop : has been revised by Kristian, DONE. --> <sect1 id="language.basic-syntax.phpmode"> <title>ÇäÎÑèÌ åæ æå× HTML</title> <para> ÙæÏåÇ êâèå åáÓÑ Èê ÅÊÔ Èê ÈåÙÇäÌÉ åäᬠáÅæç ÈÈÓÇ×É êåÑÑ æÕ Çäåäá ãåÇ çè Åäé Ãæ êèÇÌç ÃÍÏ ÇäåÙñÑáÇÊ ÇäÎÇÕÉ èÇäÊê ÊÎÈÑç Ãæ êÈÏà ÈÊÑÌåÉ ÇäæÕ ãÔáÑÉ Èê ÅÊÔ Èê. êâèå ÇäåáÓÑ ÙæÏÆÐ ÈÊæáêÐ ãä ÇäãèÏ ÇäÐê êÌÏç Åäé Ãæ êÌÏ åÙÑñá ÅâáÇä ÇäÈê ÅÊÔ Èê¬ èÇäÐê êÎÈÑ ÇäåáÓÑ Ãæ êÈÏà ÊåÑêÑ ÇäæÕ ÇäÊÇäê ãåÇ çè åÑÉ ÃÎÑé. çÐç ÇäÂäêÉ ÇäÊê ÊÓåÍ äã Ãæ ÊÖåæ ÔáÑÉ Èê ÅÊÔ Èê ÏÇÎä ÕáÍÉ èêÈ HTML ¬ ÈåÙæé ÂÎÑ: ãä åÇ çè ÎÇÑÌ åÙÑáÇÊ ÇäÈê ÅÊÔ Èê êÊÑã ãåÇ çè ÊåÇåÇë¬ ÈêæåÇ ãä åÇ çè ÏÇÎä ÇäåÙÑáÇÊ êÙÇäÌ ÈÑåÌêÇë. </para> <para> çæÇã ÃÑÈÙ åÌåèÙÇÊ åæ ÇäåÙÑáÇÊ ÇäÊê êåãæ ÇÓÊÎÏÇåçÇ äÊÍÏÏ ÈÏÇêÉ èæçÇêÉ ÔáÑÉ PHP . åÇ êäê çåÇ ÇäåÙÑáÇÊ ÇäèÍêÏÉ ÇäËÇÈÊÉ ÏÇÆåÇë : (<?php. . .?> è <script language="php">. . .</script>) ÈêæåÇ êåãæ Ãæ êÊå ÅêâÇá èÊÔÚêä ÇäåÌåèÙÇÊ ÇäÃÎÑé åæ ÎäÇä åäá ÇäÊçêÆÉ <filename>php.ini</filename>ÈêæåÇ ÊÙÊÈÑ ÇäèÇÕáÇÊ ÇäâÕêÑÉ èÇäèÇÕáÇÊ ÇäÔÈêçÉ Èæå× ASP åäÇÆåÉ äãæçÇ äÇ ÊÙÊÈÑ åÑæÉ åËä ÇäèÇÕáÇÊ Çä×èêäɬ ãÐäã áÅæ ãæÊ ÊÙÊÒå ÊÖåêæ ÔáÑÉ PHP ÏÇÎä åäáÇÊ XML Ãè XHTML áÅæã ÊÍÊÇÌ Åäé ÇÓÊÎÏÇå <?php. . .?> </para> <para> ÇäèÇÕáÇÊ (ÇäåÙÑáÇÊ) ÇäåâÈèäÉ áê PHP: </para> <para> <example> <title>×Ñâ ÇäÎÑèÌ åæ æå× HTML</title> <programlisting role="php"> <![CDATA[ 1. <? echo ("this is the simplest, an SGML processing instruction\n"); ?> <?= expression ?>çÐÇ ÇÎÊÕÇÑ êåãæ ÇÓÊÎÏÇåç ÈÏäÇë åæ "<? echo expression ?>" 2. <?php echo("if you want to serve XHTML or XML documents, do like this\n"); ?> 3. <script language="php"> echo ("some editors (like FrontPage) don't like processing instructions"); </script> 4. <% echo ("You may optionally use ASP-style tags"); %> <%= $variable; # This is a shortcut for "<% echo . . ." %>]]> </programlisting> </example> </para> <para> Çä×ÑêâÉ ÇäÃèäé ååãæÉ áâ× ÅÐÇ åÇ ãÇæÊ ÇäèÇÕáÇÊ ÇäâÕêÑÉ åáÙñäÉ. ÍêË êåãæ Ðäã Ùæ ×Ñêâ ÇäÏÇäÉ <function>short_tags</function> (PHP 3 áâ×), ÈÊáÙêä <link linkend="ini.short-open-tag">short_open_tag</link> áê ÇäÅÙÏÇÏÇÊ ÇäÎÇÕÉ Èåäá ÊçêÆÉ PHP¬ Ãè ÈÅÙÇÏÉ ÈÊÑãêÈ PHP åÙ ÅÖÇáÉ ÇäÎÇÕêÉ --enable-short-tags<command>configure</command> </para> <para> åÑÉ ÃÎÑé¬ Çä×ÑêâÉ ÇäËÇæêÉ çê Çä×ÑêâÉ ÇäåÓÊÍÓæÉ ÈÔãä ÙÇå¬ ÅÐ ÃæçÇ ÊÓçä ÇÓÊÎÏÇå Èê ÅÊÔ Èê áê ÕêÚ XML è XHTML.</para> <para> Çä×ÑêâÉ ÇäÑÇÈÙÉ ååãæÉ áâ× Íêæ Êãèæ ÇäåÙÑáîÇÊ Ùäé ×ÑêâÉ ASP Ãè åÇ êÙÑá ÈèÇÕáÇÊ (ASP-style) åáñÙäÉ åæ ÎäÇä ÎÇÕêÉ ÇäÊçêÆÉ <link linkend="ini.asp-tags">asp_tags</link>.<note> <para>ÊåÊ ÅÖÇáÉ ÏÙå èÇÕáÇÊ ASP áê ÇäÅÕÏÇÑ 3.0.4.</para> </note> </para> <para> èÇÕáÉ ÇäæçÇêÉ ääåÌåèÙÉ Óèá ÊÊÖåæ åÈÇÔÑÉ åÄÔÑ Ó×Ñ ÌÏêÏ Åæ ãÇæ åèÌèÏÇë. ãåÇ ÃæçÇ ÓÊÚæê Ùæ èÌèÏ ÇäáÇÕäÉ Çäåæâè×É ; ÈÙÏ ÂÎÑ ÃåÑ ¬ áäæ ÊÍÊÇÌ Åäé ÅÖÇáÉ ÇäáÇÕäÉ Çäåæâè×É äÅæçÇÁ ÂÎÑ ÃåÑ áê ÇäåÌåèÙÉ âÈä èÇÕáÉ ÇäÅâáÇä.</para> <para>ÊÓåÍ äã PHP ÈÇÓÊÎÏÇå ÇäÔãä ÇäÊÇäê :<example><title>ÕêÚÉ å×èÑÉ</title> <programlisting role="php"> <![CDATA[ <?php if ($expression) { ?> <strong>This is true.</strong> <?php } else { ?> <strong>This is false.</strong> <?php } ?>]]> </programlisting> </example> êÙåä ÊåÇåÇë ãåÇ çè åÊèâÙ¬ äÃæ åáÓÑ PHP ÙæÏåÇ êÌÏ èÇÕáÉ ÇäÅâáÇä ?> , êÈÏà ÈÈÓÇ×É ÊåÑêÑ ãä åÇ êäê Ðäã ãåÎÑÌÇÊ ÍÊé êÌÏ èÇÕáÉ ÈÏÁ ÃÎÑé. ÇäåËÇä ÇäåÙ×é çæÇ åÎÊÑÙ ÈÇäÊÃãêÏ äêÓÊÚä çÐç ÇäåêÒɬ äãæç åÙñÏ ÃÓÇÓÇë áê ÍÇäÉ ÇäÑÚÈÉ áê ÊåÑêÑ ãåêÉ ãÈêÑÉ åæ ÇäæÕ¬ ÅÐ Ãæ ÅÎÑÇÌ ÇäæÕ ÈçÐç Çä×ÑêâÉ êÌæÈ PHP åæ åÍÇèä ÊáÓêÑ ÇäåÍÊèé èçê ÙåèåÇë ×ÑêâÉ áÙÇäÉ ÃáÖä åæ ÇÓÊÎÏÇå <function>echo</function> Ãè <function> print</function> Ãè åÇ ÔÇÈç.</para> </sect1> <sect1 id="language.basic-syntax.instruction-separation"> <title> ×ÑêâÉ áÕä ÇäÃèÇåÑ</title> <simpara> êÊå áÕä ÇäÃèÇåÑ åËäåÇ áê äÚÉ C Ãè Perl ÈÅæçÇÁ ãä ÃåÑ ÈÑåÒ ÇäáÇÕäÉ Çäåæâè×É.</simpara> <para> èÇÕáÉ ÇäÅâáÇä (?>) ÊÙÊÈÑ ÃêÖÇë æçÇêÉ ÇäÌåäɬ ÍêË ÊÄÏê ãäÇ Çä×ÑêâÊêæ ÇäÊÇäêÊêæ æáÓ ÇäÚÑÖ:<informalexample> <programlisting role="php"> <![CDATA[ <?php echo "This is a test"; ?> <?php echo "This is a test" ?>]]> </programlisting> </informalexample> </para> </sect1> <sect1 id="language.basic-syntax.comments"> <title>ÇäÊÙäêâÇÊ</title> <para> PHP ÊÏÙå ÇÓäèÈ äÚÉ C è C++ è Unix shell-style áê ÇÖÇáÉ ÇäÊÙäêâÇÊ. åËäÇë: <informalexample> <programlisting role="php"> <![CDATA[ <?php echo "This is a test"; // This is a one-line c++ style comment /* This is a multi line comment yet another line of comment */ echo "This is yet another test"; echo "One Final Test"; # This is shell-style style comment ?>]]> </programlisting> </informalexample> </para> <simpara> ÇÓäèÈ ÊÙäêâ "ÇäÓ×Ñ-ÇäèÇÍÏ" áê ÇäÍâêâÉ êÓåÍ ÈÅÖÇáÉ ÊÙäêâ Ãè åäÇÍØÉ ÍÊé æçÇêÉ ÇäÓ×Ñ Ãè ÇäåÌåèÙÉ ÃêçåÇ ÃâÑÈ.</simpara> <informalexample> <programlisting role="php"> <![CDATA[ <h1>This is an <?php # echo "simple";?> example.</h1> <p>The header above will say 'This is an example'. ]]> </programlisting> </informalexample> <simpara> êÌÈ Ãæ Êãèæ ÍÐÑÇë ÃËæÇÁ ÇÓÊÎÏÇå æå× äÚÉ C áê ÇäÊÙäêâÇʬ ÍêË âÏ ÊÍÏË åÔÇãä ÃËæÇÁ åÍÇèäÉ ÅÖÇáÉ ÊÙäêâÇÊ ÈãåêÉ ãÈêÑÉ.</simpara> <informalexample> <programlisting role="php"> <![CDATA[ <?php /* echo "This is a test"; /* This comment will cause a problem */ */ ?>]]> </programlisting> </informalexample> </sect1> </chapter> <!-- 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 --> Index: phpdoc/ar/language/constants.xml +++ phpdoc/ar/language/constants.xml <?xml version="1.0" encoding="iso-8859-6"?> <!-- $EN-Revision: 1.24 $ --> <chapter id="language.constants"> <title>ÇäËèÇÈÊ</title> <simpara> ÇäËÇÈÊ çè ÑåÒ åÙÑñá äâêåÉ åǬ èãåÇ çè èÇÖÍ åæ ÇäÊÓåêÉ áÅæ ÇäâêåÉ äÇ êåãæ Ãæ ÊÊÚêÑ ÎäÇä ÊæáêÐ ÇäÈÑæÇåÌ. ('ÇäËèÇÈÊ ÇäååêÒÉ' <constant>__FILE__</constant> è <constant>__LINE__</constant> ÊÈÏè ÇÓÊËæÇÁ äçÐç ÇäâÇÙÏɬ äãæçÇ äêÓÊ ËèÇÈÊ áÙäêÇë.) ÇäËÇÈÊ êÊÃËÑ ÈÍÇäÉ ÇäÍÑèá ÇäÕÚêÑÉ èÇäãÈêÑÉ ÇáÊÑÇÖêÇë. èâÏ ÌÑÊ ÇäÙÇÏÉ Ãæ Êãèæ ÇäËèÇÈÊ ÏÇÆåÇë ÈÃÍÑá ãÈêÑÉ . </simpara> <para> ÇÓå ÇäËÇÈÊ êÊÈÙ æáÓ ÇäÔÑè× äÃê ÊÓåêÉ áê äÚÉ ÇäÈê ÅÊÔ Èê. ÇäÇÓå ÇäÕÍêÍ ääËÇÈÊ êÈÏà ÈÍÑá Ãè ÔÑ×É Óáäêɬ åÊÈèÙÉ ÈÃê ÙÏÏ åæ ÇäÍÑèᬠÇäÃÑâÇå Ãè ÇäÔÑ× ÇäÓáäêÉ . èÈÊÙÈêÑ âêÇÓê êåãæ ÊåËêä âÇÙÏÉ ÇÓå ÇäËÇÈÊ çãÐÇ :<literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> <!-- TODO: Example of valid & invalid constant names --> </para> <note> <simpara> çæÇ ÓæÙÊÈÑ ÇäÍÑá çè ÃÍÏ ÇäÍÑèá ÇäçÌÇÆêÉ ÇäÇæÌäêÒêÉ a-z è A-Z èÑåèÒ ASCII ÐÇÊ ÇäâêåÉ åæ 127 èÍÊé 255 (Ox7f-Oxff). </simpara> </note> <simpara> åÏé (æ×Çâ) ÇÓÊÎÏÇå ÇäËÇÈÊ åÏéë ÔÇåä¬ ÍêË ÊÓÊ×êÙ ÇäèÕèä Åäêç åæ Ãê åãÇæ ÏÇÎä ÈÑæÇåÌã Ïèæ ÇçÊåÇå ääåÏé.</simpara> <sect1 id="language.constants.syntax"> <title>ÇäÕêÚÉ</title> <simpara> ÊÓÊ×êÙ Ãæ ÊÙÑá ËÇÈÊÇë ÈÇÓÊÎÏÇå ÏÇäÉ <function>define</function>. ÍêæåÇ êÊå ÊÙÑêá ÇäËÇÈÊ äÇ êåãæ ÙæÏÆÐ Ãæ êÊÚêÑ Ãè êÒÇä ÊÙÑêáç. </simpara> <simpara> ÇäÈêÇæÇÊ ÇäâêÇÓêÉ áâ× (<type>boolean</type>, <type>integer</type>, <type>double</type> è <type>string</type>) êåãæ ÇÓÊÎÏÇåçÇ áê ÇäËèÇÈÊ. </simpara> <simpara> ÊÓÊ×êÙ ÇäÍÕèä Ùäé âêåÉ Ãê ËÇÈÊ Ùæ ×Ñêâ ÊÍÏêÏ ÇÓåç ÈÈÓÇ×ç. Ùäé ÙãÓ ÇäåÊÚêÑÇʬ êÌÈ Ãæ <emphasis>äÇ</emphasis> ÊÓÈâ ÇäËÇÈÊ ÈÙäÇåÉ<literal>$</literal> ÊÓÊ×êÙ ÇÓÊÎÏÇå ÇäÏÇäÉ <function>constant</function>¬ äâÑÇÁÉ âêåÉ ÇäËÇÈʬ ÇÐÇ ãæÊ ÊÑÚÈ áê ÇÓÊÎÏÇå ÇÓå ÇäËÇÈÊ ÏêæÇåêãêÇë. ÊÓÊ×êÙ ÇêÖÇë ÇÓÊÎÏÇå <function>get_defined_constants</function> ääÍÕèä Ùäé âÇÆåÉ Èãä ÇäËèÇÈÊ ÇäåÙÑáÉ . </simpara> <note> <simpara> ÇäËèÇÈÊ è ÇäåÊÚêÑÇÊ (ÇäÔÇåäÉ) ÊâÙ áê åèÇâÙ åÎÊäáɬ ååÇ êæÊÌ Ùæ Ðäã åËäÇë ãèæ &true; è <varname>$TRUE</varname> åÎÊäáÇæ ÊåÇåÇë.</simpara> </note> <simpara> ÙæÏåÇ ÊÓÊÎÏå ËÇÈÊÇë ÚêÑ åÙÑᬠáÓêáÊÑÖ PHP Ãæã ÊÙæê ÇÓÊÎÏÇå ÇÓå ÇäËÇÈÊ æáÓç èäêÓ ÇäâêåÉ. Óèá êÕÏÑ <link linkend="features.error-handling">ÊæÈêç</link> ÙæÏåÇ ÊÍÏË åËä çÐç ÇäÍÇäÉ. äÐäã êåãæã ÇÓÊÎÏÇå ÇäÏÇäÉ <function>defined</function> ÇÐÇ ÃÑÏÊ Ãæ ÊÙÑá åÇ ÅÐÇ ãÇæ ÇäËÇÈÊ âÏ Êå ÊÙÑêáç.</simpara> <para> çÐç çê ÇäÇÎÊäÇáÇÊ Èêæ ÇäËèÇÈÊ èÇäåÊÚêÑÇÊ : <itemizedlist> <listitem> <simpara> ÇäËèÇÈÊ äÇ ÊÓÊÎÏå ÙäÇåÉ ÇäÏèäÇÑ (<literal>$</literal>) âÈäçÇ» </simpara> </listitem> <listitem> <simpara> ÇäËèÇÈÊ êåãæ Ãæ êÊå ÊÙÑêáçÇ áâ× åæ ÎäÇä ÇäÏÇäÉ <function>define</function>, èäêÓ Ùæ ×Ñêâ ÊÙêêæ ÈÓê×; </simpara> </listitem> <listitem> <simpara> ÇäËèÇÈÊ êåãæ ÊÙÑêáçÇ èÊÎÕêÕçÇ áê Ãê åãÇæ Ïèæ ÇäÇçÊåÇå ÈÔÑè× åÏé ÇäåÊÚêÑÇÊ» </simpara> </listitem> <listitem> <simpara> ÇäËèÇÈÊ äÇ êåãæ ÅÙÇÏÉ ÊÙÑêáçÇ Ãè ÅÒÇäÉ ÊÙÑêáçǬ ÙæÏåÇ êÊå ÊÙÑêáçÇ åÑÉ ÊÕÈÍ åÙêæÉ ÈÔãä æçÇÆê» </simpara> </listitem> <listitem> <simpara> ÇäËèÇÈÊ êåãæ Ãæ ÊâÏÑ Èâêå âêÇÓêÉ áâ×.</simpara> </listitem> </itemizedlist> </para> <para> <example> <title>ÊÙÑêá ÇäËèÇÈÊ</title> <programlisting role="php"> <![CDATA[ <?php define("CONSTANT", "Hello world."); echo CONSTANT; // outputs "Hello world." echo Constant; // outputs "Constant" and issues a notice. ?>]]> </programlisting> </example> </para> </sect1> <sect1 id="language.constants.predefined"> <title>ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë</title> <simpara> ÊÒèÏ PHP ÙÏÏÇë ãÈêÑÇë åæ ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë äÃê ÈÑæÇåÌ êæáÐ. ÇäÙÏêÏ åæ çÐç ÇäËèÇÈÊ ÙåèåÇë ÊæÔà ÈèÇÓ×É ÇäÙÏêÏ åæ ÇäÇåÊÏÇÏÇÊ (extensions)¬ èÊãèæ ÍÇÖÑÉ ÙæÏåÇ Êãèæ çÐç ÇäÇåÊÏÇÏÇÊ åÊèáÑÉ áâ׬ ÅåÇ ÙÈÑ ÊÍåêäçÇ ÏêæÇåêãêÇë Ãè Ãæ Êãèæ åÏåÌÉ ÃËæÇÁ ÇäÊÑãêÈ. </simpara> <simpara> âÇÆåÉ ÈÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë åèÌèÏÉ áê çÐÇ ÇäâÓå <link linkend="reserved.constants">ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë</link> </simpara> </sect1> </chapter> <!-- 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 -->
Index: phpdoc/ar/language/basic-syntax.xml +++ phpdoc/ar/language/basic-syntax.xml <?xml version="1.0" encoding="iso-8859-6"?> <!-- $EN-Revision: 1.26 $ --> <chapter id="language.basic-syntax"> <title>ÇäÕêÚÉ ÇäÃÓÇÓêÉ</title> <!-- NOTE: Last modified: 2001-05-16 13:00 GMT the language part is currently under heavy revision. Please do not not make any heavy (i.e. structural) modifications to this part for a moment. You'd also better not start any translation yet. Comments are always welcome at phpdoc@lists.php.net Progress: intro : DOESN'T EXIST - yet? new chapter, with some introductionary remarks? Will be discussed on the ML soon. basic-syntax: FINISHED except maybe moving the 'advanced escaping' to a better place? TODO: - nada types : Being revised. Added all new types Boolean and Integer are more or less finished. The rest isn't. TODO: - why is $foo[bar] bad syntax? - what's the difference between unset($bla) and $bla = NULL; (it is different!) - $obj->{expr} syntax - (unset) cast????? - $bla = unset <== should've been nuked, don't mention it - $str{offset} syntax, rather than $str[offset] - read notes and apply when any of them are useful - remove notes which have been included here. - ... the rest: Not yet started with. TODO: - ? oop : has been revised by Kristian, DONE. --> <sect1 id="language.basic-syntax.phpmode"> <title>ÇäÎÑèÌ åæ æå× HTML</title> <para> ÙæÏåÇ êâèå åáÓÑ Èê ÅÊÔ Èê ÈåÙÇäÌÉ åäᬠáÅæç ÈÈÓÇ×É êåÑÑ æÕ Çäåäá ãåÇ çè Åäé Ãæ êèÇÌç ÃÍÏ ÇäåÙñÑáÇÊ ÇäÎÇÕÉ èÇäÊê ÊÎÈÑç Ãæ êÈÏà ÈÊÑÌåÉ ÇäæÕ ãÔáÑÉ Èê ÅÊÔ Èê. êâèå ÇäåáÓÑ ÙæÏÆÐ ÈÊæáêÐ ãä ÇäãèÏ ÇäÐê êÌÏç Åäé Ãæ êÌÏ åÙÑñá ÅâáÇä ÇäÈê ÅÊÔ Èê¬ èÇäÐê êÎÈÑ ÇäåáÓÑ Ãæ êÈÏà ÊåÑêÑ ÇäæÕ ÇäÊÇäê ãåÇ çè åÑÉ ÃÎÑé. çÐç ÇäÂäêÉ ÇäÊê ÊÓåÍ äã Ãæ ÊÖåæ ÔáÑÉ Èê ÅÊÔ Èê ÏÇÎä ÕáÍÉ èêÈ HTML ¬ ÈåÙæé ÂÎÑ: ãä åÇ çè ÎÇÑÌ åÙÑáÇÊ ÇäÈê ÅÊÔ Èê êÊÑã ãåÇ çè ÊåÇåÇë¬ ÈêæåÇ ãä åÇ çè ÏÇÎä ÇäåÙÑáÇÊ êÙÇäÌ ÈÑåÌêÇë. </para> <para> çæÇã ÃÑÈÙ åÌåèÙÇÊ åæ ÇäåÙÑáÇÊ ÇäÊê êåãæ ÇÓÊÎÏÇåçÇ äÊÍÏÏ ÈÏÇêÉ èæçÇêÉ ÔáÑÉ PHP . åÇ êäê çåÇ ÇäåÙÑáÇÊ ÇäèÍêÏÉ ÇäËÇÈÊÉ ÏÇÆåÇë : (<?php. . .?> è <script language="php">. . .</script>) ÈêæåÇ êåãæ Ãæ êÊå ÅêâÇá èÊÔÚêä ÇäåÌåèÙÇÊ ÇäÃÎÑé åæ ÎäÇä åäá ÇäÊçêÆÉ <filename>php.ini</filename>ÈêæåÇ ÊÙÊÈÑ ÇäèÇÕáÇÊ ÇäâÕêÑÉ èÇäèÇÕáÇÊ ÇäÔÈêçÉ Èæå× ASP åäÇÆåÉ äãæçÇ äÇ ÊÙÊÈÑ åÑæÉ åËä ÇäèÇÕáÇÊ Çä×èêäɬ ãÐäã áÅæ ãæÊ ÊÙÊÒå ÊÖåêæ ÔáÑÉ PHP ÏÇÎä åäáÇÊ XML Ãè XHTML áÅæã ÊÍÊÇÌ Åäé ÇÓÊÎÏÇå <?php. . .?> </para> <para> ÇäèÇÕáÇÊ (ÇäåÙÑáÇÊ) ÇäåâÈèäÉ áê PHP: </para> <para> <example> <title>×Ñâ ÇäÎÑèÌ åæ æå× HTML</title> <programlisting role="php"> <![CDATA[ 1. <? echo ("this is the simplest, an SGML processing instruction\n"); ?> <?= expression ?>çÐÇ ÇÎÊÕÇÑ êåãæ ÇÓÊÎÏÇåç ÈÏäÇë åæ "<? echo expression ?>" 2. <?php echo("if you want to serve XHTML or XML documents, do like this\n"); ?> 3. <script language="php"> echo ("some editors (like FrontPage) don't like processing instructions"); </script> 4. <% echo ("You may optionally use ASP-style tags"); %> <%= $variable; # This is a shortcut for "<% echo . . ." %>]]> </programlisting> </example> </para> <para> Çä×ÑêâÉ ÇäÃèäé ååãæÉ áâ× ÅÐÇ åÇ ãÇæÊ ÇäèÇÕáÇÊ ÇäâÕêÑÉ åáÙñäÉ. ÍêË êåãæ Ðäã Ùæ ×Ñêâ ÇäÏÇäÉ <function>short_tags</function> (PHP 3 áâ×), ÈÊáÙêä <link linkend="ini.short-open-tag">short_open_tag</link> áê ÇäÅÙÏÇÏÇÊ ÇäÎÇÕÉ Èåäá ÊçêÆÉ PHP¬ Ãè ÈÅÙÇÏÉ ÈÊÑãêÈ PHP åÙ ÅÖÇáÉ ÇäÎÇÕêÉ --enable-short-tags<command>configure</command> </para> <para> åÑÉ ÃÎÑé¬ Çä×ÑêâÉ ÇäËÇæêÉ çê Çä×ÑêâÉ ÇäåÓÊÍÓæÉ ÈÔãä ÙÇå¬ ÅÐ ÃæçÇ ÊÓçä ÇÓÊÎÏÇå Èê ÅÊÔ Èê áê ÕêÚ XML è XHTML.</para> <para> Çä×ÑêâÉ ÇäÑÇÈÙÉ ååãæÉ áâ× Íêæ Êãèæ ÇäåÙÑáîÇÊ Ùäé ×ÑêâÉ ASP Ãè åÇ êÙÑá ÈèÇÕáÇÊ (ASP-style) åáñÙäÉ åæ ÎäÇä ÎÇÕêÉ ÇäÊçêÆÉ <link linkend="ini.asp-tags">asp_tags</link>.<note> <para>ÊåÊ ÅÖÇáÉ ÏÙå èÇÕáÇÊ ASP áê ÇäÅÕÏÇÑ 3.0.4.</para> </note> </para> <para> èÇÕáÉ ÇäæçÇêÉ ääåÌåèÙÉ Óèá ÊÊÖåæ åÈÇÔÑÉ åÄÔÑ Ó×Ñ ÌÏêÏ Åæ ãÇæ åèÌèÏÇë. ãåÇ ÃæçÇ ÓÊÚæê Ùæ èÌèÏ ÇäáÇÕäÉ Çäåæâè×É ; ÈÙÏ ÂÎÑ ÃåÑ ¬ áäæ ÊÍÊÇÌ Åäé ÅÖÇáÉ ÇäáÇÕäÉ Çäåæâè×É äÅæçÇÁ ÂÎÑ ÃåÑ áê ÇäåÌåèÙÉ âÈä èÇÕáÉ ÇäÅâáÇä.</para> <para>ÊÓåÍ äã PHP ÈÇÓÊÎÏÇå ÇäÔãä ÇäÊÇäê :<example><title>ÕêÚÉ å×èÑÉ</title> <programlisting role="php"> <![CDATA[ <?php if ($expression) { ?> <strong>This is true.</strong> <?php } else { ?> <strong>This is false.</strong> <?php } ?>]]> </programlisting> </example> êÙåä ÊåÇåÇë ãåÇ çè åÊèâÙ¬ äÃæ åáÓÑ PHP ÙæÏåÇ êÌÏ èÇÕáÉ ÇäÅâáÇä ?> , êÈÏà ÈÈÓÇ×É ÊåÑêÑ ãä åÇ êäê Ðäã ãåÎÑÌÇÊ ÍÊé êÌÏ èÇÕáÉ ÈÏÁ ÃÎÑé. ÇäåËÇä ÇäåÙ×é çæÇ åÎÊÑÙ ÈÇäÊÃãêÏ äêÓÊÚä çÐç ÇäåêÒɬ äãæç åÙñÏ ÃÓÇÓÇë áê ÍÇäÉ ÇäÑÚÈÉ áê ÊåÑêÑ ãåêÉ ãÈêÑÉ åæ ÇäæÕ¬ ÅÐ Ãæ ÅÎÑÇÌ ÇäæÕ ÈçÐç Çä×ÑêâÉ êÌæÈ PHP åæ åÍÇèä ÊáÓêÑ ÇäåÍÊèé èçê ÙåèåÇë ×ÑêâÉ áÙÇäÉ ÃáÖä åæ ÇÓÊÎÏÇå <function>echo</function> Ãè <function> print</function> Ãè åÇ ÔÇÈç.</para> </sect1> <sect1 id="language.basic-syntax.instruction-separation"> <title> ×ÑêâÉ áÕä ÇäÃèÇåÑ</title> <simpara> êÊå áÕä ÇäÃèÇåÑ åËäåÇ áê äÚÉ C Ãè Perl ÈÅæçÇÁ ãä ÃåÑ ÈÑåÒ ÇäáÇÕäÉ Çäåæâè×É.</simpara> <para> èÇÕáÉ ÇäÅâáÇä (?>) ÊÙÊÈÑ ÃêÖÇë æçÇêÉ ÇäÌåäɬ ÍêË ÊÄÏê ãäÇ Çä×ÑêâÊêæ ÇäÊÇäêÊêæ æáÓ ÇäÚÑÖ:<informalexample> <programlisting role="php"> <![CDATA[ <?php echo "This is a test"; ?> <?php echo "This is a test" ?>]]> </programlisting> </informalexample> </para> </sect1> <sect1 id="language.basic-syntax.comments"> <title>ÇäÊÙäêâÇÊ</title> <para> PHP ÊÏÙå ÇÓäèÈ äÚÉ C è C++ è Unix shell-style áê ÇÖÇáÉ ÇäÊÙäêâÇÊ. åËäÇë: <informalexample> <programlisting role="php"> <![CDATA[ <?php echo "This is a test"; // This is a one-line c++ style comment /* This is a multi line comment yet another line of comment */ echo "This is yet another test"; echo "One Final Test"; # This is shell-style style comment ?>]]> </programlisting> </informalexample> </para> <simpara> ÇÓäèÈ ÊÙäêâ "ÇäÓ×Ñ-ÇäèÇÍÏ" áê ÇäÍâêâÉ êÓåÍ ÈÅÖÇáÉ ÊÙäêâ Ãè åäÇÍØÉ ÍÊé æçÇêÉ ÇäÓ×Ñ Ãè ÇäåÌåèÙÉ ÃêçåÇ ÃâÑÈ.</simpara> <informalexample> <programlisting role="php"> <![CDATA[ <h1>This is an <?php # echo "simple";?> example.</h1> <p>The header above will say 'This is an example'. ]]> </programlisting> </informalexample> <simpara> êÌÈ Ãæ Êãèæ ÍÐÑÇë ÃËæÇÁ ÇÓÊÎÏÇå æå× äÚÉ C áê ÇäÊÙäêâÇʬ ÍêË âÏ ÊÍÏË åÔÇãä ÃËæÇÁ åÍÇèäÉ ÅÖÇáÉ ÊÙäêâÇÊ ÈãåêÉ ãÈêÑÉ.</simpara> <informalexample> <programlisting role="php"> <![CDATA[ <?php /* echo "This is a test"; /* This comment will cause a problem */ */ ?>]]> </programlisting> </informalexample> </sect1> </chapter> <!-- 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 --> Index: phpdoc/ar/language/constants.xml +++ phpdoc/ar/language/constants.xml <?xml version="1.0" encoding="iso-8859-6"?> <!-- $EN-Revision: 1.24 $ --> <chapter id="language.constants"> <title>ÇäËèÇÈÊ</title> <simpara> ÇäËÇÈÊ çè ÑåÒ åÙÑñá äâêåÉ åǬ èãåÇ çè èÇÖÍ åæ ÇäÊÓåêÉ áÅæ ÇäâêåÉ äÇ êåãæ Ãæ ÊÊÚêÑ ÎäÇä ÊæáêÐ ÇäÈÑæÇåÌ. ('ÇäËèÇÈÊ ÇäååêÒÉ' <constant>__FILE__</constant> è <constant>__LINE__</constant> ÊÈÏè ÇÓÊËæÇÁ äçÐç ÇäâÇÙÏɬ äãæçÇ äêÓÊ ËèÇÈÊ áÙäêÇë.) ÇäËÇÈÊ êÊÃËÑ ÈÍÇäÉ ÇäÍÑèá ÇäÕÚêÑÉ èÇäãÈêÑÉ ÇáÊÑÇÖêÇë. èâÏ ÌÑÊ ÇäÙÇÏÉ Ãæ Êãèæ ÇäËèÇÈÊ ÏÇÆåÇë ÈÃÍÑá ãÈêÑÉ . </simpara> <para> ÇÓå ÇäËÇÈÊ êÊÈÙ æáÓ ÇäÔÑè× äÃê ÊÓåêÉ áê äÚÉ ÇäÈê ÅÊÔ Èê. ÇäÇÓå ÇäÕÍêÍ ääËÇÈÊ êÈÏà ÈÍÑá Ãè ÔÑ×É Óáäêɬ åÊÈèÙÉ ÈÃê ÙÏÏ åæ ÇäÍÑèᬠÇäÃÑâÇå Ãè ÇäÔÑ× ÇäÓáäêÉ . èÈÊÙÈêÑ âêÇÓê êåãæ ÊåËêä âÇÙÏÉ ÇÓå ÇäËÇÈÊ çãÐÇ :<literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> <!-- TODO: Example of valid & invalid constant names --> </para> <note> <simpara> çæÇ ÓæÙÊÈÑ ÇäÍÑá çè ÃÍÏ ÇäÍÑèá ÇäçÌÇÆêÉ ÇäÇæÌäêÒêÉ a-z è A-Z èÑåèÒ ASCII ÐÇÊ ÇäâêåÉ åæ 127 èÍÊé 255 (Ox7f-Oxff). </simpara> </note> <simpara> åÏé (æ×Çâ) ÇÓÊÎÏÇå ÇäËÇÈÊ åÏéë ÔÇåä¬ ÍêË ÊÓÊ×êÙ ÇäèÕèä Åäêç åæ Ãê åãÇæ ÏÇÎä ÈÑæÇåÌã Ïèæ ÇçÊåÇå ääåÏé.</simpara> <sect1 id="language.constants.syntax"> <title>ÇäÕêÚÉ</title> <simpara> ÊÓÊ×êÙ Ãæ ÊÙÑá ËÇÈÊÇë ÈÇÓÊÎÏÇå ÏÇäÉ <function>define</function>. ÍêæåÇ êÊå ÊÙÑêá ÇäËÇÈÊ äÇ êåãæ ÙæÏÆÐ Ãæ êÊÚêÑ Ãè êÒÇä ÊÙÑêáç. </simpara> <simpara> ÇäÈêÇæÇÊ ÇäâêÇÓêÉ áâ× (<type>boolean</type>, <type>integer</type>, <type>double</type> è <type>string</type>) êåãæ ÇÓÊÎÏÇåçÇ áê ÇäËèÇÈÊ. </simpara> <simpara> ÊÓÊ×êÙ ÇäÍÕèä Ùäé âêåÉ Ãê ËÇÈÊ Ùæ ×Ñêâ ÊÍÏêÏ ÇÓåç ÈÈÓÇ×ç. Ùäé ÙãÓ ÇäåÊÚêÑÇʬ êÌÈ Ãæ <emphasis>äÇ</emphasis> ÊÓÈâ ÇäËÇÈÊ ÈÙäÇåÉ<literal>$</literal> ÊÓÊ×êÙ ÇÓÊÎÏÇå ÇäÏÇäÉ <function>constant</function>¬ äâÑÇÁÉ âêåÉ ÇäËÇÈʬ ÇÐÇ ãæÊ ÊÑÚÈ áê ÇÓÊÎÏÇå ÇÓå ÇäËÇÈÊ ÏêæÇåêãêÇë. ÊÓÊ×êÙ ÇêÖÇë ÇÓÊÎÏÇå <function>get_defined_constants</function> ääÍÕèä Ùäé âÇÆåÉ Èãä ÇäËèÇÈÊ ÇäåÙÑáÉ . </simpara> <note> <simpara> ÇäËèÇÈÊ è ÇäåÊÚêÑÇÊ (ÇäÔÇåäÉ) ÊâÙ áê åèÇâÙ åÎÊäáɬ ååÇ êæÊÌ Ùæ Ðäã åËäÇë ãèæ &true; è <varname>$TRUE</varname> åÎÊäáÇæ ÊåÇåÇë.</simpara> </note> <simpara> ÙæÏåÇ ÊÓÊÎÏå ËÇÈÊÇë ÚêÑ åÙÑᬠáÓêáÊÑÖ PHP Ãæã ÊÙæê ÇÓÊÎÏÇå ÇÓå ÇäËÇÈÊ æáÓç èäêÓ ÇäâêåÉ. Óèá êÕÏÑ <link linkend="features.error-handling">ÊæÈêç</link> ÙæÏåÇ ÊÍÏË åËä çÐç ÇäÍÇäÉ. äÐäã êåãæã ÇÓÊÎÏÇå ÇäÏÇäÉ <function>defined</function> ÇÐÇ ÃÑÏÊ Ãæ ÊÙÑá åÇ ÅÐÇ ãÇæ ÇäËÇÈÊ âÏ Êå ÊÙÑêáç.</simpara> <para> çÐç çê ÇäÇÎÊäÇáÇÊ Èêæ ÇäËèÇÈÊ èÇäåÊÚêÑÇÊ : <itemizedlist> <listitem> <simpara> ÇäËèÇÈÊ äÇ ÊÓÊÎÏå ÙäÇåÉ ÇäÏèäÇÑ (<literal>$</literal>) âÈäçÇ» </simpara> </listitem> <listitem> <simpara> ÇäËèÇÈÊ êåãæ Ãæ êÊå ÊÙÑêáçÇ áâ× åæ ÎäÇä ÇäÏÇäÉ <function>define</function>, èäêÓ Ùæ ×Ñêâ ÊÙêêæ ÈÓê×; </simpara> </listitem> <listitem> <simpara> ÇäËèÇÈÊ êåãæ ÊÙÑêáçÇ èÊÎÕêÕçÇ áê Ãê åãÇæ Ïèæ ÇäÇçÊåÇå ÈÔÑè× åÏé ÇäåÊÚêÑÇÊ» </simpara> </listitem> <listitem> <simpara> ÇäËèÇÈÊ äÇ êåãæ ÅÙÇÏÉ ÊÙÑêáçÇ Ãè ÅÒÇäÉ ÊÙÑêáçǬ ÙæÏåÇ êÊå ÊÙÑêáçÇ åÑÉ ÊÕÈÍ åÙêæÉ ÈÔãä æçÇÆê» </simpara> </listitem> <listitem> <simpara> ÇäËèÇÈÊ êåãæ Ãæ ÊâÏÑ Èâêå âêÇÓêÉ áâ×.</simpara> </listitem> </itemizedlist> </para> <para> <example> <title>ÊÙÑêá ÇäËèÇÈÊ</title> <programlisting role="php"> <![CDATA[ <?php define("CONSTANT", "Hello world."); echo CONSTANT; // outputs "Hello world." echo Constant; // outputs "Constant" and issues a notice. ?>]]> </programlisting> </example> </para> </sect1> <sect1 id="language.constants.predefined"> <title>ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë</title> <simpara> ÊÒèÏ PHP ÙÏÏÇë ãÈêÑÇë åæ ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë äÃê ÈÑæÇåÌ êæáÐ. ÇäÙÏêÏ åæ çÐç ÇäËèÇÈÊ ÙåèåÇë ÊæÔà ÈèÇÓ×É ÇäÙÏêÏ åæ ÇäÇåÊÏÇÏÇÊ (extensions)¬ èÊãèæ ÍÇÖÑÉ ÙæÏåÇ Êãèæ çÐç ÇäÇåÊÏÇÏÇÊ åÊèáÑÉ áâ׬ ÅåÇ ÙÈÑ ÊÍåêäçÇ ÏêæÇåêãêÇë Ãè Ãæ Êãèæ åÏåÌÉ ÃËæÇÁ ÇäÊÑãêÈ. </simpara> <simpara> âÇÆåÉ ÈÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë åèÌèÏÉ áê çÐÇ ÇäâÓå <link linkend="reserved.constants">ÇäËèÇÈÊ ÇäåÙÑáÉ åÓÈâÇë</link> </simpara> </sect1> </chapter> <!-- 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 -->