İçeriğe geç
zefıly
← Tüm yazılar

PHP 7.4'ten 8.x'e geçiş: her seferinde bir sürüm ilerleyen kontrol listesi

7 dk okuma

Eski bir PHP 7.4 uygulamasını doğrudan en yeni PHP'ye yükseltmek nadiren işe yarar. 8.0, 8.1, 8.2, 8.4 ve 8.5'te nelerin bozulduğu, sorunları sizin yerinize bulan araçlar ve canlı siteye dokunmadan nasıl deneneceği; adım adım.

PHP 7.4, Kasım 2022'de PHP projesinden güvenlik düzeltmesi almayı bıraktı. Birçok uygulama hâlâ onunla çalışıyor, çünkü yükseltme tek ve riskli bir sıçrama gibi görünüyor.

Tek sıçrama olmak zorunda değil. Her PHP sürümü küçük ve bilinen bir grup şeyi bozar. Her seferinde bir sürüm ilerlerseniz her adımda birkaç sorun düzeltirsiniz ve hangi adımın neye yol açtığını bilirsiniz.

Kısaca

  • Sitenin kopyası üzerinde çalışın, canlı sitede değil.
  • 7.4 → 8.0 → 8.1 → 8.2 → 8.3 → 8.4 → 8.5 sırasıyla gidin ve her adımda günlükler susana kadar durun.
  • 8.0 büyük adımdır: eski işlevleri kaldırır ve birçok uyarıyı hataya çevirir.
  • 8.1–8.5 çoğunlukla kullanımdan kaldırma uyarısı ekler: kod çalışır, ama PHP 9'da neyin bozulacağını söyler.
  • Aramayı araçlara bırakın: PHPCompatibility, Rector, PHPStan.

Hiçbir şeyi değiştirmeden önce

  1. Kopya alın. Siteyi ve veritabanını bir hazırlık (staging) adresine kopyalayın. Bir şeyleri bozmanın bedelsiz olduğu bir yere ihtiyacınız var.

  2. Kopyada tam hata günlüğünü açın; ekrana değil, dosyaya:

    error_reporting = E_ALL
    display_errors = Off
    log_errors = On
    
  3. Önce 7.4'te temizleyin. Önemli her sayfayı açın, her cron işini çalıştırın, sonra günlüğü okuyun. PHP 7.4'ün zaten bildirdiği uyarılar, PHP 8'in reddedeceği şeylerdir. Bunları şimdi düzeltmek yükseltmenin en ucuz kısmıdır.

  4. Size ait olmayanı güncelleyin. Çatı, CMS, eklentiler, temalar, Composer paketleri: her birini 7.4'ü hâlâ destekleyen en yeni sürüme alın. Çoğu zaman o sürüm 8.x'i de destekler ve işin yarısı bitmiş olur.

  5. "Çalışıyor"un ne demek olduğunu yazın: mutlaka çalışması gereken on sayfa ve işlem (giriş yapmak, ödeme, iletişim formu, PDF üretmek, içe aktarma). Bu listeyi her adımda tekrarlayacaksınız.

Adım 1: PHP 8.0, büyük adım

Kaldırılan ve artık betiği durduran şeyler:

  • create_function(), each(), money_format(), get_magic_quotes_gpc().
  • Dizge ve dizi konumları için süslü parantez: $str{0}, $str[0] olmalı.
  • (real) ve (unset) dönüşümleri.
  • Sınıfla aynı adı taşıyan metot artık kurucu değildir. __construct() kullanın.

