اجرای کدهای قرار گرفته در یک فایل دیگر، به صورت تنها یک بار در هنگام چندین بار ارجاع به آن (با قابلیت ادامه اجرای کدهای صفحه فعلی در صورت نیافتن صفحه ارجاع داده شده)، با تابع include

اجرای کدهای قرار گرفته در یک فایل دیگر، به صورت تنها یک بار در هنگام چندین بار ارجاع به آن (با قابلیت ادامه اجرای کدهای صفحه فعلی در صورت نیافتن صفحه ارجاع داده شده)، با تابع include_once ، در PHP

در کلید شماره 455 ، تابع include در PHP را معرفی کردیم و گفتیم که با استفاده از آن می توانیم کدهای موجود در یک فایل دیگر (غیر از فایل فعلی) را اجرا کنیم.

هنگامی که ما با تابع include ، چند بار به یک فایل مشخص ارجاع دهیم، آنگاه کدهای آن فایل، به همان تعداد دفعات اجرا می شوند :

بنابراین کد بالا باعث می شود که کدهای فایل kelidestan.php ، سه بار اجرا شوند.

اما ممکن است ما بخواهیم که در صورت چندین بار ارجاع به یک فایل مشخص، ((تنها یک بار)) کدهای آن اجرا شوند. برای این منظور، می توانیم به جای تابع include ، از تابع include_once استفاده نماییم :

بنابراین بر اساس کد PHP بالا، کدهای فایل kelidestan.php ، تنها یک بار اجرا می شوند.

نکته

هنگام استفاده از تابع include_once یا include ، اگر ((صفحه ارجاع داده شده)) مورد نظر پیدا نشود، ادامه کدهای ((صفحه فعلی)) اجرا خواهد شد.

اگر می خواهید که در این مواقع (در صورت نیافتن ((صفحه ارجاع داده شده)))، اجرای کدهای ((صفحه فعلی))، متوقف شود، می توانید از تابع require_once ( کلید شماره 26612 ) یا تابع require ( کلید شماره 26710 ) استفاده نمایید.

مثال

ابتدا یک فایل php با نام kelidestan.php می سازیم که حاوی کدهای PHP زیر می باشد :

کد PHP بالا، ابتدا عبارت kelidestan.com و سپس تگ br را در خروجی چاپ می کند (تگ br برای رفتن به خط جدید است، تا متن های بعدی در خط جدید چاپ شوند).

اکنون در کنار همان فایل kelidestan.php ، فایلی با هر نام دلخواه (مثلا index.php) می سازیم و کدهای PHP زیر را در آن می نویسیم (فعلا از تابع include استفاده کرده ایم) :