PHP Debuggerの基本設定と活用ポイントを解説

<?php
// エラー報告を全て有効化する設定
error_reporting(E_ALL);
ini_set('display_errors', '1');
?>

// 上記スクリプトを実行すると、PHPエラーがすべて表示されるようになります。

<?php
// phpinfo関数を利用して拡張モジュールの情報を表示する例
phpinfo(); // phpinfoページをブラウザに表示する
?>

// 出力例は、PHPバージョンや有効な拡張モジュールの一覧、設定情報が表示されます。

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "PHP Debug",
      "type": "php",
      "request": "launch",
      "program": "${workspaceFolder}/index.php", // ここにデバッグ対象のPHPファイルのパスを指定
      "port": 9003, // 利用するポート番号
      "pathMappings": {
        "/var/www/html": "${workspaceFolder}" // コンテナ内等のマッピング設定
      }
    }
  ]
}

// 上記設定ファイルを利用してデバッグツール(例：VSCodeのPHP Debug拡張)が起動可能となります。

# PHPデバッガをコマンドラインから起動する例

php -d xdebug.mode=debug -d xdebug.start_with_request=yes index.php

# 上記コマンドにより、PHPファイルがデバッグモードで実行され、Xdebugが接続待ち状態となります。

<?php
$number = 10; // ここにブレークポイントを設定して、変数の状態を確認する
$result = $number * 2;
echo "計算結果: " . $result; // 結果出力
?>

// ブレークポイントで一時停止し、$numberや$resultの値を確認できます。

<?php
for ($i = 0; $i < 20; $i++) {
    // $iが特定の値になった時のみ処理を中断させる条件付きブレークポイントを設定
    echo "現在の値: " . $i . "\n";
}
?>

// 条件付きブレークポイントを「$i == 10」に設定した場合、$iが10になった瞬間に実行が中断されます。

<?php
function processData($data) {
    $result = $data + 5; // ここでブレークポイントを設定して、$resultを確認する
    return $result;
}
$value = 15;
$output = processData($value);
echo "最終出力: " . $output;
?>

// デバッガによる実行中断後、ステップイン・ステップオーバーによる制御が可能です。

<?php
$globalValue = 100; // グローバル変数
function calculate($param) {
    $localValue = $param * 2; // ローカル変数
    return $localValue;
}
echo calculate(50);
?>

// コード実行中、$globalValueと$localValueの値をウォッチ機能で確認できます。

<?php
function functionA() {
    functionB();
}
function functionB() {
    // 故意に例外を発生させる
    throw new Exception("エラー発生");
}
try {
    functionA();
} catch (Exception $e) {
    echo $e->getMessage() . "\n";
    // エラーメッセージと共にスタックトレースを出力
    echo $e->getTraceAsString();
}
?>

// 出力例：
エラー発生
#0 {main}
// または、詳細なスタック情報が表示されます。

<?php
session_start(); // セッション開始
if (!isset($_SESSION['user'])) {
    $_SESSION['user'] = "デフォルトユーザ"; // セッション初期化時の設定
}
echo "セッションユーザ: " . $_SESSION['user'];
?>

// セッション開始後、ユーザ情報が正しく設定されているか確認できます。

<?php
$counter = 0; // 初期値設定
// ある処理の中で変数が変更される例
function incrementCounter($value) {
    $value += 1; // カウンタのインクリメント操作
    return $value;
}
$counter = incrementCounter($counter);
echo "カウンタの値: " . $counter;
?>

// デバッガを利用し、incrementCounter関数内で$counterの値が正しく変更されているか確認できる。

<?php
function processData($input) {
    // 入力値が数値でない場合に備えたチェックを追加
    if (!is_numeric($input)) {
        return "無効な入力です";
    }
    return $input * 2;
}
$result = processData(25); // 数値入力
echo "処理結果: " . $result;
?>

処理結果: 50

<?php
// 数据処理中に、設定変更が反映されるかどうかを確認するための簡単な例
function calculateSum($a, $b) {
    return $a + $b; // シンプルな足し算関数
}
$sum = calculateSum(10, 20);
echo "合計: " . $sum;
?>

合計: 30