hughcube / ipdb

src/Proxies/Proxy.php

<?php

namespace HughCube\IpDb\Proxies;

use HughCube\IpDb\Readers\IpDbReader;
use HughCube\IpDb\Readers\Reader;

abstract class Proxy
{
    /**
     * @var Reader|null
     */
    protected $reader = null;

    /**
     * Proxy constructor.
     *
     * @param $reader
     *
     * @throws \Exception
     */
    public function __construct(Reader $reader = null)
    {
        $reader = null === $reader ? $this->getDefaultReader() : $reader;

        $this->reader = $reader;
    }

    /**
     * 获取默认的 Reader.
     *
     * @throws \Exception
     *
     * @return Reader
     */
    protected function getDefaultReader()
    {
        $dbFile = __DIR__.'/../../data/ipipfree.ipdb';

        return new IpDbReader($dbFile);
    }

    /**
     * @return Reader|null
     */
    public function getReader()
    {
        return $this->reader;
    }

    /**
     * 根据ip查找信息.
     *
     * @param string $ip       查找的ip
     * @param string $language 语言
     *
     * @return array|null
     */
    public function find($ip, $language)
    {
        return $this->getReader()->find($ip, $language);
    }

    /**
     * 根据ip查找信息map.
     *
     * @param string $ip       查找的ip
     * @param string $language 语言
     *
     * @return array|null
     */
    public function findMap($ip, $language)
    {
        return $this->getReader()->findMap($ip, $language);

The expression return $this->getReader()->findMap($ip, $language) could also return false which is incompatible with the documented return type array|null. Did you maybe forget to handle an error condition?

    }

    /**
     * 根据ip查找信息对象
     *
     * @param string $ip       查找的ip
     * @param string $language 语言
     *
     * @return mixed
     */
    abstract public function findInfo($ip, $language);
}