先生と生徒の会話形式で理解しよう

生徒

「CodeIgniterというフレームワークを使うと、コントローラというものが出てくるんですが、これって何ですか？」

先生

「コントローラは、Webアプリケーションの中心となる重要な部分です。ユーザーからのリクエストを受け取って、適切な処理を実行する役割を持っています。」

生徒

「リクエストを受け取るというのは、具体的にどういうことですか？」

先生

「それでは、CodeIgniterのコントローラについて、基本から詳しく見ていきましょう！」

1. CodeIgniterのコントローラとは？

CodeIgniterのコントローラは、PHPで書かれたWebアプリケーションの中で、交通整理役のような働きをするファイルです。例えるなら、レストランの「ウェイター」のような存在です。お客さん（ユーザー）が注文（リクエスト）をすると、ウェイターはその注文を厨房（モデル）に伝え、料理ができたらお客さんに提供（ビュー）します。

CodeIgniterは、MVCアーキテクチャという設計パターンを採用しています。MVCとは、Model（モデル）、View（ビュー）、Controller（コントローラ）の略で、それぞれ異なる役割を持っています。コントローラは、この三つの中で中心的な役割を果たし、アプリケーション全体の流れを制御します。

具体的には、ユーザーがブラウザでURLにアクセスすると、そのURLに対応したコントローラが呼び出されます。コントローラは必要に応じてモデルからデータを取得し、ビューにデータを渡して画面表示を行います。このように、コントローラはアプリケーションのロジックを管理する重要な部分なのです。

2. コントローラの基本構造

CodeIgniterのコントローラは、application/controllersフォルダの中に配置されるPHPファイルです。ファイル名は、クラス名と同じにする必要があり、最初の文字は大文字にします。それでは、最もシンプルなコントローラの例を見てみましょう。


<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Welcome extends CI_Controller {
    
    public function index()
    {
        echo 'ようこそ、CodeIgniterへ！';
    }
}

このコードを一行ずつ解説します。まず、<?phpは、PHPコードの開始を示すタグです。次のdefined('BASEPATH')は、セキュリティのための記述で、このファイルが直接ブラウザからアクセスされることを防ぎます。

class Welcomeの部分でクラスを定義しています。クラスとは、関連する機能をまとめたプログラムの設計図のようなものです。extends CI_Controllerは、CodeIgniterが提供する基本的なコントローラの機能を引き継ぐという意味です。これにより、CodeIgniterの便利な機能を自動的に使えるようになります。

public function index()は、メソッドと呼ばれるもので、実際の処理を記述する部分です。indexというメソッドは、URLでメソッド名が指定されなかった場合に、自動的に呼び出されるデフォルトのメソッドです。この例では、単純に「ようこそ、CodeIgniterへ！」というメッセージを表示しています。

3. コントローラでビューを読み込む方法

コントローラの重要な役割の一つは、ビューファイルを読み込んで画面を表示することです。ビューとは、HTMLなどで書かれた画面の見た目を定義するファイルのことです。コントローラからビューを読み込むには、$this->load->view()というメソッドを使用します。


<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Home extends CI_Controller {
    
    public function index()
    {
        $data['title'] = 'ホームページ';
        $data['message'] = 'CodeIgniterの学習を始めましょう！';
        
        $this->load->view('home_view', $data);
    }
}

このコードでは、まず$dataという配列を作成し、ビューに渡したいデータを格納しています。配列とは、複数のデータを一つの変数にまとめて管理できる便利な仕組みです。ここでは、titleとmessageという二つの情報を配列に入れています。

$this->load->view('home_view', $data)の部分で、home_view.phpというビューファイルを読み込み、同時に$data配列のデータをビューに渡しています。ビュー側では、$titleや$messageという変数名でこれらのデータにアクセスできるようになります。

4. URLとコントローラの対応関係

CodeIgniterでは、URLとコントローラの関係が非常に分かりやすく設計されています。基本的なURL構造は、http://example.com/コントローラ名/メソッド名/パラメータとなっています。

例えば、http://example.com/blog/view/123というURLにアクセスした場合、CodeIgniterはBlogコントローラのviewメソッドを呼び出し、123をパラメータとして渡します。この仕組みにより、URLを見ただけでどのコントローラのどのメソッドが実行されるかが分かるのです。

メソッド名を省略した場合は、自動的にindexメソッドが呼ばれます。また、コントローラ名も省略した場合は、config/routes.phpで設定されたデフォルトコントローラが使用されます。この柔軟な仕組みにより、シンプルで分かりやすいURL設計が可能になります。

5. コントローラでパラメータを受け取る

コントローラのメソッドは、URLから渡されたパラメータを受け取ることができます。これにより、動的なページを作成することが可能になります。パラメータとは、処理に必要な追加情報のことで、例えば記事のIDや商品番号などがこれに当たります。


<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Blog extends CI_Controller {
    
    public function article($id = 1)
    {
        echo '記事番号: ' . $id . 'の内容を表示します';
        
        // 実際のアプリケーションでは、ここでモデルから
        // データを取得してビューに渡します
    }
}

