(PHP 4, PHP 5, PHP 7, PHP 8)
htmlentities — Dönüştürülebilecek tüm karakterleri HTML öğeleri haline getirir
$dizge
,$seçenekler
= ENT_QUOTES
| ENT_SUBSTITUTE
| ENT_HTML401
,$kodlama
= null
,$çifte_kodlama
= true
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.
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.
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ö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: | 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.
|
Örnek 1 - htmlentities() örneği
<?php
$str = "<b>Tek</b> bir 'tırnak'";
// Çıktısı: <b>Tek</b> bir 'tırnak'
echo htmlentities($str);
// Çıktısı: <b>Tek</b> bir 'quote'
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");
?>