| この記事の要点 |
|
get_header 関数とは
get_header() は WordPress のテンプレートタグで、現在有効なテーマの header.php ファイルを読み込んで出力します。ページごとに同じヘッダ(ロゴ・グローバルナビ・<head> タグなど)を再利用するのが目的で、ほぼすべてのテーマファイル冒頭で呼ばれます。
構文
get_header( string $name = null, array $args = array() ): void|false
| 引数 | 型 | 意味 |
|---|---|---|
| $name | string | 読み込むヘッダ名。header-{$name}.php を探す。null なら header.php |
| $args | array | テンプレートに渡す変数の連想配列(WP 5.5+) |
戻り値は void(通常)または false(テンプレート発見できず)。WP 5.5 以降は void|false。
テンプレート読み込みの優先順位
get_header('foo') と呼ぶと WordPress は次の順で探します。
- 子テーマの
header-foo.php - 親テーマの
header-foo.php - 子テーマの
header.php - 親テーマの
header.php - コア
wp-includes/theme-compat/header.php(フォールバック)
子テーマでオーバーライドできる仕組みなので、子テーマ作成時はこの仕様を理解しておくと便利です。
基本的な使い方
<?php
// 最も一般的な使い方(header.php を読み込む)
get_header();
?>
<main>
<?php while ( have_posts() ) : the_post(); ?>
<article>
<h1><?php the_title(); ?></h1>
<?php the_content(); ?>
</article>
<?php endwhile; ?>
</main>
<?php get_footer(); ?>
ページ毎にヘッダを切り替える
トップページとサブページでヘッダを変えたい場合、$name 引数を渡します。
<?php
// front-page.php
get_header( 'front' ); // header-front.php を読み込む
?>
<?php
// page.php
get_header(); // header.php を読み込む
?>
<?php
// single.php(記事ページ)
get_header( 'single' ); // header-single.php を読み込む
?>
$args で変数を渡す(WP 5.5+)
<?php
// テンプレートを呼ぶ側
get_header( null, array(
'class' => 'home-hero',
'show_search' => true,
) );
?>
<!-- header.php 内 -->
<header class="<?php echo esc_attr( $args['class'] ?? '' ); ?>">
<?php if ( $args['show_search'] ?? false ) : ?>
<?php get_search_form(); ?>
<?php endif; ?>
</header>
$args の中身はテンプレート内で $args 変数として参照できます。
典型的な header.php の中身
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title><?php wp_title(); ?></title>
<?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>
<?php wp_body_open(); ?>
<header class="site-header">
<h1 class="site-title">
<a href="<?php echo esc_url( home_url( '/' ) ); ?>">
<?php bloginfo( 'name' ); ?>
</a>
</h1>
<?php
wp_nav_menu( array(
'theme_location' => 'primary',
'menu_class' => 'main-nav',
) );
?>
</header>
wp_head() はプラグインやコアが head 内に出力するためのフックなので、テーマには必須。
関連フック
| フック | 種類 | 用途 |
|---|---|---|
| get_header | action | get_header() 実行時、テンプレート読み込み前に発火 |
| get_header_template | filter | 読み込まれるテンプレートのパスを変更 |
| wp_head | action | header.php 内の wp_head() で発火(CSS / JS 出力) |
| wp_body_open | action | body 開始直後(GA タグ・Cookie 同意など) |
注意点
- functions.php で呼ばない — 初期化前は wp_head 等が動かない。テンプレート (single.php / page.php) の冒頭で呼ぶ
- $name はファイル名の
-以降。header-mobile.phpならget_header('mobile') - ヘッダ内で大きな処理を行うとページ全体の生成が遅くなる — 重い処理はキャッシュ化
関連関数
| 関数 | 役割 |
|---|---|
| get_footer() | footer.php を読み込む |
| get_sidebar() | sidebar.php を読み込む |
| get_template_part() | 任意のテンプレート部品を読み込む |
| locate_template() | テンプレートのパスを取得(読み込まずに) |
FAQ
Q: get_header() を呼ばないとどうなる?
A: wp_head() フックが動かず、プラグインが出力する CSS/JS が読み込まれない。トラッキングや表示も壊れる。
Q: 同じテンプレートで複数回呼んでいい?
A: 技術的には可能だが、<html> / <head> を二重出力する事故になるので非推奨。
Q: ブロックテーマ(FSE)でも使う?
A: ブロックテーマでは theme.json + block templates が中心で、PHP テンプレートと get_header() は使わない。クラシックテーマでのみ必須。
関連: get_footer 関数 / get_sidebar 関数
子ページ
子ページはありません
同階層のページ
- do_action
- get_header
人気ページ
- 1 Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法
- 2 tomcat の起動 / 停止ログと catalina.log・catalina.out の違い
- 3 JavaScript で base URL を取得する方法|window.location.origin
- 4 YouTube Data API v3 エラー一覧|403・400・404 の原因と対処
- 5 Laravel エラー一覧|500/Blade/DB 接続/ルーティングの代表エラー
- 6 3Dグラフィックスとは|モデリング/レンダリング/主要ソフトウェア (Blender / Maya)
- 7 Spring Frameworkのアノテーション一覧
- 8 【Spring】@Valueアノテーションとは
- 9 CATALINA_HOME の確認方法 (Linux / Mac)
- 10 【Spring】@Autowiredアノテーションとは
最近更新/作成されたページ
- プロジェクトをTomcatプロジェクトとして認識させる方法 2026-10-07 22:32:50
- MySQLの1366 Incorrect string value|Laravelの文字コード・絵文字エラー 2026-10-07 21:54:03
- curlの証明書ホスト名不一致|旧エラー51・現行60の確認と対処 2026-10-07 21:54:03
- LaravelのMassAssignmentException|fillableの原因と安全な対処 2026-10-07 21:54:03
- Eclipse で Tomcat の起動ログがコンソールに出ない時の確認手順 2026-10-07 21:54:02
- MySQLにおける中央値(Median)の導き方(バージョン8未満) 2026-10-07 13:49:45
- getInputForward 2026-10-07 13:41:15
- JSONから配列に変換 2026-10-07 13:41:15
- ビューから値をモデルに格納しコントローラーで受け取る方法 2026-10-07 13:23:41
- Laravelのテーブル作成と定義変更|マイグレーション・up/down・注意点 2026-10-07 13:23:41
- NumPy 配列に要素を追加する方法 (append / concatenate) 2026-10-07 13:23:41
- MariaDB・MySQLで現在日時を取得する方法|NOW・タイムゾーン・保存型 2026-10-07 13:13:36
- 【django】テンプレートで定数を使用する方法 2026-10-07 13:10:15
- Spring BootにおけるApplication.propertiesの環境依存設定の分割方法 2026-10-07 12:09:35
- Not supported for DML operations【Springエラー】 2026-10-07 11:09:38