CodeIgniterプロジェクトの作成と実行

CodeIgniterとは

CodeIgniterは、軽量かつ高パフォーマンスなPHP Webアプリケーション開発フレームワークです。Model-View-Controller（MVC）デザインパターンに従っており、開発者が機能豊富なWebアプリケーションを素早く構築できるよう設計されています。シンプルな構造と優れたパフォーマンス、そして学習しやすい特性により、多くのPHP開発者に選ばれています。

CodeIgniterの主な特徴とメリット

• 軽量なコア: コアシステムは非常にコンパクトで、必要最低限のコンポーネントのみを搭載しており、高速な起動が可能です。
• 優れたパフォーマンス: 高効率な設計で多くの同時リクエストに対応し、安定かつ高速な動作を実現します。
• 習得が容易: クリアなドキュメントと直感的なAPIにより、学習コストが低く短期間で使いこなせます。
• 高い柔軟性: プロジェクトごとの要件に合わせてサードパーティ製ライブラリの選択や統合が可能で、拡張やカスタマイズも簡単です。
• 活発なコミュニティサポート: 多くの開発者が利用しているため、豊富なリソースやサポートを受けられます。

CodeIgniterは、小規模なプロジェクトから大規模なエンタープライズ用途まで幅広い開発ニーズに適しています。高品質なWebソリューションを効率よく構築できます。

ServBayを使ったCodeIgniter開発環境の構築

ServBayは、macOS向けに設計されたローカルWeb開発環境ツールです。PHPやデータベース（MySQL, PostgreSQL, MongoDB）、キャッシュ（Redis, Memcached）、Webサーバー（Caddy, Nginx, Apache）など多彩なパッケージを統合し、分かりやすい管理インターフェースを提供します。ServBayを使えば、CodeIgniterに必要な開発環境の構築・管理が非常に簡単に行えます。

本ガイドでは、ServBayのPHP環境とウェブサイト機能を活用してCodeIgniterプロジェクトを作成・設定・起動する方法や、各種データベースやキャッシュサービスの統合例を解説します。

事前準備

始める前に、以下の準備ができていることを確認してください。

• macOS上にServBayがインストールされ、正常に動作している。
• ServBayで使用したいPHPバージョン（例：PHP 8.3）が有効化されている。
• ServBayで使用する予定のデータベースやキャッシュパッケージ（例：MySQL, PostgreSQL, Redis, Memcached）が有効化されている。

CodeIgniterプロジェクトの作成

ServBayでは、ウェブサイトプロジェクトは /Applications/ServBay/www ディレクトリにまとめて配置することを推奨しています。このディレクトリに置くことで、ServBayによるローカルサイトの管理が容易になります。

1. Composerのインストール

   ServBayにはComposerが最初から付属していますので、通常は追加インストール不要です。ターミナルでそのまま composer コマンドを利用できます。

2. ウェブサイトのルートディレクトリに移動

   ターミナルを開き、推奨ディレクトリへ移動します。

   cd /Applications/ServBay/www

3. CodeIgniterプロジェクトを作成

   Composerを使って新しいCodeIgniter 4プロジェクトを作成します。ここでは、プロジェクト名を servbay-codeigniter-app としています。

   composer create-project codeigniter4/appstarter servbay-codeigniter-app

   Composerが、CodeIgniterのスケルトンや依存パッケージをservbay-codeigniter-appディレクトリ内にダウンロードします。

4. プロジェクトディレクトリに移動

   新しく作成したプロジェクトディレクトリに移動します。

   cd /Applications/ServBay/www/servbay-codeigniter-app

初期設定

データベース接続の設定

CodeIgniterのデータベース設定ファイルは app/Config/Database.php にあります。データベースを利用する場合は、ここで接続情報を記入する必要があります。

まず、データベースを使う予定の場合はServBayのDB管理ツール（AdminerやphpMyAdmin、ServBay管理画面からアクセス可能）で、servbay_codeigniter_app というデータベースを作成してください。

続いて app/Config/Database.php ファイルを開きます。$default 配列を見つけ、利用するデータベースタイプ（MySQLやPostgreSQL）に合わせて接続情報を編集します。ServBayのデフォルトDBユーザー名・パスワードは通常 root / password です。

以下はMySQLでの設定例です。

