创建并运行 CodeIgniter 项目

什么是 CodeIgniter？

CodeIgniter 是一个轻量级的 PHP 框架，适用于开发快速、高效的 Web 应用程序。它遵循 MVC（Model-View-Controller）设计模式，提供了丰富的功能和工具，使开发者能够快速构建高质量的 Web 应用。CodeIgniter 以其简洁、高性能和易于学习而著称，是许多开发者的首选框架。

CodeIgniter 的主要特性和优势

• 轻量级：CodeIgniter 的核心系统非常小巧，只包含必要的组件，加载速度非常快。
• 高性能：CodeIgniter 以其高效的性能和速度而闻名，能够处理高并发请求。
• 易于学习：提供简洁易用的 API 和丰富的文档，开发者可以快速上手。
• 灵活性：允许开发者自由选择和使用第三方库和插件，方便扩展和定制功能。
• 强大的社区支持：拥有活跃的开发者社区和丰富的第三方扩展。

CodeIgniter 可以帮助开发者快速构建高性能、高质量的 Web 应用，适用于各种规模的项目。

使用 ServBay 创建并运行 CodeIgniter 项目

在这篇文章中，我们将使用 ServBay 提供的 PHP 环境来创建并运行一个 CodeIgniter 项目。我们将利用 ServBay 的『主机』功能来设置 Web 服务器，并通过简单的配置实现项目的访问。

注意：如果你曾经是 NGINX 或 Apache 的用户

ServBay 默认使用 Caddy 作为 Web 服务器。对于从 NGINX 和 Apache 迁移到 ServBay 的用户，有一些关键变动点需要注意：

1. Caddy 配置

   ServBay 已经内置了 Caddy，并且默认配置已经优化和调试好。开发者只需通过 ServBay 的『主机』功能来管理站点，无需手动修改 Caddy 配置文件。

2. Rewrite 规则和 .htaccess

   在 NGINX 和 Apache 中，开发者通常需要自己编写 Rewrite 规则和 .htaccess 文件来处理 URL 重写和其他配置。然而，ServBay 出厂时已经配置好了 Caddy 的规则，因此，除非有特殊需求，否则开发者无需自己编写这些规则。

3. 了解更多

   更多相关信息，请参阅Rewrite与htaccess、Apache网站如何迁移到ServBay、NGINX网站如何迁移到ServBay。

创建 CodeIgniter 项目

TIP

ServBay 建议开发者把网站放置在/Applications/ServBay/www目录下，以方便管理。

1. 安装 Composer

   ServBay 出厂时已经自带 Composer，无需单独安装。

2. 创建 CodeIgniter 项目

   使用 Composer 创建一个新的 CodeIgniter 项目：

   cd /Applications/ServBay/www
   mkdir servbay-codeigniter-app
   cd servbay-codeigniter-app
   composer create-project codeigniter4/appstarter .

3. 进入项目目录

   进入新创建的 CodeIgniter 项目目录：

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

初始化配置

1. 配置数据库连接

   在 app/Config/Database.php 文件中配置数据库连接信息：

   public $default = [
       'DSN'      => '',
       'hostname' => '127.0.0.1',
       'username' => 'root',
       'password' => 'password',
       'database' => 'servbay_codeigniter_app',
       'DBDriver' => 'MySQLi',
       'DBPrefix' => '',
       'pConnect' => false,
       'DBDebug'  => (ENVIRONMENT !== 'production'),
       'charset'  => 'utf8mb4',
       'DBCollat' => 'utf8mb4_general_ci',
       'swapPre'  => '',
       'encrypt'  => false,
       'compress' => false,
       'strictOn' => false,
       'failover' => [],
       'port'     => 3306,
   ];

配置 Web 服务器

使用 ServBay 的『主机』功能，通过 Web 服务器来访问 CodeIgniter 项目。在 ServBay 的『主机』设置中，添加一个新的主机：

