htmlentities

(PHP 4, PHP 5, PHP 7, PHP 8)

htmlentitiesDönüştürülebilecek tüm karakterleri HTML öğeleri haline getirir

Açıklama

htmlentities(
    string $dizge,
    int $seçenekler = ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401,
    ?string $kodlama = null,
    bool $çifte_kodlama = true
): string

HTML öğesi olarak bir karşılığı bulunan tüm karakterleri dönüştürmesi dışında htmlspecialchars() işlevi gibidir. get_html_translation_table() işlevi, $seçenekler bağımsız değişkeninde belirtilen sabitlere bağlı olarak kullanılacak dönüştürme tablosunu elde etmek için kullanılabilir.

Bu işlev ile dönüştürülen bir dizgeyi eski haline getirmek için html_entity_decode() işlevini kullanabilirsiniz.

Bağımsız Değişkenler

dizge

Girdi dizgesi.

seçenekler

Geçersiz kod dizilimlerinin, kullanılan belge türünün ve tırnakların nasıl ele alınacağını belirten aşağıdaki seçenekler bitsel VEYAlanarak seçenekler bağımsız değişkeninde belirtilebilir. ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401 öntanımlıdır.

Olası sabit seçenekleri
Sabit İsmi Açıklama
ENT_COMPAT Sadece çift tırnaklar dönüştürülür, tek tırnaklara dokunulmaz.
ENT_QUOTES Çift tırnaklara ilaveten tek tırnaklar da dönüştürülür.
ENT_NOQUOTES Ne tek ne de çift tırnaklar dönüştürülür.
ENT_IGNORE Geçersiz kod dizilimlerinde boş dizge döndürülmeyip seesizce yoksayma yoluna gidilir. » Güvenlikle ilgili etkiler olabileceğinden bu seçeneğin kullanımı önerilmemektedir.
ENT_SUBSTITUTE Geçersiz kod dizilimi için boş bir dizge döndürülmeyip dizilimin yerine Unicode Değiştirme Karakteri (U+FFFD veya &#FFFD;) yerleştirilir.
ENT_DISALLOWED Geçersiz kod dizilimini olduğu gibi bırakmak yerine Unicode Değiştirme Karakteri (U+FFFD veya &#FFFD;) ile değiştirilir. Örneğin, XML belgelerin gömülü harici içerikle iyi biçimliliğini sağlamak için bu seçenek kullanışlı olabilir.
ENT_HTML401 Kod HTML 4.01 olarak ele alınır.
ENT_XML1 Kod XML 1 olarak ele alınır.
ENT_XHTML Kod XHTML olarak ele alınır.
ENT_HTML5 Kod HTML 5 olarak ele alınır.

kodlama

Karakterleri dönüştürürken kullanılan kodlamayı tanımlayan seçimlik bağımsız değişken.

Belirtilmezse kodlama için default_charset yapılandırma seçeneğinin değeri öntanımlıdır.

Bu bağımsız değişken teknik olarak seçimlikse de kodunuz için gereken değeri atamanız gerekir. Çünkü default_charset yapılandırma seçeneğine hatalı bir değer atanmış olabilir.

çifte_kodlama

Bu bağımsız değişkende false belirtilirse zaten kodlanmış HTML öğeleri tekrar kodlanmaz. Öntanımlı olarak herşey dönüştürülür.

Dönen Değerler

Dönüştürülen dizge döner.

Belirtilen kodlama altında belirtilen dizge geçersiz bir kod dizilimi içeriyorsa, ENT_IGNORE veya ENT_SUBSTITUTE seçenekleri atanmadığı takdirde boş dizge döndürülür.

Sürüm Bilgisi

Sürüm: Açıklama
8.1.0 seçenekler bağımsız değişkeninin öntanımlı değeri ENT_COMPAT iken ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401 oldu.
8.0.0 kodlama artık null olabiliyor.

Örnekler

Örnek 1 - htmlentities() örneği

<?php
$str
= "<b>Tek</b> bir 'tırnak'";

// Çıktısı: &lt;b&gt;Tek&lt;/b&gt; bir 'tırnak'
echo htmlentities($str);

// Çıktısı: &lt;b&gt;Tek&lt;/b&gt; bir &#039;quote&#039;
echo htmlentities($str, ENT_QUOTES);
?>

Örnek 2 - ENT_IGNORE kullanımı

<?php
$str
= "\x8F!!!";

// Boş dizge çıktılar
echo htmlentities($str, ENT_QUOTES, "UTF-8");

// "!!!" çıktılar
echo htmlentities($str, ENT_QUOTES | ENT_IGNORE, "UTF-8");
?>

Ayrıca Bakınız

  • html_entity_decode() - HTML öğelerini karşılığı olan karakterlere dönüştürür
  • get_html_translation_table() - htmlspecialchars ve htmlentities tarafından kullanılan dönüşüm tablosunu döndürür
  • htmlspecialchars() - Özel karakterleri HTML öğeleri haline getirir
  • nl2br() - Dizgedeki tüm satırsonlarının yerine HTML satır katlayıcıları yerleştirilir
  • urlencode() - Dizgeye URL kodlaması uygular