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

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

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

基本的な使い方

charsetプロパティは、Dom\Documentクラスに属し、現在のドキュメントの文字エンコーディングを保持するプロパティです。このプロパティの型は文字列（string）であり、"UTF-8"や"ISO-8859-1"といった文字エンコーディングの名称が格納されます。Dom\Documentオブジェクトが表すHTMLまたはXMLドキュメントのテキストデータの解釈方法を決定するために利用されます。

HTMLやXMLドキュメントを扱う際には、文字エンコーディングが非常に重要です。不適切なエンコーディングでドキュメントを処理すると、テキストが正しく表示されず、いわゆる文字化けが発生してしまいます。このcharsetプロパティを参照することで、現在DOMが認識しているドキュメントのエンコーディングを確認できます。

さらに、このプロパティは読み取り専用ではなく、値を設定することも可能です。例えば、$dom->charset = 'UTF-8'; のように記述することで、ドキュメントの内部的なエンコーディング設定を変更できます。これは、新たにDOMオブジェクトを生成して特定のエンコーディングで出力したい場合や、既存のドキュメントのエンコーディングをPHPコード内で統一したい場合に特に有用です。ただし、このプロパティを設定しても、HTMLドキュメント内の<meta charset="...">タグやXML宣言自体は自動的には更新されません。これらのメタ情報を更新するには、DOMのノード操作を別途行う必要があります。

ウェブアプリケーションにおいて、異なる言語や地域からのデータを扱う際には、国際化（i18n）の観点から正しい文字エンコーディングの指定と処理が不可欠です。charsetプロパティを適切に利用することで、文字化けを防ぎ、一貫性のあるテキスト処理を実現できます。

構文(syntax)


1<?php
2$html = '<!DOCTYPE html><html><head><meta charset="UTF-8"></head><body>こんにちは</body></html>';
3$document = new Dom\Document();
4$document->loadHTML($html);
5echo $document->charset;
6?>

引数(parameters)

戻り値(return)

string

DomDocumentオブジェクトが内部で保持している文字エンコーディングの文字列を返します。