ブログアフィリエイトで稼ぐ

Limitless.net

  • サイト管理人
誠太

誠太

接客業で年間1,600万円の売上を達成した経験を活かして、リアル接客とWebマーケティングを融合。アフィリエイト初心者やブロガーに向けて一助できるような情報を発信。

WordPress

【解決】WordPressのカスタマイズで起こるfunction.phpエラーの対処法

投稿日:

 

誠太

こんにちは、誠太です!

 

WordPress を使用していると、「function.php」に新しい構文を追加する
機会がそれなりにありますよね。

 

しかし、構文を新しく追加をした矢先。

 

誠太

よっし!!これで・・・

エ、エラーだと・・・

 

ついでに画面が真っ白で理解不能な文章が出てきている、
もしくは真っ白で何も表示されないなんて状況になってしまいます。

 

今回は「function.phpエラーの対処法」をテーマに解説していきたいと思います。

 

この解説どおりに修正して頂ければ、サイトや管理画面に
アクセスできるようになるので、いま現在真っ白な状況かも
しれませんが焦らないでくださいね!

 

function.phpでエラーが起こる原因

 

 

それでは function.php に追加で記述した際になんでエラーが
起きるのかを簡単に解説していきたいと思います。

 

function.phpエラーの原因① 同じ英文を2重で書き込んでいる

 

言語を理解できていない初心者の場合、参考になるサイトなどから構文をコピーして
使用することが大半だと思います。

 

そのため、ショートカットキーの「Ctrl + V」で構文を貼り付けるのが大半を
締めていると言っても過言ではないはずです。

 

その際に、誤って「Ctrl + V」を2回押してしまって、
同じ構文が2個記述されてしまうとエラーが発生してしまいます。

 

新しい構文を貼り付けで追加する際は、画面右のスクロールバーを入力した場所まで
上げて、二重に記述されていないか確認が必要です。

 

二重記述の例文

function addStyleHead(href) {
var link = document.createElement("link"); link.rel = "stylesheet";
link.href = href;
document.head.appendChild(link);
};//本来ここまででOK//
function addStyleHead(href) {
var link = document.createElement("link"); link.rel = "stylesheet";
link.href = href;
document.head.appendChild(link);
};//不要な二重記述//

 

function.phpエラーの原因② 文章の何処かが間違っている

 

よくありがちなのは

 

  • 「{」でスタートした構文が「}」で閉じられていない。
  • 構文末に「;」の記述がない
  • 関数名が間違っている

 

などが挙げられます。

 

恐らく、コピーした構文が最初から最後までしっかりとドラッグされていたら
このようなことはないかと思いますが、最後までドラッグされていなかった場合、
エラーとなってしまいます。

 

コピーする構文の最後の1文字までしっかりとドラッグできているか、
確認をするようにクセを付けておきましょう!

 

関数名が間違っている場合は、例としてこのような場合です。

 