Davranışı değişen şeyler:

  • Dizgelerin sayılarla karşılaştırılması. 0 == "abc" PHP 7'de true idi, PHP 8'de false. $status içinde dizge varken if ($status == 0) gibi bir kod artık hiçbir hata mesajı vermeden öbür dala girer. Formdan ya da veritabanından gelen değerlerdeki gevşek karşılaştırmaları arayın.
  • Yerleşik işlevlere yanlış tür vermek TypeError fırlatır; önceden uyarı verip null döndürürdü. Örnek: strlen([]).
  • Birçok uyarı istisnaya dönüştü: sıfıra bölme DivisionByZeroError fırlatır.
  • Tanımsız değişkenler ve dizi anahtarları artık bildirim değil, uyarıdır. Hata işleyiciniz uyarıları istisnaya çeviriyorsa eski özensiz kod başarısız olmaya başlar.
  • @ işleci artık ölümcül hataları gizlemez.

Bu adım en çok zamanı alır. Günlük temizlenmeden ilerlemeyin.

Adım 2: PHP 8.1

  • Yerleşik işlevlere null vermek kullanımdan kaldırıldı: strlen(null), trim(null), str_replace('a', 'b', null). Eski kod bunu her yerde yapar; genellikle eksik bir form alanıyla. $value ?? '' ile düzeltin.
  • strftime() ve gmstrftime() kullanımdan kaldırıldı. date() ya da IntlDateFormatter kullanın.
  • FILTER_SANITIZE_STRING kullanımdan kaldırıldı. Değeri çıktıya yazdığınız yerde htmlspecialchars() kullanın.
  • mysqli varsayılan olarak istisna fırlatır. Başarısız sorgu önceden false döndürürdü; şimdi mysqli_sql_exception fırlatır. if (!$result) diye kontrol eden kod oraya hiç ulaşmaz.
  • Yerleşik arayüzleri (ArrayAccess, Iterator, Countable) uygulayan sınıflar dönüş türleri hakkında bildirim alır. Türleri ekleyin ya da bir süreliğine #[\ReturnTypeWillChange] kullanın.

Adım 3: PHP 8.2

  • Dinamik özellikler kullanımdan kaldırıldı. Sınıf $foo özelliğini hiç tanımlamamışken $this->foo = 1 yazmak uyarı verir. Özelliği tanımlayın. Henüz düzeltemediğiniz sınıflarda #[\AllowDynamicProperties] uyarıyı susturur.
  • utf8_encode() ve utf8_decode() kullanımdan kaldırıldı. mb_convert_encoding() kullanın.
  • Dizgelerde "${var}" kullanımdan kaldırıldı. "{$var}" yazın.

Adım 4: PHP 8.3

Çoğu uygulama için sakin bir adım. Listenizi çalıştırın, günlüğü okuyun, devam edin.

Adım 5: PHP 8.4

  • Örtük null kabul eden parametreler kullanımdan kaldırıldı. function f(string $a = null), function f(?string $a = null) olmalı. Rector bunu toplu düzeltir.
  • Bazı eklentiler PHP çekirdeğinden çıkarıldı; IMAP bunlardan biri. Uygulamanız imap_open() ile posta kutusu okuyorsa sisteminizde bu sürüm için eklentinin olup olmadığına bakın. Örneğin Ubuntu 26.04'te PHP 8.5 için IMAP paketi yoktur.

Adım 6: PHP 8.5

Bunları PHP 8.5'te çalıştırdık:

  • (integer), (boolean), (double) ve (binary) dönüşümleri kullanımdan kaldırıldı. (int), (bool), (float), (string) yazın.
  • Ters tırnak işleci kullanımdan kaldırıldı. shell_exec() kullanın.

Sorunları araçlar bulsun

  • PHPCompatibility (PHP_CodeSniffer için bir kural seti) kodunuzu çalıştırmadan okur ve belirli bir PHP sürümünde neyin çalışmayacağını listeler:

    phpcs --standard=PHPCompatibility --runtime-set testVersion 8.0 src/
    

    Her adımdan önce bir sonraki sürüm için çalıştırın.

  • Rector kodu sizin yerinize yeniden yazar: null kabul eden türler, kaldırılan işlevler, eski sözdizimi. Değişikliklerini başka her değişiklik gibi gözden geçirin.

  • PHPStan, PHP 8'de TypeError'a dönüşen tür sorunlarını bulur. En düşük düzeyi bile eski kodda gerçek hatalar bulur.

  • Kendi günlüğünüz. Hiçbir araç her şeyi bulmaz. Her adımda "Hiçbir şeyi değiştirmeden önce" bölümündeki listeyi baştan sona deneyin.

