扩展接口提供小的一整套函数,允许用户根据设置定义任意数量名称唯一的计数器。简单接口可与扩展接口同时使用。
Example #1 "counter"的扩展接口
<?php
function print_counter_info($counter)
{
if (is_resource($counter)) {
printf("计数器的名称为 '%s',且%s进行持久化。其当前值为 %d.\n",
counter_get_meta($counter, COUNTER_META_NAME),
counter_get_meta($counter, COUNTER_META_IS_PERSISTENT) ? '' : '不',
counter_get_value($counter));
} else {
print "计数器无效!\n";
}
}
if (($counter_one = counter_get_named("one")) === NULL) {
$counter_one = counter_create("one", 0, COUNTER_FLAG_PERSIST);
}
counter_bump_value($counter_one, 2);
$counter_two = counter_create("two", 5);
$counter_three = counter_get_named("three");
$counter_four = counter_create("four", 2, COUNTER_FLAG_PERSIST | COUNTER_FLAG_SAVE | COUNTER_FLAG_NO_OVERWRITE);
counter_bump_value($counter_four, 1);
print_counter_info($counter_one);
print_counter_info($counter_two);
print_counter_info($counter_three);
print_counter_info($counter_four);
?>
首次运行时,以上例子的输出为:
计数器的名称为 'one',且进行持久化。其当前值为 2. 计数器的名称为 'two',且不进行持久化。其当前值为 5. 计数器无效! 计数器的名称为 'four',且进行持久化。其当前值为 3.
在同一 PHP 实例中第 2 次运行时的输出为:
计数器的名称为 'one',且进行持久化。其当前值为 4. 计数器的名称为 'two',且不进行持久化。其当前值为 5. 计数器无效! 计数器的名称为 'four',且进行持久化。其当前值为 4.
在另一个 PHP 实例中第 3 次运行时的输出为:
计数器的名称为 'one',且进行持久化。其当前值为 2. 计数器的名称为 'two,且不进行持久化。其当前值为 5. 计数器无效! 计数器的名称为 'four',且进行持久化。其当前值为 5.