“Syntax error” WordPress’te genelde bir tema dosyasında, eklentide veya wp-config.php’da yapılan küçük bir yazım hatasından kaynaklanır. En tipik örnekler noktalı virgül unutmak, parantezi kapatmamak, tırnakları yanlış kapatmak veya PHP etiketlerini bozmak. Bu hata çıktığında yapılacak iş nettir: hatanın hangi dosyada ve hangi satırda olduğunu bul, o satırı düzelt, tekrar test et. “Deneme yanılma” ile siteyi karartmak profesyonel iş değildir.
Eğer ekranda hata mesajı görünüyorsa genelde şöyle yazar: “Parse error: syntax error, unexpected … in /path/file.php on line 123”. Bu bilgi altındır. Eğer görünmüyorsa debug logu açarsın.
// wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Sonra wp-content/debug.log içinden dosya ve satır numarasını alırsın. En sık yapılan hata, functions.php içine kopyalanan bir kodun başına/sonuna gereksiz PHP aç-kapa etiketi koymaktır. functions.php zaten PHP ile başlar, tekrar <?php yazarsan parse error alırsın.
Yanlış örnek:
<?php
// functions.php içinde tekrar yazılmışsa sorun çıkarabilir
<?php
add_action('init', function() { echo "x"; });
<?php
// functions.php içinde tekrar yazılmışsa sorun çıkarabilir
<?php
add_action('init', function() { echo "x"; });
Doğru örnek:
Bir diğer klasik hata tek tırnak/çift tırnak karışmasıdır. Özellikle dizilerde veya HTML stringlerinde gözden kaçar.
Yanlış:
echo '<div class="box">Merhaba</div>;
Doğru:
echo '<div class="box">Merhaba</div>';
Noktalı virgül unutmak da en eski hatadır.
Yanlış:
$foo = "bar"
Doğru:
$foo = "bar";
Bu hataları canlı sitede düzeltirken en güvenli yöntem, dosyayı önce lokalinde kontrol etmektir. SSH varsa php -l ile lint yapmak altın standarttır.
php -l wp-content/themes/temaadi/functions.php
Bu komut syntax hatasını çalıştırmadan yakalar. FTP ile düzenleme yapıyorsan, yanlış kaydedip siteyi tamamen düşürmemek için önce dosyanın yedeğini alırsın, sonra değişiklik yaparsın. Bu “eski usul” disiplin seni kurtarır.
WordPress admin paneline giremiyorsan ve hata bir eklentiden kaynaklandıysa, ilgili eklenti klasörünü yeniden adlandırıp siteyi ayağa kaldırırsın. Sonra hatalı dosyayı düzeltirsin.
/wp-content/plugins/eklenti-adi -> /wp-content/plugins/eklenti-adi.off
Syntax error bazen tek bir karakter yüzünden saatler harcatır, ama mantığı basittir: dosya, satır, token. Debug log ve lint ile ilerlersen el yordamıyla aramaya gerek kalmaz. En önemlisi, düzenleme alışkanlığını doğru kurarsan bu hatalar tekrar etmez: kodu parça parça ekle, her adımda kontrol et, mümkünse staging ortamında dene, canlıya en son geçir.