正:function addStyleHead(href) {

誤:fanction addStyleHead(href) {

 

コピー&ペーストで構文を追加する場合、コピーをしたサイト側で間違っていたら
気がつくのは正直難しいと思います。

 

そのため、コピー&ペーストをした場合、環境によっては画面右側の列番号が書いている
ところにエラー記号が表示されるものもあるので、そちらをチェックしてみても良いかもしれません。

 

もしエラー記号が表示されない環境であれば、画面が真っ白になってしまった場合、
記述をした構文を全て削除して、同じ種類の構文を載せているサイトからコピーをしましょう。

 

function.phpエラーの原因③ 文末に空白がある(全角・半角スペース)

 

これも実によくある事例です。

 

原因としてあげられるのは、スペース表示がされないメモ帳を使用して構文を
貼り付け入力したこと。

 

文末に空白があることに気が付かずに「更新」ボタンを押してしまうと、
もれなくエラーになってしまいます。

 

そのため、 function.php に限らず、CSS(Style.css)などに構文を貼り付ける際は、
メモ帳ではなく TeraPad のような空白が入っていることを確認できるメモ帳を
使用するようにしましょう。

 

僕もこの空白でのエラーが怖くて、TeraPad に移行しました。

 

構文をコピーしたサイトによっては文末に空白が入っている
場合があるので、気が付かないで貼り付けてしまう事を防ぐのに最適です。

 

■TeraPad

https://tera-net.com/library/tpad.html

 

管理画面でエラー文章が表示された時の修正方法

 

それでは WordPress の管理画面にログインしようとした際に、エラーとなり
画面が真っ白になってしまった時の対処法を解説します。

 

エラー修正の方法① エラー文が表示されていない場合はデバッグ機能を追加

 

  • FFFTP・FilZira の WordPress をインストールしたフォルダ内を確認
  • wp-config.php を見つけたらサーバーからダウンロード
  • define('WP_DEBUG', false); を define('WP_DEBUG', true); へ書き換え

 

基本的にデバックの設定はされているものかと思われますが、
念の為、設定方法をお伝えします。

 

WordPress をインストールしたサーバーの中に「wp-config.php」というファイルが
あるかと思いますので、そのファイルをサーバーからダウンロードして記述し直します。

 

デバッグモードが有効になっているかは下記の構文で確認することができます。

define('WP_DEBUG', false);

 

この状態では無効状態になっているので、「false」を「true」に変更を行えば、
完全に真っ白な画面ではなくエラーコードが表示されるようになります。

 

表示されるエラー文は下記のような文になります。

例:Parse error: syntax error・・・(中略)・・・/Affinger5 Child/function.php on line 99

 

このエラー分が表示されるだけでも何行目の部分でエラーが起きているのか
確認できるようになるので、真っ白よりかは少し安心できます。

 

エラー修正の方法② サーバーにアクセスし編集を加えたファイルを修正

 

  • FFFTP・File Zira 等を使用し、function.php をダウンロード
  • TeraPad を使用し、function.php を開く
  • エラー文で指定されている行を修正もしくは削除をする
  • FFFTP・File Zira へ function.php をアップロードし管理画面を確認。

 

上記のエラーの文章が確認できたら、FFFTP や File Zira などを使用し、
サーバーから function.php をダウンロードします。

 

先ほど紹介した TeraPad を使用してfunction.php を開きます。

 

エラー文で表示されている行を確認し、ペーストで入力した構文を一度全部削除するか、
「{}」で閉じられていなかったり「;」で閉められていない場所がわかるようなら、
追記をして、上書き保存を行います。

 

サーバーへ修正した function.php を上書きし、管理画面へアクセスが出来るかどうか確認します。

 

エラー修正の方法③ FTP()を使用せずにエックスサーバー内で修正する

 

今回は僕が使用しているエックスサーバーを例に解説します。

 

  • エックスサーバーのファイル管理にログイン
  • ドメイン名➜public_html➜wp➜wp-content➜themes➜使用テーマフォルダ➜function.php
  • function.php をクリックするとファイルとしてダウンロードされる
  • TeraPad を使用し、エラー構文で表示されている行を修正
  • ファイルのアップロードをクリックし、修正した function.php をアップロード

 

まずはエックスサーバー(契約しているサーバー)の管理画面にアクセスします。

 

その後、ファイル管理(サーバーにアップロードされているファイルの管理画面)へ移動し、
function.php がある場所まで移動します。

 

その後、function.php をダウンロード(エックスサーバーの場合は、ファイル名クリックでOK)

 

Terapad でエラーとなっている行の構文を削除もしくは修正。

 

サーバーの function.php があるところへ修正した function.php をアップロード

 

管理画面にアクセス可能可確認を行います。

 

PHPファイルなどをカスタマイズする時の注意点!

 

それでは次に function.php のカスタマイズを行う際の注意点をお伝えします。

 

WordPressをカスタマイズする時の注意① 必ず最初にバックアップを取ること

 

これは style.css の場合でも同じことが言えるのですが、WordPress の動作に関する
ファイルに手を加える時は必ずバックアップを取るようにしましょう。

 

万が一致命的なダメージを受けてしまった場合、バックアップから元の状態に戻せる
可能性が極めて高いので、必ず定期的にバックアップしておきましょう。

 

僕は下記のプラグインを使用し、1周間お気にバックアップ。
構文を入力する前には必ずバックアップを取っています。

 

WordPress プラグイン「BackWPup 」

 

WordPressをカスタマイズする時の注意② サーバーからファイルをダウンロードしてから作業

 

WordPress の管理画面での function.php 等の修正は止めましょう。

 

エラーが改善されているにもかかわらず、改善されたことになっていなかったり、
エラーを起こした際に結局はサーバーから function.php 等をダウンロードしなければ
いけないので二度手間になってしまいます。

 

はじめからサーバーのファイルをダウンロードして、TeraPad で修正を加えたほうが
トータル的に楽なのは間違いないと言えるでしょう。

 

WordPressをカスタマイズする時の注意③ TeraPadなどを使用して改善を加える

 

これは途中でお伝えしましたが、Windowsに標準搭載されている「メモ帳」は
構文記述の際には使用しないでください。

 

空白スペースなどの見落としで管理画面がエラーを起こしてしまう事を未然に
防げることを考えれば、使わない手は無いかと思います。

 

また、補足として WordPress で立ち上げたサイトのトップページなどで、
このエラー分が表示されている状態だと、あなたの WordPress ファイルが
どのような場所にあるかも表示されてしまう状態になるので、
セキュリティ上あまりよろしくありません。

 

「じゃあ、上の方で書いていたデバッグ機能をなくしたほうが良いんじゃないの?」

 

という声が聞こえてきそうですが、無かったら無かったでエラーを修繕するのに
とても時間がかかってしまうことが予想されます。

 

あなたのサイトのPVが高ければ高いほど、画面が真っ白になっていることにより、
ユーザーの不安感をつのらせてしまう原因にもなりかねないので、早期改善を第一に
考えるならば、やはりデバッグ機能はあなたにとって必須の対策となります。

 

エラーを修正しても画面が切り替わらない場合

 

上記の方法で間違いなくエラーを修正したにもかかわらず、管理画面にアクセスが
できない場合があります。

 

その場合は、すこし時間をあけることで改善されるので不安である気持は重々承知ですが、
1~2分ほど待ってから再度、管理画面にアクセスしてみて下さい。

 

まとめ:function.php に構文を記述する時は、最新の注意を!!

 

 

今回は「【解決】WordPressのカスタマイズで起こるfunction.phpエラーの対処法」をお伝えしました。

 

この記事のポイントは下記になります。

 

  • 構文のコピーは必ず最後までドラッグしたのを確認してから
  • WordPress Debug を有効にする
  • function.php 等 を操作する時は、サーバーからダウンロードしTeraPad を使用する
  • バックアップは必ず記述前に行う

 

これを徹底するだけでもかなりエラーが発生する頻度は下げられますし、
万が一エラーが発生してもバックアップの復元からすぐに対処することができます。

 

今回のこの記事を参考に、構文入力の際には万全の準備をしてから
編集に望みましょう。

 

誠太

それでは!今回も最後まで読んで頂き、ありがとうございました。

 

 

 

  • この記事を書いた人
  • 最新記事
誠太

誠太

接客業で年間1,600万円の売上を達成した経験を活かして、リアル接客とWebマーケティングを融合。アフィリエイト初心者やブロガーに向けて一助できるような情報を発信。

-WordPress
-

Copyright© Limitless.net , 2019 All Rights Reserved.