lionsoul2014/ip2region · error · Exception

failed to open xdb file '%s'

Error message

failed to open xdb file '%s'

What it means

PHP constructor guard: fopen() on the xdb file returned false, so the searcher has no readable handle. Common causes are a missing/unreadable file, wrong path, or insufficient file permissions; note the message uses %s-style formatting passed to Exception, so the path may render literally.

Source

Thrown at binding/php/xdb/Searcher.class.php:438

    }

    // --- End of static creator

    /**
     * initialize the xdb searcher
     * @throws Exception
     */
    function __construct($version, $dbFile, $vectorIndex=null, $cBuff=null) {
        $this->version = $version;
        // check the content buffer first
        if ($cBuff != null) {
            $this->vectorIndex = null;
            $this->contentBuff = $cBuff;
        } else {
            // open the xdb binary file
            $this->handle = fopen($dbFile, "r");
            if ($this->handle === false) {
                throw new Exception("failed to open xdb file '%s'", $dbFile);
            }

            $this->vectorIndex = $vectorIndex;
        }
    }

    public function close() {
        if ($this->handle != null) {
            fclose($this->handle);
        }
    }

    public function getIPVersion() {
        return $this->version;
    }

    public function getIOCount() {
        return $this->ioCount;

View on GitHub (pinned to c1a1fc7d59)

Solutions

1. Confirm the dbFile path is correct and the file exists
2. Grant the PHP process read permission on the xdb file
3. Alternatively pass the whole file content via the cBuff parameter to avoid file access entirely

When it happens

Trigger: Thrown at binding/php/xdb/Searcher.class.php:438 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of lionsoul2014/ip2region@c1a1fc7d59 (2026-09-02). Data as JSON: /api/errors/eb15060e1999b956. Report an issue: GitHub.