CodeIgniterでビューにデータを渡す方法を完全ガイド！初心者でもわかる仕組みと使い方

CodeIgniterでビューにデータを渡す方法

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

生徒

「CodeIgniterでコントローラーからビューにデータを渡すにはどうすればいいですか？」

先生

「CodeIgniterでは、ビューにデータを渡す方法がいくつか用意されています。どれも簡単に使えるので安心してください。」

生徒

「具体的にはどんな方法がありますか？」

先生

「それでは、基本的な使い方から順番に見ていきましょう！」

1. ビューにデータを渡すとは？

CodeIgniterのフレームワークでは、コントローラーとビューという役割分担があります。コントローラーは処理を担当し、ビューは画面表示を担当します。この二つをつなぐために、コントローラーからビューへデータを渡す必要があります。

例えば、ユーザーの名前をデータベースから取得して画面に表示する場合、コントローラーでデータを取得し、それをビューに渡して表示します。このデータの受け渡しこそが、今回学ぶ重要なポイントです。

データを渡すことで、動的なウェブページを作ることができます。同じビューファイルでも、渡すデータを変えることで表示内容を変更できるため、コードの再利用性が高まります。

2. 基本的なデータの渡し方（配列を使う方法）

CodeIgniterでビューにデータを渡す最も基本的な方法は、配列を使う方法です。配列とは、複数のデータをまとめて扱うための入れ物のようなものです。

コントローラーで配列を作成し、それをビューの読み込み時に第二引数として渡します。配列のキー（名前）がビューの中で変数名として使えるようになります。


// コントローラー（例：app/Controllers/Home.php）
public function index()
{
    $data = array(
        'title' => 'ようこそ',
        'message' => 'CodeIgniterへようこそ！'
    );
    
    return view('welcome_message', $data);
}

上記のコードでは、$dataという配列にtitleとmessageという二つのデータを入れています。この配列をview()関数の第二引数に渡すことで、ビュー側でこれらの変数が使えるようになります。

ビューファイル側では、配列のキーがそのまま変数名として展開されます。つまり、$titleと$messageという変数として利用できるようになるのです。

3. ビューでデータを受け取って表示する

コントローラーから渡されたデータは、ビューファイルの中でPHPの変数として使用できます。HTMLの中にPHPのコードを埋め込んで、動的にコンテンツを表示します。


<!-- ビュー（例：app/Views/welcome_message.php） -->
<!DOCTYPE html>
<html>
<head>
    <title><?= $title ?></title>
</head>
<body>
    <h1><?= $title ?></h1>
    <p><?= $message ?></p>
</body>
</html>

ビューファイルでは、<?= $title ?>のような短縮記法を使ってデータを出力します。これは<?php echo $title; ?>と同じ意味で、変数の内容を画面に表示します。

このように、コントローラーで準備したデータをビューで受け取り、HTMLに組み込むことで動的なページを作成できます。

4. 複数のデータをまとめて渡す方法

実際のウェブアプリケーションでは、一つや二つだけでなく、もっと多くのデータをビューに渡す必要があります。配列を使えば、いくつでもデータをまとめて渡すことができます。


// コントローラー
public function profile()
{
    $data = array(
        'name' => '山田太郎',
        'age' => 25,
        'email' => 'yamada@example.com',
        'address' => '東京都渋谷区',
        'hobbies' => array('読書', '音楽鑑賞', 'プログラミング')
    );
    
    return view('profile_view', $data);
}

この例では、名前、年齢、メールアドレス、住所、趣味といった複数の情報を一つの配列にまとめています。趣味のように複数の項目がある場合は、配列の中に配列を入れることもできます。これを多次元配列といいます。

ビュー側では、渡された配列の中の配列も簡単に扱うことができます。ループ処理を使えば、複数の趣味を順番に表示することも可能です。

5. 連想配列を短縮して書く方法

CodeIgniterでは、データを渡す際により短く書ける記法も用意されています。特に、変数名とキー名が同じ場合は、コードをシンプルにできます。

PHPの新しいバージョンでは、compact()関数を使うと、変数名を文字列で指定するだけで自動的に配列を作成してくれます。この関数は変数名をそのままキー名とした配列を生成します。


// コントローラー
public function about()
{
    $title = '会社概要';
    $company_name = '株式会社サンプル';
    $established = '2020年4月1日';
    
    // compact関数で変数を配列にまとめる
    return view('about_view', compact('title', 'company_name', 'established'));
}

