Download the PHP package ryunosuke/simple-cache without Composer
On this page you can find all versions of the php package ryunosuke/simple-cache. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package simple-cache
simple cache
Description
psr-16 を実装したシンプルなキャッシュパッケージです。 ストリームのみの実装ですが、php には強力な StreamWrapper があるので、(Wrapper があれば)実質的にあらゆる対象に書き込むことができます。
Install
Feature
(Wrapper があれば)あらゆる個所に出力できます。 例えば下記は S3 にキャッシュを出力します。
ArrayAccess を実装しています。
それ自体は特筆すべきではない実装ですが、ArrayAccess によって ??=
を利用した「あるなら取得、なかったら設定しつつ取得」が容易になります。
追加で下記のようなメソッドが生えています。
- fetch*: 取得を試みて、無かったらクロージャの返り値を格納しつつ返します
- *ByHash: キーの制約がないキャッシュです
- keys: キャッシュキーの一覧を取得します
- items: キャッシュキーとキャッシュアイテムの一覧を取得します
- gc: 有効期限の切れたアイテムや無効になっているアイテムを削除します
キーに特殊な拡張子を指定すると格納方法を指定できます。 組み込みで下記の拡張子が使えます。
php
: php のコードとして格納します。opcache が効くため高速ですphp-serialize
: serialize で格納します。↑があるため出番はほぼありません
php
は無名クラスやクロージャもキャッシュできます。
これらの拡張子・クラスは itemClasses
オプションで拡張できます。
defaultExtension
で拡張子がなかった場合のデフォルト格納方法を指定できます。
なお、 キーの .
はディレクトリ区切りを意味し、新たにディレクトリが作成されます。
この動作を切りたい場合は directorySupport
に明示的に false を指定してください。
License
MIT
FAQ
- Q. なんで車輪の再開発した?
- A. 元々 symfony-cache を好んで使っていたんですが、少し仰々しく感じてきて、実際のところ adapter は PhpFilesAdapter しか使わないし見通し良くなるように自前実装したかったのです
- Q. いや、symfony-cache なら Redis とか APCu とか有用なのもあるよ?
- A. 専用の adapter を書かずとも php には既に StreamWrapper という強力な抽象化レイヤーが存在します。adapter で使い分けるよりも
s3://hoge/cache
とかredis://hoge/cache
とか書くだけでよしなに判断してくれる方が好みなのです
- A. 専用の adapter を書かずとも php には既に StreamWrapper という強力な抽象化レイヤーが存在します。adapter で使い分けるよりも
- Q. それにしたって自前実装しなくても…
- A. PhpFilesAdapter の吐き出すファイル名が好みではない、というのも多分にありました。フラットかつ key から想起されるファイル名であって欲しかったのです
Release
バージョニングは romantic versioning に準拠します(semantic versioning ではありません)。
- メジャー: 大規模な互換性破壊の際にアップします(アーキテクチャ、クラス構造の変更など)
- マイナー: 小規模な互換性破壊の際にアップします(引数の変更、タイプヒントの追加など)
- パッチ: 互換性破壊はありません(デフォルト引数の追加や、新たなクラスの追加、コードフォーマットなど)
1.2.1
- [feature] php8.2 のエラーを修正
1.2.0
- [*change] directorySeparator の廃止
1.1.1
- [composer] update
1.1.0
- [change] php>=8.0
- [change] タイプヒントを完備
- [*change] memorize を int 限定に変更
1.0.8
- [composer] update
1.0.7
- [feature] All としてすべてを継承するインターフェースを追加
- [feature] Hashable を実装
1.0.6
- [feature] ArrayAccess を実装
1.0.5
- [feature] ロック機構を追加
- [fixbug] 軽微な不具合を修正
1.0.4
- [feature] ChainCache/NullCache もすべての interface を完備する
- [refactor] fetch を trait 化
- [refactor] getMultiple の実装が気持ち悪かったのでリファクタ
1.0.3
- [feature] メモ化にサイズ上限を実装
1.0.2
- [feature] debugInfo を実装
1.0.1
- [feature] NullCache を追加
- [refactor] 戻り値だけでも型宣言を合わせたいので psr を拡張した CacheInterface を用意
- [refactor] SingleTrait の導入と ChainCache への組み込み
1.0.0
- 公開