【PHP】レイアウトのデフォルトのメタタグを、ビューごとのカスタムメタタグで上書きする方法

メタタグとは？

メタタグ（metaタグ）は、HTMLドキュメントに関する付加情報を格納するための要素です。主に以下のような情報を記述するために使われます。

• ドキュメントの作成者（author）
• ページの説明文（description）
• 文字コード、キーワードなどの各種設定

SEOやSNSでのシェア表示にも影響する重要な要素のため、サイト全体では共通のデフォルト値を持ちつつ、ページごとに適切な内容へ切り替えられる構成が理想的です。

ベストプラクティス：デフォルト値を定義し、ビューで上書きする

最も効果的なアプローチは、アプリケーション側でデフォルトのメタタグを定義し、必要に応じて個々のビューでそのパラメータを上書きするというものです。この仕組みはPHPを使えば簡単に実装できます。

手順1：設定ファイル（config）にデフォルト値を定義する

まず、アプリケーションの設定ファイルに、サイト全体で共通して使うデフォルトのメタ情報を定義します。

<?php
return [
    'addemailid' => 'demo@example.com',
    'descrip' => 'docdescription'
];

ここでは例として、作成者のメールアドレス（addemailid）とドキュメントの説明（descrip）を定義しています。

手順2：レイアウトでメタタグを登録する

次に、レイアウトファイル内で registerMetaTag() メソッドを使い、設定ファイルから読み込んだデフォルト値をメタタグとして登録します。

<?php
$this->registerMetaTag(Yii::$app->params['addemailid'], 'addemailid');
$this->registerMetaTag(Yii::$app->params['descrip'], 'descrip');
?>

第1引数にメタタグの内容、第2引数に識別用のキーを渡します。このキーが後ほどビュー側で上書きを行う際の目印になります。

手順3：個別のビューでメタタグを上書きする

特定のページだけで異なるメタ情報を表示したい場合は、そのビューファイル内で同じキーを指定して registerMetaTag() を呼び出します。これにより、レイアウトで設定されたデフォルト値が上書きされます。

<?php
// 例：このページ専用の説明文に差し替える
$this->registerMetaTag('このページ固有の説明文がここに入ります', 'descrip');
?>

上書きしなかったキーについては、レイアウトで定義したデフォルト値がそのまま出力されるため、全ページでメタタグが欠落する心配もありません。

まとめ

メタタグの管理は「configでデフォルト値を定義 → レイアウトで登録 → ビューで必要に応じて上書き」という3段階の流れにすると、保守性が高く拡張しやすい構成になります。全ページ共通の情報は一箇所で管理でき、ページ固有のSEO対策も柔軟に行えるため、規模の大きいWebアプリケーション開発では特に有効な手法です。