«خطای تجزیه: خطای نحو، غیرمنتظره» یک خطای متداول در وردپرس است که میتواند صاحبان وبسایتها را نسبت به مراحل بعدی ناامید و نامطمئن کند.
این خطا معمولاً به دلیل خطاهای نحوی در کد PHP ایجاد می شود که وردپرس از آن برای ساخت و راه اندازی صفحات وب پویا خود استفاده می کند.
اگر با این پیام گیج کننده مواجه شدید، نگران نباشید – شما تنها نیستید. در این پست وبلاگ، خطاهای مختلف تجزیه را توضیح خواهیم داد و شما را با نحوه رفع آنها آشنا خواهیم کرد.
اماده ای؟ بیا شروع کنیم.
1 خطای “Parse Error: Syntax Error, Unnexpected” در وردپرس چیست؟
«خطای تجزیه: خطای نحو، غیرمنتظره» خطایی است که زمانی رخ می دهد که وردپرس با یک عنصر غیرمنتظره یا نامعتبر در کد PHP مواجه می شود و از تفسیر و اجرای موفقیت آمیز دستورالعمل ها جلوگیری می کند.
وقتی وردپرس کدهای PHP را تجزیه میکند، به دنبال قوانین و ساختارهای نحوی خاص میگردد تا مطمئن شود که کد معتبر است و میتواند به درستی اجرا شود.
اگر وردپرس با خطا در کد PHP مواجه شود، اجرای کد را متوقف کرده و یک پیام خطا نمایش می دهد.
حالا بیایید خطا را تجزیه کنیم تا بتوانید آن را درک کنید:
- اشتباه نوشتاری: مشکل مربوط به نحو کد شماست که ممکن است منجر به نقض قوانین کدنویسی شده و باعث سردرگمی تجزیه کننده شود.
- غیر منتظره: تجزیه کننده نتوانست چیزی را که در واقع به دنبال آن است پیدا کند و نمی داند چگونه با آن کار کند.
پیام اغلب شامل اطلاعات اضافی مانند شماره خط و مسیر فایل است که به مشخص کردن بخش کد مشکل ساز کمک می کند. بسته به اینکه چه چیزی باعث خطا شده است، خطای واقعی “Parse Error Syntax Error, Unnexpected” در وردپرس ممکن است پایان متفاوتی داشته باشد.
در اینجا چند نمونه آورده شده است:
- خطای نحوی، پایان غیرمنتظره فایل
- خطای نحوی، نشانه غیرمنتظره
- خطای نحوی، متغیر غیرمنتظره
- خطای نحوی، شناسه غیرمنتظره
اکنون که متوجه شدید این خطای تجزیه چیست، اجازه دهید در مورد علل آن صحبت کنیم.
2 دلایل رایج “خطای تجزیه: خطای نحوی، غیرمنتظره” در وردپرس
خطاهای تجزیه به خودی خود در وب سایت شما ظاهر نمی شود. بلکه نتیجه اشتباهی است که در کد وب سایت شما رخ داده است، مانند:
- نقل قول ها یا براکت های بسته نشده: بسته نشدن نقل قول ها یا براکت ها می تواند تجزیه کننده PHP را سردرگم کند.
- شخصیت های گم شده: یک کاراکتر از دست رفته، مانند نقطه ویرگول، علامت نقل قول یا پرانتز، می تواند باعث شود وردپرس کد را اشتباه تفسیر کند و خطا را ایجاد کند.
- نحو نادرست: استفاده از نحو نادرست، مانند استفاده از کلمه کلیدی اشتباه یا قرار دادن یک عبارت در مکان نامناسب نیز می تواند باعث ایجاد خطا شود.
- کد ناسازگار: کدهای ناسازگار مانند کدهای نوشته شده برای نسخه قدیمی PHP نیز می تواند باعث ایجاد خطا شود.
- فایل های خراب یا اصلاح شده: اگر یک فایل اصلی وردپرس یا یک فایل افزونه/موضوع به طور ناخواسته خراب یا اصلاح شده باشد، می تواند خطاهای نحوی ایجاد کند.
این خطا همچنین اغلب در هنگام ویرایش نادرست کد در افزونه وردپرس یا ویرایشگر فایل تم مشاهده می شود.
در مثال بالا، خطای تجزیه به دلیل عدم وجود نقطه ویرگول پس از آن رخ داد true). افزودن نقطه ویرگول از دست رفته به خط ذکر شده، مشکل را با موفقیت برطرف می کند.
به همین ترتیب، اگر با یک “بسته نشده” خطا، و به دنبال آن یک کاراکتر و شماره خط خاص، کد را برای از دست دادن بریسهای فرفری بررسی کنید. در مثال زیر، مهاربند بسته شدن منطبق وجود نداشت.
توجه داشته باشید: برای رفع خطاها در حین ویرایش کد در ویرایشگر فایل وردپرس، به سادگی روی هر نقطه از فایل کلیک کنید، از “Ctrl + Z” (ویندوز) یا “Command + Z” (Mac) برای لغو تغییرات اخیر استفاده کنید و روی “Update File” کلیک کنید. ”
حتی اگر این کار را انجام ندهید، وردپرس هنوز تغییرات را ذخیره نمی کند تا زمانی که کد صحیح باشد. بنابراین، همچنان میتوانید صفحه را بهروزرسانی کنید تا تغییرات قبلی خود را لغو کنید، که بلافاصله مشکل برطرف میشود.
تصحیح خطاهای تجزیه واقعاً دشوار نیست، اما باید بدانید که کد چگونه کار می کند و چگونه آن را ویرایش کنید. با این حال، اگر دانش کدنویسی ندارید، جایگزین خوبی برای حل این مشکل به شما نشان خواهیم داد.
در صورت قفل کردن داشبورد وردپرس خود، به نحوه رفع این مشکل خواهیم پرداخت.
3 نحوه رفع «خطای تجزیه: خطای نحو، غیرمنتظره» در وردپرس
اغلب اوقات، هنگامی که این خطا رخ می دهد، می تواند شما را از داشبورد وردپرس خود قفل کند. در این صورت برای شناسایی منبع این خطا و رفع سریع آن، مراحل زیر را دنبال کنید.
3.1 حالت Debug Mode را فعال کنید
به طور معمول، زمانی که وردپرس شما را از داشبورد مدیریت خود قفل می کند، صفحه خالی با پیامی مشابه این را مشاهده می کنید.
حالت WP Debug به شما کمک می کند تا خطاهای سایت وردپرس خود را شناسایی و اشکال زدایی کنید. هنگامی که حالت اشکال زدایی WP فعال باشد، پیام خطای PHP را به همراه منبع خطا نمایش می دهد.
می توانید اشکال زدایی را از طریق cPanel یا FTP خود فعال کنید. اگر از cPanel استفاده می کنید، آن را باز کنید public_html پوشه در شما مدیر فایل.
در اینجا، برای جستجو به پایین بروید wp-config.php. روی آن کلیک راست کرده و سپس انتخاب کنید “ویرایش”.
در ویرایشگر کد، عبارت را جستجو کنید WP_DEBUG همانطور که در زیر نشان داده شده است.
اطمینان حاصل کنید که تنظیم شده است true. در صورتی که کد در فایل wp-config.php شما گم شده باشد، کد زیر را کپی کرده و در اینجا قرار دهید. در نهایت، فراموش نکنید که روی آن کلیک کنید ذخیره تغییرات دکمه.
define('WP_DEBUG', true);
متوجه خواهید شد که نه تنها خطای بحرانی را دوباره نمایش می دهد، بلکه جزئیات مربوط به خطای مؤثر بر وب سایت شما را نیز در اختیار شما قرار می دهد.
حالا به صفحه خطا رفته و آن را دوباره بارگذاری کنید. پیام خطا با جزئیات بیشتر ظاهر می شود و در اینجا می توانید اطلاعات مربوط به منبع خطا را دریافت کنید.
3.2 در حال ویرایش کد
حالا به فایل مشخص شده در اعلان خطا بروید و فایل را در ویرایشگر کد باز کنید.
توجه داشته باشید: توصیه می کنیم در صورت نیاز به بازگردانی به این نسخه، یک نسخه پشتیبان از این فایل نگه دارید.
در ویرایشگر کد، به خط ذکر شده در خطا بروید. سپس نحو را بررسی کنید و آن را اصلاح کنید. اگر با کد آشنا نیستید، به کمک یک توسعه دهنده نیاز دارید یا برای راهنمایی بیشتر با کارشناسان پشتیبانی Rank Math تماس بگیرید.
پس از ایجاد تغییرات، به وب سایت وردپرس خود بازگردید و صفحه را مجدداً بارگیری کنید. اگر خطا را برطرف کرده باشید، متوجه خواهید شد که صفحه شما به درستی شروع به بارگذاری می کند.
وقتی خطا برطرف شد، آن را باز کنید wp-config.php فایل و برگردانید WP_DEBUG تنظیم مطابق شکل زیر
define('WP_DEBUG', false);
غیرفعال کردن حالت اشکال زدایی ضروری است زیرا می تواند به جلوگیری از قرار گرفتن در معرض اطلاعات حساس در وب سایت شما کمک کند، که می تواند منجر به خطرات امنیتی شود.
3.3 غیرفعال کردن پلاگین/موضوع
اگر نمی توانید راه حل های ارائه شده در این مقاله را دنبال کنید، شاید به این دلیل که با کدنویسی آشنایی ندارید، باید این روش آخر را امتحان کنید.
افزونه/موضوع ایجاد کننده مشکل را با انجام بررسی سلامت یا حالت اشکال زدایی شناسایی کنید، سپس می توانید با غیرفعال کردن افزونه/موضوع مشکل زا، سایت خود را به سرعت بازیابی کنید.
اگر همچنان می توانید به داشبورد وردپرس خود دسترسی داشته باشید، باید افزونه/موضوع خود را غیرفعال کنید.
با این حال، اگر دسترسی به داشبورد وردپرس خود را قفل کرده اید، به آن بروید public_html → wp-content و سپس افزونه ها/موضوعات را در مدیریت فایل خود انتخاب کنید.
در اینجا، نام پوشه مشکل ایجاد پلاگین/موضوع را مطابق شکل زیر تغییر نام دهید.
در حین تغییر نام، فقط می توانید اضافه کنید -قدیمی به نام پوشه، و پس از ذخیره آن، افزونه/موضوع در وب سایت شما غیرفعال می شود.
پس از انجام این کار، به سادگی به وب سایت خود بازگردید و صفحه را بازخوانی کنید. متوجه خواهید شد که وب سایت شما به درستی شروع به کار خواهد کرد.
4 نکاتی برای جلوگیری از خطاهای تجزیه در آینده
در اینجا چند نکته پیشگیرانه ساده وجود دارد که به شما کمک می کند از اشتباهات بعدی جلوگیری کنید.
- افزونه ها و تم های خود را به روز نگه دارید: این کمک می کند تا اطمینان حاصل شود که آنها با آخرین نسخه وردپرس سازگار هستند و حاوی هیچ گونه اشکالی نیستند که می تواند باعث خطا شود.
- افزونه ها را از منابع قابل اعتماد نصب کنید: فقط پلاگین هایی را از منابع معتبر نصب کنید تا خطر نصب افزونه هایی که حاوی کدهای ناسازگار هستند را به حداقل برسانید.
- کد تست به طور کامل تغییر می کند: قبل از استقرار تغییرات کد، آنها را به طور کامل در یک محیط مرحلهبندی آزمایش کنید تا مشکلات احتمالی را شناسایی و برطرف کنید.
- از لینترهای کد و اعتبار سنجی استفاده کنید: برای شناسایی خطاهای نحوی بالقوه و اطمینان از پایبندی کد به بهترین شیوه ها، از خط های کد و اعتبار سنجی استفاده کنید.
- به طور منظم از وب سایت خود نسخه پشتیبان تهیه کنید: به طور منظم از وب سایت وردپرس خود نسخه پشتیبان تهیه کنید تا در صورت بروز مشکل به راحتی آن را به حالت کار بازگردانید.
با رعایت این نکات پیشگیری، امیدواریم وب سایت شما عاری از خطاهای Parse Syntax باشد.
5 نتیجه
نوشتن کد می تواند شکننده باشد، به این معنی که هر اشتباهی می تواند منجر به مشکلات بزرگ شود.
این برای ویرایش مضامین وردپرس یا فایل های افزونه نیز صدق می کند. اگر برنامه نویس نیستید به شما توصیه می کنیم یک حرفه ای استخدام کنید.
اگر در کدنویسی مهارت دارید، از ویرایش مستقیم در ویرایشگر فایل پلاگین یا تم خودداری کنید. در عوض، فایل کد را دانلود کنید و از یک محیط توسعه یکپارچه (IDE) مجهز به استفاده کنید اعتبار سنجی کد. این به شما امکان می دهد تا هر گونه خطای کد را به سرعت پیدا و رفع کنید.
سپس، قبل از آپلود کد در سایت خود، کد را در یک سایت مرحله آزمایش کنید. همیشه از وب سایت خود نسخه پشتیبان تهیه کنید تا در صورت بروز خطاهای تجزیه بتوانید به راحتی نسخه پشتیبان قبلی را بازیابی کنید.
امیدواریم که خطای تجزیه وب سایت خود را با موفقیت برطرف کرده باشید و مطمئن هستیم که این مقاله برای شما مفید بوده است. اگر چنین است، لطفا به ما اطلاع دهید توییت کردن @rankmathseo.