【PHP8.x】bodyプロパティの使い方

bodyプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年11月02日

基本的な使い方

bodyプロパティは、PHPのDom\Documentクラスに属し、HTMLドキュメントの<body>要素を保持するプロパティです。Dom\Documentオブジェクトは、HTMLやXMLといったドキュメント全体を表現するものであり、このプロパティを通じてドキュメントの本体部分に直接アクセスできます。

このプロパティが保持するのは、Dom\Element型のオブジェクトです。これは、HTMLドキュメント内の<body>タグによって定義される要素を表現します。例えば、Webページのコンテンツ本体に新しい要素（例えば段落や画像など）を追加したり、既存の要素のテキスト内容や属性を変更したりする場合に、このbodyプロパティから得られるDom\Elementオブジェクトを通じて操作を行います。

注意点として、もし解析対象のドキュメントがHTML形式ではなく<body>要素を含まないXMLドキュメントである場合や、HTMLドキュメントであっても何らかの理由で<body>要素が存在しない場合には、このbodyプロパティはnullを返します。そのため、利用する際には、返り値がnullではないことを確認する処理を挟むことが推奨されます。このプロパティは読み取り専用であり、新しい<body>要素を直接代入してドキュメント構造を変更することはできません。

構文(syntax)


1<?php
2$document = new \Dom\Document();
3$document->loadHTML('<!DOCTYPE html><html><head><title>Example</title></head><body><p>This is the body content.</p></body></html>');
4$bodyElement = $document->body;
5?>

引数(parameters)

戻り値(return)

?DOMElement

Dom\Document::body プロパティは、HTML ドキュメントの <body> 要素を表す DOMElement オブジェクト、または <body> 要素が存在しない場合は null を返します。