compact()関数は、指定した変数名を自動的に配列のキーとして使用します。上記の例では、$title、$company_name、$establishedという三つの変数が、それぞれ同じ名前のキーを持つ配列に変換されます。

この方法を使うと、配列を手動で作成する手間が省けるため、コードがすっきりして読みやすくなります。特に渡す変数が多い場合に便利です。

6. データベースから取得したデータを渡す

実際のアプリケーション開発では、データベースから取得した情報をビューに渡すことが多くあります。CodeIgniterのモデルを使ってデータベースからデータを取得し、それをビューに渡す流れを見ていきましょう。

まず、コントローラーでモデルを読み込み、データベースからデータを取得します。取得したデータは通常、配列やオブジェクトの形式で返されるため、そのままビューに渡すことができます。

例えば、ブログ記事の一覧を表示する場合、記事モデルから全ての記事を取得し、それをビューに渡します。ビュー側では、渡された記事データをループ処理で一つずつ表示していきます。

データベース連携を行うことで、管理画面から更新した内容が自動的にウェブページに反映される、本格的な動的サイトを構築できるようになります。

7. ビューで条件分岐を使ってデータを表示する

ビューに渡されたデータによって、表示内容を変えたい場合があります。そのような時は、ビューの中でPHPの条件分岐を使います。

例えば、ユーザーがログインしているかどうかで表示を変える場合や、データが空の時に「データがありません」と表示する場合などに使います。ビュー内でもPHPの全ての機能が使えるため、柔軟な表示制御が可能です。

ただし、ビューには複雑なロジックを書きすぎないことが大切です。複雑な処理はコントローラーやモデルで行い、ビューはあくまで表示に専念させるのがベストプラクティスです。

このような役割分担を守ることで、コードが整理され、後からの修正や機能追加がしやすくなります。これをMVC（モデル・ビュー・コントローラー）パターンといい、CodeIgniterの基本的な設計思想です。

8. エスケープ処理の重要性

ビューにデータを表示する際、エスケープ処理を行うことが非常に重要です。エスケープとは、HTMLタグとして解釈される特殊文字を無害な文字列に変換することです。

CodeIgniterでは、esc()関数を使ってデータをエスケープできます。これにより、ユーザーが入力した悪意のあるスクリプトが実行されるのを防ぎ、クロスサイトスクリプティング（XSS）攻撃から守ることができます。

例えば、掲示板やコメント機能など、ユーザーが入力したテキストを表示する場合は、必ずエスケープ処理を行うようにしましょう。セキュリティは後回しにできない重要な要素です。

短縮記法の<?= esc($variable) ?>を使うことで、安全にデータを出力できます。ユーザー入力に関わるデータは常にエスケープすることを習慣づけましょう。

9. 複数のビューでデータを共有する方法

ウェブサイトでは、ヘッダーやフッターなど、全てのページで共通して表示する要素があります。このような共通データを毎回渡すのは手間がかかります。

CodeIgniterでは、複数のビューで共通して使いたいデータを効率的に管理する方法があります。一つは、ベースコントローラーを作成して、そこで共通データを設定する方法です。

もう一つは、ビューのレイアウト機能を使う方法です。共通部分を別のビューファイルとして作成し、それを各ページで読み込むことで、コードの重複を避けられます。

このような工夫により、サイト全体で一貫性のあるデザインを保ちながら、メンテナンスしやすいコード構造を実現できます。大規模なプロジェクトほど、このような設計の重要性が高まります。

公的機関での指導実績【CodeIgniterモダン開発実践セミナー】

商用CodeIgniter 4 徹底実践講座：軽量MVCによる高速開発とシステムのモダナイゼーション

#商用設計 #APIアーキテクチャ #市場価値最大化

ハローワーク職業訓練講師の実績を持つプロが監修。商用PHP開発の「現場の作法」を完全伝授。

「極限のパフォーマンス」を実装する。CodeIgniter 4で軽量・高速な商用システムを構築。

本講座では、フレームワークのオーバーヘッドを最小限に抑えた「高レスポンスなWebアプリケーション設計」を学びます。シンプルながら強力なCodeIgniter 4を通じ、既存システムのPHP 8.x対応や、リソース効率を極めたAPI開発など、実務で重宝される最適化技術を習得します。