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
-->