خطای سینتکس در وردپرس چیست؟ + دلیل بروز Syntax Error

یکی از خطاهایی که ممکنه هنگام ویرایش کدهای وردپرس با اون مواجه بشید، خطای سینتکس یا Syntax Error هست. این خطا معمولا زمانی اتفاق میفته که در نوشتن کدهای PHP اشتباهی وجود داشته باشه؛ مثلا یک علامت جا افتاده باشه، پرانتزها به درستی بسته نشده باشن یا ساختار یک دستور با قواعد زبان PHP مطابقت نداشته باشه.

بروز خطای سینتکس در وردپرس گاهی باعث میشه بخشی از سایت یا حتی کل سایت از دسترس خارج بشه. به همین دلیل، اگه هنگام اضافه کردن کد به فایل های قالب، افزونه یا فایل functions.php با این خطا مواجه شدید، بهتره بدون عجله و با بررسی دقیق کدها برای رفع اون اقدام کنید.

در این مقاله با خزای سینتکس آشنا خواهیم شد، اینکه چرا در وردپرس اتفاق میفته، چطور میتوانید اون رو تشخیص بدید و برای رفعش چه راهکارهایی وجود داره.

خطای سینتکس در وردپرس به چه معناست؟

خطای سینتکس یا Syntax Error به خطایی گفته میشه که وقتی ساختار یک کد با قواعد زبان برنامه نویسی مطابقت نداشته باشه، ایجاد میشه. هر زبان برنامه نویسی قوانین مشخصی برای نوشتن دستورها داره و حتی جا افتادن یک علامت ساده میتونه باعث بشه کد به درستی اجرا نشه.

در وردپرس، بسیاری از این خطاها به زبان PHP مربوط میشن؛ چون هسته وردپرس، قالب ها و افزونه های اون تا حد زیادی از PHP استفاده می کنن.

برای مثال، فرض کنید یک دستور PHP نوشتید اما در پایان اون علامت سمی کالن (;) رو قرار ندادید. بسته به ساختار کد و نسخه PHP، ممکنه با خطای سینتکس مواجه بشید. همین اتفاق میتونه زمانی رخ بده که پرانتز، آکولاد یا کوتیشن رو به درستی نبسته باشید.

نکته مهم اینه که خطای سینتکس با خطاهای منطقی یا خطاهای زمان اجرا تفاوت داره. در خطای سینتکس، مفسر PHP نمی تونه ساختار کد رو به شکل معتبر تجزیه کنه؛ اما در خطای منطقی، ممکنه کد بدون مشکل اجرا بشه و فقط نتیجه ای که انتظار دارید به دست نیاد.

خطای سینتکس در وردپرس چرا اتفاق می افتد؟

دلایل مختلفی میتونن باعث بروز خطای سینتکس بشن. در بیشتر مواقع، مشکل به تغییراتی مربوط میشه که در کدهای سایت انجام دادید؛ اما گاهی هم ممکنه یک فایل ناقص یا کد ناسازگار باعث بروز خطا بشه.

جا افتادن علامت سمی کالن

در PHP، بسیاری از دستورها با علامت سمی کالن (;) پایان پیدا می کنن. اگه این علامت در جای لازم قرار نگیره، ممکنه مفسر PHP نتونه دستورها رو به درستی تشخیص بده.

برای مثال، کد زیر رو در نظر بگیرید:

<?php

$message = “Hello WordPress”

echo $message;

در این مثال، بعد از مقدار دهی متغیر $message علامت سمی کالن جا افتاده. نسخه صحیح کد به شکل زیر هست:

<?php

$message = “Hello WordPress”;

echo $message;

البته همیشه محل نمایش خطا دقیقا همون جایی نیست که اشتباه اصلی رخ داده. گاهی PHP خطا رو در خط بعدی گزارش میده، چون تازه در اون قسمت متوجه میشه دستور قبلی کامل نشده.

بسته نشدن پرانتز یا آکولاد

پرانتزها و آکولادها نقش مهمی در ساختار کدهای PHP دارن. اگه یکی از اونها باز بمونه و بسته نشه، احتمال بروز خطای سینتکس وجود داره.

