آموزش کار با دستور include در PHP

آموزش کار با دستور include و require در PHP

دستور include و require کلیه متن،کد یا تگ های موجود در فایل تعیین شده برای آن را گرفته و در فایل استفاده کننده از دستور کپی می کند. از دستور های include و require برای تکرار یک دستور یا محتوی تکراری در درون چند صفحه استفاده می شودو عملکردی مانند قابلیت متدپیج در Asp.Netدارد.
به عبارت دیگر دستور include زمانی بسیار کاربرد دارد که می خواهید محتویات یکسانHTML ٬ PHP یا متنی را درون چندین صفحه یک وب سایت عینا تکرار کنید.
این امکان وجود دارد که با استفاده از دستورات include یا require محتویات یک فایل PHP را درون یک فایل PHP دیگر وارد نمایید)قبل از این که سرور فایل مقصد را خوانده و اجرا کند.)
عملکرد دستورات include و require کاملا شبیه هم هستند و تنها تفاوت آن ها واکنش در هنگام بروز خطاست که به صورت زیر تقسیم می شوند:

• دستور require در هنگام بروز خطا یک error کامل (fatal) بروز داده مثل (E_COMPAE_ERRO) و اجرای اسکریپت را متوقف می کند.
• دستور include در هنگام بروز خطا یک هشدار یا warning مثل (E_WARNING) صادر کرده و به اجرای اسکریپت ادامه می دهد.

بنابراین اگر می خواهید اجرای صفحات همواره ادامه داشته و خروجی را به کاربر نشان دهد حتی اگر صفحه یا فایل دستور include گم شده یا قابل خواندن نباشد باید از دستور include استفاده کنید.
از طرف دیگر در موار کار با فریم ورک ها٬ CMS ها و یا نرم افزارهای کامل تحت PHP از دستور require استفاده کنید تا همواره مطمئن شوید که فایل تعیین شده برای کپی در صفحات در روند اجرای برنامه قرار گیرد.
استفاده از دستور require امنیت برنامه PHP و تمامیت آن همواره حذف شود زیرا کاربر نمی تواند باحذف عمدی یا اتفاقی یک فایل کلیدی یا بخشی از کد٬ صفحات را اجرا کند.
برای درک بهتر یک مثال می زنیم.فرض کنید بخش چک کردن هویت کاربر از طریق یک دستور require به تمامی صفحات کپی می شود. اگر از دستور include استفاده شود کاربر می تواند فایل مربوط به دستورات هویت را پاک کرده و صفحه را بدون آن اجرا نموده و مسئله هویت را دور بزند. اما در صورت استفاده از دستور require در صورت پاک شدن فایل کد هویت دیگر پروژه اجرا نخواهد شد و امنیت آن به خطر نمی افتد.
استفاده از دستورات include و require حجم زیادی از کار را کاهش می دهد به این معنا که می توانید بخش های زیادی مثل هدر٬ فوتر و منو را در فایل های مجزا تولید کرده و آن را در تمامی صفحات وب سایتتان فقط با یک دستور ساده استفاده کنید. از طرف دیگر برای به روزرسانی و opdate فقط کافی است فایل اصلی کد را تغییر داده و این تغییر در همه صفحات وب سایت درجا اعمال شده و آپدیت بسیار سریع خواهد بود. ساختار کلی استفاده از دستور include یا require به صورت زیر است:

                    include 'filename';
                    or
                    require 'filename';
                    

مثال های عملی کار با دستور include در PHP:

فرض کنید یک فایل فوتر یکسان به نام "footer.php" برای صفحات خود طراحی کرده ایم که به صورت زیر است:

                        
                        Copyright © 1999-" . date("Y") . " W3Schools.com
";
                        ?>
                    

برای اضافه کردن کد صفحه footer به صفحه مورد نظر از کدی مثل کد زیر استفاده می شود:

                        < html>
                        < body>
                        < h1>Welcome to my home page!
                        < p>Some text.

                        < p>Some more text.
                        
                        < /body>
                        < /html>
                    

فرض کنید کد منوی سایت را همانند کد مثال زیر در یک فایل به نام "menu.PHP" قرار داده ایم:

                        
                        Home -
    HTML Tutorial -
    CSS Tutorial -
    JavaScript Tutorial -
    PHP Tutorial';
                        ?>
                    

تمامی صفحات سایت بایستی از این منو استفاده کنند.در کد مثال زیر نحوه قرار دادن این منو در تمامی صفحات فایل با استفاده ز تگ را نشان داده ایم. بعدا می توانید با CSS استایل و ظاهر منو را نیز تغیر دهید:

فرض کنید یک فایل با نام "vars.PHP" با تعداد متغیر تعریف شده در آن به صورت زیر داریم :

بنابراین اگر فایل "vars.php" رادر یک فایل دیگر include کنیم می توان از این متغیرها در فایل فراخوانی شده استفاده کرد به صورت کد مثال عملی زیر :

                        < html>
                        < body>
                         < h1>Welcome to my home page!
                        
                        < /body>
                        < /html>
                    

مقایسه دستورات require و include در PHP:

همانطور که در ابتدای درس نیز اشاره کردیم٬ از دستور require نیز می توان برای قرار دادن کدهای یک فایل در یک فایل PHP دیگر استفاده کرد.
اما بین این دو دستور یک اختلاف عمده وجود دارد اگر یک فایل را با دستور include در یک فایل دیگر PHP وارد کرده و PHP نتواند فایل include شده را پیدا کند٬ اجرای اسکریپت بدون توجه به نقصان فایل ادامه خواهد داشت.همانند کد زیر:

                        < html>
                        < body>
                        < h1>Welcome to my home page!
                        
                        < /body>
                        < /html>
                    

اما اگر در مثال فوق به جای دستور include از دستور require استفاده کنید در صورت فقدان فایل اضافه شده دستور echo به دلیل صدور خطای fatal یا نابود کننده از سوی فایل مقصد٬ اجرا نخواهد شد و عملیات فایل متوقف می شود. همانند کد زیر:

                        < html>
                        < body>
                        < h1>Welcome to my home page!
                        
                        < /body>
                        < /html>
                    

از دستور require زمانی استفاده کنید که می خواهید فایل کپی شده حتما در فایل مقصد PHP وجود داشته و برنامه بدون آن اجرا نشود. اما از دستور include زمانی استفاده کنید که حتی فقدان فایل کپی شده اهمیتی نداشته و اجرای برنامه بدون آن٬ خطر خاصی نداشته باشد.