README

入门指南

获取凭据

要开始使用iron_cache_php，您需要注册并获取一个oauth令牌。

1. 前往 http://iron.io/ 并注册。
2. 在 http://hud.iron.io/tokens 获取Oauth令牌

安装iron_cache_php

使用iron_cache_php有两种方式

使用预编译的phar存档

将iron_cache.phar复制到目标目录并包含它

<?php
require_once "phar://iron_cache.phar";

请注意，phar 扩展默认仅在php 5.3.0及以后版本中可用。对于php 5.2，您应该手动安装phar或使用第二种选项。

直接使用类

1. 将IronCache.class.php复制到目标目录
2. 从这里获取IronCore.class.php并将其复制到目标目录
3. 包含这两个文件

<?php
require_once "IronCore.class.php"
require_once "IronCache.class.php"

配置

配置IronCache的三种方式

• 传递包含选项的数组

<?php
$cache = new IronCache(array(
    'token' => 'XXXXXXXXX',
    'project_id' => 'XXXXXXXXX'
));

• 传递存储配置选项的ini文件名。将sample_config.ini重命名为config.ini，并包含您的Iron.io凭据（token和project_id）

<?php
$cache = new IronCache('config.ini');

• 自动配置搜索 - 将零个参数传递给构造函数，库将尝试在以下位置查找配置文件

  • 当前目录中的iron.ini
  • 当前目录中的iron.json
  • IRON_CACHE_TOKEN、IRON_CACHE_PROJECT_ID和其他环境变量
  • IRON_TOKEN、IRON_PROJECT_ID和其他环境变量
  • 用户主目录中的.iron.ini
  • 用户主目录中的.iron.json

基础知识

放入缓存中的项

<?php
$res = $cache->put("mykey", "hello world!");

获取缓存中的项

<?php
$item = $cache->get("mykey");

增加缓存中项的值

<?php
$res = $cache->increment("mykey", 1);

删除缓存中的项

<?php
$res = $cache->delete("mykey");

缓存选择

在与项交互之前选择缓存

• 在构造函数中： $cache = new IronCache('config.ini', 'my_cache');
• 通过方法： $cache->setCacheName('my_cache');
• 稍后进行操作： $cache->getItem('my_cache','my_key');

将IronCache用作会话存储

<?php
$cache = new IronCache();
$cache->set_as_session_store();

# Use session as usual
session_start();
...

故障排除

http错误：0

如果您看到 未捕获的异常 'Http_Exception'，消息为 'http error: 0 | '，这最可能是由于配置不当的cURL https证书引起的。有两种方法可以修复此错误

1. 禁用SSL证书验证 - 在IronCache初始化后添加此行：$cache->ssl_verifypeer = false;
2. 切换到http协议 - 在配置选项中添加此行：protocol = http 和 port = 80