برای مثال:

<?php

if ( $is_active ) {

    echo “Plugin is active”;

در این کد، آکولاد مربوط به شرط if بسته نشده. نسخه صحیح به این شکل هست:

<?php

if ( $is_active ) {

    echo “Plugin is active”;

}

وقتی کدهای طولانی می نویسید یا چند شرط تو در تو دارید، بررسی جفت بودن پرانتزها و آکولادها اهمیت بیشتری پیدا می کنه.

استفاده نادرست از کوتیشن ها

برای تعریف رشته های متنی در PHP معمولا از کوتیشن تکی یا دوتایی استفاده میشه. اگه کوتیشن باز بشه اما بسته نشه، ممکنه خطای سینتکس ایجاد بشه.

مثلا کد زیر اشتباه هست:

<?php

$title = “Welcome to WordPress;

در این مثال، کوتیشن دوتایی در انتهای متن بسته نشده. نسخه صحیح به شکل زیر هست:

<?php

$title = “Welcome to WordPress”;

هنگام کپی کردن کد از منابع مختلف هم بهتره به علامت های نقل قول توجه کنید؛ چون گاهی کوتیشن های معمولی با علامت های تایپوگرافیک مشابه جایگزین میشن و در کد قابل استفاده نیستن.

اشتباه هنگام ویرایش فایل functions.php

فایل functions.php یکی از فایل های مهم قالب وردپرس هست که برای اضافه کردن قابلیت های مختلف استفاده میشه. به همین دلیل، اشتباه در کدهای این فایل میتونه روی عملکرد سایت تاثیر بذاره.

اگه کدی رو بدون بررسی به این فایل اضافه کنید، ممکنه پرانتز، سمی کالن یا ساختار شرط ها به درستی نوشته نشده باشه. در چنین شرایطی، احتمال داره سایت با خطای PHP مواجه بشه و حتی صفحه مدیریت وردپرس هم به درستی باز نشه.

برای جلوگیری از این مشکل، بهتره قبل از ویرایش فایل از نسخه اصلی اون یک نسخه پشتیبان تهیه کنید و کدهای جدید رو قبل از انتقال به سایت اصلی بررسی کنید.

ناسازگاری کد با نسخه PHP

گاهی کدی که در یک نسخه از PHP به درستی اجرا میشه، در نسخه قدیمی تر قابل استفاده نیست. در چنین شرایطی، ممکنه با خطاهای نحوی یا خطاهای مرتبط با قابلیت های پشتیبانی نشده مواجه بشید.

البته هر ناسازگاری با نسخه PHP لزوما خطای سینتکس نیست؛ بعضی از این مشکلات به خطاهای زمان اجرا یا فراخوانی قابلیت های پشتیبانی نشده مربوط میشن. بنابراین بهتره متن دقیق خطا و نسخه PHP سایت رو بررسی کنید.

کپی کردن کد اشتباه از اینترنت

کپی کردن کد از آموزش ها و منابع اینترنتی یکی از روش های رایج برای اضافه کردن قابلیت به وردپرس هست. با این حال، اگه کد ناقص باشه، بخشی از اون حذف شده باشه یا برای نسخه متفاوتی از PHP نوشته شده باشه، ممکنه هنگام اجرا مشکل ایجاد کنه.

بهتره کدها رو از منابع معتبر دریافت کنید و قبل از اضافه کردن اونها به سایت اصلی، ساختار و کاربردشون رو بررسی کنید.

چطور خطای سینتکس وردپرس را تشخیص دهیم؟

برای رفع خطا، اول باید متوجه بشید مشکل در کدوم فایل و کدوم خط اتفاق افتاده. معمولا پیام خطای PHP اطلاعاتی درباره نوع خطا، فایل درگیر و شماره خط ارائه میده.

برای مثال ممکنه با پیامی شبیه به این مواجه بشید:

Parse error: syntax error, unexpected token “;”

in /home/example/public_html/wp-content/themes/mytheme/functions.php on line 25

در این مثال، پیام خطا به یک مشکل نحوی اشاره می کنه و محل گزارش اون هم خط ۲۵ فایل functions.php هست.

البته باید توجه داشته باشید که شماره خط نمایش داده شده همیشه محل دقیق اشتباه نیست. ممکنه مشکل در چند خط قبل تر باشه و PHP در خط بعدی متوجه ناقص بودن ساختار شده باشه.

برای پیدا کردن مشکل، ابتدا فایل معرفی شده در پیام خطا رو باز کنید، سپس خط اعلام شده و چند خط قبل و بعد از اون رو با دقت بررسی کنید.

روش های رفع خطای سینتکس در وردپرس

روش رفع خطای سینتکس به محل بروز اون بستگی داره. اگه به فایل های سایت دسترسی دارید، معمولا میتونید با بررسی کد و اصلاح اشتباه، مشکل رو برطرف کنید.

بررسی و اصلاح کدهای PHP

اگه اخیرا کدی به سایت اضافه کردید، بهتره اول همون کد رو بررسی کنید. وجود سمی کالن جا افتاده، پرانتز ناقص، کوتیشن بسته نشده یا اشتباه در ساختار شرط ها از مواردی هستن که باید به اونها توجه کنید.

در صورتی که از ویرایشگر کد استفاده می کنید، قابلیت های بررسی نحوی PHP میتونن به پیدا کردن بعضی از این اشتباهات کمک کنن.

استفاده از FTP یا File Manager هاست

گاهی خطای سینتکس باعث میشه سایت یا پیشخوان وردپرس باز نشه. در این شرایط، میتونید از طریق File Manager هاست یا یک اتصال FTP به فایل های سایت دسترسی پیدا کنید.

اگه خطا بعد از ویرایش فایل قالب ایجاد شده، مسیر مربوط به قالب رو بررسی کنید. برای مثال، فایل functions.php معمولا در پوشه قالب فعال قرار داره.

قبل از هر تغییری از فایل مورد نظر نسخه پشتیبان تهیه کنید. سپس کد اشتباه رو اصلاح کنید یا در صورت امکان، تغییر اخیر رو به حالت قبلی برگردونید.

غیرفعال کردن افزونه مشکل ساز

اگه خطا بعد از نصب یا ویرایش یک افزونه ایجاد شده باشه، ممکنه فایل های همون افزونه عامل مشکل باشن.

اگه به پیشخوان دسترسی ندارید، میتونید از طریق File Manager یا FTP پوشه افزونه مشکوک رو به طور موقت تغییر نام بدید تا وردپرس اون رو بارگذاری نکنه. این روش برای عیب یابی مفیده، اما تضمینی نیست که در همه شرایط خطا رو رفع کنه.

قبل از تغییر نام پوشه، بهتره از فایل های سایت نسخه پشتیبان داشته باشید. بعد از رفع مشکل هم علت اصلی رو بررسی کنید و از نصب مجدد نسخه معیوب خودداری کنید.

بازگرداندن نسخه پشتیبان

اگه نمی تونید محل دقیق خطا رو پیدا کنید و سایت از دسترس خارج شده، بازگرداندن نسخه پشتیبان سالم میتونه یکی از راهکارها باشه.

بهتره نسخه ای رو انتخاب کنید که قبل از ایجاد تغییرات مشکل ساز تهیه شده باشه. البته بازیابی نسخه پشتیبان ممکنه تغییرات جدید سایت رو هم حذف کنه؛ بنابراین قبل از انجام این کار، تاثیر اون روی اطلاعات جدید رو بررسی کنید.

بررسی خطا در محیط تست

اگه قصد دارید کدهای سفارشی به وردپرس اضافه کنید، بهتره ابتدا اونها رو در یک محیط تست اجرا کنید. در این حالت، اگه کد باعث بروز خطای سینتکس بشه، سایت اصلی تحت تاثیر قرار نمی گیره.

همچنین میتونید از ابزارهای بررسی نحوی PHP برای پیدا کردن اشتباهات استفاده کنید. برای نمونه، دستور php -l میتونه فایل PHP رو از نظر خطاهای نحوی بررسی کنه، بدون اینکه کد اون رو اجرا کنه.

آیا فعال کردن دیباگ وردپرس به رفع خطای سینتکس کمک می کند؟

بله، در بعضی شرایط فعال کردن حالت دیباگ میتونه اطلاعات بیشتری درباره خطاهای PHP در اختیار شما قرار بده. وردپرس گزینه ای به نام WP_DEBUG داره که برای بررسی مشکلات سایت استفاده میشه.

برای فعال کردن دیباگ، ابتدا از فایل wp-config.php نسخه پشتیبان تهیه کنید و بعد مقدار تنظیم مربوط به اون رو بررسی کنید. در محیط توسعه میتونید از تنظیم زیر استفاده کنید:

define( ‘WP_DEBUG’, true );

این تنظیم باید قبل از خطی قرار بگیره که پایان ویرایش فایل تنظیمات وردپرس رو مشخص می کنه. اگه WP_DEBUG از قبل تعریف شده، مقدار همون تعریف رو تغییر بدید و یک تعریف تکراری اضافه نکنید.

در محیط اصلی سایت، نمایش خطاها به بازدیدکنندگان میتونه اطلاعات فنی و مسیرهای داخلی سرور رو آشکار کنه. به همین دلیل بهتره نمایش خطاها رو برای کاربران فعال نکنید و در صورت نیاز، از تنظیمات مناسب برای ثبت خطا در فایل گزارش استفاده کنید. پس از پایان عیب یابی هم تنظیمات دیباگ رو متناسب با محیط سایت به حالت امن برگردونید.

چطور از بروز خطای سینتکس جلوگیری کنیم؟

پیشگیری از خطای سینتکس معمولا ساده تر از رفع مشکلی هست که باعث از دسترس خارج شدن سایت شده. برای همین بهتره قبل از تغییر فایل های وردپرس چند نکته رو رعایت کنید.

اول از همه، قبل از ویرایش فایل های قالب یا افزونه از اونها نسخه پشتیبان تهیه کنید. این کار باعث میشه اگه کد جدید مشکل ایجاد کرد، بتونید فایل قبلی رو بازیابی کنید.

نکته بعدی اینه که از ویرایش مستقیم فایل های سایت اصلی خودداری کنید، مخصوصا وقتی با PHP آشنایی کافی ندارید. استفاده از محیط تست و ویرایشگر کدی که خطاهای نحوی رو تشخیص میده، میتونه احتمال بروز مشکل رو کمتر کنه.

همچنین بهتره کدها رو از منابع معتبر دریافت کنید و قبل از استفاده، کاربرد و سازگاری اونها رو بررسی کنید. اگه قصد دارید قابلیت جدیدی به سایت اضافه کنید، استفاده از روش های استاندارد وردپرس و بررسی مستندات رسمی میتونه از بسیاری از مشکلات جلوگیری کنه.

جمع بندی

خطای سینتکس در وردپرس معمولا به دلیل رعایت نکردن قواعد نوشتاری PHP ایجاد میشه. جا افتادن سمی کالن، بسته نشدن پرانتز یا آکولاد، استفاده نادرست از کوتیشن و اشتباه در ویرایش فایل هایی مثل functions.php از دلایل رایج این مشکل هستن.

برای رفع خطا، ابتدا پیام نمایش داده شده رو بررسی کنید تا فایل و خط احتمالی مشخص بشه. سپس کدهای اطراف اون بخش رو با دقت بررسی کنید و در صورت نیاز، از طریق File Manager یا FTP تغییرات رو اصلاح کنید.

در نهایت، تهیه نسخه پشتیبان، آزمایش کدها در محیط تست و بررسی سازگاری اونها با نسخه PHP میتونه احتمال بروز این مشکل رو کاهش بده. اگه خطا بعد از تغییر خاصی ایجاد شده، برگردوندن همون تغییر معمولا بهترین نقطه برای شروع عیب یابی هست.

سوالات متداول