• 名字：My First CodeIgniter Dev Site
• 域名：servbay-codeigniter-test.local
• 网站类型：PHP
• PHP 版本：选择 8.3
• 网站根目录：/Applications/ServBay/www/servbay-codeigniter-app/public

详细设置步骤请参考 添加第一个网站。

添加示例代码

在 app/Controllers/Home.php 文件中添加以下代码：

namespace App\Controllers;

use CodeIgniter\Controller;

class Home extends Controller
{
    public function index()
    {
        return 'Hello ServBay!';
    }

    public function memcached()
    {
        $cache = \Config\Services::cache();
        $cache->save('key', 'Hello Memcached!', 60);
        $value = $cache->get('key');
        return $value;
    }

    public function redis()
    {
        $redis = \Config\Services::cache();
        $redis->set('key', 'Hello Redis!');
        $value = $redis->get('key');
        return $value;
    }

    public function mysqlAdd()
    {
        $db = \Config\Database::connect();
        $db->table('users')->insert([
            'name' => 'ServBay',
            'email' => '[email protected]',
        ]);
        return 'User added';
    }

    public function mysql()
    {
        $db = \Config\Database::connect();
        $users = $db->table('users')->get()->getResult();
        return json_encode($users);
    }
}

访问网站

打开浏览器，访问以下 URL：

• https://servbay-codeigniter-test.local：您会看到页面输出 Hello ServBay!。

NoSQL数据库示例

Memcached 示例

1. 安装 Memcached 扩展

   在 ServBay 中，Memcached 扩展已经预装好，无需额外安装。

2. 配置 Memcached

   在 app/Config/Cache.php 文件中配置 Memcached 连接信息：

   public $memcached = [
       'host'   => '127.0.0.1',
       'port'   => 11211,
       'weight' => 1,
   ];

3. 使用 Memcached

   在控制器中使用缓存：

   public function memcached()
   {
       $cache = \Config\Services::cache();
       $cache->save('key', 'Hello Memcached!', 60);
       $value = $cache->get('key');
       return $value;
   }

4. 在文件app/Config/Routes.php中增加路由:

   $routes->get('/memcached', 'Home::memcached');

5. 打开浏览器并且访问：https://servbay-codeigniter-test.local/memcached

Redis 示例

1. 安装 Redis 扩展

   在 ServBay 中，Redis 扩展已经预装好，无需额外安装。

2. 配置 Redis

   在 app/Config/Cache.php 文件中配置 Redis 连接信息：

   public string $handler = 'redis';
   
   public $default = [
       'host'     => '127.0.0.1',
       'password' => null,
       'port'     => 6379,
       'timeout'  => 0,
       'database' => 0,
   ];

3. 使用 Redis

   在控制器中使用缓存：

   public function redis()
   {
       $redis = \Config\Services::cache();
       $redis->save('key', 'Hello Redis!');
       $value = $redis->get('key');
       return $value;
   }

4. 在文件app/Config/Routes.php中添加路由:

   $routes->get('/redis', 'Home::redis');

5. 打开浏览器并且访问：https://servbay-codeigniter-test.local/redis

关系型数据库示例

创建数据库结构和迁移文件

1. 创建迁移文件

   使用 CodeIgniter 的 CLI 工具创建迁移文件：

   php spark make:migration create_users_table

2. 编辑迁移文件

   在 app/Database/Migrations 目录下找到新创建的迁移文件，并编辑它以定义数据库表结构：

   use CodeIgniter\Database\RawSql;
   
   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',
               'default' => new RawSql('CURRENT_TIMESTAMP'),
           ],
           'updated_at' => [
               'type' => 'TIMESTAMP',
               'default' => new RawSql('CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP'),
           ],
       ]);
       $this->forge->addKey('id', true);
       $this->forge->createTable('users');
   }

3. 运行迁移

   使用 CodeIgniter 的迁移命令运行迁移，创建数据库表：

   php spark migrate

MySQL 示例

