メインコンテンツへスキップ
見出し画像

WordPressのPHPは「厨房の壁に貼る追加ルールの紙」で読めます

    WordPressの困りごとを検索すると、「このコードをfunctions.phpに貼ってください」という答えによく出会います。けれども、PHP(ピーエイチピー)のコードは、CSSに比べて記号が多く、何が書いてあるのか見当もつかない方が多いのではないでしょうか。意味が分からないものを、自分のホームページに貼るのは怖いものです。

    千葉市でホームページ制作と運用サポートをしているskymotherです。毎朝10分、自社サイトの実物を開いて、コードの読み方を確かめる時間を取っています。この記事は、その中でPHPを扱った回をまとめたものです。

    お伝えするのは、次の6つです。

    • PHPはどこで動いているのか

    • functions.phpとは何か、なぜ子テーマに書くのか

    • add_action・add_filterの読み方

    • 拾ったコードを貼る前の確認

    • 画面が真っ白になったときの戻し方

    • 実際のfunctions.phpの3行を読んでみる

    全体を通して、ホームページを1軒のレストランにたとえて読んでいきます。

    PHPは「厨房」で動いています

    レストランには、料理を作る厨房と、お客さんが座る客席があります。ホームページも同じつくりになっています。

    • 厨房=サーバー(ホームページのデータを置いている場所)

    • 料理人とレシピ=PHP

    • 客席=ホームページを見る人のブラウザ(ChromeやSafariなど)

    • 運ばれる料理=HTML(ページの中身)

    PHPは、見る人のパソコンやスマホではなく、サーバーの中で動いています。厨房でレシピどおりに料理を作り、客席に届けるのは、作り終えた料理だけです。

    たとえば、次の1行があったとします。

    <?php echo date('Y'); ?>

    これは「今の年を書いてください」というレシピです。厨房でこのレシピが動き、客席には「2026」という完成した料理だけが届きます。お客さんの目に、レシピそのものは見えません。

    これは自社サイトで確かめられます。Chromeでトップページを開き、ページのソース(客席に届いた料理の中身)を表示して「<?php」を検索してみると、見つかったのは0件でした。PHPは厨房の中にとどまっていて、客席には届いていないことが、実物で分かります。

    ここで覚えておきたいのは、PHPの書き間違いは「化粧崩れ」ではなく「厨房停止」になりやすいということです。CSS(見た目を整えるコード)を間違えても、崩れるのは見た目です。けれどもPHPのレシピを書き間違えると、厨房が止まり、ページそのものが出てこなくなることがあります。PHPを扱うときに慎重になる理由は、ここにあります。

    functions.phpは「厨房の壁に貼る追加ルールの紙」です

    WordPressでは、ホームページの見た目や動きをまとめた「テーマ」を使います。レストランでいえば、テーマは本部から届いた「レシピと厨房一式」です。

    functions.phpは、そのテーマの中にあるファイルで、厨房の壁に貼る「うちのお店の追加ルール」の紙にあたります。紙に1枚ルールを足すことで、機能を増やしたり、動きを変えたりできます。

    では、なぜ「子テーマ」に書くのでしょうか。

    テーマには、親テーマと子テーマがあります。

    • 親テーマ=本部の公式マニュアル。更新のたびに丸ごと新しいものに差し替えられます

    • 子テーマ=お店の別冊ノート。本部のマニュアルが新しくなっても、そのまま残ります

    親テーマのfunctions.phpに直接ルールを書き足すと、テーマを更新したときに、本部のマニュアルと一緒に書き足した内容まで差し替えられてしまいます。子テーマに書いておけば、更新しても自分で足したルールは残ります。WordPress公式の説明でも、子テーマを使えば親のテーマを更新しても変更が守られるとされています(WordPress公式:FAQ Troubleshooting)。

    もうひとつ大事なのは、子テーマのfunctions.phpは、親テーマのfunctions.phpを置き換えるわけではないという点です。厨房では、本部のマニュアルとお店の別冊ノートの両方が読まれます。

    これも自社サイトで確かめました。ページのソースで子テーマのフォルダ名「emanon-premium-child」を検索すると3件、親テーマのフォルダ名「emanon-premium/」を検索すると14件見つかりました。親と子の両方が、実際に読み込まれていることが分かります。

    add_actionとadd_filterは「予約票」です

    functions.phpを開くと、よく出てくるのが「add_action(アド・アクション)」と「add_filter(アド・フィルター)」という言葉です。

    レストランの厨房では、料理を出すまでに毎回通る段階が決まっています。仕込み、盛りつけ、料理を出す前の最終確認、といった流れです。WordPressにも、ページを作る途中で毎回通る決まった段階があり、これを「フック」と呼びます。

    functions.phpの紙に書くのは、「その段階が来たら、これをしてください」という予約票です。予約票には2種類あります。

    add_action=作業を足す予約

    add_action( 'wp_footer', 'my_message' );

    「ページの一番下(フッター)を作る段階が来たら、my_messageという作業をしてください」という予約です。お店でいえば、「閉店前に看板も出しておいてね」と作業をひとつ足すイメージです。

    add_filter=中身を受け取って、直して返す予約

    add_filter( 'the_content', 'my_change' );

    「記事の本文を出す段階が来たら、いったんmy_changeに渡して、直してから出してください」という予約です。料理を出す前に、味見係を通すイメージです。

    味見係は、受け取った料理を直したら、お皿に戻して返す必要があります。返し忘れると、お客さんの前に空のお皿が出てしまいます。add_filterで中身を返し忘れると、記事の本文が表示されなくなることがあるのは、このためです。

    まずは、

    • add_action=作業を足す予約

    • add_filter=中身を受け取って直して返す予約

    と読むと、functions.phpの中身がつかみやすくなります。

    拾ったコードは「知らない人から渡された紙」として扱います

    ネットで見つけたコードの断片を、「スニペット」と呼びます。貼って使う短いコードのことです。

    レストランで、知らない人から「これを厨房の壁に貼っておいて」と紙を渡されたら、中身を読まずに貼る人はいないはずです。拾ったスニペットも同じように扱います。

    貼る前に確かめるのは、次の5つです。

    1. このコードが何をするかを、1文で言えるか。 「〇〇の段階が来たら、△△をする予約」の形で言えれば、中身をつかめています

    2. 今日の分のバックアップがあるか。 私の自社サイトでは、WPvividというバックアップのプラグインを使っています。最後にいつ取ったか、自動で取る設定になっているかの2点を、プラグインの画面で確かめます

    3. 子テーマのfunctions.phpか。 親テーマに書くと、更新で消えてしまいます

    4. 貼った直後に、ホームページの表側を開いて確認するか。 管理画面が動いていても、表側が崩れていることがあります

    5. 元に戻す手順を知っているか。 次の見出しでお伝えします

    あわせて、コードの中に次の言葉があったら、いったん手を止めてください。

    • eval・base64_decode:中身が読めないように包まれた封筒のようなものです。何が入っているのか、外からは分かりません

    • 知らないURLへの送信や読み込み:お店の情報を、知らない場所へ送る紙かもしれません

    • wp_create_user:新しいユーザーを作る命令です。お店の合鍵を作る紙にあたります

    これらが入っていても危険とは限りません。ただ、意味が分からないまま貼るのは避けるのが安全です。

    画面が真っ白になったら「裏口」から紙を剥がします

    functions.phpの書き間違いでページが出なくなると、画面が真っ白になったり、「このサイトで重大なエラーが発生しました」という表示になったりします。WordPressには、重大なエラーが起きたときに、管理者のメールアドレスへ知らせを送る仕組みがあります(WordPress公式:Common WordPress Errors)。

    このとき、管理画面にも入れなくなっていることがあります。レストランでいえば、正面玄関が開かない状態です。そんなときは裏口から入ります。裏口にあたるのが、レンタルサーバーの管理画面にあるファイルマネージャーです。

    戻し方は、軽いものから順に3段階あります。

    1. 管理画面に入れるなら、管理画面から貼ったコードを消します

    2. 入れないなら、ファイルマネージャー(裏口)から子テーマのfunctions.phpを開き、貼る前の状態に戻します

    3. それでも直らないときは、バックアップごと元に戻します

    ここで気をつけたいのは、「消す」と「戻す」の違いです。

    停電したときのブレーカーを思い浮かべてください。原因になった家電の配線だけを抜けば、家の電気は戻ります。家ごと壊す必要はありません。functions.phpも同じで、剥がすのは自分が貼った追加分だけです。ファイルやフォルダごと消すと、テーマが元から使っている大事な予約まで消えてしまうことがあります。

    そこで役に立つのが、「貼る前の控え」です。私は、ConoHa WINGのファイルマネージャーで自社サイトの子テーマのフォルダ(wp-content/themes/emanon-premium-child)をたどり、functions.phpをパソコンにダウンロードしました。ファイルの大きさは318バイトで、ほんの十数行の小さなファイルです。名前を「functions_20261005.php」と日付つきに変えて、パソコンの書類の中に作った「サイト控え」というフォルダに入れています。

    ダウンロードのフォルダに置いたままにすると、あとで整理したときに一緒に消してしまいやすくなります。控えは、決まった場所に、日付が分かる名前で置いておくと安心です。

    実際のfunctions.phpの3行を読んでみます

    最後に、控えておいた自社サイトの子テーマのfunctions.phpを読んでみます。中身の中心は、次の3行です。

    add_action( 'wp_enqueue_scripts', 'theme_enqueue_styles' );
    function theme_enqueue_styles() {
    	wp_enqueue_style( 'parent-style', T_DIRE_URI . '/style.css', array(), THEME_VERSION );

    ここまでのたとえを使うと、1行ずつ次のように読めます。

    • 1行目の「wp_enqueue_scripts」:ページを作る途中の「CSSやJavaScriptの読み込みを並べる段階」の名前です。レストランでいえば、料理に添えるものを並べる時間です

    • 1行目の「theme_enqueue_styles」:予約した作業の名前です。2行目に同じ名前が出てきて、そこから下が作業の中身になります

    • 3行目の「T_DIRE_URI . '/style.css'」:親テーマの場所にある、style.cssというファイルを指しています

    • 3行目の「parent-style」:読み込んだCSSにつける名札です

    つまりこの3行は、「CSSを並べる段階が来たら、親テーマのCSSを読み込んでください」という予約票です。

    実際に、自社サイトのページで「parent-style」を検索すると1件見つかり、親テーマのstyle.cssのすぐ後ろに、子テーマのstyle.cssが並んでいました。予約票のとおりに、親のCSSが読み込まれていることが分かります。

    では、この紙を剥がすと、ホームページはどうなるでしょうか。ここは、2つの場合を分けて考えます。

    • 紙を丸ごときれいに剥がしたとき:厨房は止まらないので、ページは表示されます。ただし、親テーマのCSSが届かなくなります。見た目にどこまで影響が出るかは、テーマのつくりによって変わります

    • 紙の書き方を間違えたとき・途中まで消してしまったとき:厨房が止まり、ページが表示されなくなることがあります

    画面が真っ白になる原因は、紙があることでもなくなることでもなく、紙の書き間違いです。正しく書き換えることは問題ありません。だからこそ、貼る前の控えを取り、何かあれば控えの状態に戻せるようにしておくことが大切になります。

    まとめ

    • PHPはサーバーという厨房で動き、見る人に届くのは作り終えたHTMLです

    • functions.phpは、厨房の壁に貼る「お店の追加ルール」の紙です

    • 子テーマに書けば、親テーマを更新しても自分で足したルールは残ります

    • add_actionは作業を足す予約、add_filterは中身を受け取って直して返す予約です

    • 拾ったコードは、何をするか1文で言えるか・バックアップ・子テーマ・表側の確認・戻し方の5つを確かめてから貼ります

    • 画面が真っ白になったら、ファイルマネージャー(裏口)から入って、貼る前の控えに戻します

    PHPは、記号の多さに驚きますが、「いつ・何をする予約か」を探しながら読むと、意味が見えてきます。意味が分かってから貼る。戻し方を知ってから貼る。この2つを守っておけば、functions.phpに何かあったときも、落ち着いて元に戻せます。

    skymotherの「WEB担当 引き継ぎプラン」では、ホームページの制作をおまかせいただき、公開後の6か月で更新のしかたやAIの使い方までお伝えして、ご自身で動かせる状態にしてお渡しします。まずは30分の無料ホームページ診断で、今のホームページの直す順番を3つお伝えしています。WordPressを自分の手で育てていきたい方は、こちらをご覧ください。

    ▶ 無料ホームページ診断(WEB担当 引き継ぎプラン):https://www.kigyo-skymother.site/web-handover/

     
     
    元看護師・保健師。パソコン初心者からWEBデザイナーへ転身し、千葉の個人事業主・中小企業のホームページ制作を手がけています。3人の子育て中、幕張を拠点に活動中。「ホームページをどう集客に使えばいいかわからない」という方に向けて、ノウハウをわかりやすく発信します。

    あなたへのおすすめ