CakePHP で複数のデータベース接続を使用するにはどうすればよいですか?

CakePHP は、Web アプリケーションを迅速に開発するために必要な基本的な機能と構造を提供する、人気のある PHP 開発フレームワークです。最新のアプリケーションでは、マスター/スレーブ データベース接続を確立したり、データを異なるデータベースにシャーディングしたりするなど、複数のデータベース接続を使用することが一般的な要件になっています。この記事では、CakePHP で複数のデータベース接続を使用する方法を紹介します。

CakePHP のデフォルトのデータベース接続

始める前に、まず CakePHP のデフォルトのデータベース接続を理解しましょう。 CakePHP は設定ファイルを使用してデータベース接続情報を管理します。データベース接続情報は通常 config/app.php ファイルに保存されます。このファイルには構成配列が含まれており、データベース接続構成情報を配列のデフォルトのサブキーに設定できます。

デフォルトでは、CakePHP はプライマリ データベース接続として MySQL を使用します。以下はサンプル コードです。

    'Datasources' => [
        'default' => [
            'className' => 'CakeDatabaseConnection',
            'driver' => 'CakeDatabaseDriverMysql',
            'persistent' => false,
            'host' => 'localhost',
            'username' => 'myuser',
            'password' => 'mypass',
            'database' => 'mydb',
            'encoding' => 'utf8mb4',
            'timezone' => 'UTC',
            'cacheMetadata' => true,
            'quoteIdentifiers' => false,
            'log' => false,
        ],
    ],

上記の構成情報には、データベース接続のクラス名、ドライバーの種類、ユーザー名とパスワードなど、いくつかの一般的な項目が表示されます。

複数のデータベース接続の使用

複数のデータベース接続を使用するには、上記のデフォルトのサブキーをコピーして、新しいデータベース接続を作成します。たとえば、次のコードは、セカンダリという名前の新しい接続を作成します。

    'Datasources' => [
        'default' => [
            'className' => 'CakeDatabaseConnection',
            'driver' => 'CakeDatabaseDriverMysql',
            '...
        ],
        'secondary' => [
            'className' => 'CakeDatabaseConnection',
            'driver' => 'CakeDatabaseDriverPostgres',
            'persistent' => false,
            'host' => 'localhost',
            'username' => 'myuser',
            'password' => 'mypass',
            'database' => 'mydb2',
            'encoding' => 'utf8',
            'timezone' => 'UTC',
            'cacheMetadata' => true,
            'quoteIdentifiers' => false,
            'log' => false,
        ],
    ],

上記のコードでは、さまざまなクラス名、ドライバーの種類、ユーザー名とパスワードなどの新しい接続構成項目が表示されます。たとえば、ユーザー名やパスワードなどの機密情報の場合、暗号化と復号化には Crypt クラスの encrypt() 関数と decrypt() 関数を使用する必要があることに注意してください。

さまざまな接続の使用

複数のデータベース接続を設定したので、次のステップはそれらをアプリケーションで使用することです。 CakePHP では、ConnectionManager クラスを使用してさまざまな接続にアクセスできます。サンプル コードは次のとおりです。

// 使用默认连接
$users = TableRegistry::get('Users');

// 使用secondary连接
$secondaryConn = ConnectionManager::get('secondary');
$secondaryUsers = TableRegistry::get('Users', [
    'connection' => $secondaryConn
]);

上記のコードでは、ConnectionManager クラスを使用してさまざまな接続を取得する方法がわかります。接続を確立したら、TableRegistry クラスを使用して、接続に関連付けられたデータ テーブル オブジェクトを取得できます。デフォルトの接続では、接続オプションを渡さずに省略できます。

接続の使用の拡張

接続を使用する場合、アプリケーションのニーズを満たすように接続をさらに拡張できます。たとえば、CakePHP のデータベース接続クラスを継承してカスタム接続クラスを作成すると、接続をより適切に処理できるようになります。以下はサンプル コードです:

class CustomMySqlConnection extends MySqlConnection
{
    public function __construct($config)
    {
        parent::__construct($config);
        $this->_isCustom = true;
    }

    public function customFunction()
    {
        return "Hello from CustomMySqlConnection!";
    }
}

// 使用CustomMySqlConnection来创建连接
'custom' => [
    'className' => 'CustomMySqlConnection',
    'driver' => 'CakeDatabaseDriverMysql',
    '...
],

// 获取custom连接并调用自定义函数
$customConn = ConnectionManager::get('custom');
$customConn->customFunction();

上記のコードでは、CakePHP のデフォルトの MySqlConnection クラスを拡張するために CustomMySqlConnection という名前のクラスを作成しました。このクラスはカスタム関数を追加し、_isCustom 変数を true に設定して、アプリケーション内の元の接続と区別できるようにします。

結論

上記の方法を使用すると、CakePHP で複数のデータベース接続を簡単にセットアップして使用し、複雑なアプリケーション要件をサポートできます。これらの接続は非常によく似ていますが、ConnectionManager クラスと TableRegistry クラスを使用して接続を取得および操作すると、アプリケーションで接続を柔軟に使用および管理できるようになります。

以上がCakePHP で複数のデータベース接続を使用するにはどうすればよいですか?の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。