1. 配置 MySQL

   在 app/Config/Database.php 文件中配置 MySQL 连接信息：

   public $default = [
       'DSN'      => '',
       'hostname' => '127.0.0.1',
       'username' => 'root',
       'password' => 'password',
       'database' => 'servbay_codeigniter_app',
       'DBDriver' => 'MySQLi',
       'DBPrefix' => '',
       'pConnect' => false,
       'DBDebug'  => (ENVIRONMENT !== 'production'),
       'charset'  => 'utf8',
       'DBCollat' => 'utf8_general_ci',
       'swapPre'  => '',
       'encrypt'  => false,
       'compress' => false,
       'strictOn' => false,
       'failover' => [],
       'port'     => 3306,
   ];

2. 添加路由

   在文件中app/Config/Routes.php添加以下路由:

   $routes->get('/mysql-add', 'Home::mysqlAdd');
   $routes->get('/mysql', 'Home::mysql');

3. 写入用户数据

   在控制器中写入用户数据：

   public function mysqlAdd()
   {
       $db = \Config\Database::connect();
       $db->table('users')->insert([
           'name' => 'ServBay',
           'email' => '[email protected]',
       ]);
       return 'User added';
   }

4. 使用 MySQL

   在控制器中调用数据库：

   public function mysql()
   {
       $db = \Config\Database::connect();
       $users = $db->table('users')->get()->getResult();
       return json_encode($users);
   }

   打开浏览器并且访问：https://servbay-codeigniter-test.local/mysql-add 和 https://servbay-codeigniter-test.local/mysql

PostgreSQL 示例

1. 配置 PostgreSQL

   在 app/Config/Database.php 文件中配置 PostgreSQL 连接信息：

   public $default = [
       'DSN'      => '',
       'hostname' => '127.0.0.1',
       'username' => 'root',
       'password' => 'password',
       'database' => 'servbay_codeigniter_app',
       'DBDriver' => 'Postgre',
       'DBPrefix' => '',
       'pConnect' => false,
       'DBDebug'  => (ENVIRONMENT !== 'production'),
       'charset'  => 'utf8',
       'DBCollat' => 'utf8_general_ci',
       'swapPre'  => '',
       'encrypt'  => false,
       'compress' => false,
       'strictOn' => false,
       'failover' => [],
       'port'     => 5432,
   ];

2. 创建数据库迁移文件

   使用以下命令，生成数据库迁移文件：

   php spark make:migration create_users_table

3. 编辑数据库迁移文件

   use CodeIgniter\Database\RawSql;
   
   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',
               'default' => new RawSql('NOW()'),
           ],
           'updated_at' => [
               'type' => 'TIMESTAMP',
               'default' => new RawSql('NOW()'),
           ],
       ]);
       $this->forge->addKey('id', true);
       $this->forge->createTable('users');
   }

4. 运行数据库迁移

   执行下面的命令，来执行数据库迁移，创建表结构：

   php spark migrate

5. 添加路由

   在文件app/Config/Routes.php中添加以下路由:

   $routes->get('/pgsql-add', 'Home::pgsqlAdd');
   $routes->get('/pgsql', 'Home::pgsql');

6. 写入用户数据

   在控制器中写入用户数据：

   public function pgsqlAdd()
   {
       $db = \Config\Database::connect();
       $db->table('users')->insert([
           'name' => 'ServBay',
           'email' => '[email protected]',
       ]);
       return 'User added';
   }

7. 使用 PostgreSQL

   在控制器中调用数据库：

   public function pgsql()
   {
       $db = \Config\Database::connect();
       $users = $db->table('users')->get()->getResult();
       return json_encode($users);
   }

   打开浏览器并且访问： https://servbay-codeigniter-test.local/p;pgsql-add 和 https://servbay-codeigniter-test.local/pgsql

通过以上步骤，您成功创建并运行了一个 CodeIgniter 项目，并使用 ServBay 提供的功能来管理和访问您的项目，同时连接了多种数据库并调用数据。希望这篇文章能帮助您快速上手 CodeIgniter，并应用于您的项目中。