README

A request management utility for PHP.

Usage

Execute composer require command.

$ composer require tomk79/request;

PHP

Basic

<?php
require_once('./vendor/autoload.php');
$req = new tomk79\request();

Optional

<?php
require_once('./vendor/autoload.php');
$req = new tomk79\request(array(
  'session_name' => 'SESSID',
  'session_expire' => (24 * 60 * 60),
  'directory_index_primary' => 'index.html',
  'cookie_default_path' => '/',
  'cookie_default_expire' => (7 * 24 * 60 * 60),
  'cookie_default_secure' => false, // 開発環境でHTTPを使う場合は false
));

API Document

see: docs/index.html

Test

$ cd (project directory)
$ php ./vendor/phpunit/phpunit/phpunit

phpDocumentor

$ composer run-script documentation

Change log

tomk79/request v1.4.2 (2026/1/10)

• セッションクッキーで cookie_default_domain が適用されていなかった問題を修正。
• cookie_default_secure オプションを追加。デフォルトは true。
• cookie_default_httponly オプションを追加。デフォルトは true。通常のクッキーにのみ適用されます（セッションクッキーは常に true）。
• cookie_default_samesite オプションを追加。デフォルトは 'Lax'。CSRF対策として、セッションクッキーと通常のクッキーの両方に適用されます。
• set_cookie() で、第8引数 $samesite を指定できるようになった。
• セッションクッキーに SameSite 属性を設定するようになった（デフォルトは 'Lax'）。
• セッション初期化時に isset($_SESSION) が常に真になる問題を修正。
• session_start(), session_name(), session_set_cookie_params(), setcookie() のエラー処理に関する改善。
• delete_cookie() で、パスとドメインを正しく指定するように修正し、Cookieを確実に削除できるようになった。
• set_cookie() と delete_cookie() で、ヘッダー送信済みチェックを追加。
• session_regenerate_id() で古いセッションファイルを削除するように変更し、セッション固定攻撃への対策を強化。
• session_start() のエラーハンドリングを強化し、失敗時に適切に false を返すようになった。
• セッション有効期限切れ時に session_unset() と session_destroy() を使用して適切にセッションを破棄するようになった。
• その他、内部コードの細かい修正、パフォーマンスの改善など。

tomk79/request v1.4.1 (2023/5/1)

• set_cookie()、 delete_cookie() で null が渡されて発生するエラーを修正。

tomk79/request v1.4.0 (2023/2/5)

• set_cookie() で、第7引数 $httponly を指定できるようになった。
• set_cookie() で、第3引数以降を、まとめて連想配列で指定できるようになった。
• cookie_default_expire オプションを追加した。
• cookie_default_domain オプションを追加した。
• session_expire が省略された場合、 cookie_default_expire の値を参照するようになった。
• セッションを2重に開始しようとしたときにPHPエラーが起きる不具合を修正。
• session_update() を追加した。
• セッションの予約後に、 SESSION_LAST_MODIFIED を廃止し、 SESSION_STARTED_AT, SESSION_DESTROYED_AT を追加した。
• その他、内部コードの細かい修正。

tomk79/request v1.3.1 (2022/12/28)

• .gitattributes を追加。

tomk79/request v1.3.0 (2022/4/24)

• get_method() を追加。
• get_headers() を追加。
• get_header() を追加。
• 内部コードの細かい修正。

tomk79/request v1.2.0 (2022/1/4)

• サポートするPHPのバージョンを >=7.3.0 に変更。

tomk79/request v1.1.1 (2021/4/23)

• 内部コードの細かい修正。

tomk79/request v1.1.0 (2020/6/21)

• $req->set_cookie() の $secure フラグは、デフォルトが true に変更されました。

tomk79/request v1.0.2 (2018/8/22)

• 細かい不具合の修正。

tomk79/request v1.0.1 (2018/2/9)

• PHP 7.2 で、CLIで session_start() を実行した際に Warning が発生する問題を修正。

tomk79/request v1.0.0 (2017/04/11)

• 初期化オプションに cookie_default_path を追加。

tomk79/request v0.1.4 (2015/03/19)

• Noticeレベルのエラー修正

tomk79/request v0.1.3 (2014/12/09)

• $req->get_request_file_path() の戻り値をスラッシュで正規化するようになった。

tomk79/request v0.1.2 (2014/11/24)

• $req->get_request_file_path() でのディレクトリトラバーサル対策処理を追加。

tomk79/request v0.1.1 (2014/10/21)

• Bug fix on Windows

tomk79/request v0.1.0 (2014/09/22)

• Initial Release.

License

MIT License

Author

• (C)Tomoya Koyanagi tomk79@gmail.com
• website: https://www.pxt.jp/
• Twitter: @tomk79 https://twitter.com/tomk79/