CodeIgniterのコントローラとMVCの関係を徹底解説！初心者向け完全ガイド
生徒
「CodeIgniterでウェブアプリを作りたいんですが、コントローラって何ですか?」
先生
「コントローラは、ユーザーからのリクエストを受け取って、適切な処理を実行する司令塔のような役割を持っています。」
生徒
「司令塔ですか?もう少し詳しく教えてください!」
先生
「わかりました。まずは、MVCという設計パターンから説明していきましょう!」
1. MVCとは何か?初心者でもわかる基礎知識
MVCは、Model（モデル）、View（ビュー）、Controller（コントローラ）の3つの要素で構成される設計パターンです。これは、ウェブアプリケーション開発において、プログラムを役割ごとに分けて整理するための考え方です。
例えば、レストランで例えるとわかりやすいでしょう。お客さん（ユーザー）が注文すると、ウェイター（コントローラ）が注文を受け取ります。ウェイターは厨房（モデル）に注文を伝え、料理が完成したら、お皿に盛り付けて（ビュー）お客さんに提供します。このように役割を分担することで、効率的に運営できるのです。
CodeIgniterは、このMVCパターンを採用したPHPフレームワークです。フレームワークとは、アプリケーション開発を効率化するための骨組みや道具箱のようなものです。CodeIgniterを使うことで、複雑なウェブアプリも整理された状態で開発できます。
2. Controllerの役割とは?MVCの中心的存在
コントローラは、MVCの中で最も重要な役割を担っています。ユーザーがブラウザからアクセスすると、まずコントローラがそのリクエストを受け取ります。コントローラは、どのような処理が必要かを判断し、必要に応じてモデルにデータベースへのアクセスを依頼したり、ビューに画面表示を指示したりします。
具体的には、コントローラは次のような仕事をします。ユーザーの入力データを受け取る、データの妥当性をチェックする、モデルを呼び出してデータベース操作を依頼する、処理結果をビューに渡して画面表示する、といった流れです。つまり、コントローラはアプリケーション全体の交通整理役なのです。
3. CodeIgniterでコントローラを作成する基本
CodeIgniterでコントローラを作成するには、application/controllersフォルダの中にPHPファイルを配置します。ファイル名の最初の文字は大文字にする必要があります。例えば、Welcome.phpというファイル名にします。
コントローラのクラス名もファイル名と同じにし、CI_Controllerを継承します。継承とは、既に用意されている機能を受け継ぐことです。これにより、CodeIgniterが提供する便利な機能を使えるようになります。
<?php
defined('BASEPATH') OR exit('No direct script access allowed');
class Welcome extends CI_Controller {
public function index()
{
echo "Welcome to CodeIgniter!";
}
}
このコードでは、Welcomeというクラスを定義しています。indexメソッドは、デフォルトで実行されるメソッドです。ブラウザでhttp://yourdomain.com/welcomeにアクセスすると、このindexメソッドが実行されます。
4. Modelとの連携でデータベース操作を実現
コントローラだけでは、データベースの情報を取得したり保存したりすることはできません。そこで登場するのがモデルです。モデルは、データベースとのやり取りを専門に担当する部分です。コントローラからモデルを呼び出すことで、データの取得や更新が可能になります。
例えば、ユーザー情報を管理するアプリケーションを作る場合、User_model.phpというモデルファイルを作成し、その中にデータベース操作のメソッドを書きます。コントローラからこのモデルを読み込んで使用します。
<?php
class User extends CI_Controller {
public function __construct()
{
parent::__construct();
$this->load->model('User_model');
}
public function show($id)
{
$data['user'] = $this->User_model->get_user($id);
$this->load->view('user_view', $data);
}
}
このコードでは、__constructメソッドでモデルを読み込んでいます。コンストラクタとは、クラスが作られたときに最初に実行される特別なメソッドです。showメソッドでは、モデルからユーザー情報を取得し、ビューに渡しています。
5. Viewへのデータ受け渡しと画面表示
コントローラで処理したデータは、ビューに渡して画面に表示します。ビューは、HTMLファイルのようなもので、ユーザーが実際に目にする画面を作ります。コントローラからビューにデータを渡すには、配列を使います。
ビューファイルはapplication/viewsフォルダに配置します。コントローラから$this->load->view()メソッドを使ってビューを読み込みます。このとき、第二引数に配列でデータを渡すことができます。
<?php
class Product extends CI_Controller {
public function detail($product_id)
{
$data['title'] = '商品詳細ページ';
$data['product_name'] = 'ノートパソコン';
$data['price'] = 89800;
$this->load->view('product_detail', $data);
}
}
このコードでは、$dataという配列に、タイトル、商品名、価格を格納しています。この配列をビューに渡すことで、ビュー側で$title、$product_name、$priceという変数として使用できます。
6. URLルーティングとコントローラの関係
CodeIgniterでは、URLの構造とコントローラが密接に関係しています。基本的なURL構造はhttp://yourdomain.com/controller/method/parameterとなります。最初の部分がコントローラ名、次がメソッド名、その後がパラメータです。
例えば、http://yourdomain.com/blog/article/123というURLの場合、Blogコントローラのarticleメソッドが呼ばれ、123がパラメータとして渡されます。このような仕組みをルーティングと呼びます。
ルーティングの設定はapplication/config/routes.phpで変更できます。デフォルトのコントローラを設定したり、URLのパターンをカスタマイズしたりすることが可能です。これにより、よりわかりやすいURLでアプリケーションを構築できます。
7. コントローラでのリクエスト処理とバリデーション
ユーザーがフォームからデータを送信したとき、コントローラでそのデータを受け取り、処理します。CodeIgniterでは、$this->input->post()メソッドを使ってPOSTデータを取得できます。GETデータの場合は$this->input->get()を使います。
受け取ったデータが正しいかどうかをチェックすることを、バリデーション（検証）と言います。CodeIgniterには、バリデーション機能が標準で用意されており、必須項目のチェックやメールアドレスの形式確認などが簡単にできます。
<?php
class Contact extends CI_Controller {
public function submit()
{
$this->load->library('form_validation');
$this->form_validation->set_rules('name', '名前', 'required');
$this->form_validation->set_rules('email', 'メールアドレス', 'required|valid_email');
if ($this->form_validation->run() == FALSE)
{
$this->load->view('contact_form');
}
else
{
echo "送信が完了しました!";
}
}
}
このコードでは、名前とメールアドレスのバリデーションを行っています。requiredは必須項目、valid_emailは正しいメールアドレス形式かをチェックします。バリデーションが失敗した場合は、再度フォームを表示し、成功した場合は完了メッセージを表示します。
8. MVCパターンを使うメリットとCodeIgniterの強み
MVCパターンを使うことで、コードの保守性が大幅に向上します。保守性とは、プログラムを後から修正したり機能を追加したりする際の容易さのことです。役割ごとにファイルが分かれているため、どこを修正すれば良いかがすぐにわかります。
例えば、画面のデザインを変更したい場合はビューファイルだけを修正すれば良く、データベースのテーブル構造を変更する場合はモデルだけを修正すれば済みます。コントローラに影響を与えることなく、部分的な変更が可能です。
CodeIgniterは、軽量で高速なフレームワークとして知られています。設定ファイルが少なく、学習コストが低いため、初心者でも取り組みやすいのが特徴です。また、日本語の情報も豊富で、困ったときに解決策を見つけやすい環境が整っています。
さらに、CodeIgniterはセキュリティ機能も充実しています。SQLインジェクションやクロスサイトスクリプティングといった攻撃から守る機能が標準で備わっており、安全なウェブアプリケーション開発が可能です。
9. 実践例：簡単なブログシステムのコントローラ
実際に、簡単なブログシステムのコントローラを見てみましょう。記事の一覧表示と詳細表示の機能を持つコントローラです。これにより、MVCがどのように連携して動作するかがよくわかります。
<?php
class Blog extends CI_Controller {
public function __construct()
{
parent::__construct();
$this->load->model('Blog_model');
$this->load->helper('url');
}
public function index()
{
$data['articles'] = $this->Blog_model->get_all_articles();
$data['page_title'] = 'ブログ記事一覧';
$this->load->view('blog/list', $data);
}
public function view($article_id)
{
$data['article'] = $this->Blog_model->get_article($article_id);
if (empty($data['article']))
{
show_404();
}
$data['page_title'] = $data['article']['title'];
$this->load->view('blog/detail', $data);
}
}
このコードでは、indexメソッドで記事一覧を取得し、viewメソッドで個別記事の詳細を表示しています。記事が見つからない場合は、show_404()関数で404エラーページを表示します。ヘルパーは、URLの生成など便利な関数を提供する機能です。
10. コントローラ開発のベストプラクティス
コントローラを開発する際には、いくつかの重要なポイントがあります。まず、コントローラには複雑なビジネスロジックを書かないことです。ビジネスロジックとは、アプリケーション固有の処理や計算のことで、これらはモデルに記述するべきです。
コントローラは、あくまでも交通整理役に徹し、シンプルに保つことが大切です。また、一つのメソッドが長くなりすぎないように注意しましょう。目安としては、一つのメソッドは50行以内に収めるのが理想的です。
命名規則も重要です。コントローラ名は英語の名詞を使い、最初の文字を大文字にします。メソッド名は動詞を使い、何をするメソッドなのかがわかりやすい名前を付けましょう。例えば、create、update、deleteといった名前が適切です。
セキュリティにも配慮が必要です。ユーザーからの入力は必ずバリデーションを行い、信頼できないデータをそのままデータベースに保存しないようにしましょう。CodeIgniterの機能を活用して、安全なアプリケーション開発を心がけてください。
