これだけは押さえるPHPの言語基礎：エラーの8割を防ぐ文法・字句構造・実務TIPS

PHP

【この記事で得られること】

  • 変数名、セミコロン、コメント、大小文字など、PHPの「文法の土台」を最短で理解できます。
  • エラーの8割（セミコロン漏れ、大小文字違い）を防ぐための実務的な書き方がわかります。
  • PHP 8.xのモダンなコーディング規約（PSR-12）に基づいたコピペ可能なスニペットが手に入ります。

皆さん、こんにちは！ 最速でプログラミングの基礎を固めるブロガーの[Zuba]です。

PHPを学び始めたばかり、または他言語経験者の方へ。「プログラムの最小単位」である字句構造（Lexical Structure）を最初に固めておくと、後の学習効率が劇的に上がります。例えるなら、家を建てる前の基礎工事です。

この基礎を疎かにすると、些細な文法ミス（セミコロン忘れ、大文字小文字の間違い）で毎回時間を浪費することになります。

まずは結論から。PHPの文法エラーの多くは、この基礎を固めるだけで解決します。

【結論】エラーの8割を防ぐ基礎の型

  1. 単純文にはセミコロンを必ず打つ。
  2. 変数の大小文字は厳密に区別する（$nameと$NAMEは別物）。
  3. コメントは//（C++風）を標準とし、一時無効化に/* */を使う。
  4. コーディング規約（PSR-12）に従って、インデントと命名を統一する。

2.1 字句構造の要点（プログラムの最小単位）

字句構造とは、コードをプログラムが解釈できる最小単位（トークン）に分割するためのルールです。最低限、以下の4点を押さえるだけで、プログラムが突然動かなくなる事態を大幅に減らせます。

2.1.1 大文字小文字の扱い（Case Sensitivity）

PHPは、要素によって大文字小文字の区別（Case Sensitive/Insensitive）が異なります。

✅ 区別する（Sensitive）：

  • 👉 変数：$name と $NAME は全く別の変数です。
  • 👉 定数：MY_CONST と my_const は別物（define()使用時）。

✅ 区別しない（Insensitive）：

  • 👉 言語キーワード：if, echo, while, function などは、IFやEcHoでも動きます。
  • 👉 ユーザー定義の関数・クラス名：呼び出し時は大小を区別しません。

実務TIP：PSR-12規約で統一
関数やクラス呼び出しは大小非区別で動きますが、可読性とツールの互換性のため、PSR-12などの規約に従い、定義と呼び出しで同一表記に統一するのがベストプラクティスです。

  • クラス名: StudlyCaps（例: UserController）
  • 関数/メソッド名: camelCase（例: listAllUsers()）

2.1.2 文とセミコロン（必須と任意の境界）

PHPのプログラムは「文（Statement）」の集まりです。文の終わりを示すのがセミコロン（;）です。

  • 単純文：変数への代入や関数呼び出しなど、一行で完結する文にはセミコロンが必須です。
  • ブロック文：if, for, whileなどの制御構造の閉じ波括弧 } の後はセミコロンは不要です。
例：セミコロンの境界

if ($needed) {
    echo "We must have it!"; // <-- 単純文なので必須
} // <-- ブロックの閉じ括弧なので不要

echo "Hello, world"; // <-- 閉じタグ直前は省略可能だが、拡張のためつけるのが無難
?>

落とし穴： セミコロン漏れは、次の行のコードと合体して解釈され、予期せぬ場所で「Parse error」を引き起こす最たる原因です。

2.1.3 空白・改行（可読性を高める整形ルール）

PHPの文法上、空白や改行の数は自由です。しかし、可読性を劇的に高めるために、PSR-12規約では以下の整形を推奨しています。

  • インデントは4スペースを使用。
  • 長い引数リストは改行して整形する。
例：可読性の高い改行整形

// アンチパターン: 詰め込みすぎ
raise_prices($inventory, $inflation, $cost_of_living, $greed);

// 推奨パターン: 引数ごとに改行
raise_prices(
    $inventory,
    $inflation,
    $cost_of_living,
    $greed
);

2.1.4 コメント（# // /* */ の使い分けと注意）

コメントは、「コードの意図や前提、設計上の判断理由」を残すために使います。明白な処理（例: $aに1を足す）の説明は不要です。

種類書き方用途
C++風//単行の標準スタイル（最も推奨）
Shell風#単行の短い注釈（//と混在させない方が吉）
C風/* ... */複数行にわたる説明や、一時的なブロック無効化
例：コメントの使い分け

// ユーザーに確認フォームを表示
if ($double_check) {
    echo confirmation_form();
}

$value = $p * exp($r * $t); // 複利計算。利息は月単位で計算済

/*
* 次の機能はパフォーマンス上の問題があるため、
* 安定化まで一時的に無効化する。
*/
// $g = 7;
// $h = 8;

