介護ヘルパーからITエンジニアになった話
よくあるPHPエラーの読み方と直し方|エラー文の一覧を初心者向けに解説
プログラミング学習

エックスサーバーで動かすPHP入門  10 / 12

よくあるPHPエラーの読み方と直し方|エラー文の一覧を初心者向けに解説

※この記事にはプロモーション(広告)を含みます

目次

画面に、英語のエラー文がずらっと出てきた。Parse error、Undefined、unexpected……。何を言われているのかわからなくて、そっとブラウザを閉じたくなりますよね。

でも、PHPのエラー文は、出てくるものがだいたい決まっています。このシリーズの2本目から9本目の「よくあるつまずき」でも、同じ言葉が何度も出てきました。

この記事では、それらのエラー文を集めて、読み方と直し方を一覧にしました。エラーが出たときに、辞書のように引いて使ってください。

この記事は「エックスサーバーで動かすPHP入門」シリーズの10本目です。前回は、エラーすら出ずに画面が真っ白になったときの対処法を紹介しました。

👉 PHPで画面が真っ白になったときの対処法|原因の見つけ方を初心者向けに解説

この記事の使い方

  1. 出てきたエラー文の最初のほう(たとえばUndefined array key)をコピーする
  2. このページでCtrlを押しながらFを押して、貼り付けて探す
  3. 「早見表」か、その下のくわしい説明で、意味と直すところを見る
  4. もっとくわしく知りたいときは、そのエラーが出てきた回の記事へ

まずは、どのエラー文にも共通する「読み方」から説明します。ここがわかると、この記事にのっていないエラーでも、自分で手がかりを見つけられるようになります。

エラー文の読み方

エラー文は4つの部分でできている

5本目で出てきた、次のエラー文を例にします。

Warning: Undefined array key "name" in /home/…/contact.php on line 2

これは、次の4つに分けて読めます。

部分 この例では 意味
1. エラーの種類 Warning どれくらい重いエラーか(このあと説明します)
2. 何が起きたか Undefined array key "name" エラーの中身。ここを読んで原因を考える
3. どのファイルか in /home/…/contact.php エラーが起きたファイル(in=〜の中で)
4. 何行目か on line 2 エラーに気づいた行(line=行)

2の「何が起きたか」には、あなたが書いた名前が、そのまま入っていることがよくあります。この例の"name"がそうです。変数の名前、配列のキー、命令の名前などが"…"の中に出てくるので、その名前を、自分のコードの中で探すのが近道です。

Fatal error は、行の書き方が少しちがう

9本目で出てきたFatal errorは、次のように何行にもなります。

Fatal error: Uncaught Error: Call to undefined function htmlspecialchar() in /home/…/white.php:8
Stack trace:
#0 {main}
  thrown in /home/…/white.php on line 8
  • 1行目の最後のwhite.php:8 … ファイル名のうしろの:8が「8行目」という意味です
  • Stack trace:と#0 {main} … 「どういう順番でここまで来たか」の記録です。このシリーズのコードでは、読まなくて大丈夫です
  • thrown in … on line 8 … 1行目と同じく、「8行目で起きました」ということです
  • Uncaught(アンコート) … 「だれも受け止めなかった」という意味です。7本目でtryとcatchを使ったとき、catchはエラーを「受け止める」ものだと説明しました。受け止めるcatchがなかったので、エラーの文がそのまま出てきた、ということです

つまり、見るところは1行目だけです。Uncaught Error:のうしろが「何が起きたか」で、最後の:8が行です。

エラーの種類は4つ

エラー文の一番最初に出る言葉で、どれくらい重いエラーかがわかります。このシリーズで出てきたのは、次の4つです。

種類 意味 PHPは止まる? エックスサーバーの初期設定で画面に出る?
Parse error 書き方(文法)のまちがい 止まる(1行も実行されない) 出る
Fatal error 重大なエラー 止まる(その行から下は実行されない) 出る
Warning 注意 止まらない(でも表示はおかしくなる) 出る
Deprecated 「この書き方は、いずれ使えなくなります」というお知らせ 止まらない 出ない

