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

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

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

基本的な使い方

headプロパティは、Dom\Documentクラスに属し、HTMLドキュメントの<head>要素を保持するプロパティです。PHPのDOM拡張機能は、HTMLやXMLといった構造化されたドキュメントをプログラムから操作するための機能を提供しており、Dom\Documentクラスはそのドキュメント全体を表す中心的な役割を担います。

このheadプロパティは、Dom\Documentオブジェクトが解析したHTMLドキュメント内に<head>要素が存在する場合に、その<head>要素を表すDom\Element型のオブジェクトを保持します。これにより、開発者はドキュメントの<head>部分に簡単にアクセスし、その内部にある<title>、<meta>、<link>、<script>といった要素を効率的に取得したり、新しい要素を追加・削除したりする操作が可能になります。例えば、ウェブページのタイトルを動的に変更したり、特定のメタ情報を読み込んだりする場合に非常に便利です。

もし解析対象のドキュメントに<head>要素が存在しない場合（例えば、HTMLではないXMLドキュメントを扱っている場合や、HTML構造が不完全な場合）、headプロパティはnullを保持します。そのため、このプロパティを利用する際は、返り値がnullでないことを確認してから操作を行うことが、安全なプログラミングには不可欠です。

headプロパティを使用することで、HTMLドキュメントの重要な情報を管理する<head>セクションへのアクセスが直感的になり、ウェブページの動的な生成や解析をよりスムーズに行うことができます。

構文(syntax)


1<?php
2$document = new \Dom\Document();
3$document->loadHTML('<!DOCTYPE html><html><head><title>Document Title</title></head><body></body></html>');
4$headElement = $document->head;
5echo $headElement->tagName;
6?>

引数(parameters)

戻り値(return)

?Dom\Element

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