このコードでは、articleメソッドが$idというパラメータを受け取れるようになっています。$id = 1という記述により、パラメータが渡されなかった場合のデフォルト値を1に設定しています。

例えば、http://example.com/blog/article/5にアクセスすると、$idには5が入り、「記事番号: 5の内容を表示します」と表示されます。このように、URLから動的に値を受け取ることで、一つのメソッドで複数のページに対応できるのです。

6. コントローラでモデルを使用する

実際のWebアプリケーションでは、データベースとのやり取りが必要になります。CodeIgniterでは、データベース処理はモデルで行い、コントローラはそのモデルを呼び出して使用します。この役割分担により、コードが整理され、メンテナンスしやすくなります。


<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Product extends CI_Controller {
    
    public function __construct()
    {
        parent::__construct();
        $this->load->model('Product_model');
    }
    
    public function list()
    {
        $data['products'] = $this->Product_model->get_all_products();
        $this->load->view('product_list', $data);
    }
}

__construct()は、コンストラクタと呼ばれる特別なメソッドで、コントローラが作成されたときに自動的に実行されます。ここで$this->load->model('Product_model')により、Product_modelというモデルを読み込んでいます。

listメソッドでは、$this->Product_model->get_all_products()を呼び出してデータベースから商品データを取得し、それをビューに渡しています。このように、コントローラはモデルとビューの橋渡し役として機能するのです。

7. コントローラのコンストラクタの役割

先ほど少し触れましたが、コンストラクタは非常に便利な機能です。コンストラクタを使うことで、そのコントローラのすべてのメソッドで共通して行いたい処理を一箇所にまとめることができます。

例えば、ログイン済みのユーザーだけがアクセスできるページを作る場合、各メソッドでログインチェックを書くのは面倒です。そんなときは、コンストラクタでログインチェックを行えば、そのコントローラのすべてのメソッドにログインチェックが適用されます。

また、複数のメソッドで使用するライブラリやヘルパーの読み込みも、コンストラクタで一度だけ行えば済みます。これにより、コードの重複を避け、効率的なプログラミングが可能になります。コンストラクタを使用する際は、必ずparent::__construct();を最初に記述することを忘れないでください。これは、親クラスのコンストラクタを呼び出すための記述です。

8. コントローラでのリダイレクト処理

Webアプリケーションでは、ある処理が完了した後に別のページに移動させたい場合があります。例えば、フォームの送信が完了したら完了ページに移動する、といった処理です。このような処理をリダイレクトと呼びます。CodeIgniterでは、リダイレクト処理も簡単に実装できます。

リダイレクトには、redirect()関数を使用します。この関数は、URLヘルパーに含まれているため、使用する前に$this->load->helper('url');でURLヘルパーを読み込む必要があります。ただし、config/autoload.phpで自動読み込みの設定をしておけば、毎回読み込む必要はありません。

リダイレクトは、フォーム送信後の二重送信防止や、権限のないページへのアクセスを防ぐためにも使用されます。適切にリダイレクト処理を実装することで、ユーザーにとって使いやすく、セキュアなWebアプリケーションを作ることができます。

9. プライベートメソッドとパブリックメソッド

コントローラのメソッドには、外部から呼び出せるパブリックメソッドと、コントローラ内部でのみ使用できるプライベートメソッドがあります。パブリックメソッドは、URLから直接アクセスできるメソッドで、publicキーワードを付けて定義します。

一方、プライベートメソッドは、コントローラ内の共通処理をまとめるために使用します。メソッド名の先頭にアンダースコア（_）を付けることで、そのメソッドはURLから直接アクセスできなくなります。これにより、内部的な処理をユーザーから隠すことができ、セキュリティが向上します。

例えば、複数のメソッドで使用する共通のバリデーション処理や、データの整形処理などをプライベートメソッドとして定義すると便利です。このように役割を分けることで、コードの可読性と保守性が大きく向上します。

10. コントローラのベストプラクティス

CodeIgniterのコントローラを効果的に使用するためには、いくつかの推奨される方法があります。まず、一つのコントローラには関連する機能だけをまとめることが重要です。例えば、商品に関する処理はProductコントローラに、ユーザー管理はUserコントローラにまとめるというように、機能ごとに分割します。

また、コントローラには複雑なビジネスロジックを書かないことも大切です。データベース操作や複雑な計算処理はモデルに任せ、コントローラはあくまで交通整理役に徹するようにします。これにより、コードの再利用性が高まり、テストもしやすくなります。

さらに、適切なエラーハンドリングを行うことも忘れてはいけません。ユーザーからの入力値は必ずバリデーションを行い、予期しないエラーが発生した場合は適切なエラーメッセージを表示するようにしましょう。セキュリティ面でも、XSS対策やCSRF対策などを適切に実装することが重要です。CodeIgniterにはこれらのセキュリティ機能が標準で用意されているため、積極的に活用しましょう。