yac

yac-另一個緩存

YAC是用於PHP的共享和無鎖的內存用戶數據緩存。

它可用於替換APC或本地備忘錄。

要求

• 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 :: __構造

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

YAC的構造函數，您可以指定一個前綴，該前綴將在執行/get/delete時將其預定到任何鍵

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

yac ::設定

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

將一個值存儲到YAC緩存中，鍵是緩存唯一的，因此使用相同鍵存儲第二個值將覆蓋原始值。

成功返回真實，返回錯誤時錯誤（就像沒有內存一樣，無法獲得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 ::刪除

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

從緩存中刪除存儲的變量。如果指定延遲，則該值將在$延遲秒後刪除。

yac ::齊平

   Yac::flush()

立即使所有現有項目無效。它實際上並沒有免費的任何資源，它僅將所有項目標記為無效。

yac ::信息

   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 )
  }
  */