htmlentities

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

    htmlentities — Dö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 İsmiAçıklama
    ENT_COMPATSadece ç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_NOQUOTESNe 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.0seçenekler bağımsız değişkeninin öntanımlı değeri ENT_COMPAT iken ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401 oldu.
    8.0.0kodlama 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

    To Top