PHPackages ipqualityscore/ipqs-php-db-reader - 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. [Utility & Helpers](/categories/utility) 4. / 5. ipqualityscore/ipqs-php-db-reader ActiveLibrary[Utility & Helpers](/categories/utility) ipqualityscore/ipqs-php-db-reader ================================= IPQualityScore IP Address Reputation & Proxy Detection PHP DB Reader v2.0.0(1mo ago)32763[2 PRs](https://github.com/IPQualityScore/PHPIPQSDBReader/pulls)MITPHPPHP >=5.3.0 Since Sep 23Pushed 1mo ago1 watchersCompare [ Source](https://github.com/IPQualityScore/PHPIPQSDBReader)[ Packagist](https://packagist.org/packages/ipqualityscore/ipqs-php-db-reader)[ RSS](/packages/ipqualityscore-ipqs-php-db-reader/feed)WikiDiscussions main Synced today READMEChangelog (5)DependenciesVersions (10)Used By (0) IPQualityScore IP Address Reputation & Proxy Detection PHP DB Reader ======================================================================== [](#ipqualityscore-ip-address-reputation--proxy-detection-php-db-reader) Flat File Version 2.0 --------------------- [](#flat-file-version-20) The IPQS PHP DB reader allows you to read our flat file databases and get started implimenting our proxy detection easily. You can find the full [PHP IPQualityScore flat file database documentation here](https://www.ipqualityscore.com/documentation/ip-reputation-database/php) or view a description of what our [proxy detection database does here](https://www.ipqualityscore.com/proxy-detection-database). ###### Installation [](#installation) Installation can be achieved via composer or via manual inclusion in any PSR0/4 autoloader. ``` composer require ipqualityscore/ipqs-php-db-reader ``` ###### Usage [](#usage) Using our flat file database system to lookup an IP address is simple: ``` ``` use IPQualityScore\DB\DBReader; $ip = "8.8.0.0"; $reader = new DBReader("IPQualityScore-Reputation-IPV4-Database.ipqs"); ```$record = $reader->Fetch($ip); if($record->IsProxy()){ echo "{$ip} is a proxy!"; } ``` ###### IPQSRecord Fields: [](#ipqsrecord-fields) Depending on which database file you receive some of these fields may be unavailable. If the field in question is unavailable in your database it will default to null. FieldTypeDescription$record->IsProxy()boolIs this IP address suspected to be a proxy? (SOCKS, Elite, Anonymous, VPN, Tor, etc.)$record->IsVPN()boolIs this IP suspected of being a VPN connection? This can include data center ranges which can become active VPNs at any time. The "proxy" status will always be true when this value is true.$record->IsTOR()boolIs this IP suspected of being a TOR connection? This can include previously active TOR nodes and exits which can become active TOR exits at any time. The "proxy" status will always be true when this value is true.$record->IsCrawler()boolIs this IP associated with being a confirmed crawler from a mainstream search engine such as Googlebot, Bingbot, Yandex, etc. based on hostname or IP address verification.$record->IsBot()boolIndicates if bots or non-human traffic has recently used this IP address to engage in automated fraudulent behavior. Provides stronger confidence that the IP address is suspicious.$record->RecentAbuse()boolThis value will indicate if there has been any recently verified abuse across our network for this IP address. Abuse could be a confirmed chargeback, compromised device, fake app install, or similar malicious behavior within the past few days.$record->IsBlacklisted()boolThis value will indicate if the IP has been blacklisted by any 3rd party agency for spam, abuse or fraud.$record->IsPrivate()boolThis value will indicate if the IP is a private, nonrouteable IP address.$record->IsMobile()boolThis value will indicate if the IP is likely owned by a mobile carrier.$record->HasOpenPorts()boolThis value will indicate if the IP has recently had open (listening) ports.$record->IsHostingProvider()boolThis value will indicate if the IP is likely owned by a hosting provider or is leased to a hosting company.$record->ActiveVPN()boolIdentifies active VPN connections used by popular VPN services and private VPN servers.$record->ActiveTOR()boolIdentifies active TOR exits on the TOR network.$record->PublicAccessPoint()boolIndicates if this IP is likely to be a public access point such as a coffee shop, college or library.$record->ConnectionTypeRaw()intA numerical representation for the suspected type of connection for this IP address. It is generally reccomended you call the ConnectionType() function listed below instead of using this value, but it is available as an option. \#Enum Description1Residential IP2Mobile IP3Corporate IP4Data Center IP5Educational IP $record->ConnectionType()intA string representation for the suspected type of connection for this IP address. (Residential, Mobile, Corporate, Data Center, Education or Unknown) $record->AbuseVelocityRaw()intHow frequently the IP address is engaging in abuse across the IPQS threat network. Can be used in combination with the Fraud Score to identify bad behavior. It is generally reccomended you call the AbuseVelocity() function listed below instead of using this value, but it is available as an option. \#Enum Description1Low Recent Abuse IP2Medium Recent Abuse IP3High Recent Abuse IP $record->AbuseVelocity()intHow frequently the IP address is engaging in abuse across the IPQS threat network. Values can be "high", "medium", "low", or "none". $record->Country()stringTwo character country code of IP address or "N/A" if unknown. $record->City()stringCity of IP address if available or "N/A" if unknown. $record->ISP()stringISP if one is known. Otherwise "N/A". $record->Organization()stringOrganization if one is known. Can be parent company or sub company of the listed ISP. Otherwise "N/A". $record->ASN()intAutonomous System Number if one is known. Zero if nonexistent. $record->Timezone()stringTimezone of IP address if available or "N/A" if unknown. $record->Latitude()float32Latitude of IP address if available or 0.00 if unknown. $record->Longitude()float32Longitude of IP address if available or 0.00 if unknown. $record->FraudScore($strictness)intReturns the fraud score for the "strictness level" specified and can be 0, 1 or 2. Some databases may contain 1 entry, others all 3. It is reccomended that you use the lowest strictness for Fraud Scoring. Increasing this value will expand the tests we perform. Levels 2+ have a higher risk of false-positives. ###### Usage Notes [](#usage-notes) Each database only holds either IPv4 or IPv6 data. Therefore you may need two instances of the reader available depending on your use case. ### Health Score 45 — FairBetter than 92% of packages Maintenance91 Actively maintained with recent releases Popularity18 Limited adoption so far Community9 Small or concentrated contributor base Maturity51 Maturing project, gaining track record 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. ### Release Activity Cadence Every ~235 days Recently: every ~402 days Total 8 Last Release 44d ago Major Versions v1.0.6 → v2.0.02026-03-26 ### Community Maintainers ![](https://www.gravatar.com/avatar/6bedc8ed8bbb9bd5023eccc921e6a3727cc791da65933c515e56c72ee5e23dfe?d=identicon)[IPQualityScore](/maintainers/IPQualityScore) --- Top Contributors [![IPQualityScore](https://avatars.githubusercontent.com/u/50187766?v=4)](https://github.com/IPQualityScore "IPQualityScore (20 commits)") ### Embed Badge ![Health badge](/badges/ipqualityscore-ipqs-php-db-reader/health.svg) ``` [![Health](https://phpackages.com/badges/ipqualityscore-ipqs-php-db-reader/health.svg)](https://phpackages.com/packages/ipqualityscore-ipqs-php-db-reader) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)