CodeIgniterでRESTfulなルーティングを完全攻略！初心者向け設計ガイド

1. RESTfulとルーティングの基本を知ろう

1. RESTfulとルーティングの基本を知ろう

プログラミングの世界では、Webサイトやアプリの「住所」にあたるものをURLと呼びます。そして、その住所にアクセスが来た時に「どのプログラムを動かすか」を決める仕組みをルーティング（Routing）と言います。特に、近年推奨されている「RESTful（レストフル）」という考え方は、非常にシンプルで分かりやすい住所の作り方のルールです。

例えば、ブログの記事一覧を見たい時は /posts、特定の記事を新しく作りたい時は /posts/create といったように、URLを見ただけで中身が想像できるように設計します。CodeIgniter（コードイグナイター）というPHPのフレームワーク（アプリを作るための道具箱）を使うと、この複雑になりがちな住所整理がとても楽になります。パソコンを触り始めたばかりの方でも、「このURLならこの処理！」というパズルを組み合わせる感覚で進められますので安心してください。

ここで出てくるフレームワークとは、家を建てる時の「土台」や「骨組み」のようなものです。一から全てを自分で作らなくても、あらかじめ用意された便利な機能を使うことで、素早く安全にWebアプリケーションを開発することができます。CodeIgniterは、その中でも動作が軽快で、覚えるべきルールが少ないため、初心者の方には最適な選択肢と言えるでしょう。

2. HTTPメソッドという「命令」の種類

2. HTTPメソッドという「命令」の種類

RESTfulな設計を理解するために避けて通れないのが、HTTPメソッドという考え方です。これは、サーバーに対して出す「お願いの種類」のことです。代表的なものは以下の4つです。

• GET（ゲット）： データを取得したい時に使います（一覧表示や詳細表示など）。
• POST（ポスト）： 新しいデータを保存したい時に使います（新規投稿など）。
• PUT（プット）： 既にあるデータを書き換えたい時に使います（記事の編集保存など）。
• DELETE（デリート）： データを消したい時に使います（記事の削除など）。

これらをURLと組み合わせることで、「誰が見ても分かりやすい操作」が実現します。例えば、同じ /items というURLでも、GETで送れば「商品の一覧を見せて」、POSTで送れば「新しい商品を登録して」という意味に変わるのです。この使い分けが、モダンなWeb開発の基本となります。

3. 実際にルーティングを書いてみよう（基本編）

3. 実際にルーティングを書いてみよう（基本編）

CodeIgniterでは、app/Config/Routes.php というファイルにルーティングのルールを記述します。まずは最もシンプルな、特定のURLにアクセスがあったら特定の「コントローラー（命令を実行する担当者）」を呼び出す方法を見てみましょう。

// 「/hello」にアクセスが来たら、Homeコントローラのindexメソッドを動かす
$routes->get('hello', 'Home::index');

このコードは、「もしブラウザから hello という場所に見に来たら、Home という名前のプログラム集の中にある index という処理を実行してね」というお願いを予約している状態です。get という部分が先ほど説明したHTTPメソッドにあたります。このように、左側にURLのパターン、右側に実行したい場所を書くのが基本の型になります。これだけで、自分の好きなURLを自由に作成できるようになるのです。

4. リソースルーティングで一括設定

4. リソースルーティングで一括設定

RESTfulな設計をする際、一つ一つ手書きで get や post を書くのは大変です。そこでCodeIgniterには、リソースルーティングという魔法のような機能があります。これを使うと、標準的なRESTのルールに基づいたURLを一気に作成してくれます。

// 「photos」という名前でRESTfulなルートを自動作成する
$routes->resource('photos');

この一行を書くだけで、CodeIgniterは「一覧表示」「詳細表示」「新規作成」「更新」「削除」といったWebアプリに必要な主要なURLをすべて自動で準備してくれます。例えば、内部的には以下のような道筋（ルート）が作られます。

GET /photos          => Photos::index (一覧)
GET /photos/new      => Photos::new (作成画面)
POST /photos         => Photos::create (保存処理)
GET /photos/1        => Photos::show (1番の写真を表示)
DELETE /photos/1     => Photos::delete (1番を削除)

