Skip to content

README.md

Latest commit

 

History

History
47 lines (30 loc) · 1.38 KB

README.md

File metadata and controls

47 lines (30 loc) · 1.38 KB

PHP runtime

This folder contains a simple PHP implementation of ReverseGeocoder endpoints.

Files

  • reverse_geocode.php
  • geocode.php
  • ip2country.php

Each script has its own DB connection settings at the top ($dsn, $username, $password).

Setup

  1. Build/import data (see ../data/README.md).
  2. Update DSN credentials in each PHP file.
  3. Deploy scripts to a PHP server with PDO support for your selected driver.

API

The shared API is documented in ../README.md.

This PHP implementation is expected to match that behavior for:

  • request parameters
  • success/error status codes
  • response shapes

Runtime-specific note:

  • ip2country.php can fall back to request headers / server vars when ip is omitted
  • scripts currently respond with application/javascript for compatibility with existing deployments

Operational notes

  • Current scripts are intentionally minimal and use in-file settings.
  • Content type is set as application/javascript for compatibility with existing deployments.
  • Caching headers are long-lived for explicit lookup queries.

Validation checklist

After changes:

  1. Verify each script can connect to the configured DB.
  2. Validate one successful and one invalid-input request per endpoint.
  3. Confirm IPv6 lookups still resolve expected countries.
  4. Confirm empty-result handling remains stable (no PHP warnings leaked).