在php中使用redis的georadius 函数，options参数的详解以及使用示例

GEORADIUS 是 Redis 中用于实现地理位置相关查询的命令，配合 PHP 的 Redis 扩展库，可以方便地在 PHP 中利用 Redis 进行地理位置查询。GEORADIUS 命令的语法如下：

GEORADIUS key longitude latitude radius m|km|ft|mi [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count] [ASC|DESC] [STORE key] [STOREDIST key]

其中，key 表示 Redis 中存储地理位置信息的有序集合的名称，longitude 和 latitude 分别表示查询点的经度和纬度，radius 表示查询半径，可以指定单位（m、km、ft、mi），WITHCOORD、WITHDIST、WITHHASH、COUNT、ASC、DESC、STORE 和 STOREDIST 等选项用于控制查询结果的返回格式和存储结果。

在 PHP 中使用 GEORADIUS 的 Redis::geoRadius 方法对应着 GEORADIUS 命令，其中的 $options 参数用于指定选项。$options 参数的类型为数组，数组的键可以是 WITHCOORD、WITHDIST、WITHHASH、COUNT、ASC、DESC、STORE 或 STOREDIST，对应着 GEORADIUS 命令中的选项。

以下是一个使用示例：

<?php
// 连接 Redis 服务器
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);

// 添加地理位置信息
$redis->geoAdd('cities', 121.4737, 31.2304, 'Shanghai');
$redis->geoAdd('cities', 116.4074, 39.9042, 'Beijing');
$redis->geoAdd('cities', 113.2644, 23.1291, 'Guangzhou');

// 查找距离指定经纬度 500 公里以内的城市
$options = [
    'radius' => 500000,
    'unit' => 'km',
    'WITHDIST',
    'ASC',
    'COUNT' => 2
];
$results = $redis->geoRadius('cities', 114.3055, 30.5928, $options);

foreach ($results as $result) {
    var_dump($result);
}

在这个例子中，$options 参数指定了查询半径为 500 公里，返回格式为 WITHDIST，结果按照距离升序排序，并且最多返回 2 条结果。执行后，会输出距离指定经纬度 500 公里以内的城市的名称和距离。

在 ThinkPHP 5.0 中使用 Redis 的 Geo 函数进行地理位置距离计算，需要通过 ThinkPHP 框架封装的 think\cache\driver\Redis 缓存类来进行 Redis 的操作。具体代码示例如下：

<?php
namespace app\index\controller;

use think\Cache;

class Index
{
    public function geoDistance()
    {
        // 连接 Redis
        $redis = Cache::store('redis')->handler();

        // 添加地理位置信息
        $redis->rawCommand('geoadd', 'cities', 121.4737, 31.2304, 'Shanghai');
        $redis->rawCommand('geoadd', 'cities', 116.4074, 39.9042, 'Beijing');
        $redis->rawCommand('geoadd', 'cities', 113.2644, 23.1291, 'Guangzhou');

        // 计算两个城市之间的距离（单位：米）
        $distance = $redis->rawCommand('geodist', 'cities', 'Shanghai', 'Beijing');

        echo "Distance between Shanghai and Beijing: " . $distance . " meters";
    }
}

在这个例子中，通过 Cache::store('redis')->handler() 获取 Redis 连接，从而调用 rawCommand 方法来运行 Redis 命令。具体来说，使用了 geoadd 命令添加了三个城市的经纬度信息，然后使用 geodist 命令计算了上海和北京两个城市之间的距离，最后将计算的距离输出到浏览器端。

需要注意的是，在这个例子中为了方便演示，代码没有对 Redis 进行错误处理、参数校验等操作，请在实际应用中进行适当的处理。另外，还可以使用 georadius 命令来查询指定半径范围内的地理位置信息，具体方法和使用方式与上面的示例类似，请自行学习和实践。

在 ThinkPHP 5.0 中，使用 Redis 缓存驱动的配置非常简单，只需设置 cache 配置项中的 type 参数为 redis，并且指定 Redis 服务器的相关配置即可。具体可以在应用程序的 config 目录下的 cache.php 文件中进行配置，示例代码如下：

<?php
return [
    // 默认缓存驱动
    'default' => 'redis',

    // 缓存配置
    'stores' => [
        // Redis 缓存配置
        'redis' => [
            'type'       => 'redis',
            'host'       => '127.0.0.1',
            'port'       => 6379,
            'password'   => '',
            'select'     => 0,
            'timeout'    => 0,
            'persistent' => false,
        ],
    ],

    // 缓存前缀
    'prefix' => 'think',
];

在 Redis 缓存驱动的配置中，‘type’ 参数需要设置为 redis，其他配置项需要按照 Redis 服务器的实际情况进行适当的配置，其中 host 表示 Redis 服务器的 IP 地址或者主机名，port 表示 Redis 服务器的端口号，如果有需要，可以指定 Redis 服务器的密码 password。select 参数表示 Redis 服务器上的数据库编号，如果不指定，默认使用数据库编号 0。当 timeout 参数设置为 0 时，表示一直等待 Redis 服务器的响应，persistent 参数表示是否使用持久连接。最后，‘prefix’ 参数表示 Redis 缓存的键名前缀，可以自定义修改。

完成配置后，可以在应用程序中通过 Cache 类的 store 方法来指定 Redis 缓存驱动，然后进行相应的缓存操作，例如：

<?php
namespace app\index\controller;

use think\Cache;

class Index
{
    public function readCache()
    {
        // 指定 Redis 缓存驱动
        $redis = Cache::store('redis')->handler();

        // 设置缓存
        $redis->set('name', 'thinkphp');

        // 获取缓存
        $name = $redis->get('name');

        echo $name;
    }
}

在这个例子中，使用了 store 方法指定缓存驱动为 Redis，并且通过 $redis->set() 方法设置缓存，然后通过 $redis->get() 方法获取缓存内容。