public $default = [
    'DSN'      => '',
    'hostname' => '127.0.0.1', // ServBayのDBは通常127.0.0.1で待受
    'username' => 'root',     // ServBayデフォルトユーザー
    'password' => 'password', // ServBayデフォルトパスワード
    'database' => 'servbay_codeigniter_app', // 作成したDB名
    'DBDriver' => 'MySQLi',   // DB種類に応じて。MySQLならMySQLiかPdo
    'DBPrefix' => '',
    'pConnect' => false,
    'DBDebug'  => (ENVIRONMENT !== 'production'),
    'charset'  => 'utf8mb4',
    'DBCollat' => 'utf8mb4_general_ci',
    'swapPre'  => '',
    'encrypt'  => false,
    'compress' => false,
    'strictOn' => false,
    'failover' => [],
    'port'     => 3306,       // MySQLデフォルトポート
];

PostgreSQLの場合は、DBDriver を 'Postgre' に、port を 5432 に変更し、文字コードの設定も必要に応じて調整してください。

キャッシュ接続の設定（Memcached/Redis）

MemcachedやRedisをキャッシュストアとして利用する場合は、app/Config/Cache.php ファイルを編集します。

app/Config/Cache.php を開き、該当する設定セクションを見つけます。ServBayのMemcachedはデフォルトでポート11211、Redisは6379（どちらも通常パスワード不要）で待受しています。

Memcachedの設定例：

public $memcached = [
    'host'   => '127.0.0.1', // ServBay Memcachedは通常127.0.0.1で待受
    'port'   => 11211,      // デフォルトポート
    'weight' => 1,
];

Redisの設定例：

public string $handler = 'redis'; // デフォルトキャッシュハンドラをredisに設定

public $default = [ // Redis設定はdefault配列内
    'host'     => '127.0.0.1', // ServBay Redisは通常127.0.0.1で待受
    'password' => null,       // ServBay Redisはデフォルトでパスワード無し
    'port'     => 6379,       // Redisデフォルトポート
    'timeout'  => 0,
    'database' => 0,
];

利用するキャッシュパッケージに応じて、該当箇所を設定してください。

Webサーバーの設定（ServBayウェブサイト設定）

ServBayのウェブサイト機能を使ってWebサーバーを設定し、CodeIgniterプロジェクトに紐づけます。

1. ServBayアプリのインターフェースを開く。
2. Webサイト(Websites) タブへ移動。
3. 左下の + ボタンで新規ウェブサイトを追加。
4. サイト情報を入力：
   • 名前(Name): 識別しやすい任意の名前（例：My First CodeIgniter Dev Site）。
   • ドメイン(Domain): ブラウザでアクセスするローカルドメイン（例：servbay-codeigniter-test.local）。ServBayは .local ドメインを自動でローカルに解決します。
   • サイトタイプ(Site Type): PHP を選択。
   • PHPバージョン(PHP Version): 例：8.3 など利用したいバージョンを選択。
   • ドキュメントルート(Document Root): ここが重要です。CodeIgniterのエントリポイントである index.php はプロジェクトルートの public フォルダ内にあるため、ドキュメントルートは必ず public フォルダ（/Applications/ServBay/www/servbay-codeigniter-app/public）に設定してください。
5. 追加(Add) ボタンで設定を保存。
6. 設定反映の案内が出た場合は指示に従ってください。

詳細な設定方法は はじめてのWebサイト追加 もご参照ください。

サンプルコードの追加

動作確認とDB・キャッシュ接続テストのため、CodeIgniterのデフォルト Home コントローラにサンプルメソッドを追加します。

app/Controllers/Home.php ファイルを編集し、以下の内容に置き換えます。

<?php

namespace App\Controllers;

use CodeIgniter\Controller;
use CodeIgniter\Database\Exceptions\DatabaseException; // データベース例外クラスをインポート
use CodeIgniter\Cache\Exceptions\CacheException; // キャッシュ例外クラスをインポート

class Home extends Controller
{
    /**
     * デフォルトのホームページ表示
     */
    public function index(): string
    {
        // 簡単なウェルカムメッセージを返す
        return '<h1>Hello ServBay and CodeIgniter!</h1><p>Your CodeIgniter project is running on ServBay.</p>';
    }

    /**
     * Memcachedサンプルメソッド
     */
    public function memcached(): string
    {
        try {
            $cache = \Config\Services::cache();

            // キャッシュ書き込みを試行
            $success = $cache->save('servbay_memcached_key', 'Hello Memcached from CodeIgniter!', 60); // 60秒間キャッシュ

            if (!$success) {
                 return 'Error: Failed to save data to Memcached. Check Memcached service and configuration.';
            }

            // キャッシュから読み出しを試行
            $value = $cache->get('servbay_memcached_key');

            if ($value === null) {
                return 'Error: Failed to get data from Memcached. Cache might have expired or service is down.';
            }

            return 'Memcached Test Success: ' . $value;

        } catch (CacheException $e) {
            // キャッシュ関連例外をキャッチ
            return 'Cache Error: ' . $e->getMessage() . '. Ensure Memcached service is running and configured correctly.';
        } catch (\Exception $e) {
            // その他の例外もキャッチ
            return 'An unexpected error occurred: ' . $e->getMessage();
        }
    }

