PHP の基本構文（開始タグ・コメント・インデント）を完全ガイド！初心者向け解説
新人
「PHP ってどんなプログラミング言語ですか？」
先輩
「PHP は、Web サイトを作るためのプログラミング言語だよ。動的なページを簡単に作れるのが特徴だね。」
新人
「PHP の基本的な書き方ってどうなっていますか？」
先輩
「それじゃあ、まずは PHP の開始タグと終了タグの書き方から説明しよう！」
1. PHP とは？
PHP（Hypertext Preprocessor）は、サーバーサイドで動作するプログラミング言語です。主に Web 開発に利用され、動的なコンテンツを作成するのに適しています。
例えば、PHP を使うと、HTML に埋め込んでページを生成することができます。
<!DOCTYPE html>
<html>
<head>
<title>PHP の基本</title>
</head>
<body>
<?php echo "こんにちは、PHP！"; ?>
</body>
</html>
このコードを実行すると、ブラウザには 「こんにちは、PHP！」 と表示されます。
2. PHP の開始タグと終了タグ
PHP のコードを書くときは、必ず <?php で始まり、?> で終わります。
以下のように、PHP コードの中に HTML を組み合わせて書くことができます。
<?php
echo "Hello, PHP!";
?>
このコードをブラウザで実行すると、以下のように表示されます。
Hello, PHP!
3. コメントの書き方
PHP では、コードに説明を加えるために「コメント」を書くことができます。コメントは、プログラムの動作には影響しません。
一行コメント（// または #）
一行コメントは、コードの途中や行末に追加できます。
<?php
// これは一行コメントです
echo "コメントの使い方"; # これも一行コメントです
?>
複数行コメント（/* ... */）
複数行コメントは、長い説明を入れたいときに便利です。
<?php
/*
これは複数行のコメントです。
説明を長く書きたいときに使います。
*/
echo "複数行コメントの使い方";
?>
コメントを活用すると、コードの意味を後から理解しやすくなります。
4. PHP のコードを書くときのルール（インデントの重要性）
プログラムを読みやすくするためには、インデント（字下げ）を正しく使うことが重要です。インデントを統一することで、コードの構造が分かりやすくなり、エラーを見つけやすくなります。
例えば、次のようなインデントがないコードは読みにくいです。
<?php
if(true){
echo "インデントがないと読みにくい";
}
?>
しかし、適切にインデントすると、一目でコードの構造が分かるようになります。
<?php
if (true) {
echo "インデントをつけると読みやすい";
}
?>
このように、インデントを付けることで、条件分岐やループの範囲が明確になり、バグを防ぎやすくなります。
5. インデントのやり方と推奨スタイル（スペース or タブ）
PHP では、インデントの方法としてスペースとタブのどちらかを使用します。どちらを使うかはチームのルールによりますが、一般的には スペース4つ または タブ1つ を使うことが推奨されています。
スペース4つの例（推奨）
<?php
if (true) {
echo "これはスペース4つのインデントです";
}
?>
タブ1つの例
<?php
if (true) {
echo "これはタブ1つのインデントです";
}
?>
どちらを使うかは開発環境のルールに従いましょう。プロジェクトによっては、PSR-12（PHPのコードスタイルガイド）に従い、スペース4つを使うことが一般的です。
6. PHP のコードの見やすさを向上させるためのコツ
PHP のコードをきれいに書くために、以下のポイントを意識しましょう。
1. 適切なインデントを使う
コードのネスト（入れ子）が深くなっても、適切なインデントを使えば構造が分かりやすくなります。
2. 空行を使ってコードを整理する
適度に空行を入れることで、コードの区切りが分かりやすくなります。
<?php
function sayHello() {
echo "こんにちは";
}
echo "関数の前に空行を入れると分かりやすい\n";
sayHello();
?>
3. コメントを適切に活用する
複雑な処理を説明するために、コメントを適切に活用しましょう。ただし、不要なコメントはコードを読みにくくするため、必要な部分にだけコメントを記述するのが重要です。
<?php
// ユーザーの名前を取得して表示する
$name = "太郎";
echo "こんにちは、" . $name . "さん";
?>
4. コードの長さを適切にする
1行のコードが長くなりすぎると読みにくくなるため、適度に改行を入れることをおすすめします。
<?php
// 長すぎるコード（読みにくい）
echo "これは非常に長い文字列を出力するコードですが、適切に改行しないととても読みにくくなります。";
// 適切に改行（読みやすい）
echo "これは非常に長い文字列を出力するコードですが、" .
"適切に改行すると読みやすくなります。";
?>
このように、適度に改行を入れることでコードの可読性を向上させることができます。
5. コードの整形ツールを活用する
コードのフォーマットを統一するために、以下のツールを活用しましょう。
- PHP-CS-Fixer: コードの整形を自動で行うツール
- PHP_CodeSniffer: コードスタイルのチェックツール
- VS Code のフォーマッター: Visual Studio Code でコードの自動整形が可能
7. 実際にPHPの基本コードを書いてみよう（簡単なサンプルコード）
ここまで PHP の基本構文について学んできました。実際に、簡単な PHP のコードを書いてみましょう。
まずは、PHP で「こんにちは、PHP！」と表示するプログラムです。
<?php
echo "こんにちは、PHP！";
?>
このコードを実行すると、以下のように表示されます。
こんにちは、PHP！
次に、変数を使って名前を出力するサンプルを見てみましょう。
<?php
$name = "太郎";
echo "こんにちは、" . $name . "さん！";
?>
こんにちは、太郎さん！
PHP では、$ を使って変数を定義し、文字列を連結することで動的なメッセージを作ることができます。
次に、if 文を使った条件分岐の例を紹介します。
<?php
$age = 18;
if ($age >= 18) {
echo "あなたは成人です。";
} else {
echo "あなたは未成年です。";
}
?>
あなたは成人です。
このように、条件分岐を使うことで状況に応じた処理を実行できます。
8. よくある初心者のミス（タグの閉じ忘れ、コメントの書き方ミス、インデントのズレ）
PHP を始めたばかりの初心者がよくやる間違いについて解説します。
1. タグの閉じ忘れ
PHP のコードは <?php で始まり、適切に ?> で閉じる必要があります。しかし、閉じ忘れるとエラーになります。
間違った例：
<?php
echo "これは間違ったコードです";
正しい例：
<?php
echo "これは正しいコードです";
?>
2. コメントの書き方ミス
コメントを正しく使わないと、コードが正常に動作しなくなることがあります。
間違った例：
<?php
echo "こんにちは"; /* ここでコメントが閉じていない
echo "PHP!";
?>
正しい例：
<?php
echo "こんにちは"; /* ここでコメントが閉じている */
echo "PHP!";
?>
3. インデントのズレ
インデントがズレていると、コードの構造が分かりにくくなります。
間違った例：
<?php
if (true) {
echo "これはインデントがズレていて読みにくい";
}
?>
正しい例：
<?php
if (true) {
echo "これはインデントが適切で読みやすい";
}
?>
インデントを適切に使うことで、コードの可読性が向上します。
9. PHPの基本構文を理解することの重要性
PHP の基本構文を理解することは、Web 開発をスムーズに進めるためにとても重要です。
1. コードの読みやすさが向上する
適切なインデントやコメントを使うことで、他の人が読んでも分かりやすいコードになります。
2. バグを減らせる
タグの閉じ忘れやインデントミスを防ぐことで、エラーの発生を減らすことができます。
3. さまざまなプロジェクトに対応できる
PHP の基本をしっかり学ぶことで、WordPress や EC サイトの開発など、さまざまなプロジェクトで活躍できます。
PHP をマスターする第一歩として、今回学んだ基本構文をしっかり身につけましょう！
