開発運用

PHP Redisセッションハンドラー設定

最終更新： 03/03/2025
1分未満

Redisは、セッション管理やキャッシュ処理を高速に行うために使用される、インメモリ型データベースです。PHPとRedisを連携させて、Redisをセッションハンドラーとして使用する方法をUbuntu環境で設定する手順を、完全かつ包括的に解説します。以下の手順に従って、RedisをPHPセッションハンドラーとして設定することで、セッションデータの管理を高速化し、スケーラビリティの向上が期待できます。

1. Redisのインストール

まず最初に、RedisサーバーをUbuntuにインストールする必要があります。以下の手順でインストールを行います。

関連記事

1.1 Redisパッケージのインストール

Ubuntuのパッケージマネージャを使用してRedisをインストールします。ターミナルを開き、以下のコマンドを実行します。

bash
sudo apt update
sudo apt install redis-server

インストールが完了したら、Redisが自動的に起動します。Redisが正常に動作しているか確認するには、次のコマンドを実行して確認します。

bash
sudo systemctl status redis

「active (running)」と表示されれば、正常に起動しています。

1.2 Redisの設定

Redisのデフォルト設定は、セッションハンドラーとして使用する場合にも適していますが、セキュリティやパフォーマンスを考慮して設定を調整することもできます。設定ファイルは/etc/redis/redis.confにあります。このファイルを開き、必要に応じて設定を変更します。

例えば、Redisを外部からアクセスできないようにするには、以下のように設定します。

bash
bind 127.0.0.1

設定変更後、Redisを再起動します。

bash
sudo systemctl restart redis

2. PHPのRedis拡張のインストール

RedisをPHPで利用するためには、PHP用のRedis拡張をインストールする必要があります。Ubuntuでは、php-redisというパッケージをインストールできます。

2.1 PHP Redis拡張のインストール

bash
sudo apt install php-redis

インストール後、PHPがRedis拡張を利用できるようになります。PHPのインストールされたバージョンによっては、php7.x-redisのようにバージョンを指定する必要がある場合があります。

2.2 PHP設定ファイルの確認

PHPがRedis拡張をロードしているかを確認するには、次のコマンドで確認できます。

bash
php -m | grep redis

redisが表示されれば、Redis拡張が正しくインストールされています。

3. PHPセッションの設定

PHPでRedisをセッションハンドラーとして使用するためには、PHPのセッション設定を変更する必要があります。

3.1 php.iniの設定変更

PHPのセッション設定をRedisに変更するために、php.iniファイルを編集します。php.iniの場所は、PHPのバージョンやインストール方法によって異なりますが、通常は/etc/php/7.x/apache2/php.iniや/etc/php/7.x/cli/php.iniにあります。

以下の設定をphp.iniに追加または変更します。

ini
session.save_handler = redis
session.save_path = "tcp://127.0.0.1:6379?database=0"

これにより、PHPはRedisをセッションの保存先として使用するようになります。session.save_pathの設定には、Redisサーバーのアドレス（ここではローカルホスト）とポート番号を指定します。

3.2 Apacheの再起動

設定変更後、Apacheを再起動して変更を反映させます。

bash
sudo systemctl restart apache2

4. PHPコードの実装

次に、PHPコードでRedisセッションを実際に利用する方法について説明します。

4.1 セッション開始

PHPのセッションを使用するには、まずセッションを開始します。session_start()を呼び出すことで、セッションが開始され、Redisを通じてセッションデータが保存されます。

php

session_start();

// セッション変数に値をセット
$_SESSION['user_id'] = 1;
$_SESSION['username'] = 'testuser';

// セッションデータを確認
echo $_SESSION['username'];  // 出力: testuser
?>

4.2 セッションの削除

セッションデータを削除するには、session_unset()を使用してセッション変数を削除し、session_destroy()を使用してセッションを完全に破棄します。

php

session_start();

// セッションデータの削除
session_unset();
session_destroy();
?>

5. Redisのセッション設定のテスト

PHPでRedisをセッションハンドラーとして使用する設定が正しく行われているかテストするために、簡単なPHPスクリプトを作成して、セッションデータがRedisに保存されるか確認します。

5.1 セッションテストスクリプト

以下のコードをtest_session.phpとして保存し、Webブラウザでアクセスして動作を確認します。

php

session_start();

// セッションにデータを設定
$_SESSION['username'] = 'testuser';
$_SESSION['last_visit'] = time();

// セッション情報の表示
echo 'Username: ' . $_SESSION['username'] . '
';
echo 'Last Visit: ' . date('Y-m-d H:i:s', $_SESSION['last_visit']);
?>

このスクリプトを実行後、Redisに保存されたセッションデータを確認するには、redis-cliを使用して、セッションが保存されていることを確認します。

bash
redis-cli
keys *

Redisに保存されているキーのリストが表示され、セッションデータが正しく保存されていることがわかります。

6. トラブルシューティング

もしセッションが正常に動作しない場合、以下の点を確認してください。

  • Redisサーバーが動作しているか：sudo systemctl status redisで確認します。
  • PHPのエラーログ：/var/log/apache2/error.logにエラーが出力されていないか確認します。
  • セッション設定：php.iniの設定が正しいか再確認します。
  • Redis接続：Redisのポートやホスト設定が正しいか確認します。

まとめ

RedisをPHPのセッションハンドラーとして使用することで、セッション管理が効率的に行えるようになります。特に、スケーラブルなアプリケーションで複数のサーバー間でセッションを共有する必要がある場合に非常に有効です。上記の手順に従って設定を行うことで、Redisをセッション管理に活用でき、アプリケーションのパフォーマンスを向上させることができます。

最終更新： 03/03/2025
1分未満
Back to top button