functions.phpの追記位置に迷わない！初心者向けの記述ルールと整理術

6

Views

functions.phpの追記位置の考え方

functions.phpにコードを追加するとき、「どこに書けばいいのか分からない」と悩んだ経験はありませんか？

この記事では、functions.phpの追記位置に迷わないための基本ルールと、おすすめの記述スタイルを初心者向けに紹介します。

functions.phpの役割を再確認

functions.phpは、テーマに追加したいPHPベースの機能（関数）をまとめる場所です。

WordPressのテーマを読み込む際にこのファイルが実行され、メニュー登録・ウィジェット・CSS/JSの読み込みなどが反映されます。

追記位置に迷う原因

初心者が追記に迷う主な理由は：

  • どのコードがどの機能なのか分かりづらい
  • 似た関数が並んでいて、分類があいまい
  • コメントがなく、どこに追加すべきかの目印がない

おすすめの書き方ルール

以下のルールをもとに整理して記述すれば、あとから見返しても理解しやすくなります。

① 機能ごとに「見出しコメント」をつける

目的別に分類すると、どこに何を書くかが明確になります。

// ----------------------------
// メニュー関連の設定
// ----------------------------

function register_my_menu() {
  register_nav_menus([
    'main-menu' => 'メインメニュー',
  ]);
}
add_action('after_setup_theme', 'register_my_menu');


// ----------------------------
// CSS・JSの読み込み
// ----------------------------

function my_theme_scripts() {
  wp_enqueue_style('style', get_stylesheet_uri());
}
add_action('wp_enqueue_scripts', 'my_theme_scripts');

② 追加コードは「似た機能の近く」に書く

たとえば「管理画面をカスタマイズするコード」は、同じような管理系のコードと並べて配置しましょう。

③ 下のほうに「一時保管エリア」を作るのもアリ

試しに動かしてみたいコードや、用途が未定のコードは下部にまとめておくと安全です。

④ エラー対策のため「PHP文法」にも注意

functions.phpは1つのPHPファイルです。開きタグ（<?php）を重ねない、セミコロン忘れに注意など、文法ミスを防ぎましょう。

追記例：正しい順番で記述

<?php
// ----------------------------
// テーマの初期設定
// ----------------------------
add_theme_support('post-thumbnails');
add_theme_support('title-tag');

// ----------------------------
// メニュー登録
// ----------------------------
function my_theme_menus() {
  register_nav_menus(['main' => 'メインメニュー']);
}
add_action('after_setup_theme', 'my_theme_menus');

// ----------------------------
// スクリプト読み込み
// ----------------------------
function enqueue_my_scripts() {
  wp_enqueue_style('style', get_stylesheet_uri());
}
add_action('wp_enqueue_scripts', 'enqueue_my_scripts');

おわりに

functions.phpの追記位置に迷ったときは、まず機能ごとに整理された構成を意識しましょう。

コメントで区切るだけでも可読性は大幅にアップします。 将来的に複雑なfunctions.phpを扱うときにも、大きな助けになります。

次回は、複雑になってきたfunctions.phpを外部ファイルに分割する方法もご紹介予定です！

関連記事