WordPress ve diğer CMS siteleri

Sorun nadiren çekirdektedir; eklentiler ve temalardadır. Hepsini önce 7.4'te güncelleyin, sonra hazırlık kopyasında PHP'yi değiştirin. Bozulan her eklenti için önce güncelleme, sonra yerine geçecek başka bir eklenti arayın. Yıllardır sürümü çıkmayan bir eklenti her PHP sürümünde risktir.

Canlıya geçiş

  1. Düzeltilmiş kodu, canlı site hâlâ eski PHP ile çalışırken yükleyin. Geçiş sırasında kodun hem 8.x'te hem 7.4'te çalışması olağandır.
  2. Yedek alın.
  3. PHP sürümünü değiştirin.
  4. Hata günlüğünü bir gün izleyin.
  5. Sorun çıkarsa sürümü geri alın. Kod ikisinde de çalıştığı için bu saniyeler sürer.

Bunların hepsi nerede yapılır

İki şeye ihtiyacınız var: sitenin bir hazırlık kopyası ve eski ile yeni PHP sürümlerinin yan yana çalıştığı bir sunucu.

Zefily ikisini de yapar. Siteyi bir hazırlık kopyasına klonlayın, sonra her adımda sitenin sayfasından PHP sürümünü değiştirin. Ubuntu 26.04 dahil güncel sistemlere PHP 7.3–8.5 kurar; her site kendi kullanıcısıyla, kendi havuzunda çalışır ve eski sürüm diğer sitelere ulaşamaz. Ubuntu 26.04'te PHP 7.4 yazısına bakın.

Sunucuyu kendiniz kuruyorsanız Ubuntu 26.04'te birden çok PHP sürümünü yan yana çalıştırmak yazısına bakın.

Sık sorulan sorular

PHP 7.4'ten doğrudan PHP 8.5'e yükseltebilir miyim?

Yükseltebilirsiniz, ama altı sürümün bütün sorunları aynı anda çıkar. Hazırlık kopyasında her seferinde bir sürüm ilerlemek, hangi değişikliğin hangi hataya yol açtığını gösterir.

PHP 7.4'ten yükseltirken en zor adım hangisi?

PHP 8.0. Eski işlevleri ve sözdizimini kaldırır, birçok uyarıyı hataya çevirir ve dizgelerin sayılarla karşılaştırılmasını değiştirir.

strlen(null) neden kullanımdan kaldırma uyarısı veriyor?

PHP 8.1'den beri, null kabul etmeyen bir yerleşik işlev parametresine null vermek kullanımdan kaldırılmıştır. Bunun yerine boş dizge verin; örneğin $value ?? '' ile.

Dinamik özellik nedir ve neden kullanımdan kaldırıldı?

Sınıfın hiç tanımlamadığı bir özelliğe değer atamaktır. PHP 8.2 bunu kullanımdan kaldırır. Özelliği sınıfta tanımlayın.

PHP 8 yükseltmesinde hangi araçlar yardımcı olur?

PHPCompatibility hedef sürüm için uyumsuz kodu listeler, Rector birçok durumu sizin yerinize yeniden yazar, PHPStan tür hatalarını bulur.

Zefily'de bir sitenin PHP sürümünü değiştirmek için Web yığını belgesine bakın.

Diğer yazılar

Muhteşem Kasım · Siber Pazartesi

Gitmeden önce: ömürlük paketler indirimde

Ömürlük paketi bir kez ödeyin ya da yıllık paketlerin ilk yılında %30 indirim alın.

Paket başına yalnızca 100 ömürlük paket satılır. Bitince biter.

Kampanyayı inceleyin

Muhteşem Kasım

Kampanyayı inceleyin →