برای اتصال یک فایل اضافی به یک اسکریپت PHP ، از عملکرد ویژه شامل استفاده کنید. پس از اتصال یک سند خارجی ، برنامه نویس این فرصت را دارد که از کد نوشته شده یا سایر مطالب موجود در برنامه فعلی استفاده کند.
شامل عملکرد
شامل دستور زیر است:
شامل "نام پرونده" ؛
نام یک مسیر نسبی یا مطلق با پسوند سند موجود است. اگر مکانی مشخص نشده باشد ، PHP به طور خودکار محتویات پیکربندی php.ini را بررسی می کند ، که شامل include_path است - دایرکتوری که می توان کتابخانه های اضافی را در آن قرار داد. اگر دستورالعمل خالی باشد یا پرونده مورد نیاز در مسیر مشخص شده در آن پیدا نشود ، عبارت شامل نمی شود.
پس از فعال شدن ، می توانید از محتوای مورد نظر خود در اسکریپت استفاده کنید ، متغیرها را اختصاص دهید ، از ساختارهای اعلام شده استفاده کنید و غیره به عنوان مثال ، 2 پرونده 1.php و 2.php وجود دارد. محتوای 1.php به این شکل است:
<؟ php
$ firstly = "متغیر از پرونده اول"؛
$ secondly = "مقدار وارد شده"؛
?>
برای قرار دادن متغیرهای فوق در 2.php ، می توانید عملیات زیر را انجام دهید:
<؟ php
شامل "1.php" ؛
اولاً echo $؛
$ emerge = "$ secondly"؛
echo $ ظهور؛ ؟>
در این اسکریپت از فایل دوم ، دستور شامل شامل محتویات سند اول است و پس از آن از متغیرهای اعلام شده در 1.php برای نمایش مقادیر لازم در صفحه استفاده می شود.
شامل می تواند در ابتدای پرونده و داخل عملکرد اعلام شده در هر قسمت از سند استفاده شود. استفاده از این عملکرد برای اتصال فایلهای واقع در یک سرور از راه دور نامطلوب است. اگر می خواهید این ویژگی را پیاده سازی کنید ، باید گزینه allow_url_fopen را در پرونده php.ini در سرور محلی یا راه دور خود فعال کنید.
نیاز
تابع نیاز مشابه است که شامل می شود. دستورات از نظر نحوی و فناوری اجرا تفاوتی ندارند. تنها تفاوت این است که اگر پرونده مشخص نشده باشد ، اسکریپت مورد نیاز را خاتمه می دهد ، در حالی که شامل اجرای اسکریپت را ادامه می دهد و هشدار مربوط به E_WARNING را نمایش می دهد ، که می تواند با استفاده از کاراکتر ویژه @ سرکوب شود مثلا:
<؟ php
نیاز به "1q.php" ؛
echo "اسکریپت متوقف می شود" ؛ ؟>
در این مثال ، مسیر سند 1q.php موجود نیست. اگر پرونده از دست رفته باشد ، اسکریپت دستور echo را اجرا نمی کند و صفحه کاربر یک صفحه خالی یا یک پیام خطا (بسته به تنظیمات php.ini) نمایش می دهد. اگر کد مشابهی را با استفاده از کد زیر وارد کنید:
<؟ php
شامل "1q.php" ؛
echo "متن ادامه دارد" ؛ ؟>
دستور echo اجرا می شود و متن مربوطه بر روی صفحه نمایش ظاهر می شود.