cvs: phpdoc-fa /language basic-syntax.xml

psalehpoor Tue Jun 24 17:26:52 2008 UTC Added files: /phpdoc-fa/language basic-syntax.xml Log: translation to persian

http://cvs.php.net/viewvc.cgi/phpdoc-fa/language/basic-syntax.xml?view=markup&rev=1.1 Index: phpdoc-fa/language/basic-syntax.xml +++ phpdoc-fa/language/basic-syntax.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.52 Maintainer: pedram Status: ready --> <!-- $Revision: 1.1 $ --> <chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook"> <title>دستور اصلی</title> <sect1 xml:id="language.basic-syntax.phpmode"> <title>انتقال از HTML</title> <para> زمانی که PHP یک فایل را پردازش می‌نماید بدنبال برچسب شروع و پایان می‌گردد تا کد میان آنها را تفسیر کند. تحلیل به این شکل به PHP این امکان را می‌دهد تا تا در تمام انواع اسناد بکار رود زیرا هر چیزی خارج از آن برچسب‌ها نادیده گرفته می‌شود. بیشتر اوقات شما PHP را در داخل فایل‌های HTML خواهید دید همانطور که این مثال نشان داده است. <informalexample> <programlisting role="php"> <![CDATA[ <p>This is going to be ignored.</p> <?php echo 'While this is going to be parsed.'; ?> <p>This will also be ignored.</p> ]]> </programlisting> </informalexample> </para> <para> شما همچنین می‌توانید از شاختارهای پیشرفته‌تری نیز استفاده کنید: <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 ?&gt; را مشاهده می‌نماید و بسادگی هر چه را مشاهده نمود به خروجی می‌فرستد (به جز خط جدید بلافاصله پس از آن <link linkend="language.basic-syntax.instruction-separation">جداسازی دستورالعمل‌ها</link> را ببینید ) تا زمانی که به برچسب شروع جدیدی رسد. مثال داده شده در این جا مثال داده شده مصنوعی است اما برای ارسال یک بلوک بزرگ از داده‌ها خروج از حالت PHP بهینه‌تر از ارسال تمام متن از طریق <function>echo</function> یا <function>print</function> است. </para> <para> چهار زوج مختلف برچسب شروع و پایان برای استفاده در PHP وجود دارد. دو تای آنها &lt;?php ?&gt; و &lt;script language="php"&gt; &lt;/script&gt;, همیشه موجود هستند. دو تای دیگر برچسب‌های خلاصه شده هستند که می‌توان آنها را در فایل تنظیمات &php.ini; خاموش یا روشن نمود. با وجود مناسب بودن برچسب‌های کوتاه و برچسب‌های شیوه <productname>ASP</productname> برای بعضی از افراد آنها قابلیت حمل کمتری داشته و عموما توصیه نمی‌شوند. <note> <para> همچنین توجه نمایید اگر می‌خواهید PHP را در XML و XHTML قرار دهید شما باید از برچسب‌های &lt;?php ?&gt; برای پیروی از استانداردها استفاده نمایید. </para> </note> </para> <para> <example> <title>برچسب‌های شروع و پایان PHP</title> <programlisting role="php"> <![CDATA[ 1. <?php echo 'if you want to serve XHTML or XML documents, do like this'; ?> 2. <script language="php"> echo 'some editors (like FrontPage) don\'t like processing instructions'; </script> 3. <? echo 'this is the simplest, an SGML processing instruction'; ?> <?= expression ?> This is a shortcut for "<? echo expression ?>" 4. <% echo 'You may optionally use ASP-style tags'; %> <%= $variable; # This is a shortcut for "<% echo . . ." %> ]]> </programlisting> </example> </para> <para> با وجود این که برچسب‌های نشان داده شده در مثال اول و دوم هر دو موجود هستند برچسب استفاده شده در مثال اول معمول‌تر است و استفاده از آن توصیه می‌گردد. </para> <para> برچسب‌های کوتاه (مثال سوم) تنها زمانی در اختیار شما قرار دارد که از طریق شبه جمله فایل تنظیمات <link linkend="ini.short-open-tag">short_open_tag</link> در &php.ini; فعال شده باشد و یا گزینه <option>--enable-short-tags</option> در PHP بکار رود. </para> <para> برچسب‌های شیوه <productname>ASP</productname> (مثال چهار) تنها در صورتی موجود است که از طریق شبه جمله فایل تنظیمات <link linkend="ini.asp-tags">asp_tags</link> در &php.ini;فعال شده باشد. </para> <para> <note> <para> استفاده از برچسب‌های کوتاه در حین تولید کتابخانه‌ها برنامه‌های برای فروش مجدد خودداری گردد. زیرا برچسب‌های کوتاه ممکن است در سرور مقصد پشتیبانی نشده باشند. برای قابلیت حمل کد ارائه شده از برچسب کوتاه استفاده ننمایید. </para> </note> </para> </sect1> <sect1 xml:id="language.basic-syntax.instruction-separation"> <title>جداسازی دستورالعمل‌ها</title> <para> همانند C یا Perl PHP نیازمند پایان هر خط کد با استفاده از ; است. برچسب پایانی کد PHP بطور خودکار یک ; دریافت می‌نماید. برچسب پایانی برای بلوک خط جدید را نیز در صورت وجود منظور می‌نماید. <informalexample> <programlisting role="php"> <![CDATA[ <?php echo 'This is a test'; ?> <?php echo 'This is a test' ?> <?php echo 'We omitted the last closing tag'; ]]> </programlisting> </informalexample> <note> <para> برچسب پایانی PHP در پایان فایل اختیاری است و در بعضی حالات حذف آن هنگام استفاده از <function>include</function> یا <function>require</function> مفید بوده و خطوط خالی انتهای فایل حذف می‌نماید و شما می‌توانید درادامه به انتهای فایل‌ها header اضافه نمایید و همچنین در صورت بافر نمودن خروجی به شما کمک کرده و خطوط خالی فایل‌های اضافه شده را از بین می‌برد. </para> </note> </para> </sect1> <sect1 xml:id="language.basic-syntax.comments"> <title>توضیحات</title> <para> PHP از توضیحات 'C' 'C++' و Unix shell-style (Perl 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 a one-line shell-style comment ?> ]]> </programlisting> </informalexample> </para> <simpara> توضیح خطی در پایان خط خاتمه یا بلوک PHP خاتمه می‌یابد. کد HTML پس از <literal>// ... ?&gt;</literal> یا <literal># ... ?&gt;</literal> چاپ خواهد شد ?&gt; از حالت PHP خارج شده و وارد حالت HTML می‌شود و <literal>//</literal> یا <literal>#</literal> بر آن اثر نمی‌گذارد. اگر شبه جمله فایل تنظیمات <link linkend="ini.asp-tags">asp_tags</link> فعال شده باشد همانند <literal>// %&gt;</literal> و <literal># %&gt;</literal> رفتار می‌نماید. به هر حال برچسب <literal>&lt;/script&gt;</literal> از حالت PHP در توضیح یک خطی خارج نخواهد شد. </simpara> <para> <informalexample> <programlisting role="php"> <![CDATA[ <h1>This is an <?php # echo 'simple';?> example.</h1> <p>The header above will say 'This is an example'.</p> ]]> </programlisting> </informalexample> </para> <simpara> توضیحات شیوه 'C' در اولین <literal>*/</literal> خاتمه می‌یابد. مطمئن باشید که توضیحات شیوه 'C' را در داخل یکدیگر بکار نبرید. بسادگی ممکن است هنگام توضیحی نمودن یک بلوک بزرگ دچار اشتباه گردید. </simpara> <para> <informalexample> <programlisting role="php"> <![CDATA[ <?php /* echo 'This is a test'; /* This comment will cause a problem */ */ ?> ]]> </programlisting> </informalexample> </para> </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 -->