خطای Syntax یا Parse Error یعنی PHP نمی‌تواند ساختار کد را به‌درستی تجزیه کند. یک کوتیشنِ ناقص، براکتِ بسته‌نشده یا دستور ناسازگار با نسخهٔ PHP می‌تواند مانع بارگذاری سایت شود. پیش از ویرایش، متن خطا و نسخهٔ فعلی فایل را خصوصی نگه دارید.
مسیر و شمارهٔ خط را درست بخوانید
پیام معمولاً فایل و شمارهٔ خط را نشان می‌دهد. آن خط ممکن است محل آشکارشدن خطا باشد، نه محل شروع اشتباه؛ برای نمونه یک کوتیشن باز در چند خط بالاتر می‌تواند باعث خطای بعدی شود. واژهٔ unexpected هم همیشه به معنی نبودن «تابع پایانی» نیست. متن دقیق پیام و تغییر اخیر را کنار هم بررسی کنید.
اول نسخهٔ سالم و تغییر اخیر را پیدا کنید
- مشخص کنید آخرین ویرایش، نصب یا آپدیت چه بوده است.
- پوشهٔ نصب درست را از روی دامنه و مسیر تأیید کنید.
- نسخهٔ فعلی و نسخهٔ سالمِ همان فایل را بیرون از دسترس عمومی نگه دارید.
- تفاوت را بررسی کنید؛ خط اعلام‌شده را فقط برای ناپدیدشدن خطا پاک نکنید.
خطاهای رایج هنگام کپی کد
کوتیشن‌های تزئینی با کوتیشن مستقیم PHP یکسان نیستند. حذف سمی‌کالن، بسته‌نشدن پرانتز یا قرارگرفتن کد بیرون از بخش مناسب نیز می‌تواند خطا بسازد. اگر قطعه‌کد برای نسخهٔ دیگری نوشته شده، پشتیبانیِ همان نحو در نسخهٔ PHP سایت را کنترل کنید. ویرایش یک فایل هسته برای پنهان‌کردن مشکل افزونه انتخاب مناسبی نیست.
آزمون نحو بدون اجرای فایل
php -l /path/to/file.phpطبق راهنمای گزینه‌های خط فرمان PHP، گزینهٔ lint ساختار را بررسی می‌کند؛ این فرمان عملکرد برنامه را آزمایش نمی‌کند. مسیر نمونه را با فایل واقعی جایگزین کنید و نسخهٔ PHP خط فرمان را با نسخهٔ وب تطبیق دهید. تأیید نحو با یک نسخه، سازگاری همهٔ نسخه‌ها را ثابت نمی‌کند.
اگر پیشخوان باز نمی‌شود
با دسترسی مجاز فایل، اصلاح را از روی نسخهٔ شناخته‌شده انجام دهید. اگر خطا دقیقاً از افزونهٔ تازه است، توقف محدود آن می‌تواند دسترسی را برای بررسی برگرداند؛ اثرش را بر خدمات بشناسید. تغییر نام قالب فعال بدون داشتن جایگزین سازگار، راه‌حل عمومی نیست. در صورت ابهام، فایل و پیامِ پالایش‌شده را به توسعه‌دهندهٔ مجاز بدهید.
بعد از رفع خطای Syntax
ورود، صفحهٔ اصلی و همان عملیاتی را که خطا ایجاد کرد دوباره آزمون کنید. لاگ تازه را هم بررسی کنید؛ ممکن است پس از عبور از Parse Error، خطای اجرایی دیگری آشکار شود. فایل‌های پشتیبان دارای اطلاعات حساس را در پوشهٔ عمومی باقی نگذارید و علت اصلاح را ثبت کنید. نبود پیام نحو فقط آغاز تأیید است، نه تضمین سلامت همهٔ سایت.
راهنمای مرتبط
بازبینی فنی و منابع: ۲۷ مهر ۱۴۰۵. تاریخ انتشار اولیه و مسیر قبلی حفظ شده‌اند.
