クッキーを送受信する

　クッキーはWebブラウザーに少量のデータを保存しておくことができる仕組みです。クライアント側にデータを保存しておき、クライアントからのリクエストと一緒にクッキーのデータを送信します。サーバーはそのリクエストと共にデータを受信して処理することができます。

　phpでクッキーを使うには「$_COOKIE」変数を利用します。またクッキーにデータを保存するには「setcookie」関数を利用します。

パラメーターリスト
関数名	setcookie
パラメター名	説明
string $name	クッキー名
string $value = “”	クッキーに保存する値
string $expires = 0	クッキーの有効期限
返り値
bool	正常に実行されるとTRUE、失敗した場合FALSE

setcookie関数の仕様

　「POSTTest.php」ファイルをコピーして、次のPHPファイルをプロジェクトに追加してください。

ファイルの種類	PHPファイル
ファイル名	CookieForm.php

<?php
//ユーザー名のクッキー情報を取得する
if(isset($_COOKIE['user_name'])){
　$user_name = $_COOKIE['user_name'];
}else{
　$user_name = '';
}
//名前のクッキー情報を取得する
if(isset($_COOKIE['name'])){
　$name = $_COOKIE['name'];
}else{
　$name = '';
}
//Emailのクッキー情報を取得する
if(isset($_COOKIE['email'])){
　$email = $_COOKIE['email'];
}else{
　$email = '';
}
?>
<!DOCTYPE html>
<html>
　<head>
　　<meta charset="UTF-8">
　　<title>データ入力フォーム</title>
　</head>
　<body>
　　<p>ユーザー情報をクッキーに保存する</p>
　　<form action="CookieTest.php" method="POST">
　　　ユーザー名：
　　　<input type="text" name="user_name" value="<?php print($user_name); ?>">
　　　<br>
　　　名前：
　　　<input type="text" name="name" value="<?php print($name); ?>">
　　　<br>
　　　Email：
　　　<input type="email" name="email" value="<?php print($email); ?>">
　　　<br>
　　　<input type="checkbox" name="save" checked>情報を保存する
　　　<br>
　　　<input type="submit">
　　</form>
　</body>
</html>

　3、10、17行目で、isset関数を使用しています。この関数は引数で指定した変数が存在しているかどうかを確認できます。存在していればTRUEを、存在していなければFALSEを返します。今回は、クッキー情報が存在していれば、クッキー情報をそれぞれのデータ用の変数に格納し、存在していなければ、それぞれのデータ用の変数に空文字列をセットしています。

　それぞれのデータ用変数の内容を33、36、39行目のテキストボックスのデフォルト値として表示するようにしています。これにより、クッキーに情報があれば入力フォームに前回入力した内容が表示されるようになります。

　次に、送信されたフォームデータをクッキーに保存するプログラムを作成しましょう。

　「POSTTest.php」ファイルをコピーして、次のPHPファイルをプロジェクトに追加してください。

ファイルの種類	PHPファイル
ファイル名	CookieTest.php

<?php
//チェックボックスがチェックされているかどうか
if(isset($_POST['save'])){ //チェックが入っている場合
　$expires = time() + 300; //5分間有効
}else{ //チェックが入っていない場合
　$expires = time() - 60; //過去に設定することで無効(削除)にする
}
//クッキー情報登録
setcookie('user_name', $_POST['user_name'], $expires);
setcookie('name', $_POST['name'], $expires);
setcookie('email', $_POST['email'], $expires);
?>
<!DOCTYPE html>
<html>
　<head>
　　<meta charset="UTF-8">
　　<title>クッキー登録</title>
　</head>
　<body>
　　<p>クッキー情報を登録しました。<p>
　　<a href="CookieForm.php">入力フォームに戻る</a>
　</body>
</html>

　3行目で、フォームで選択された「情報を保存する」チェックボックスの値を調べています。チェックが入っていればポストデータで送信されてくるため、isset関数でTRUEが返ってきます。その場合は$expires変数に現在から5分後の時間のデータを格納しています。FALSEの場合は$expires変数に現在から1分前の時間のデータを格納しています。

　10~12行目で、setcookie関数を使ってクッキー情報を格納しています。第1引数にクッキー名、第2引数に保存するデータ、第3引数に有効期限を渡しています。これによりサーバーからWebブラウザーにレスポンスが返る時に、Webブラウザーにクッキーを操作する情報も一緒に渡されることになります。

　有効期限は省略したり、0を設定したりするとクッキーはWebブラウザーを閉じるまでが有効期限となります。未来の時間を指定すると、その時間までクッキーは保持され、過去の時間を指定するとクッキーは有効期限切れとなり、Webブラウザーからクッキーが削除されます。

○　実行結果(有効期限を過去にした場合、有効期限が切れた場合)

　入力フォームで「情報を保存する」チェックボックスのチェックを外した状態で送信すると、過去の有効期限がセットされ、入力フォームに戻ると入力内容が消えていることを確認できます。また、入力フォームにクッキーのデータが表示されている状態で、5分後にWebブラウザーを更新しても、入力内容が消えていることを確認できます。