Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 94 – Çoklu dil / Unicode

Python’da UTF-8 ve Unicode kullanımını adım adım öğrenerek çoklu dil desteği sağlayın ve karakter sorunlarını kökten çözün.

Ders 94 – Çoklu dil / Unicode

Günümüzün küresel yazılım dünyasında uygulamaların birden fazla dili sorunsuz bir şekilde işlemesi bir lüks değil, zorunluluktur. Python, varsayılan olarak UTF-8 kodlamasını benimser, ancak gerçek projelerde dosya okuma‑yazma, veri tabanı etkileşimi ve dış API çağrıları sırasında kodlama hataları sıkça karşımıza çıkar. Bu ders, Unicode kavramını temelden alıp Python kodunuza nasıl güvenli bir şekilde entegre edeceğinizi gösterir; ayrıca PHP’de aynı konsepti nasıl ele alacağınızı iki örnekle sunar.

Temeller

Unicode, tüm dünyadaki karakterleri tek bir evrensel standartta toplar. Her karakter bir code point (ör. U+0061 = "a") ile tanımlanır. Bu kod noktaları farklı kodlamalar (UTF‑8, UTF‑16, UTF‑32) aracılığıyla ikili veriye dönüştürülür. Python 3, str tipini Unicode dizgesi olarak tanımlar; bytes ise ikili veri tutar. En kritik kural, her zaman kodlamayı açıkça belirtmektir.

Adım adım Unicode desteği

  1. Kaynak dosyanızı UTF‑8 olarak kaydedin. Çoğu modern editör (VS Code, PyCharm) varsayılan olarak UTF‑8 kullanır; ancak # -*- coding: utf-8 -*- satırını dosyanın en üstüne eklemek, eski ortamlarla uyumluluğu garantiler.
  2. Metin verisini str tipinde tutun. Sayısal işlemler, dilbilgisel analizler ve formatlama işlemleri doğrudan Unicode dizgeleriyle yapılabilir.
  3. Dış kaynaklarla iletişimde encoding parametresini kullanın.
    • Dosya okuma/yazma: open('dosya.txt', 'r', encoding='utf-8')
    • HTTP istekleri: requests.get(url).text.encode('utf-8')
    • Veri tabanı bağlantısı: cursor.execute('SET NAMES utf8mb4')
  4. Unicode normalizasyonu. Aynı karakter farklı kombinasyonlarla temsil edilebilir (ör. "é" = "e" + "´"). unicodedata.normalize('NFC', text) ile tutarlı bir formata dönüştürün.
  5. Hata ayıklama. UnicodeEncodeError ve UnicodeDecodeError istisnalarını yakalayarak hangi karakterin sorun yarattığını loglayın.

PHP ile Unicode örnekleri

Python’da Unicode doğal olsa da, aynı konsepti PHP’de de uygulamak gerekir. Aşağıdaki iki örnek, UTF‑8 dosya okuma ve ekrana Unicode karakter yazdırma süreçlerini gösterir.

<?php
// örnek 1: UTF‑8 kodlu bir dosyayı satır satır okuma
$dosya = 'metin.txt';
$handle = fopen($dosya, 'r');
if ($handle) {
    while (($satir = fgets($handle)) !== false) {
        // satırı UTF‑8 olarak işleyelim
        $satir = mb_convert_encoding($satir, 'UTF-8', 'auto');
        echo $satir . "<br>";
    }
    fclose($handle);
} else {
    echo 'Dosya açılamadı.';
}
?>
<?php
// örnek 2: Unicode karakterleri JSON çıktısına dahil etme
header('Content-Type: application/json; charset=utf-8');
$data = [
    'mesaj' => "Merhaba Dünya 🌍",
    'dil'   => "Türkçe",
    'emoji' => "😊"
];
// JSON_UNESCAPED_UNICODE bayrağı ile karakterleri kaçış yapmadan göndeririz
echo json_encode($data, JSON_UNESCAPED_UNICODE);
?>

Sık yapılan hatalar

  • Kodlamayı belirtmemek. open('dosya.txt') gibi bir çağrı sistem varsayılanını kullanır; bu, farklı işletim sistemlerinde farklılık gösterebilir.
  • Bytes ve str karıştırmak. bytes nesnesini doğrudan print() ile göstermek UnicodeDecodeError üretir.
  • Veritabanı karakter setini ayarlamamak. MySQL’de utf8mb4 kullanılmazsa emoji gibi 4‑byte karakterler kaybolur.
  • Normalizasyonu ihmal etmek. Arama ve karşılaştırma işlemlerinde aynı karakter farklı temsillerde bulunabilir.

Özet ve kontrol listesi

Bu derste şunları öğrendik:

  • Unicode nedir, kod noktaları ve kodlamalar arasındaki ilişki.
  • Python’da str ve bytes arasındaki fark.
  • Dosya, ağ ve veri tabanı işlemlerinde encoding='utf-8' kullanımının önemi.
  • PHP’de mb_convert_encoding ve JSON_UNESCAPED_UNICODE ile Unicode desteği.
  • Yaygın hatalar ve bunların önlenmesi.

Kontrol Listesi

  • Kaynak dosyanız UTF‑8 olarak kaydedildi mi?
  • Tüm open, read, write işlemlerinde encoding='utf-8' kullandınız mı?
  • Veri tabanı bağlantısında utf8mb4 ayarını yaptınız mı?
  • Unicode normalizasyonunu (NFC) uyguladınız mı?
  • PHP örneklerinde mbstring ve json_encode bayraklarını kullandınız mı?

SSS

Soru 1: Python’da bir bytes nesnesini nasıl str tipine dönüştürürüm?

Cevap: bytes_obj.decode('utf-8') yöntemiyle UTF‑8 kodlamasını belirterek dönüştürülür. Hata durumunda errors='replace' veya 'ignore' parametresi eklenebilir.

Soru 2: UTF‑8 dosyasını Windows Notepad ile açtığımda karakterler bozuluyor, ne yapmalıyım?

Cevap: Notepad varsayılan olarak ANSI (Windows‑1254) kullanabilir. Dosyayı “Farklı Kaydet” menüsünden “UTF‑8” olarak seçin ya da codecs.open(..., encoding='utf-8') ile Python’da yeniden kaydedin.

Soru 3: MySQL’de emoji kaydetmek istiyorum, hangi karakter seti yeterli?

Cevap: utf8mb4 karakter seti 4‑byte Unicode karakterlerini destekler. Tablo ve sütun tanımlarında CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci kullanın.

Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

Python ile web, veri, otomasyon ve AI alanlarına yön veren ileri seviye bir yol haritası, adım ad…

Ders 99 – Kontrol listesi: üretim

Üretim ortamı için log, health, config ve secret yönetimini kapsayan kontrol listesi, adım adım ö…

Ders 98 – Mikroservis iletişimi fikri

Mikroservis mimarisinde HTTP/JSON sözleşmesiyle versiyonlu endpoint oluşturma, adım adım örnekler…

Ders 97 – Veri doğrulama katmanı

Veri doğrulama katmanını Pydantic ve Cerberus ile nasıl kuracağınızı adım adım öğrenin, örnek PHP…

Demo
Büyütülmüş Görsel