yac

YAC-さらに別のキャッシュ

YACは、PHPの共有およびロックレスメモリユーザーデータキャッシュです。

APCまたはローカルMemcachedの交換に使用できます。

要件

• PHP 7 +

インストール

 $/path/to/phpize
$./configure --with-php-config=/path/to/php-config
$make && make install

注記

1. YACはロックレスキャッシュです。複数のプロセスの確率を回避または減らす必要があります。
2. YACは部分的なCRCを使用し、キャッシュコンテンツを再配置し、最も重要な（可変）バイトを頭または尾に配置する方が良いでしょう

制限

1. キャッシュキーは、48（yac_max_key_len）バイトを超えることはできません
2. キャッシュ値は64m（yac_max_value_raw_len）バイトを超えることはできません
3. 圧縮後のキャッシュ値は1mを超えることはできません（yac_max_value_compressed_len）バイト

inis

 yac.enable = 1

yac.keys_memory_size = 4M ; 4M can get 30K key slots, 32M can get 100K key slots

yac.values_memory_size = 64M

yac.compress_threshold = -1

yac.enable_cli = 0 ; whether enable yac with cli, default 0

yac.serializer = php ; since yac 2.2.0 , specific seralizer yac used
                       could be json(--enable-json), msgpack(--enable-msgpack) or igbinary(--enable-igbinary)

定数

 YAC_VERSION

YAC_MAX_KEY_LEN = 48 ; if your key is longer than this, maybe you can use md5 result as the key

YAC_MAX_VALUE_RAW_LEN = 64M

YAC_MAX_VALUE_COMPRESSED_LEN = 1M

YAC_SERIALIZER_PHP = 0   ; since yac-2.2.0

YAC_SERIALIZER_JSON = 1  ; since yac-2.2.0

YAC_SERIALIZER_MSGPACK = 2 ; since yac-2.2.0

YAC_SERIALIZER_IGBINARY = 3 ; since yac-2.2.0

YAC_SERIALIZER  ; serializer according to yac.serializer, default is YAC_SERIALIZER_PHP

方法

yac :: __ construct

   Yac:: __construct ([string $ prefix = "" ])

YACのコンストラクターでは、set/get/deleteを実行するときに任意のキーにプリデントするために使用されるプレフィックスを指定できます

 <?php
   $ yac = new Yac ( " myproduct_ " );
?>

yac :: set

   Yac:: set ( $ key , $ value [, $ ttl = 0 ])
   Yac:: set (array $ kvs [, $ ttl = 0 ])

値をYACキャッシュに保存し、キーはキャッシュユニークです。そのため、同じキーで2番目の値を保存すると、元の値が上書きされます。

成功にtrueを返す、エラーの偽りを返す（メモリなし、CASの書き込みを正しく取得できない）

 <?php
$ yac = new Yac ();
$ yac -> set ( " foo " , " bar " );
$ yac -> set (
    array (
        " dummy " => " foo " ,
        " dummy2 " => " foo " ,
        )
    );
?> 

注記：

YAC 2.1として、CASの競争が失敗した場合、ストアが失敗する可能性があります。

 while (!( $ yac -> set ( " important " , " value " )));

適切に保存する値を必要とする場合。

yac :: get

   Yac::get(array|string $key[, &$cas = NULL])

キャッシュから保存された変数を取得します。配列が渡されると、各要素がフェッチされて返されます。

成功の値を返す、エラーの偽りを返す（メモリなし、CASの書き込みを正しく取得できない）

 <?php
$ yac = new Yac ();
$ yac -> set ( " foo " , " bar " );
$ yac -> set (
    array (
        " dummy " => " foo " ,
        " dummy2 " => " foo " ,
        )
    );
$ yac -> get ( " dummy " );
$ yac -> get ( array ( " dummy " , " dummy2 " ));
?>

yac :: delete

   Yac::delete(array|string $keys[, $delay=0])

キャッシュから保存された変数を削除します。遅延が指定されている場合、$遅延秒後に値は削除されます。

yac ::フラッシュ

   Yac::flush()

すぐに既存のすべてのアイテムを無効にします。実際にはリソースを解放するわけではなく、すべてのアイテムを無効とマークします。

YAC :: INFO

   Yac::info(void)

キャッシュ情報を取得します

 <?php
  . . . .
  var_dump ( $ yac -> info ());
  /* will return an array like :
  array ( 11) {
      [ " memory_size "]=> int(541065216)
      [ "slots_memory_size" ] => int ( 4194304 )
      [ "values_memory_size" ] => int ( 536870912 )
      [ "segment_size" ] => int ( 4194304 )
      [ "segment_num" ] => int ( 128 )
      [ "miss" ] => int ( 0 )
      [ "hits" ] => int ( 955 )
      [ "fails" ] => int ( 0 )
      [ "kicks" ] => int ( 0 )
      [ "slots_size" ] => int ( 32768 )
      [ "slots_used" ] => int ( 955 )
  }
  */