自分でたくさんのルールを書かなくて済むため、ミスが減り、プログラムの中身（ロジック）を作ることに集中できるようになります。これがフレームワークを使う大きなメリットの一つです。

5. 変数を使った動的なルーティング

5. 変数を使った動的なルーティング

Webサイトでは、記事のID番号によって表示する内容を変えたい場面がよくあります。例えば /blog/1 や /blog/100 など、数字の部分が変わる場合です。これを実現するためにプレースホルダー（身代わり）を使います。

// 「(:num)」は数字が入る場所という目印です
$routes->get('blog/view/(:num)', 'Blog::show/$1');

ここで使われている (:num) は、「ここに数字が来るよ！」という意味の特別な記号です。そして、右側の $1 は「その数字をプログラムに渡してね」という指示になります。これにより、1番の記事でも100番の記事でも、一つの設定で対応できるようになります。初心者の方は、「カッコで囲まれた部分は動的に変わる場所なんだな」と覚えておけば大丈夫です。この仕組みをマスターすれば、何千、何万というページを持つ大規模なサイトも管理できるようになります。

6. グループ化でURLをスッキリ整理

6. グループ化でURLをスッキリ整理

管理画面など、特定の言葉で始まるURLがたくさんある場合は、グループ化機能を使うとコードが綺麗になります。例えば、管理者用のページすべてに admin という言葉を付けたい場合です。

// 「admin」という言葉で始まるグループを作る
$routes->group('admin', function($routes) {
    $routes->get('users', 'Admin\Users::index');
    $routes->get('settings', 'Admin\Settings::index');
});

この設定により、実際のURLは /admin/users や /admin/settings になります。バラバラに書くよりも、共通のグループとしてまとめることで、後から見返した時に「ここから下は管理者用の設定だな」と一目でわかります。プログラムを書くときは、後で自分が読んだり、他の人が見たりすることを考えて、このように整理整頓する癖をつけておくと、上達が早くなります。可読性（読みやすさ）はプログラミングにおいて非常に重要なスキルです。

7. 注意点！ルーティングの優先順位

7. 注意点！ルーティングの優先順位

ルーティングを設定する際に初心者が陥りやすい罠があります。それは、設定を書く「順番」です。CodeIgniterは、ファイルの「上から順番」にルールをチェックし、最初に当てはまったものを採用します。そのため、広すぎるルールを上に書いてしまうと、その下にある具体的なルールが無視されてしまうことがあります。

例えば、「何でも受け付ける」という設定を一番上に書くと、その後に書いた「特定のページだけを見せる」設定までたどり着きません。住所案内で例えるなら、「とりあえず全部Aさんの家へ行ってください」という看板を町の入り口に立ててしまうと、Bさんの家へ行くための看板が役に立たなくなるのと同じです。基本的には、「具体的で細かいルール」を上に、「一般的で広いルール」を下に書くのが鉄則です。もし思った通りに画面が表示されない時は、この順番を疑ってみてください。

8. まとめ：RESTfulな設計を目指す理由

8. まとめ：RESTfulな設計を目指す理由

なぜここまでしてRESTfulなルーティングにこだわるのでしょうか。それは、Webの世界の標準的なルールに従うことで、自分以外の開発者がコードを見た時に、説明なしでも構造を理解できるようになるからです。また、Googleなどの検索エンジンにとっても、整理されたURLは内容を理解しやすく、SEO（検索エンジン最適化）の面でも有利に働くと言われています。

初心者のうちは、「なぜこんなに細かく分けるんだろう？」と疑問に思うかもしれません。しかし、大規模なアプリになればなるほど、この規律が自分を助けてくれます。CodeIgniterのルーティング機能を使いこなし、美しく使いやすいURL設計を心がけましょう。一歩ずつ、実際にコードを書いて動かしてみることが、理解への最短ルートです。まずは簡単な一覧表示から始めて、徐々に更新や削除といった機能に挑戦してみてください。