その他

PHP Cookieの基本と利用方法について解説

2025-02-19更新日: 2025-02-19

PHPではCookieを使って、クライアント側に少量のデータを保存します。

ユーザー認証やセッション管理に役立ち、サイトの操作性を向上させる仕組みです。

setcookie関数でCookieを設定し、 $expire$ やパスなどのオプションを指定できるため、柔軟なデータ管理が可能です。

目次から探す

Cookieの基本知識
- Cookieとは
- Cookie利用の主な場面
Cookieの作成と設定
- setcookie関数の使い方
- 保存オプションの設定
Cookieの取得と管理
- $_COOKIEの利用方法
- Cookieの削除
Cookieのセキュリティ対策
- 安全な属性設定
まとめ

Cookieの基本知識

Cookieとは

定義と役割

Cookieは、Webサーバーとブラウザ間で情報をやり取りする仕組みの一つです。

ユーザーがサイトを訪問すると、サーバーからブラウザに送信されるCookieは、ユーザー固有の情報保持やセッション管理に役立ちます。

例えば、ユーザーのログイン状態やサイト内での設定情報を記録することができます。

Cookieの役割は、以下のような点に挙げられます。

ユーザー識別
セッション管理
個々のユーザーに合わせたコンテンツ表示

ブラウザでの動作

ブラウザは、サーバーから送られるCookie情報を受け取り、指定された有効期限やドメイン、パスに基づいて保存します。

次回、同じドメインへリクエストを送信する際、ブラウザは自動的に該当するCookie情報をリクエストヘッダーに含めて送信します。

この動作により、サーバーはユーザーの前回の訪問情報や設定内容を参照することが可能となります。

また、ブラウザのCookie管理機能を利用して、不要なCookieの削除や設定の変更が可能です。

Cookie利用の主な場面

Cookieは主に以下の場面で利用されます。

ユーザー認証：ログイン状態の維持、セッションIDの管理
ユーザー設定：サイトのレイアウトや言語設定などの個別設定の保存
トラッキング：ユーザーの操作履歴や訪問記録の保存(プライバシー保護に注意が必要)

Cookieの作成と設定

setcookie関数の使い方

各パラメータの詳細( $expire$ など)

PHPでCookieを作成する際に利用するのがsetcookie関数です。

setcookie関数は、以下のようなパラメータを設定することができます。

name：Cookieの名前
value：Cookieに保存する値
expire：Cookieの有効期限をUNIXタイムスタンプで設定。たとえば、現時刻から1時間後の場合はtime() + 3600となります。
path：Cookieが有効なパス。指定したパス下のすべてのページでCookieが利用されます。
domain：Cookieが有効なドメイン
secure：trueの場合、HTTPS通信だけでCookieが送信される
httponly：trueの場合、JavaScriptからCookieへのアクセスが制限される

以下は、基本的なsetcookieの利用例です。

<?php
// Cookie名: user_id、値: ユーザー識別用のID、1時間後に有効期限が切れるCookieをセットする例
setcookie("user_id", "sample_user_123", time() + 3600, "/");
?>

// Cookieは設定された条件に沿ってブラウザに送信されます。
// 出力はなく、HTTPヘッダーにCookie情報が追加されます。

設定時の注意点

Cookieの設定時には、以下の点に注意してください。

CookieはHTTPヘッダーとして送信されるため、出力前に設定する必要があります。
有効期限が過ぎたCookieは自動的に無効となるため、適切なタイミングで更新が必要です。
セキュリティ対策として、secureやhttponlyオプションの利用を検討してください。

保存オプションの設定

有効期限の指定方法

Cookieの有効期限はexpireパラメータを利用して指定します。

有効期限はUNIXタイムスタンプで設定する必要があり、たとえば、24時間後に有効期限が切れる場合はtime() + 86400となります。

具体例は以下の通りです。

<?php
// Cookie名: session_token、値: セッショントークン、24時間後に期限が切れるCookie
setcookie("session_token", "secure_session_value", time() + 86400, "/");
?>