Parse errorとFatal errorのちがいは、いつ気づくかです。Parse errorは、PHPが実行する前にファイル全体を読んだ時点で気づくので、1行も実行されません。Fatal errorは、上から実行していって、その行に来たときに気づくので、その行より上は実行されています。

エックスサーバーで Deprecated が出ないわけ

表の一番右の列は、エックスサーバーの「php.ini設定」の初期値によるものです。9本目で、display_errors(エラーを画面に出すかどうか)を紹介しました。同じ「エラー設定」のところに、もう1つerror_reporting(エラー・レポーティング)という設定があります。report=知らせる、で、「どの種類のエラーを知らせるか」を決める設定です。

エックスサーバーの公式マニュアル「php.ini設定で設定可能な項目」によると、error_reportingの初期値は次のとおりです。

E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED

むずかしそうですが、読み方は簡単です。

  • E_ALL … 全部のエラー(ALL=全部)
  • & ~ … 「ただし、〜はのぞく」
  • E_NOTICE、E_STRICT、E_DEPRECATED … のぞく種類。E_DEPRECATEDがDeprecatedのこと

つまり「全部知らせる。ただし、Notice・Strict・Deprecatedはのぞく」という設定です。なので、エックスサーバーでは、ふつうはDeprecatedが画面に出ません。この記事のDeprecatedの説明は、「ほかのサーバーやパソコンで練習したときに出るかもしれないもの」として読んでください。

この設定は、変えなくて大丈夫です。Deprecatedが出るようなコードは、たいてい一緒にWarningも出るので、Warningを直せば消えます(くわしくは、このあとのDeprecated の説明で)。

見る順番

  1. 種類を見る(止まるエラーか、注意か)
  2. on line ○の行を見る。まちがいが見つからなければ、その1つ前の行を見る
  3. 「何が起きたか」の"…"に入っている名前を、コードの中で探して見比べる

ただし、Unclosed '{'とunexpected end of fileの2つだけは、on line ○がファイルの一番最後を指します。この2つは、くわしい説明のところで見てください。

また、エラーが2つ以上出たときは、一番上のエラーから直します。上のエラーが原因で、下のエラーが出ていることが多いからです。

早見表

エラー文の最初のほうで探してください。「くわしく」を押すと、このページの説明に移動します。

エラー文(最初のほう) よくある原因 くわしく
Parse error: syntax error, unexpected token "echo", expecting "," or ";" 1つ前の行の;忘れ 説明へ
Parse error: syntax error, unexpected identifier "…", expecting "," or ";" 'の閉じ忘れ、全角の記号 説明へ
Parse error: syntax error, unexpected single-quoted string 全角スペース 説明へ
Parse error: syntax error, unexpected token "=" 変数の$忘れ 説明へ
Parse error: syntax error, unexpected token "=>" >=を=>と書いた 説明へ
Parse error: Unclosed '{' on line ○ }の閉じ忘れ 説明へ
Parse error: syntax error, unexpected end of file endforeach;・endif;の書き忘れ 説明へ
Fatal error: Uncaught Error: Call to undefined function 命令の名前のつづりまちがい 説明へ
Fatal error: Uncaught Error: Undefined constant 変数の$忘れ 説明へ
Fatal error: Uncaught PDOException: SQLSTATE[…] データベースまわり(番号で原因がわかる) 説明へ
Warning: Undefined variable $… 変数名の打ちまちがい 説明へ
Warning: Undefined array key 配列の番号・キーのまちがい、送信前の$_POST 説明へ
Warning: Array to string conversion 配列をそのままechoした 説明へ
Warning: foreach() argument must be of type array|object foreachのasの前後が逆 説明へ
Warning: Cannot modify header information - headers already sent headerより前に何か表示している 説明へ
Deprecated: …(): Passing null to parameter #1 $_POST['…']に?? ''がない 説明へ

エラー文が出ないのに、表示や動きがおかしいときは、記事の最後のほうの「エラー文が出ないつまずき」を見てください。

Parse error(書き方のまちがい)

Parse errorのあとには、ほとんどの場合syntax error(シンタックス・エラー=文法のまちがい)と続きます。そのうしろによく出てくる言葉は、次の3つです。

  • unexpected(アンエクスペクテッド) … 「思っていなかった」。unexpected …で、「ここに…が来るとは思っていなかった」
  • token(トークン) … PHPのコードを区切った、echoや=などの1つ1つのまとまり
  • expecting(エクスペクティング) … 「〜が来ると思っていた」