    /**
     * Redisサンプルメソッド
     */
    public function redis(): string
    {
        try {
            $cache = \Config\Services::cache();

            // キャッシュ書き込みを試行
            $success = $cache->save('servbay_redis_key', 'Hello Redis from CodeIgniter!', 60); // 60秒間キャッシュ

             if (!$success) {
                 return 'Error: Failed to save data to Redis. Check Redis service and configuration.';
            }

            // キャッシュから読み出しを試行
            $value = $cache->get('servbay_redis_key');

             if ($value === null) {
                return 'Error: Failed to get data from Redis. Cache might have expired or service is down.';
            }

            return 'Redis Test Success: ' . $value;

        } catch (CacheException $e) {
             // キャッシュ関連例外をキャッチ
            return 'Cache Error: ' . $e->getMessage() . '. Ensure Redis service is running and configured correctly.';
        } catch (\Exception $e) {
            // その他の例外もキャッチ
            return 'An unexpected error occurred: ' . $e->getMessage();
        }
    }

    /**
     * ユーザーデータをDB(MySQL/PostgreSQL)へ追加
     */
    public function addUser(): string
    {
        try {
            $db = \Config\Database::connect();

            // 'users'テーブルの存在確認（簡易的な安全対策）
            if (!$db->tableExists('users')) {
                 return 'Error: "users" table does not exist. Please run database migrations first.';
            }

            // データ挿入
            $data = [
                'name' => 'ServBay Demo User',
                'email' => 'user_' . time() . '@servbay.demo', // ユニークなemailを生成
            ];

            $db->table('users')->insert($data);

            // 挿入成功の確認（通常insert()はtrueを返します）
            // if ($db->affectedRows() > 0) {
                 return 'User added successfully: ' . $data['email'];
            // } else {
            //      return 'Error: Failed to add user.';
            // }

        } catch (DatabaseException $e) {
            // データベース関連例外
            return 'Database Error: ' . $e->getMessage() . '. Check database connection and table structure.';
        } catch (\Exception $e) {
             // その他の例外
            return 'An unexpected error occurred: ' . $e->getMessage();
        }
    }

    /**
     * DBからユーザーデータを一覧取得(MySQL/PostgreSQL)
     */
    public function listUsers(): string
    {
         try {
            $db = \Config\Database::connect();

             // 'users' テーブル存在確認
            if (!$db->tableExists('users')) {
                 return 'Error: "users" table does not exist. Please run database migrations first.';
            }

            // 全ユーザーを取得
            $users = $db->table('users')->get()->getResult();

            if (empty($users)) {
                return 'No users found in the database.';
            }

            // ユーザーリストをJSON形式で返す
            return json_encode($users);

        } catch (DatabaseException $e) {
             // データベース関連例外
            return 'Database Error: ' . $e->getMessage() . '. Check database connection and table structure.';
        } catch (\Exception $e) {
            // その他の例外
            return 'An unexpected error occurred: ' . $e->getMessage();
        }
    }
}

このコントローラーは、分かりやすい出力と基本的なエラーハンドリングを備えており、問題診断にも役立ちます。

ルーティング設定

追加したHomeコントローラーの各サンプルメソッドをURLで直接アクセスできるよう、CodeIgniterのルート設定を行います。

app/Config/Routes.php ファイルを編集し、$routes 定義セクションに以下を追加します。

// ... 他のルート設定 ...

// Memcachedサンプルルート
$routes->get('/memcached', 'Home::memcached');

// Redisサンプルルート
$routes->get('/redis', 'Home::redis');

// DBサンプルルート
$routes->get('/add-user', 'Home::addUser');
$routes->get('/list-users', 'Home::listUsers');

// ... 他のルート設定 ...

これらのルートは既存の $routes 定義に追記し、元の設定が上書きされないようご注意ください。

サイトへアクセスする

これでCodeIgniterプロジェクトがServBay上で動作開始しています。Webブラウザで指定したドメインにアクセスしてみましょう。

• トップページ: https://servbay-codeigniter-test.local
Hello ServBay and CodeIgniter! という表示が確認できれば、ServBayのWebサーバー経由でプロジェクトが正常に動作しています。

• Memcachedサンプル: https://servbay-codeigniter-test.local/memcached
  Memcachedサービスと設定が正しければMemcached Test Success: Hello Memcached from CodeIgniter! のような出力が表示されます。

