شاید برای شما اتفاق افتاده که وقتی افزونه‌ای را آپدیت می‌کنید یا اینکه نسخه جدید قالب خود را روی سایت بارگزاری می‌کنید با خطای syntax error یا همان خطای parse error مواجه شده .
این خطا را با نام‌های دیگری در وردپرس همچون ارور syntax یا parse error در وردپرس شناخته می شود که دلیل رخ دادن این خطا در کدنویسی و ایجاد اختلال در بین کدهای وردپرس است. این اختلال می‌تواند به یکی از دلایل زیر رخ دهد:
- وجود خطا در افزونه خاص یا ایجاد ناهماهنگی یک افزونه با سایر افزونه‌ها
- وجود خطا در کدنویسی قالب یا ایجاد ناهماهنگی بین قالب و افزونه خاصی در وردپرس
- ایجاد تغییرات در فایل‌های هسته خود وردپرس و به وجود آمدن ناهماهنگی
رفع خطای syntax error در وردپرس
پیش از هر چیز باید ابتدا این خطا را بشناسیم و سپس با استفاده از آدرس‌دهی و سیگنالی که خود این خطا به ما می‌دهد بدانیم مشکل دقیقا به چه فایلی برمی‌گردد. ابتدا به تصویر زیر دقت کنید.
همانطور که در تصویر مشاهده می‌کنید بخش‌هایی مثل parse error، syntax error، unexpected، نام فایل(های) مواجه شده با خطا و در نهایت خطی که در فایل ذکر شده این خطا را دارد مواجه هستیم. اگر بخواهیم توضیحات بیشتر در این خصوص ارائه کنیم به شرح زیر است.
- parse error: این خط که در ابتدا به ما نمایش داده می‌شود نشان دهنده این است که کدهای برنامه نویسی در وردپرس دچار اختلال شده‌اند. گاهی اوقات این خط با fatal error نیز نمایش داده می‌شود که در این صورت هم باز به همین شکل باید عمل کنید. بنابراین اگر با خطای fatal error در وردپرس مواجه شدید، این آموزش هم برای رفع چنین خطایی کاربرد دارد.
- syntax error: با نمایش دادن این بخش وردپرس به ما می‌گوید که نوع خطا از نوع این هست که کدهای برنامه نویسی به درستی استفاده نشده‌اند.
- unexpected: این پیغام زمانی نمایش داده می‌شود که خطای رخ داده به دلیل عدم استفاده از توابع کد نویسی باشد. به عنوان مثال در همین تصویر بالا از کاراکتر > که بعد از این کلمه نمایش داده شده نشان دهنده این است که خطا به دلیل استفاده نادرست از این کاراکتر است. حال باید بررسی کرد و ببینیم که آیا اشتباهاً از < استفاده شده یا اینکه اصلا فراموش کردیم از > استفاده کنیم.
- آدرس فایل: بخش بعدی شامل آدرس فایل است که در هاست مسیردهی شده است. در اینجا مسیر ما مربوط به پوسته فرزند قالب است که باعث به وجود آمدن این خطا شده است. بنابراین می‌دانیم که مشکل از سمت قالب بوده و افزونه‌ها باعث به وجود آمدن ارور syntax error در وردپرس نشده‌اند.
- نام فایل: بعد از آدرس فایل نام فایل مشخص می‌شود که کدام فایل با این خطا مواجه است. در مرحله قبل برای این تصویر مشخص شد که مشکل از سمت قالب فرزند است؛ اما مشکل دقیقا مربوط به چه فایلی می‌شود؟ در ادامه نام فایل functions.php به ما نمایش داده شده که باید این فایل را باز کنیم.
- شماره خط: در نهایت که تا اینجا فهمیدیم مشکل از چه فایلی است، نهایتاً شماره خطی که با این خطا مواجه است به ما نمایش داده شده که در این مثال خط 17 با خطا مواجه شده. حالا باید خط 17 فایل functions.php را بررسی کنیم و ببینیم که کاراکتر > به چه شکلی استفاده شده یا اینکه اصلا وارد نشده که باعث به وجود آمدن این خطا شده است.
حال تا اینجا دانش کافی برای برطرف کردن ارور syntax بدست آوردیم .
ارور syntax در پیشخوان وردپرس
تقریبا از نسخه 4 وردپرس قابلیت شناسایی و نمایش خطا در هنگام استفاده از ویرایشگر افزونه و ویرایشگر قالب از طریق پیشخوان وردپرس نیز به بخش مدیریتی اضافه شد. یعنی زمانی که در حال تغییر کدها از طریق پیشخوان هستید، اگر اشتباهاً کدنویسی انجام گیرد، وردپرس این مورد را شناسایی کرده و از اینکه فایل را با تغییرات جدید ذخیره کند، جلوگیری می‌کند. در این صورت با صفحه‌ای مشابه تصویر زیر مواجه خواهید شد.
همانطور که در توضیحات خطا می‌بینید در اینجا هم مشخص شده فایلی که در حال ویرایش آن هستیم، یعنی فایل functions.php که برای قالب twentyseventeen می‌باشد در خط 588 دارای خطایی می‌باشد و از آنجایی که در بخش انتهایی و علاوه بر این در همین خط ویرایشگر هم قابل مشاهده است، از کاراکتر ! به صورت نادرست استفاده شده که وردپرس از ذخیره کردن تغییرات در این فایل جلوگیری کرده و به شما هشدار می‌دهد که خطا را برطرف کرده و سپس روی دکمه ذخیره تغییرات کلیک کنید.