つまり、Parse errorは「ここに○○が来るのはおかしい。本当は△△が来るはずだった」と言っています。PHPが「おかしい」と気づいた場所なので、本当のまちがいはその少し前にあることが多いです。

unexpected token "echo", expecting "," or ";"

<?php
echo 'Hello World'
echo 'こんにちは、たろうです';
Parse error: syntax error, unexpected token "echo", expecting "," or ";" in ... on line 3

意味:「echoが来るとは思っていなかった。,か;が来るはずだった」

原因:2行目の最後の;忘れです。エラーは3行目と言っていますが、PHPは「2行目が終わらないまま、3行目で次のechoが来た」ところで気づくので、まちがいは1つ前の行にあります。

直し方:on line ○の1つ前の行の最後に;があるか見る。

unexpected token "…"の"…"には、;を忘れた行の次の行の、最初の言葉が入ります。"echo"のほかに、"$name"や"if"になることもあります。うしろにexpecting "," or ";"が付いていたら、;忘れをうたがいましょう。

👉 くわしくは2本目:エックスサーバーで初めてのPHP|Hello Worldを表示してechoの意味を理解しよう

unexpected identifier "…", expecting "," or ";"

<?php
echo 'Hello World;
echo 'こんにちは、たろうです';
Parse error: syntax error, unexpected identifier "こんにちは、たろうです", expecting "," or ";" in ... on line 3

意味:「こんにちは、たろうですという名前(identifier=名前)が来るとは思っていなかった」

原因:2行目の'の閉じ忘れです。2行目の'が閉じていないので、PHPは「3行目の最初の'までが文字だ」と思います。その結果、こんにちは、たろうですが'の外にはみ出してしまいました。

直し方:'は必ず2つで1組。エラーの行と、その1つ前の行の'を数える。

本当は'の中にあるはずの文字が"…"に出ていたら、'の閉じ忘れです。

👉 くわしくは2本目:エックスサーバーで初めてのPHP|Hello Worldを表示してechoの意味を理解しよう

全角の記号が混ざったとき(unexpected single-quoted string など)

日本語入力のまま記号を打つと、見た目がほとんど同じ全角の記号が入ってしまいます。どの記号かによって、エラー文が変わります。Dockerで試すと、次のようになりました。