• Redisサンプル: https://servbay-codeigniter-test.local/redis
  Redisサービスと設定が正しければRedis Test Success: Hello Redis from CodeIgniter! のような出力が表示されます。

データベース操作サンプル（MySQL/PostgreSQL）

データベースを使用したサンプルを試す前に、users テーブルを作成するためCodeIgniterのマイグレーションコマンドを実行します。

DB構造の作成（マイグレーション実行）

1. ターミナルでCodeIgniterプロジェクトディレクトリに移動

   cd /Applications/ServBay/www/servbay-codeigniter-app

2. マイグレーションファイル作成: CodeIgniterのCLIツールでusersテーブル用マイグレーションファイルを生成

   php spark make:migration create_users_table

   これにより、app/Database/Migrations ディレクトリに新しいPHPファイルが生成されます。

3. マイグレーションファイルの編集: 新規ファイル（ファイル名例：YYYY-MM-DD-HHMMSS_CreateUsersTable.php）のup()メソッドを編集して、usersテーブルのカラムやインデックスを記述します。MySQLとPostgreSQLでは自動タイムスタンプのデフォルト値構文が異なるため（CURRENT_TIMESTAMP vs NOW()）、CodeIgniterのRawSqlで動的に対応します。例：

   <?php
   
   namespace App\Database\Migrations;
   
   use CodeIgniter\Database\Migration;
   use CodeIgniter\Database\RawSql; // RawSqlクラスをインポート
   
   class CreateUsersTable extends Migration
   {
       public function up()
       {
           $this->forge->addField([
               'id'          => [
                   'type'           => 'INT',
                   'constraint'     => 5,
                   'unsigned'       => true,
                   'auto_increment' => true,
               ],
               'name'       => [
                   'type'       => 'VARCHAR',
                   'constraint' => '100',
               ],
               'email'      => [
                   'type'       => 'VARCHAR',
                   'constraint' => '100',
                   'unique'     => true, // メールアドレスを一意に設定
               ],
               'created_at' => [
                   'type'    => 'TIMESTAMP',
                   // DB種類ごとに適したデフォルト値を設定
                   // MySQL: 'default' => new RawSql('CURRENT_TIMESTAMP'),
                   // PostgreSQL: 'default' => new RawSql('NOW()'),
                   'default' => new RawSql($this->db->getPlatform() === 'MySQLi' ? 'CURRENT_TIMESTAMP' : 'NOW()'), // 動的に切り替え
               ],
               'updated_at' => [
                   'type'    => 'TIMESTAMP',
                   // MySQL: 'default' => new RawSql('CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP'),
                   // PostgreSQL: 'default' => new RawSql('NOW()'),
                    'default' => new RawSql($this->db->getPlatform() === 'MySQLi' ? 'CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP' : 'NOW()'), // 動的に切り替え
               ],
           ]);
           $this->forge->addKey('id', true); // idを主キーに設定
           $this->forge->createTable('users'); // usersテーブル作成
       }
   
       public function down()
       {
           // マイグレーション取り消し時にusersテーブルを削除
           $this->forge->dropTable('users');
       }
   }

   ※上記例ではデータベースエンジンごとにデフォルト値を動的選択しています。実際のプロジェクトでさらなる安全策や、DBごとに個別のマイグレーション定義を用意することもあります。

4. マイグレーション実行: 以下のコマンドでusersテーブルを作成します。

   php spark migrate

   成功するとマイグレーション完了メッセージが表示されます。ServBayのDB管理ツール（例：Adminer）でもservbay_codeigniter_appデータベースにusersテーブルができているかを確認できます。

データベースサンプルへのアクセス

app/Config/Database.php に正しいDB接続情報が設定され、かつ上記マイグレーションを実行してusersテーブルが作成されていることを確認してください。

• ユーザーをDBに追加: https://servbay-codeigniter-test.local/add-user にアクセス
  このURLを開くたびに、usersテーブルへ新規ユーザーが１件登録されます。User added successfully: user_XXXXXXXXXX@servbay.demo 等の表示になります。

• DB内ユーザー一覧表示: https://servbay-codeigniter-test.local/list-users にアクセス
  users テーブル内のレコードをすべてJSON形式で出力します。登録済みユーザーの配列がブラウザに返されます。

まとめ

これらの手順に従って、macOSのServBay環境上でCodeIgniterプロジェクトの作成・設定・起動までを一通り体験できます。Composerによるプロジェクト作成、正しいプロジェクトの公開ディレクトリの指定、データベースとキャッシュの設定、各種サンプルコードを通した動作確認方法まで習得できました。ServBayを利用することで、ローカル環境の構築や管理作業が簡単になり、本来注力したいCodeIgniterアプリ開発に集中できます。