PHPackages cr0w/phind - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. cr0w/phind ActiveLibrary cr0w/phind ========== Local-first service resolution 02↑2900%PHP Since Mar 28Pushed 1mo agoCompare [ Source](https://github.com/cr0w-digital/phind)[ Packagist](https://packagist.org/packages/cr0w/phind)[ RSS](/packages/cr0w-phind/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) ↯ phind ======= [](#-phind) Local-first DNS. Records, wildcards, runtime management, upstream fallback. Install ------- [](#install) Requires the [Swoole](https://swoole.co.uk) PHP extension: ``` pecl install swoole ``` Install globally: ``` composer global require cr0w/phind ``` Make sure Composer's global bin directory is on your PATH: ``` export PATH="$PATH:$(composer global config bin-dir --absolute)" ``` Or install locally in a project: ``` composer require cr0w/phind ``` Usage ----- [](#usage) ``` bin/phind # [DNS:UDP] Listening on 0.0.0.0:8053 # [DNS:TCP] Listening on 0.0.0.0:8053 bin/phind-http # [HTTP] Listening on http://127.0.0.1:8080 ``` Records ------- [](#records) Records live at `~/.phind/records.json` by default: ``` { "*.phind": [ { "type": "A", "value": "127.0.0.1", "ttl": 300 } ] } ``` Override the path: ``` export PHIND_STORAGE_PATH=/your/path ``` Wildcards, multiple domains, and cross-host targets all work, all part of the same naming layer: ``` { "*.dev": [{ "type": "A", "value": "127.0.0.1" }], "api.local":[{ "type": "A", "value": "127.0.0.1" }], "db.test": [{ "type": "A", "value": "192.168.1.50" }] } ``` phind requires a restart to pick up changes to the records file directly. To add, update, or remove records without restarting, use the HTTP API. Resolution ---------- [](#resolution) phind resolves `A`, `AAAA`, and `CNAME` records locally, including chains: ``` api.phind → auth.phind → 127.0.0.1 ``` Local records resolve first. Unknown names fall through to upstream DNS. Results are cached in memory and cleared automatically when records are modified via the HTTP API. Both UDP and TCP are supported on port 8053. TCP is used automatically by clients when a UDP response is truncated. This matters if you're routing real network traffic through phind, where large responses (DNSSEC, SPF, MX) can exceed the UDP limit. Test resolution directly: ``` dig @127.0.0.1 -p 8053 app.dev ``` System-wide Resolution ---------------------- [](#system-wide-resolution) phind listens on port 8053 by default and won't affect normal DNS until you point your system or network at it, making your naming layer available everywhere. **Router DNS** is the simplest option. Point your router's DNS server at the machine running phind and every device on the network gets wildcard resolution, with everything else falling through upstream as usual. Note that if the machine running phind restarts, your network loses DNS until it comes back up. **dnsmasq forwarding** is more surgical. Forward only your domains to phind and leave everything else alone: ``` # /etc/dnsmasq.conf server=/.phind/127.0.0.1#8053 server=/.dev/127.0.0.1#8053 ``` **Explicit queries** require no resolver config and are useful for testing: ``` dig @127.0.0.1 -p 8053 app.phind ``` Without one of the first two options, phind will only answer explicit queries. HTTP API -------- [](#http-api) MethodEndpointDescriptionGET/recordsList all recordsPOST/recordsAdd or update a recordDELETE/records/{hostname}Remove a recordGET/resolve?name=auth.phind&type=AResolve a nameGET/metricsCurrent metrics snapshotGET/eventsSSE stream of metrics updatesGET/statusServer status and record countPOST/cache/clearFlush cacheRecords are posted as `{ "hostname": "*.dev", "entries": [...] }`. Adding or removing a record clears the cache automatically. Observability ------------- [](#observability) phind tracks cache hits/misses, request latency, local vs. upstream resolution, failures, upstream forwards, and truncated upstream responses. Metrics are kept in memory and flushed to a snapshot on an interval. The HTTP API reads from that snapshot, metrics writes are never in the DNS lookup path. Access a snapshot: ``` GET /metrics ``` Stream live updates via SSE: ``` GET /events ``` The event stream emits a `metrics` event every second when anything has changed, including recent queries and the last 20 log entries. If nothing has changed, a keepalive ping is sent instead. Connect a dashboard or tail it with curl: ``` curl -N http://127.0.0.1:8080/events ``` Or export to an OTLP endpoint: ``` export PHIND_OTLP_ENDPOINT=http://localhost:4318/phind/events ``` Limitations ----------- [](#limitations) - Requires a restart to pick up changes to the records file (use the HTTP API to manage records at runtime without restarting) License ------- [](#license) MIT ### Health Score 20 — LowBetter than 14% of packages Maintenance60 Regular maintenance activity Popularity3 Limited adoption so far Community6 Small or concentrated contributor base Maturity11 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/43ef3c6f0d838a64d0863d7a140766b0e7a20d1520e157f357c22756169155b4?d=identicon)[cr0w](/maintainers/cr0w) --- Top Contributors [![cr0w-denny](https://avatars.githubusercontent.com/u/180068927?v=4)](https://github.com/cr0w-denny "cr0w-denny (2 commits)") ### Embed Badge ![Health badge](/badges/cr0w-phind/health.svg) ``` [![Health](https://phpackages.com/badges/cr0w-phind/health.svg)](https://phpackages.com/packages/cr0w-phind) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)