DOMDocument::loadHTMLFile

(PHP 5, PHP 7, PHP 8)

DOMDocument::loadHTMLFileHTML belgeyi bir dosyadan yükler

Açıklama

publicDOMDocument::loadHTMLFile(string$dosya, int$seçenekler = 0): bool

HTML belgeyi belirtilen dosyadan yükler. XML belge yüklemedeki gibi belgenin iyi biçemli olma gereği yoktur.

Uyarı

Bu işlev girdiyi HTML 4 ayrıştırıcı kullanarak ayrıştırır. Günümüz tarayıcılarının kullandığı HTML 5'in ayrıştırma kuralları farklıdır ve girdiye bağlı olarak farklı bir DOM yapısına neden olabilir. Bu nedenle bu işlevle HTML'yi arındırmak güvenli değildir.

Örnek olarak, bazı HTML öğeleri bir üst öğeyi örtülü olarak kapatacaktır. Ana öğelerin otomatik olarak kapatılmasına ilişkin kurallar HTML 4 ve HTML 5 arasında farklılık gösterir ve bu nedenle DOMDocument tarafından görülen sonuçtaki DOM yapısı, bir tarayıcının gördüğü DOM yapısından farklı olabilir ve muhtemelen bir saldırganın sonuçta ortaya çıkan HTML'yi bozmasına izin verebilir.

Bağımsız Değişkenler

dosya

HTML belgeyi içeren dosyanın yolu.

seçenekler

libxml seçenek sabitlerinin bitsel VEYAsı.

Dönen Değerler

Başarı durumunda true, başarısızlık durumunda false döner.

Hatalar/İstisnalar

dosya olarak boş bir dizge veya boş bir dosya aktarılırsa bir uyarı üretilir. Bu uyarıyı libxml üretmez ve libxml'in hata işlevleri ile elde edilemez.

Bozuk bir HTML sayfa başarıyla yüklense bile bu işlev hatalı bir imlenim ile karşılaştığında bir E_WARNING iletisi üretebilir. Böyle bir durumu atlatabilmek için libxml'in hata işleme işlevleri kullanılabilir.

Sürüm Bilgisi

Sürüm: Açıklama
8.3.0 Bu işlevin dönüş türü artık deneysel bool türünde.
8.0.0 Bu işlevin duruk olarak çağrılması artık Error oluşturuyor. Evvelce E_DEPRECATED hatası verirdi.

Örnekler

Örnek 1 - Bir belge oluşturmak

<?php
$doc
= new DOMDocument();
$doc->loadHTMLFile("filename.html");
echo
$doc->saveHTML();
?>

Ayrıca Bakınız

To Top