CodeIgniterのルーティング設定を徹底解説！初心者でも迷わないURLの仕組み

1. ルーティングとは何か？初心者向けの基本概念

1. ルーティングとは何か？初心者向けの基本概念

プログラミングの世界、特にWeb開発におけるルーティング（Routing）とは、インターネット上の住所である「URL」と、サーバーの中で動く「プログラム（コントローラー）」を紐付ける仕組みのことです。普段、私たちがブラウザにURLを入力してページを開くとき、裏側ではこのルーティングが「この住所に来た人には、このファイルを見せてあげてね」と指示を出しています。

例えば、パソコンを触ったことがない方でも「電話の取り次ぎ」をイメージすると分かりやすいでしょう。会社に電話がかかってきたとき、受付の人が「営業の内容なら営業部へ」「採用のことなら人事部へ」と振り分けますよね。この「受付の人」がルーティングの役割を果たしているのです。CodeIgniter（コードイグナイター）というフレームワークでは、この設定を自分好みにカスタマイズすることができます。

2. ルーティング設定ファイルの場所と構成

2. ルーティング設定ファイルの場所と構成

CodeIgniterでルーティングを管理している魔法のファイルは、特定の場所に決まっています。一般的には、プロジェクトのフォルダの中にある app/Config/Routes.php というファイルです。このファイルを開くと、プログラムがどのようにURLを解釈するかが細かく書かれています。初心者がまず覚えるべきは、このファイルが「システム全体の地図」であるということです。

設定ファイルの中には、あらかじめいくつかのルールが書かれています。基本的には「どのURLパターン」が来たときに「どのクラスのどのメソッド（機能）」を呼び出すか、というペアを記述していきます。これを正しく書かないと、ページにアクセスしたときに「404 Not Found（ページが見つかりません）」というエラーが出てしまうため、非常に重要なファイルと言えます。

3. 実際に書いてみよう！基本的なルーティングの書き方

3. 実際に書いてみよう！基本的なルーティングの書き方

では、実際に Routes.php に設定を書くときの基本形を見てみましょう。CodeIgniter4系では、$routes->get() という命令を使って設定を行います。以下のコードは、「example.com/hello」というURLにアクセスしたときに、Helloという名前のプログラムを動かす設定です。

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

ここで出てくるコントローラーとは、Webページを表示するための処理をまとめた「司令塔」のようなものです。Home::index という書き方は、「Homeという名前の司令塔の中にある、indexという名前の仕事を実行してね」という意味になります。このように、URLと実行したい中身を線で結ぶのがルーティングの基本作業です。

4. プレースホルダーを使った柔軟なURL設定

4. プレースホルダーを使った柔軟なURL設定

ブログサイトなどを作るとき、記事ごとにURLを変えたい場合があります。例えば「/news/1」「/news/2」のように、数字が変わるパターンです。これを一つずつ手書きするのは大変ですよね。そこで使うのがプレースホルダーという便利な仕組みです。これは「ここには何らかの文字や数字が入るよ」という予約席のようなものです。

// 「news/数字」というURLに対応する設定。(:num)は数字が入る場所を指します。
$routes->get('news/(:num)', 'News::view/$1');

上記のコードにある (:num) は「数字」を意味します。もしユーザーが「news/15」にアクセスしたら、プログラム側には「15」という数字が渡されます。これにより、一つの設定だけで何百ページもの記事に対応できるようになるのです。これは検索エンジンにとっても理解しやすいURL（SEOに強いURL）を作るための第一歩となります。

5. ルーティング設定時の重要な注意点

5. ルーティング設定時の重要な注意点

ルーティングを設定する際には、いくつか気をつけるべきポイントがあります。まず一つ目は、設定を書く順番です。ルーティングは上から順番に読み込まれます。もし、広い範囲に当てはまるルールを上に書いてしまうと、その下にある具体的なルールが無視されてしまうことがあります。これを「ルールが上書きされる」や「先にマッチする」と言ったりします。

二つ目は、大文字と小文字の区別や、綴りミスです。プログラミングの世界では、たった一文字の間違いや、全角・半角の違いだけで動かなくなります。特にパソコンに不慣れな方は、必ず半角英数字で入力できているかを確認しましょう。また、設定を変更した後は、必ず保存をしてからブラウザで確認する癖をつけることが大切です。

6. 複雑なURL構造を作る！複数パラメータの渡し方

6. 複雑なURL構造を作る！複数パラメータの渡し方

さらに応用として、複数の情報をURLに含める方法を解説します。例えば「2024年の10月の記事」を表示したい場合、URLは「/archive/2024/10」のようになります。これに対応するには、プレースホルダーを複数並べて記述します。

// 年と月の2つの数字を受け取るルーティング
$routes->get('archive/(:num)/(:num)', 'Blog::archive/$1/$2');

このように書くと、1番目の (:num) が $1 に、2番目の (:num) が $2 に対応して、プログラムへ情報が送られます。情報を正しく受け渡すことで、ユーザーが求めている特定のデータを正確に表示できるようになります。Webサイトの使い勝手を良くするためには、こうした構造的なURLの設計が欠かせません。

7. セキュリティとルーティングの関係

7. セキュリティとルーティングの関係

ルーティングは、実はセキュリティ（安全を守ること）にも深く関わっています。CodeIgniterでは「自動ルーティング（Auto Routing）」という機能があり、設定を書かなくても自動でURLを解釈してくれる場合があります。しかし、これに頼りすぎると、意図しないプログラムが外部から実行されてしまう危険性があります。

初心者のうちは、あえて自動機能をオフにして、自分ですべてのルートを定義する「名前付きルーティング」や「厳格なルーティング」を意識することをおすすめします。自分が許可したURLだけが正しく動くように設定することで、悪意のあるアクセスから大切なデータを守ることにつながります。安全なWebサイト作りは、入り口であるルーティングの管理から始まるのです。

8. エラー画面（404ページ）のカスタマイズ

8. エラー画面（404ページ）のカスタマイズ

もしユーザーが、設定していないURLにアクセスした場合はどうなるでしょうか？そのときは「404 Page Not Found」というエラー画面が表示されます。CodeIgniterでは、このエラーが起きたときの挙動もルーティング設定に関連して制御できます。デフォルトのままでも動きますが、サイトのデザインに合わせたエラーページを用意することで、ユーザーを迷わせない親切な設計になります。

// どのルールにも当てはまらなかった場合の特別な処理（イメージ）
$routes->set404Override('Errors::show404');

このように設定しておけば、URLを打ち間違えた読者に対して「ページが見つかりません。こちらのトップページへ戻ってください」といった案内を出すことができ、サイトの離脱を防ぐ効果が期待できます。これも立派なルーティング戦略の一つです。

9. HTTPメソッドを理解して正しく使い分けよう

9. HTTPメソッドを理解して正しく使い分けよう

最後に、少しだけ専門的な「HTTPメソッド」という言葉についてお話しします。Webの通信には「ページを見る（GET）」や「データを送る（POST）」といった種類があります。ルーティング設定では、これらを明確に区別することが推奨されます。

// お問い合わせフォームを表示するとき（GET）
$routes->get('contact', 'Contact::index');

// お問い合わせ内容を送信するとき（POST）
$routes->post('contact/send', 'Contact::send');

お問い合わせフォームの入力画面を開くときは get を使い、送信ボタンを押した後の処理には post を使うといった使い分けです。これを行うことで、ブラウザの「戻る」ボタンを押したときの誤動作を防いだり、データの二重送信を防止したりすることができます。初心者の方も、まずは「見るならGET、送るならPOST」という基本を覚えておくと、スムーズに開発が進められるようになります。