دستور اصلی
PHP Manual

انتقال از HTML

زمانی که PHP یک فایل را پردازش می‌نماید بدنبال برچسب شروع و پایان می‌گردد تا کد میان آنها را تفسیر کند. تحلیل به این شکل به PHP این امکان را می‌دهد تا تا در تمام انواع اسناد بکار رود زیرا هر چیزی خارج از آن برچسب‌ها نادیده گرفته می‌شود. بیشتر اوقات شما PHP را در داخل فایل‌های HTML خواهید دید همانطور که این مثال نشان داده است.

<p>This is going to be ignored.</p>
<?php echo 'While this is going to be parsed.'?>
<p>This will also be ignored.</p>

شما همچنین می‌توانید از شاختارهای پیشرفته‌تری نیز استفاده کنید:

Example #1 انتقال پیشرفته

<?php
if ($expression) { 
    
?>
    <strong>This is true.</strong>
    <?php 
} else { 
    
?>
    <strong>This is false.</strong>
    <?php 
}
?>
این کد همانطور که انتظار می‌رود عمل خواهد کرد زیرا برچسب پایان PHP ?> را مشاهده می‌نماید و بسادگی هر چه را مشاهده نمود به خروجی می‌فرستد (به جز خط جدید بلافاصله پس از آن جداسازی دستورالعمل‌ها را ببینید ) تا زمانی که به برچسب شروع جدیدی رسد. مثال داده شده در این جا مثال داده شده مصنوعی است اما برای ارسال یک بلوک بزرگ از داده‌ها خروج از حالت PHP بهینه‌تر از ارسال تمام متن از طریق echo() یا print() است.

چهار زوج مختلف برچسب شروع و پایان برای استفاده در PHP وجود دارد. دو تای آنها <?php ?> و <script language="php"> </script>, همیشه موجود هستند. دو تای دیگر برچسب‌های خلاصه شده و برچسب‌های استایل ASP هستند که می‌توان آنها را در فایل تنظیمات php.ini خاموش یا روشن نمود. با وجود مناسب بودن برچسب‌های کوتاه و برچسب‌های شیوه ASP برای بعضی از افراد آنها قابلیت حمل کمتری داشته و عموما توصیه نمی‌شوند.

Note:

همچنین توجه نمایید اگر می‌خواهید PHP را در XML و XHTML قرار دهید شما باید از برچسب‌های <?php ?> برای پیروی از استانداردها استفاده نمایید.

Example #2 برچسب‌های شروع و پایان PHP

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 . . ." %>

با وجود این که برچسب‌های نشان داده شده در مثال اول و دوم هر دو موجود هستند برچسب استفاده شده در مثال اول معمول‌تر است و استفاده از آن توصیه می‌گردد.

برچسب‌های کوتاه (مثال سوم) تنها زمانی در اختیار شما قرار دارد که از طریق شبه جمله فایل تنظیمات short_open_tag در php.ini فعال شده باشد و یا گزینه --enable-short-tags در PHP بکار رود.

برچسب‌های شیوه ASP (مثال چهار) تنها در صورتی موجود است که از طریق شبه جمله فایل تنظیمات asp_tags در php.iniفعال شده باشد.

Note:

استفاده از برچسب‌های کوتاه در حین تولید کتابخانه‌ها برنامه‌های برای فروش مجدد خودداری گردد. زیرا برچسب‌های کوتاه ممکن است در سرور مقصد پشتیبانی نشده باشند. برای قابلیت حمل کد ارائه شده از برچسب کوتاه استفاده ننمایید.

Note:

در PHP 5.2 و پیش از آن پارسر اجازه نمی‌دهد که برچسب شروع <?php تنها مورد موجود در فایل باشد. این کار در PHP 5.3 ممکن است.


دستور اصلی
PHP Manual