絶対禁止！ブロックコメントのネスト
/* ... /* ネスト */ ... */ はエラーになります。ブロック無効化には//で一行ずつコメントアウトすることを推奨します。

2.2 リテラルと識別子の基礎

2.2.1 リテラル（Literals）

リテラルとは、プログラムコードに直接記述された値のことです。

  • 数値：2001 (10進数), 0xFE (16進数), 1.4142 (浮動小数点)
  • 文字列：
    • ダブルクオート (" ")：変数展開（"Hello $name"）や特殊文字（\n）が有効。
    • シングルクオート (' ')：リテラル（文字そのまま）として解釈。高速でセキュリティも安定。
  • 真偽：true, false（大文字小文字は非区別）
  • null：null（値がないことを示す。大文字小文字は非区別）

実務TIP：安全な文字列展開
予期しない変数展開を防ぐため、変数展開が不要な文字列は基本的にはシングルクオートを使うことを推奨します。複数行文字列にはヒアドキュメント/ナウドキュメントが便利です。

2.2.2 識別子（Identifiers）

識別子とは、変数・関数・クラス・定数などに付ける名前のルールです。

  • 役割：変数、関数、定数、クラス名
  • 先頭文字：英字（a–z, A–Z）またはアンダースコア（_）で始まる必要があります。
  • 後続：数字（0–9）も利用可能です。

特に重要な変数名のルール。

変数名ルール

  • 先頭は必ず $ を付ける。
  • 大小文字は厳密に区別される（$bill と $Bill は別物）。

有効例： $total_count, $MaximumForce, $_internal_val
無効例： $3wa (数字始まり), $!error (記号不可)

2.2.3 キーワード（予約語の考え方と実務的注意）

キーワード（予約語）は、PHP言語の機能のために予約されている語句で、変数/関数/クラス名として使用できません。

  • 例：if, else, while, for, function, class, echo, return, new など

実務TIP：衝突回避

  1. 将来の予約語：PHPはバージョンアップで予約語が増えることがあります（例: PHP 8で追加された match）。一般名詞は避け、プレフィックス（接頭辞）を付けて衝突を避けましょう。（例: $app_match）
  2. 組み込み関数：count() や exit() など、組み込み関数と同名の関数を自分で定義することも避けましょう。

よくあるミスとチェックリスト

プログラムが「動かない」原因のほとんどは、以下の単純なミスです。書いたコードを必ずセルフチェックしましょう。

問題点エラーメッセージ例解決策（関数/操作）
セミコロン漏れParse error: syntax error, unexpected 'echo'単純文の末尾に必ず ; を追加。エディタの構文チェックを有効化。
変数名の大文字小文字違いUndefined variable: Total変数名は常に大小文字を区別。$total と $Total は別物です。
予約語の衝突Parse error: syntax error, unexpected 'match' (T_MATCH)変数/関数名に if, echo, match などのキーワードを使用しない。
予期しない文字列展開Hello, $name とそのまま表示されるシングルクオート ' ' ではなくダブルクオート " " を使う。
PHPの閉じタグWarning: Cannot modify header information - headers already sent純粋なPHPファイル（HTMLを含まない）の末尾の ?> は省略しましょう。

コピペ用スニペット集

このセクションはブックマーク必須です。必要な時に即座にコードをコピペして、時間の節約に役立ててください。

// --- 2.1.1 大文字小文字 ---

// 変数は区別される（$fooと$Fooは別）
$foo = 10;
$Foo = 20;

// 関数呼び出しは区別されない（echo, ECHO, EcHoは同じ）
ECHO "Hello";

// --- 2.1.2 文とセミコロン ---

if ($needed) {
    echo "We must have it!"; // 単純文は ; 必須
} // ブロックの } は ; 不要

echo "Done."; // 閉じタグ直前も付けておくのが無難

// --- 2.1.3 改行と整形（PSR-12推奨） ---

raise_prices(
    $inventory,
    $inflation,
    $cost_of_living
);

// --- 2.1.4 コメントの使い分け ---

// 単行コメント（標準推奨）
/* 複数行にわたる説明や、
* 一時的なブロック無効化に使う。
*/
$g = 7;
// $h = 8; // <- ネスト回避のため /* */ ではなく // を使う

// --- 2.1.5 リテラルと文字列展開 ---

$name = "Elphaba";

echo "Hello, $name\n"; // 変数展開される
echo 'Hello, $name\n'; // 文字列リテラルとしてそのまま表示される

// ヒアドキュメントで複数行を扱う
$s = <<

お疲れ様でした！これであなたはPHPの文法の「型」を完全にマスターしました。

この基礎固めができていれば、次章以降で学ぶデータ型、演算子、制御構文の学習にスムーズに進めます。些細な文法エラーでつまずくことなく、ロジックの構築に集中できるはずです！

早速、手元の環境でスニペットを試して、「セミコロン漏れ」のエラーを体感してみましょう。

あわせて読みたい

コメント

タイトルとURLをコピーしました