まちがい エラー文
echo 'Hello World';(全角スペース) unexpected single-quoted string "Hello World"
echo ’Hello World’;(全角のクォート) unexpected identifier "World’", expecting "," or ";"
echo 'Hello World';(全角セミコロン) unexpected identifier ";", expecting "," or ";"
  • 全角スペース … PHPには、echo (全角スペースつき)が1つの言葉に見えます。なので、そのうしろの'Hello World'(single-quoted string='で囲んだ文字)が「来るとは思っていなかった」と言われます
  • 全角のクォート・セミコロン … PHPには、’や;が記号ではなく、ただの文字に見えます。なので、"…"の中に’や;がそのまま出てきます

直し方:"…"の中に全角の記号が見えたら、それが犯人です。全角スペースは目で見つけにくいので、エラーの行で日本語入力をオフにして、記号とスペースを打ち直すのが早いです。

'と'のあいだの文字('こんにちは、たろうです'の「、」など)は、全角でもかまいません。

👉 くわしくは2本目:エックスサーバーで初めてのPHP|Hello Worldを表示してechoの意味を理解しよう

unexpected token "="

<?php
name = 'たろう';
echo $name;
Parse error: syntax error, unexpected token "=" in ... on line 2

意味:「=が来るとは思っていなかった」

原因:変数に値を入れる行で、$を付け忘れています。$がないので、PHPはnameを変数だと思いません。「変数でもないもののあとに=が来るのはおかしい」というエラーです。

直し方:=の左側の名前に$が付いているか見る。

👉 くわしくは3本目:PHPの変数と配列を初心者向けに解説|値を入れる箱を作ってechoで表示しよう

unexpected token "=>"

<?php
$total = 560;
if ($total => 1000) {
    echo '送料無料です';
}
Parse error: syntax error, unexpected token "=>" in ... on line 3

意味:「=>が来るとは思っていなかった」

原因:「以上」の>=を、逆の順番で=>と書いています。=>は連想配列で使う記号なので、if文の条件の中には書けません。

直し方:「以上」「以下」は>や<が先、=があと(>=、<=)。

👉 くわしくは4本目:PHPのif文とforeachを初心者向けに解説|条件で表示を変えて、配列を一覧にしよう

Unclosed '{' on line ○

<?php
$total = 560;
if ($total >= 1000) {
    echo '送料無料です';

echo '合計は' . $total . '円です';
Parse error: Unclosed '{' on line 3 in ... on line 7

意味:「3行目の{が閉じられていない」(unclosed=閉じられていない)

原因:{に対応する}の書き忘れです。

直し方:このエラーには行が2つ出てきます。見るのは前のほうのon line 3です。最後のon line 7は、PHPがファイルの最後まで}を探して、見つからなかった場所(ファイルの一番最後)なので、見に行っても何もありません。

3行目の{から下を見て、}がどこで閉じるはずだったかを探します。字下げをそろえておくと、{と}の組み合わせが見やすくなります。

👉 くわしくは4本目:PHPのif文とforeachを初心者向けに解説|条件で表示を変えて、配列を一覧にしよう

unexpected end of file

<?php
$fruits = ['りんご', 'みかん', 'バナナ'];
?>
<ul>
  <?php foreach ($fruits as $fruit): ?>
    <li><?php echo $fruit; ?></li>
</ul>
Parse error: syntax error, unexpected end of file in ... on line 8

意味:「思っていないところで、ファイルが終わってしまった」(end of file=ファイルの終わり)

原因::で書いたforeachの終わりのendforeach;を書き忘れています。if (…):のendif;を忘れたときも、同じエラーになります。

直し方:Unclosed '{'と同じく、on line 8はファイルの一番最後なので、見に行っても何もありません。ファイルの中のforeach (…):とif (…):を探して、それぞれにendforeach;・endif;があるか数えます。

👉 くわしくは4本目:PHPのif文とforeachを初心者向けに解説|条件で表示を変えて、配列を一覧にしよう

Fatal error(重大なエラー。その行で止まる)

Fatal errorが出ると、その行から下は実行されません。HTMLの途中で起きると、ページがそこで切れてしまいます。<title>の中で起きると画面が真っ白になることもあるので、そのときは9本目を見てください。

Call to undefined function ○○()

<?php
$name = 'たろう';
echo htmlspecialchar($name, ENT_QUOTES, 'UTF-8');
Fatal error: Uncaught Error: Call to undefined function htmlspecialchar() in /home/…/white.php:3

意味:「htmlspecialchar()という命令は、ない」(call=呼ぶ、undefined=決められていない、function=命令)

原因:命令の名前のつづりまちがいです。この例では、htmlspecialcharsの最後のsがぬけています。

直し方:エラー文に出ている命令の名前と、正しい名前を1文字ずつ見比べる。このシリーズで使った命令のうち、長いものは特にまちがえやすいです。

  • htmlspecialchars(最後にs)
  • mb_send_mail、mb_strlen(mb_のあとの_)
  • nl2br(エヌ・エル・ツー・ビー・アール)
  • var_dump、print_r(_の有無)

👉 くわしくは9本目:PHPで画面が真っ白になったときの対処法|原因の見つけ方を初心者向けに解説

Undefined constant "○○"

<?php
$name = 'たろう';
echo name;
Fatal error: Uncaught Error: Undefined constant "name" in /home/…/practice.php:3

意味:「nameという定数(constant=ていすう)は、ない」

原因:echoするところで、変数の$を付け忘れています。$が付いていない名前を見ると、PHPは定数だと思って探しにいきます。定数はこのシリーズでは使っていないので、constantと出たら、$の付け忘れと考えてかまいません。

直し方:"…"に出ている名前に、$を付ける。

同じ$の付け忘れでも、name = 'たろう';のように値を入れる行で忘れたときは、上で説明したParse error: … unexpected token "="になります。

👉 くわしくは3本目:PHPの変数と配列を初心者向けに解説|値を入れる箱を作ってechoで表示しよう

Uncaught PDOException: SQLSTATE[…]

Fatal error: Uncaught PDOException: SQLSTATE[HY000] [1045] Access denied for user 'xsample_user'@'…' (using password: YES)

7本目・8本目のデータベースのエラーです。PDOExceptionは「PDO(データベースにつなぐしくみ)で起きたエラー」という意味です。長くてこわく見えますが、SQLSTATE[…]のあとの番号を見れば、原因がしぼれます。

番号と言葉 意味 見直すところ
[1045] Access denied for user このユーザーは入れない ユーザー名(「サーバーID_」付きか)とパスワード
[1044] Access denied for user … to database このユーザーは、このデータベースに入れない データベース名(「サーバーID_」付きか)、ユーザーにアクセス権があるか
[2002]やgetaddrinfo for … failed データベースのある場所にたどり着けない ホスト名($dbHost)
[42S02]: Base table or view not found そのテーブルはない SQLのテーブル名のつづり、テーブルを作ったか
[42S22]: Column not found … Unknown column その列はない SQLの列の名前のつづり('…'に出ている名前)
[HY093]: Invalid parameter number ?の数と、入れる値の数が合わない SQLの?の数と、executeの配列の値の数
[42000]: Syntax error … 1064 SQLの書き方のまちがい near '…'に出ている文の少し前。,や( )、FROMなどのつづり

contact.phpでは、tryとcatchで受け止めているので、どんな失敗でも「保存できませんでした」としか表示されません。原因を調べたいときは、7本目で説明したとおり、db_test.phpのような確認用のファイルで同じことをして、エラー文を見てください(調べ終わったら削除します)。

ホスト名は、エックスサーバーの公式の「よくある質問」によると、MariaDBのデータベースならlocalhost、MySQL5.7ならmysql○○.xserver.jpです。サーバーパネルの「MySQL設定」→「MySQL一覧」の下のほうで確認できます。

👉 くわしくは7本目:PHPでデータベースに保存する|PDOでお問い合わせフォームの内容をMySQLに登録する方法を初心者向けに解説

👉 一覧表示(ORDER BYやFROMのまちがい)は8本目:PHPでデータベースの中身を一覧表示する|PDOのSELECTでお問い合わせ一覧を作り、パスワードで守る方法を初心者向けに解説

Warning(注意。止まらないけど、表示がおかしくなる)

Warningでは、PHPは止まらずに最後まで動きます。そのぶん、「ページは出ているのに、一部だけ空っぽ」のようになりやすいです。

ここでよく出てくるのがUndefined(アンディファインド)という言葉です。「決められていない」「作られていない」という意味で、「その名前のものは、ない」と言っています。

Undefined variable $○○

<?php
$name = 'たろう';
echo $nmae;
Warning: Undefined variable $nmae in ... on line 3

意味:「$nmaeという変数(variable)は、作られていない」

原因:変数名の打ちまちがいです。よくあるのは、次の3つです。

  • つづりのまちがい … $nameのつもりが$nmae
  • 大文字と小文字のまちがい … $nameと$Nameは別の変数
  • "の中で、変数のすぐうしろに文字を続けた … "こんにちは、$nameさん"と書くと、PHPは$nameさんまでを変数の名前だと思い、Undefined variable $nameさんになります。{$name}と波かっこで囲むか、'こんにちは、' . $name . 'さん'のように.でつなぎます

直し方:エラー文に出ている名前と、最初に値を入れたときの名前を1文字ずつ見比べる。

foreachのasの前後を逆にしたときにも出ます(下の説明を見てください)。

👉 くわしくは3本目:PHPの変数と配列を初心者向けに解説|値を入れる箱を作ってechoで表示しよう

Undefined array key

「配列(array)に、そのキー(key)はない」という意味です。このシリーズでは、3つの場面で出てきました。"…"で囲まれていれば名前のキー、囲まれていなければ番号です。

配列の番号を1から数えた(3本目)

<?php
$fruits = ['りんご', 'みかん', 'バナナ'];
echo $fruits[3];
Warning: Undefined array key 3 in ... on line 3

配列の番号は0から始まるので、この配列にあるのは0番・1番・2番だけです。「バナナ」は$fruits[2]です。どの番号に何が入っているかわからないときは、print_rで中身を見ましょう。

フォームを開いただけで出る・送信しても出る(5本目)

Warning: Undefined array key "name" in ... on line 2

$_POST['name']で、nameが送られてきていないときに出ます。原因は次のどれかです。

  • まだ送信していないのに$_POST['…']を使っている … if ($_SERVER['REQUEST_METHOD'] === 'POST')の中で受け取り、$_POST['name'] ?? ''と?? ''を付ける
  • フォームのname="…"と$_POST['…']のつづりがちがう … name="namae"と$_POST['name']など。print_r($_POST);で、実際に何が届いているか見る
  • <form>にmethod="post"がない … 送信した内容がURLに出ていたら、これです

5本目の完成版のように?? ''を付けていると、このWarningは出ず、そのかわり「お名前を入力してください」のように未入力あつかいになります。

データベースから取り出した行で出る(8本目)

Warning: Undefined array key "nmae" in /home/…/admin/inquiries.php on line 41

$inquiry['nmae']のように、[ ]の中の名前がテーブルの列の名前とちがっています。id・name・email・message・created_atと見比べてください。表のそのマスが空っぽになります。

👉 くわしくは3本目:PHPの変数と配列を初心者向けに解説|値を入れる箱を作ってechoで表示しよう

👉 フォームの場合は5本目:PHPでお問い合わせフォームを作る|入力を受け取って表示し、未入力チェックまで初心者向けに解説

Array to string conversion

<?php
$fruits = ['りんご', 'みかん', 'バナナ'];
echo $fruits;
Warning: Array to string conversion in ... on line 3
Array

意味:「配列(array)を文字(string)に変えた(conversion=変換)」

原因:配列をそのままechoしています。echoは配列の中身を出せないので、「配列ですよ」という意味のArrayという文字だけを表示します。

直し方:

  • 1つだけ表示したい → echo $fruits[0];のように番号やキーを付ける
  • 全部を表示したい → foreachで1つずつ取り出してechoする
  • 中身を確かめたいだけ → print_rやvar_dumpを使う

画面にArrayという文字が出ていたら、このWarningをうたがってください。

👉 くわしくは3本目:PHPの変数と配列を初心者向けに解説|値を入れる箱を作ってechoで表示しよう

foreach() argument must be of type array|object, null given

<?php
$fruits = ['りんご', 'みかん', 'バナナ'];
foreach ($fruit as $fruits) {
    echo $fruit;
}
Warning: Undefined variable $fruit in ... on line 3

Warning: foreach() argument must be of type array|object, null given in ... on line 3

意味:「foreach()に渡すもの(argument)は、配列(array)でなければいけない(must be)。でも、空っぽのもの(null)が渡された(given)」

原因:foreachのasの前後が逆です。asの前の$fruitを配列だと思って探したけれど、そんな変数は作られていないので、1つ目のUndefined variableも一緒に出ています。

直し方:「配列(複数形) as 1つ分(単数形)」の順にする。foreach ($fruits as $fruit)です。

8本目の$inquiriesのように、データベースから取り出した結果をforeachに渡しているときは、foreachに書いた変数名と、fetchAllの結果を入れた変数名が同じかも見てください。

👉 くわしくは4本目:PHPのif文とforeachを初心者向けに解説|条件で表示を変えて、配列を一覧にしよう

Cannot modify header information - headers already sent

Warning: Cannot modify header information - headers already sent by (output started at /home/…/contact.php:2) in /home/…/contact.php on line 3

意味:「ヘッダーの情報を変えられない(cannot modify)。ヘッダーはもう送られた(already sent)」

原因:header('Location: …');より前に、何かが表示されてしまっています。この1行には、行の番号が2つ入っています。

  • output started at …:2 … 「2行目で表示が始まった」。直すのはこっちです
  • on line 3 … 「3行目のheaderでうまくいかなかった」

直し方:output started atのうしろの行を見て、表示しているものを消すか、headerより下に動かします。よくあるのは次の4つです。

  • headerより前にechoやprint_rがある … 確認のために書いたものの消し忘れ
  • 9本目の目印のechoやvar_dumpを消し忘れた … これも「表示」です
  • <?phpの前に空の行やスペースがある … output started at …:1(1行目)と出ます。<?phpはファイルの1行目の一番左から書きます
  • headerをHTMLより下に書いている … <!DOCTYPE html>などのHTMLも表示です。headerはHTMLより上の、?>より前に書きます

このWarningが出ているときは移動ができていないので、お問い合わせフォームでは、再読み込みで二重に送信されてしまいます。見つけたらすぐに直しましょう。

👉 くわしくは6本目:PHPでお問い合わせフォームからメールを送る|mb_send_mailの使い方とエックスサーバーでの注意点を初心者向けに解説

Deprecated(いずれ使えなくなる書き方)

Deprecated(デプリケイテッド)は、「今は動くけれど、この書き方はいずれ使えなくなるので、やめてください」というお知らせです。PHPは止まりません。

上で説明したとおり、エックスサーバーの初期設定では、Deprecatedは画面に出ません。

○○(): Passing null to parameter #1 ($string) of type string is deprecated

<?php
$name = $_POST['name'];
echo htmlspecialchars($name, ENT_QUOTES, 'UTF-8');
Warning: Undefined array key "name" in ... on line 2

Deprecated: htmlspecialchars(): Passing null to parameter #1 ($string) of type string is deprecated in ... on line 3

意味:「htmlspecialchars()の1つ目(parameter #1)に、null(何も入っていないもの)を渡すのは、いずれできなくなる」

原因:$_POST['name']に?? ''を付けずに受け取ったので、nameが送られてこなかったときに、$nameにnullが入りました。それをhtmlspecialcharsに渡しています。trimに渡したときは、trim(): Passing null …と、命令の名前だけが変わります。

直し方:$_POST['…']のうしろに?? ''を付ける。

$name = trim($_POST['name'] ?? '');

エックスサーバーでは、このうち1つ目のWarning: Undefined array key "name"だけが画面に出ます。Warningのほうを直せば(?? ''を付ければ)、Deprecatedも一緒に消えます。Deprecatedが見えなくても、?? ''は付けておきましょう。

👉 くわしくは5本目:PHPでお問い合わせフォームを作る|入力を受け取って表示し、未入力チェックまで初心者向けに解説

エラー文が出ないつまずき

ここまでは「エラー文が出たとき」でした。でも、本当にやっかいなのは、エラー文が出ないのに、思ったとおりに動かないときです。シリーズで出てきたものを、起きたことから引けるようにまとめました。

起きたこと よくある原因 くわしく
画面が真っ白/ページが途中で切れる エラーが<title>の中など見えない場所に出ている、display_errorsがOFF、ifの条件・echo忘れ・exit 9本目
「このページは動作していません」「HTTP ERROR 500」 display_errorsがOFFのときのエラー。php.ini設定とエラーログを見る 9本目
コードがそのまま画面に出る ファイル名が.phpで終わっていない、<?phpの書きまちがい 2本目
ページの日本語が�になる ファイルの保存文字コードがUTF-8ではない 2本目
画面に$nameとそのまま出る 'の中に変数を書いた。'の外に出して.でつなぐ 3本目
if文がいつも当てはまる ===のつもりで=を1つだけ書いた、if (…)のうしろに;を付けた 4本目
入力したのに「お名前を入力してください」と出る フォームのname="…"と$_POST['…']のつづりがちがう 5本目
送信すると内容がURLに出る <form>のmethod="post"がない・つづりまちがい 5本目
送信すると「404 Not Found」 action="…"や移動先のファイル名がちがう、ファイルの場所がちがう 5本目
再読み込みで「フォームを再送信しますか?」 エラーではない。header('Location: …')とexit;で防ぐ 6本目
メールが届かない 迷惑メールフォルダ、宛先のつづり、From、無料お試し期間中、SPF・DKIM設定 6本目
メールが文字化けする/絵文字が?になる mb_language・mb_internal_encodingの書き忘れ、mailを使った/ISO-2022-JPには絵文字がない 6本目
メールに\nとそのまま出る '\n'と'で囲んだ。"\n"にする 6本目
保存された日本語が「ãŸã‚ã†」になる DSNの;charset=utf8mb4の書き忘れ・つづりまちがい 7本目
「送信しました」なのにデータベースに行が増えない phpMyAdminを再読み込みしていない、別のデータベースを見ている 7本目
一覧が「まだお問い合わせはありません。」のまま 保存できていない、$dbNameがちがう 8本目
画面に<br />とそのまま出る nl2brとhtmlspecialcharsの順番が逆 8本目
直したのに表示が変わらない 保存していない、別のファイルを直している、再読み込みしていない 9本目

この記事にないエラーが出たとき

英語の言葉の意味を手がかりにする

エラー文に出てくる英語は、実はそれほど多くありません。この記事に出てきた言葉をまとめておきます。これだけ知っていれば、初めて見るエラー文でも、だいたいの意味がつかめます。

言葉 意味
undefined 決められていない・作られていない(=その名前のものはない)
unexpected 思っていなかった(=ここに来るのはおかしい)
expecting 〜が来ると思っていた
unclosed 閉じられていない
uncaught だれも受け止めなかった
not found 見つからない
denied 断られた
must be 〜でなければいけない
given 渡された
variable / array / key / function 変数 / 配列 / キー / 命令
string / null 文字 / 何も入っていないもの
line 行

検索するときは「in」より前だけを使う

インターネットで検索するときは、エラー文を全部コピーするのではなく、in /home/…より前の部分を使います。

Warning: Undefined array key "name" in /home/xsample/…/contact.php on line 2

この場合は、Warning: Undefined array keyで検索します。理由は2つです。

  • in /home/…から先は、あなたのサーバーのファイルの場所なので、ほかの人のエラー文と一致しません。"name"のような、自分で付けた名前も外したほうが見つかりやすいです
  • /home/のうしろには、あなたのサーバーIDが入っています。質問サイトなどにエラー文を貼るときは、この部分を…などに書きかえてから貼りましょう

1つ直したら、別のエラーが出てきた

Parse errorを直したら、今度はWarningが出てきた――これは、前に進んだ証拠です。

Parse errorのときは、PHPは1行も実行していませんでした。直したことで、はじめて上から実行されるようになり、その先にあった別のまちがいが見えてきたのです。あわてずに、また一番上のエラーから1つずつ直していきましょう。

まとめ|エラー文は「種類・中身・行」の3つを見る

  • エラー文は「種類」「何が起きたか」「ファイル」「行」の4つでできている。"…"には自分が書いた名前が入っていることが多い
  • 種類は4つ。Parse error(書き方のまちがい。1行も実行されない)、Fatal error(その行で止まる)、Warning(止まらないが表示がおかしくなる)、Deprecated(いずれ使えなくなる書き方)
  • エックスサーバーのerror_reportingの初期値はE_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATEDなので、Deprecatedは画面に出ない
  • Parse errorは、on line ○の1つ前の行もあやしい。Unclosed '{'とunexpected end of fileは、行がファイルの最後になる
  • Undefinedは「その名前のものはない」。名前のつづり、大文字・小文字、$を見比べる
  • データベースのエラーはSQLSTATE[…]のあとの番号で原因がしぼれる
  • エラーが2つ以上出たら一番上から。検索するときはin /home/…より前だけを使い、人に見せるときはサーバーIDを隠す

エラー文は、PHPがあなたに「ここがおかしいよ」と教えてくれている手紙のようなものです。はじめは英語の長い文にしか見えませんが、読み方がわかると、エラーが出るたびに直すところがすぐ見つかるようになります。この記事は、エラーが出たときにいつでも戻ってこられるように、ブックマークしておいてください。

エラー文すら出ずに画面が真っ白になったときは、前回の記事をどうぞ。

👉 PHPで画面が真っ白になったときの対処法|原因の見つけ方を初心者向けに解説

次の記事からは、いよいよシリーズの仕上げです。ここまで学んだことを全部使って、メモアプリを作って公開します(次の記事と、最終回の2回に分けて紹介します)。

👉 PHPでメモアプリを作る|データベースに書く・一覧・削除を1ファイルで作る方法を初心者向けに解説

今すぐエックスサーバーを試してみよう

10日間の無料お試し期間あり。使い勝手を確かめてから、料金を払うかどうか決められます。

無料で試してみる →

関連記事