Alternative PHP Cache (可选 PHP 缓存)

目录

简介

APCIterator 类使得遍历大容量APC缓存更容易,这是很有帮助的因为它允许同时获取已经定义的每个被锁定实例的条目数,因此它释放的其他活动的缓存锁,而不是阻碍整个缓存以完成获取100(默认)个缓存数据的迭代,在大缓存条目。 此外,使用正则匹配效率更高,因为它被改为C级别的实现。

类摘要

APCIterator

class APCIterator implements Iterator , Traversable {

/* Methods */

public __construct ( string $cache [, mixed $search = NULL [, int $format = APC_ITER_ALL [, int $chunk_size = 100 [, int $list = APC_LIST_ACTIVE ]]]] )

public mixed current ( void )

public int getTotalCount ( void )

public int getTotalHits ( void )

public int getTotalSize ( void )

public string key ( void )

public void next ( void )

public void rewind ( void )

public void valid ( void )

}

APCIterator::__construct

构造一个 APCIterator 迭代器对象

说明

public APCIterator::__construct ( string $cache [, mixed $search = NULL [, int $format = APC_ITER_ALL [, int $chunk_size = 100 [, int $list = APC_LIST_ACTIVE ]]]] )

构造一个 APCIterator object.

参数

cache
缓存类型,可以是 user 或者 file

search
匹配 APC 键名的 PCRE 正则表达式,既可以是单个正则表达式 string,也可以是 array 的正则表达式。或者可以是 NULL 来略过搜索。

format
需要的格式可以用一个或多个 APC_ITER_* 常量。

chunk_size
块的大小。必须是一个大于0的值,默认是100。

list
需要列出的类型。可以是 APC_LIST_ACTIVEAPC_LIST_DELETED

返回值

成功时返回 APCIterator object,失败时返回 NULL

范例

示例 #1 APCIterator::__construct 例子

<?php
foreach (new APCIterator('user', '/^counter\./') as $counter) {
    echo "$counter[key]: $counter[value]\n";
    apc_dec($counter['key'], $counter['value']);
}
?>

参见

  • apc_exists
  • apc_cache_info

APCIterator::current

获取当前项

说明

public mixed APCIterator::current ( void )

APCIterator 堆中获取当前项。

参数

此函数没有参数。

返回值

成功时返回当前项,获取失败、没有更多项或者不存在任何项时返回 FALSE

参见

  • APCIterator::next
  • Iterator::current

APCIterator::getTotalCount

获取总数

说明

public int APCIterator::getTotalCount ( void )

获取总数。

Warning

本函数还未编写文档,仅有参数列表。

参数

此函数没有参数。

返回值

The total count.

参见

  • APCIterator::getTotalHits
  • APCIterator::getTotalSize
  • apc_cache_info

APCIterator::getTotalHits

获取缓存命中数

说明

public int APCIterator::getTotalHits ( void )

获取缓存命中的总数。

Warning

本函数还未编写文档,仅有参数列表。

参数

此函数没有参数。

返回值

成功时返回命中次数,失败时返回 FALSE

参见

  • APCIterator::getTotalCount
  • APCIterator::getTotalSize
  • apc_cache_info

APCIterator::getTotalSize

获取所有缓存的尺寸大小

说明

public int APCIterator::getTotalSize ( void )

获取所有缓存的尺寸大小。

Warning

本函数还未编写文档,仅有参数列表。

参数

此函数没有参数。

返回值

The total cache size.

参见

  • APCIterator::getTotalCount
  • APCIterator::getTotalHits
  • apc_cache_info

APCIterator::key

获取迭代器的键

说明

public string APCIterator::key ( void )

获取当前迭代器的键。

参数

此函数没有参数。

返回值

成功时返回一个键,失败时返回 FALSE

参见

  • APCIterator::current
  • Iterator::key

APCIterator::next

移到下一项

说明

public void APCIterator::next ( void )

移动迭代器的指针到下一个元素。

参数

此函数没有参数。

返回值

成功时返回 TRUE, 或者在失败时返回 FALSE

参见

  • APCIterator::current
  • APCIterator::rewind
  • Iterator::next

APCIterator::rewind

倒退迭代器

说明

public void APCIterator::rewind ( void )

倒退迭代器到第一项。

参数

此函数没有参数。

返回值

没有返回值。

参见

  • APCIterator::next
  • Iterator::next

APCIterator::valid

检查当前位置是否有效

说明

public void APCIterator::valid ( void )

检查当前迭代器的位置是否有效。

参数

此函数没有参数。

返回值

如果当前迭代器的位置有效返回 TRUE ,反之则返回 FALSE

参见

  • APCIterator::current
  • Iterator::valid