// Cookieは設定された有効期限に従い、24時間後に自動的に無効となります。
// 出力はなく、HTTPヘッダーにCookie情報が追加されます。

パス・ドメインの設定方法

Cookieは特定のパスやドメインに限定して利用することができます。

path：たとえば、/appを指定すると、/app以下のパスでのみCookieが利用されます。
domain：サブドメイン全体でCookieを共有したい場合、たとえば.example.comのようにドメイン名を先頭にピリオドを付けて指定します。

具体例は以下の通りです。

<?php
// Cookie名: lang、値: ユーザーの言語設定、/appパス、example.comドメインで有効
setcookie("lang", "ja", time() + 3600, "/app", ".example.com");
?>

// 指定されたパスとドメインに限定してCookieが利用されます。
// 出力はなく、HTTPヘッダーにCookie情報が追加されます。

Cookieの取得と管理

$_COOKIEの利用方法

データの読み取り手順

PHPでは、ブラウザから送信されたCookie情報はスーパーグローバル変数$_COOKIEで取得することができます。

以下は、ユーザー識別用のCookieを読み取る例です。

<?php
// ユーザーIDを保存しているCookieが存在するか確認し、値を取得する
if (isset($_COOKIE["user_id"])) {
    $userId = $_COOKIE["user_id"]; // CookieからユーザーIDを取得
    echo "ユーザーID: " . $userId;
} else {
    echo "ユーザーIDのCookieは設定されていません。";
}
?>

// ユーザーID: sample_user_123
// ※上記はCookieが設定されている場合の例です。
// Cookieが存在しない場合は、"ユーザーIDのCookieは設定されていません。"と表示されます。

Cookieの削除

削除処理の実装方法

Cookieを削除する際は、setcookie関数を利用し、有効期限を過去の時刻に設定します。

以下は、Cookieを削除する例です。

<?php
// Cookie名: user_id を削除する例
// 有効期限を過去に設定することで削除を実行
setcookie("user_id", "", time() - 3600, "/");
echo "Cookie user_id を削除しました。";
?>

// Cookie user_id を削除しました。
// 指定したCookieは即時削除されます。

Cookieのセキュリティ対策

安全な属性設定

HTTPOnly・Secure属性の利用

CookieにHTTPOnlyとSecure属性を設定することで、セキュリティレベルを向上させることができます。

HTTPOnly属性により、JavaScriptからのアクセスが禁止され、クロスサイトスクリプティング(XSS)攻撃のリスクを減少させます。
Secure属性を設定することで、HTTPS通信時のみCookieが送信され、ネットワーク上での傍受リスクが低減されます。

以下は、両方の属性を設定したCookieの例です。

<?php
// Cookie名: auth_tokenの作成。SecureおよびHTTPOnly属性を設定。
// HTTPS通信環境でのみ動作する前提
setcookie("auth_token", "encrypted_token_value", time() + 7200, "/", ".example.com", true, true);
?>

// Cookie auth_token はHTTPS通信でのみ送信され、JavaScriptからのアクセスが禁止されています。
// 出力はなく、HTTPヘッダーにCookie情報が追加されます。

SSL/TLS利用時の留意点

Cookieを安全に運用するためには、SSL/TLSを利用して暗号化された通信環境でCookieを送受信することが重要です。

SSL/TLSを利用することで、Cookieの内容がネットワーク上で傍受されるリスクを低減できます。
Webサイト全体でHTTPSを強制する設定が推奨されます。
Secure属性を設定することで、HTTP時のCookie送信を防止できます。

以上の項目に留意しながら、Cookieの管理や利用を行うと、より安全で利便性の高いWebアプリケーションの実現が期待できます。

まとめ

この記事では、PHPにおけるCookieの基本知識から作成・設定、取得・管理、セキュリティ対策までを説明しました。

Cookieの仕組みと利用方法について理解が深まったといえます。

新たな実装に挑戦して、知識を活用してみてください。