Ubuntu 24.04'ten 26.04'e yükseltmede PHP siteleri: neler bozulur
5 dk okuma
Ubuntu 24.04'ten 26.04'e geçmek sitelerinizi tek adımda PHP 8.3'ten 8.5'e, MySQL 8.0'dan 8.4'e ve OpenSSL 3.0'dan 3.5'e taşır. Önceden neye bakılır, neler bozulur ve neden yeni bir sunucu çoğu zaman daha iyi bir yükseltmedir.
Ubuntu sürüm yükseltmesi yalnızca yeni bir çekirdek değildir. PHP siteleri barındıran bir sunucu için 24.04'ten 26.04'e geçmek, uygulamanızın konuştuğu neredeyse her katmanı aynı anda değiştirir:
| Ubuntu 24.04 | Ubuntu 26.04 | |
|---|---|---|
| PHP | 8.3 | 8.5 |
| MySQL | 8.0 | 8.4 |
| MariaDB | 10.11 | 11.8 |
| PostgreSQL | 16 | 18 |
| OpenSSL | 3.0 | 3.5 |
| nginx | 1.24 | 1.28 |
26.04 sütunu, 12 Kasım 2026'da yeni kurulmuş bir Ubuntu 26.04.1 sisteminin arşivinde bulduklarımızdır.
Kısaca
- Siteleriniz PHP 8.3'ten 8.5'e atlar; 8.4 atlanır. Kodu yükseltmeden önce 8.5'te deneyin.
- PHP ayarları kendiliğinden taşınmaz:
/etc/php/8.3/yerinde kalır,/etc/php/8.5/varsayılanlarla başlar. ppa:ondrej/php26.04 için yoktur. Sunucunuz onu kullanıyorsa önce bunu planlayın.- IMAP eklentisi yok ve MySQL 8.4
mysql_native_passwordyöntemini kapatıyor. - Daha güvenli yol yeni bir 26.04 sunucusu kurup siteleri tek tek taşımaktır.
1. PHP 8.3, 8.5 olur
Ubuntu 26.04'te yalnızca PHP 8.5 vardır. 8.3'te temiz çalışan kod genellikle çalışır, ama iki sürümün kullanımdan kaldırma uyarıları birlikte gelir. Şunu PHP 8.5'te çalıştırdık:
function f(string $a = null) {}
echo (integer) "5";
echo `echo hi`;
Deprecated: Non-canonical cast (integer) is deprecated, use the (int) cast instead
Deprecated: f(): Implicitly marking parameter $a as nullable is deprecated, the explicit nullable type must be used instead
Deprecated: The backtick (`) operator is deprecated, use shell_exec() instead
string $a = null,?string $a = nullolmalı (PHP 8.4'ten beri). Eski kütüphaneler bununla doludur.(integer),(boolean),(double)ve(binary)dönüşümleri(int),(bool),(float)ve(string)olmalı (8.5'ten beri).- Ters tırnak işleci
shell_exec()olmalı (8.5'ten beri).
Bunlar hata değil, uyarıdır: kod çalışmaya devam eder. Ama site hataları ekrana basıyorsa ya da çatı bu uyarıları istisnaya çeviriyorsa sayfalar bozulur. Günlükler de hızla dolar.
Ne yapmalı: hâlâ 24.04'teyken testlerinizi PHP 8.5'te çalıştırın. Çatıyı, eklentileri ve Composer paketlerini 8.5 desteği belirten sürümlere güncelleyin.
2. Artık olmayan eklentiler
PHP 8.4 bazı eklentileri çekirdekten çıkardı. En çok can yakanı IMAP'tir. Ubuntu 26.04'te php8.5-imap paketi yoktur. imap_open() çağıran destek masası, CRM ve web posta araçları çalışmaz.
Ayrıca php8.5-opcache yoktur, çünkü OPcache PHP 8.5'in içine derlenir. Sabit bir paket listesi kuran betikler bu adda başarısız olur.
Ne yapmalı: elinizdekini listeleyin ve karşılaştırın.
php8.3 -m > /root/php83-modules.txt
Yükseltmeden sonra php8.5 -m aynı listeyi göstermeli; yalnızca gerekmediğini bildikleriniz eksik olabilir.
3. PHP ayarlarınız geride kalır
/etc/php/8.3/ altındaki her şey PHP 8.3'e aittir. PHP 8.5, varsayılan değerlerle başlayan /etc/php/8.5/ dizinini okur. Buna şunlar dahildir:
php.inideğişiklikleri:memory_limit,upload_max_filesize,max_execution_time./etc/php/8.3/fpm/pool.d/içindeki FPM havuzlarınız: kullanıcılar,pm.max_children,open_basedir.- Soket adı.
/run/php/php8.3-fpm.sockadresini gösteren nginx siteleri, siz onlarıphp8.5-fpm.sockyapana kadar 502 Bad Gateway döndürür.
Ne yapmalı: havuz dosyalarınızı 8.5 dizinine kopyalayın, soket adlarını hem onlarda hem nginx'te değiştirin ve iki php.ini dosyasını diff ile karşılaştırın.
4. Ondřej PPA'sı
Birçok 24.04 sunucusu daha yeni ya da daha eski bir PHP için ppa:ondrej/php kullanır. Sürüm yükseltmesi üçüncü taraf kaynakları kapatır ve bu PPA'da 26.04 paketi hiç yoktur. Yerini packages.sury.org/php alır. Ubuntu 26.04'te Ondřej PHP PPA'sı yazısına bakın.
Yükseltmeden sonra bir site PHP 8.3 ya da daha eskisini istiyorsa onu oradan alırsınız. Birden çok PHP sürümünü yan yana çalıştırmak yazısına bakın.
5. Veritabanı
-
MySQL 8.0 → 8.4.
mysql_native_passwordeklentisi 8.4'te varsayılan olarak kapalıdır. Onunla oluşturulmuş kullanıcılar giriş yapamaz. Yükseltmeden önce bulun:SELECT user, host, plugin FROM mysql.user WHERE plugin = 'mysql_native_password';ve
ALTER USERilecaching_sha2_passwordyöntemine geçirin. -
MariaDB 10.11 → 11.8 birkaç sürümü birden atlar. Önce tam döküm alın.
-
PostgreSQL 16 → 18. Yeni sürüm eskisinin yanına kurulur; siz
pg_upgradeclusterçalıştırana kadar veri 16 kümesinde kalır.
Hangisini kullanırsanız kullanın: döküm alın, sunucunun dışına kopyalayın ve geri yüklenebildiğini kontrol edin.
6. TLS
OpenSSL 3.5, 3.0'dan daha katıdır. PHP'den çok eski sunuculara giden bağlantılar (curl, SMTP, ödeme API'leri) başarısız olabilir. Sitenizin bağlı olduğu entegrasyonları deneyin.
Daha iyi yol: yeni bir sunucu
Yerinde yükseltme, yukarıdakilerin hepsini tek bir bakım aralığında, siteler kapalıyken değiştirir; geri dönüş yolu da tam yedeği geri yüklemektir.
Yeni sunucuya taşımak aynı şeyleri değiştirir, ama her seferinde bir site için:
- Yeni bir Ubuntu 26.04 sunucusu oluşturun.
- Bir siteyi ve veritabanını oraya kopyalayın.
- Geçici bir adreste deneyin.
- DNS'i değiştirin. Bir sorun varsa geri alın.
- Tekrarlayın. Eski sunucu boşalınca kapatın.
PHP 8.5'e hazır olmayan bir site bu sürede yeni sunucuda 8.3 ile çalışabilir.
Zefily ile önerdiğimiz yol da budur: yeni sunucuyu bağlayın, her siteyi bugün ihtiyaç duyduğu PHP sürümüyle oluşturun, ücretsiz zefily.app adresinde deneyin, sonra DNS'i çevirin. Sunucu bağlama belgesine bakın.
Başlamadan önce kontrol listesi
- Kod PHP 8.5'te denendi; çatı ve eklentiler güncellendi.
- PHP eklentilerinin listesi kaydedildi; IMAP kullanımı kontrol edildi.
/etc/php/8.3/ve/etc/nginx/kopyası alındı.grep -r ondrej /etc/apt/ile kontrol edildi.mysql_native_passwordkullanan MySQL kullanıcıları taşındı.- Veritabanı dökümü alındı, sunucu dışına kopyalandı, geri yükleme denendi.
- Sağlayıcıda sunucu anlık görüntüsü alındı.
Sık sorulan sorular
Ubuntu 24.04'ü 26.04'e yükseltince hangi PHP sürümü gelir?
PHP 8.5. Ubuntu 24.04'te PHP 8.3, Ubuntu 26.04'te yalnızca 8.5 vardır; yükseltme 8.4'ü atlar.
Yükseltmeden sonra sitelerim neden 502 Bad Gateway veriyor?
Genellikle nginx hâlâ /run/php/php8.3-fpm.sock adresini gösteriyordur. PHP 8.5, /run/php/php8.5-fpm.sock soketini dinler ve eski havuz dosyalarınız /etc/php/8.5 dizinine kopyalanmaz.
Ubuntu 26.04'te PHP 8.3'ü tutabilir miyim?
Ubuntu'nun arşivinden tutamazsınız. Ubuntu 26.04 için PHP 8.3, Ondřej Surý'nin packages.sury.org deposunda vardır.
Ubuntu 26.04'te php-imap var mı?
Hayır. IMAP eklentisi PHP 8.4'te çekirdekten çıkarıldı ve Ubuntu 26.04'te php8.5-imap paketi yoktur.
Yerinde mi yükseltmeliyim, yeni sunucuya mı taşımalıyım?
Canlı siteleri olan sunucular için yeni sunucu daha güvenlidir: siteleri tek tek taşıyıp denersiniz ve DNS'i değiştirerek geri dönebilirsiniz.
Zefily'nin her Ubuntu sürümüne ne kurduğu için desteklenen sistemler belgesine bakın.