PHP Routerの基本実装とSEO最適化対策について解説

<?php
// 受信したリクエスト情報の取得
$requestMethod = $_SERVER['REQUEST_METHOD'];
$requestUri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
// ルーティングテーブルの定義(HTTPメソッドごと)
$routes = [
    'GET' => [
         '/' => 'homeHandler',
         '/about' => 'aboutHandler'
    ],
    'POST' => [
         '/submit' => 'submitHandler'
    ]
];
// ルートに対応する処理の実行
if (isset($routes[$requestMethod][$requestUri])) {
    call_user_func($routes[$requestMethod][$requestUri]);
} else {
    // マッチしない場合は404エラーを返す
    header("HTTP/1.0 404 Not Found");
    echo "404 Not Found";
}
// サンプルの処理関数
function homeHandler() {
    echo "ホームページです。";
}
function aboutHandler() {
    echo "アバウトページです。";
}
function submitHandler() {
    echo "フォーム送信処理です。";
}
?>

ホームページです。

<?php
// 動的ルートのパターン例
$dynamicRoutes = [
    'GET' => [
         '/^\/user\/([0-9]+)$/' => 'userProfileHandler'
    ]
];
// リクエストURIの取得
$requestUri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$requestMethod = $_SERVER['REQUEST_METHOD'];
// 静的ルート処理の後、動的なルートのマッチング
$matched = false;
if (isset($dynamicRoutes[$requestMethod])) {
    foreach ($dynamicRoutes[$requestMethod] as $pattern => $handler) {
        if (preg_match($pattern, $requestUri, $matches)) {
            // キャプチャしたパラメータを引数として渡す
            call_user_func($handler, $matches[1]);
            $matched = true;
            break;
        }
    }
}
if (!$matched) {
    header("HTTP/1.0 404 Not Found");
    echo "404 Not Found";
}
// サンプルの処理関数(引数はキャプチャされたユーザーID)
function userProfileHandler($userId) {
    echo "ユーザーID " . $userId . " のプロフィールページです。";
}
?>

ユーザーID 123 のプロフィールページです。

<?php
// リクエストURIからパス部分の抽出
$requestUri = $_SERVER['REQUEST_URI'];
$parsedUrl = parse_url($requestUri);
$path = $parsedUrl['path'];
// 抽出したパスを基にルートを判定
echo "現在のパスは " . $path . " です。";
?>

現在のパスは /user/123 です。

<?php
// リクエストメソッドの取得
$requestMethod = $_SERVER['REQUEST_METHOD'];
// メソッドごとに異なる処理を呼び出す例
switch ($requestMethod) {
    case 'GET':
        echo "GETリクエストの処理です。";
        break;
    case 'POST':
        echo "POSTリクエストの処理です。";
        break;
    default:
        header("HTTP/1.0 405 Method Not Allowed");
        echo "許可されていないリクエストメソッドです。";
        break;
}
?>

GETリクエストの処理です。

<?php
// URL生成関数の例
function generateUrl($path, $params = []) {
    $url = $path;
    if (!empty($params)) {
        $url .= '?' . http_build_query($params);
    }
    return $url;
}
// 内部リンクの使用例
echo '<a href="' . generateUrl('/product/45') . '">商品ページ</a>';
?>

<a href="/product/45">商品ページ</a>

<?php
// ルートが見つからなかった場合の処理
header("HTTP/1.0 404 Not Found");
echo "404 - お探しのページは見つかりませんでした。";
?>

404 - お探しのページは見つかりませんでした。

<?php
// 旧URLから新URLへの301リダイレクトの例
header("HTTP/1.1 301 Moved Permanently");
header("Location: /new-page");
exit();
?>

(ブラウザは自動的に /new-page に移動します)

<?php
// ユーザーIDの検証例
$userId = $_GET['user_id'] ?? '';
if (!filter_var($userId, FILTER_VALIDATE_INT)) {
    echo "不正なユーザーIDです。";
    exit();
}
// 正常な場合の処理
echo "ユーザーID " . $userId . " を処理します。";
?>

ユーザーID 45 を処理します。

<?php
// エラー発生時のログ出力例
$errorMessage = "指定されたルートが見つかりませんでした。";
error_log($errorMessage);
// ユーザー側への表示はシンプルなエラーメッセージを返す
header("HTTP/1.0 404 Not Found");
echo "404エラーです。";
?>

404エラーです。

<?php
// ルート定義(静的ルートと動的ルートを含む)
$staticRoutes = [
    'GET' => [
         '/' => 'homeHandler',
         '/contact' => 'contactHandler'
    ]
];
$dynamicRoutes = [
    'GET' => [
         '/^\/user\/([0-9]+)$/' => 'userProfileHandler'
    ]
];
// リクエスト情報取得
$requestMethod = $_SERVER['REQUEST_METHOD'];
$requestUri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
// 静的ルートの判定
if (isset($staticRoutes[$requestMethod][$requestUri])) {
    call_user_func($staticRoutes[$requestMethod][$requestUri]);
    exit();
}
// 動的ルートの判定
foreach ($dynamicRoutes[$requestMethod] as $pattern => $handler) {
    if (preg_match($pattern, $requestUri, $matches)) {
        call_user_func($handler, $matches[1]);
        exit();
    }
}
// どのルートにもマッチしない場合は404エラー
header("HTTP/1.0 404 Not Found");
echo "404 Not Found";
// 各処理関数の定義
function homeHandler() {
    echo "ホームページへようこそ。";
}
function contactHandler() {
    echo "お問い合わせページです。";
}
function userProfileHandler($userId) {
    echo "ユーザーID " . $userId . " のプロフィールページです。";
}
?>

ホームページへようこそ。