Softaculous PHP uyumsuzluğu hatası alıyorsan genelde “required PHP version not met”, “incompatible PHP version” gibi uyarılar görürsün. Script kurulmaz ya da kurulum başlasa bile hata verir. Özellikle WordPress, Laravel gibi uygulamalarda bu çok olur. Sorun bu. Aşağıdaki adımları uygulayarak düzeltebilirsin.
Sorun şu:
Kurulmak istenen script ile sunucudaki PHP sürümü uyuşmuyor.
PHP ya çok eski ya da fazla yeni olduğu için kurulum engelleniyor. Aşağıdaki adımları uygulayarak düzeltebilirsin.
Çözüm Adımları
1) Script’in istediği PHP sürümünü kontrol et
Önce ne kurduğunu ve hangi PHP sürümünü istediğini net gör.
Şuraya gir:
cPanel → Softaculous → Script sayfası
Orada genelde şu yazar:
-
Requires PHP 7.4+
-
Compatible with PHP 8.x
Alternatif: kurulum ekranında “Requirements” kısmını kontrol et.
Mevcut PHP sürümünü kontrol et:
php -v
Eğer uyumsuzsa aşağıdaki adıma geç.
Ardından tekrar dene.
Olmadıysa alttaki adıma geç.
2) PHP sürümünü değiştir (en hızlı çözüm)
Softaculous PHP uyumsuzluğu çözümünde en direkt yöntem bu.
Şuraya gir:
WHM → MultiPHP Manager
Domain seç → PHP version değiştir
Önerilen:
-
WordPress için: 8.1 veya 8.2
-
Eski scriptler için: 7.4
cPanel üzerinden de yapabilirsin:
cPanel → MultiPHP Manager
Değiştirdikten sonra kontrol et:
php -v
Sonra tekrar kurulum dene.
Şimdi tekrar test et.
Olmadıysa alttaki adıma geç.
3) CLI ve Web PHP sürümü farklı mı kontrol et
Çok kritik nokta. Panelde PHP farklı, CLI’da farklı olabilir.
Şuraya gir:
SSH
Şu komutu çalıştır:
which php
php -v
WHM’de seçtiğin PHP ile aynı mı bak.
Farklıysa doğru binary ile test et:
/opt/cpanel/ea-php82/root/usr/bin/php -v
Softaculous bazen CLI PHP’yi kullanır. Bu yüzden uyumsuzluk çıkar.
Gerekirse symlink düzelt:
ln -sf /opt/cpanel/ea-php82/root/usr/bin/php /usr/bin/php
(versiyonu ihtiyaca göre değiştir)
Ardından tekrar dene.
Olmadıysa alttaki adıma geç.
4) Eksik PHP eklentilerini (extensions) kontrol et
Bazen sürüm doğru olur ama extension eksik olduğu için uyumsuzluk verir.
Şuraya gir:
WHM → EasyApache 4
Kontrol et:
-
mysqli
-
curl
-
mbstring
-
json
-
zip
-
gd
SSH ile kontrol:
php -m
Eksik varsa yükle:
yum install ea-php82-php-mysqlnd -y
yum install ea-php82-php-mbstring -y
yum install ea-php82-php-zip -y
(versiyonu kendi PHP’ne göre değiştir)
Sonra servisleri restart et:
systemctl restart httpd
systemctl restart php-fpm
Ardından tekrar dene.
Olmadıysa alttaki adıma geç.
5) PHP handler ve yapılandırmayı kontrol et
Yanlış handler bazen Softaculous PHP uyumsuzluğu gibi görünür.
Şuraya gir:
WHM → MultiPHP Manager
Kontrol et:
-
PHP-FPM aktif mi
-
handler: suPHP / LSAPI önerilir
Ayrıca PHP-FPM açık ama çalışmıyorsa:
systemctl status php-fpm
Restart:
systemctl restart php-fpm
systemctl restart httpd
Ardından tekrar dene.
Olmadıysa alttaki adıma geç.
6) .htaccess veya custom PHP ayarlarını kontrol et
Bazı projelerde .htaccess içinde eski PHP sürümüne zorlayan kurallar olur.
Şuraya gir:
cPanel → File Manager → public_html
.htaccess dosyasını aç ve şuna benzer satırlar var mı bak:
AddHandler application/x-httpd-php74 .php
Varsa kaldır ya da güncelle.
Ayrıca .user.ini dosyasını da kontrol et:
php_value memory_limit 128M
Yanlış ayarlar varsa sil.
Sonra tekrar dene.
Şimdi tekrar test et.
Olmadıysa alttaki adıma geç.
7) Softaculous update yap
Eski Softaculous versiyonu yeni PHP sürümlerini tanımayabilir.
Şuraya gir:
SSH
Şu komutu çalıştır:
/usr/local/cpanel/whostmgr/docroot/cgi/softaculous/cli.php --update
Bu işlem script uyumluluk listesini günceller.
Ardından tekrar dene.
Olmadıysa alttaki adıma geç.
8) Log kayıtlarını kontrol et (en net sonuç burada)
Softaculous PHP uyumsuzluğu hatasının gerçek sebebi burada çıkar.
Şuraya gir:
SSH
Şu komutu çalıştır:
tail -n 100 /usr/local/cpanel/logs/error_log
tail -n 100 /usr/local/cpanel/whostmgr/docroot/cgi/softaculous/error.log
Görebileceğin hatalar:
-
unsupported PHP version
-
required PHP extension missing
-
PHP fatal error
-
incompatible version
Bu log direkt hangi sürüm ya da eklentinin sorun çıkardığını gösterir.
Log’daki hataya göre doğrudan müdahale et.
cPanel Lisansında %80 Tasarruf Edin!
Bu makaledeki sorunu çözdünüz mü? Peki ya artan lisans maliyetleri? VDS/Dedicated sunucularınız için %100 güncellenebilir, limitsiz paylaşımlı (proxy) cPanel lisansımızı hemen inceleyin.
