Dom\Attr::rename

(PHP 8 >= 8.4.0)

Dom\Attr::rename — Changes the qualified name or namespace of an attribute

説明

public Dom\Attr::rename(?string $namespaceURI, string $qualifiedName): void

This method changes the qualified name or namespace of an attribute.

パラメータ

namespaceURI: The new namespace URI of the attribute.
qualifiedName: The new qualified name of the attribute.

戻り値

値を返しません。

エラー / 例外

DOMException with code Dom\NAMESPACE_ERR: Raised if there is an error with the namespace, as determined by qualifiedName.
DOMException with code Dom\INVALID_MODIFICATION_ERR: Raised if there already exists an attribute in the element with the same qualified name.

例

例1 Dom\Attr::rename() example to change both the namespace and qualified name

This changes the qualified name of my-attr to my-new-attr and also changes its namespace to urn:my-ns.

<?php

$doc = Dom\XMLDocument::createFromString('<root my-attr="value"/>');

$root = $doc->documentElement;
$attribute = $root->attributes['my-attr'];
$attribute->rename('urn:my-ns', 'my-new-attr');

echo $doc->saveXml();

?>

上の例の出力は以下となります。

<?xml version="1.0" encoding="UTF-8"?>
<root xmlns:ns1="urn:my-ns" ns1:my-new-attr="value"/>

例2 Dom\Attr::rename() example to change only the qualified name

This only changes the qualified name of my-attr and keeps the namespace URI the same.

<?php

$doc = Dom\XMLDocument::createFromString('<root my-attr="value"/>');

$root = $doc->documentElement;
$attribute = $root->attributes['my-attr'];
$attribute->rename($attribute->namespaceURI, 'my-new-attr');

echo $doc->saveXml();

?>

上の例の出力は以下となります。

<?xml version="1.0" encoding="UTF-8"?>
<root my-new-attr="value"/>

注意

注意: It is sometimes necessary to change the qualified name and namespace URI together in one step to not break any namespace rules.

参考

Dom\Element::rename()

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.