DOMDocument::importNode

(PHP 5, PHP 7, PHP 8)

DOMDocument::importNode — Belgeye bir düğüm dahil eder

Açıklama

public DOMDocument::importNode(DOMNode $node, bool $deep = false): DOMNode|false

Dahil edilen düğümü belge ile ilişkilendirip düğümün bir kopyasını döndürür.

Bağımsız Değişkenler

node: Belgeye dahil edilecek düğüm.
deep: true belirtiliği takdirde node alt düğümleriyle birlikte belgeye dahil edilir.

Bilginize:
Düğümlerin özniteliklerini de kopyalamak için bu bağımsız değişkende true belirtmek gerekir.

Dönen Değerler

Düğüm kopyalanamazsa false, yoksa kopyalanan düğümü döndürür.

Hatalar/İstisnalar

Düğüm dahil edilemezse DOMException istisnası oluşur.

Örnekler

Örnek 1 - DOMDocument::importNode() örneği

Düğümlerin bir belgeden başka bir belgeye kopyalanması.

<?php

$orgdoc = new DOMDocument;
$orgdoc->loadXML("<root><eleman><çocuk>çocuk metin</çocuk></eleman></root>");

// Yeni belgeye dahil edilecek düğüm
$node = $orgdoc->getElementsByTagName("element")->item(0);


// Yeni belgeyi oluşturalım
$newdoc = new DOMDocument;
$newdoc->formatOutput = true;

// Biraz imlenim ekleyelim
$newdoc->loadXML("<belge><bireleman>elemanın içeriği</bireleman></belge>");

echo "Düğümler kopyalanmadan 'yeni belge':\n";
echo $newdoc->saveXML();

// Düğümü alt düğümleriyle birlikte belgeye dahil edelim
$node = $newdoc->importNode($node, true);
// ve "<belge>" düğümüne ekleyelim
$newdoc->documentElement->appendChild($node);

echo "\nDüğümler kopyalandıktan sonra 'yeni belge':\n";
echo $newdoc->saveXML();
?>

Yukarıdaki örneğin çıktısı:

Düğümler kopyalanmadan 'yeni belge':
<?xml version="1.0" encoding="utf-8"?>
<belge>
  <bireleman>elemanın içeriği</bireleman>
</belge>

Düğümler kopyalandıktan sonra 'yeni belge':
<?xml version="1.0" encoding="utf-8"?>
<belge>
  <bireleman>elemanın içeriği</bireleman>
  <eleman>
    <çocuk>çocuk metin</çocuk>
  </eleman>
</belge>