divinity76/cloudflare-ip-validator

Fast Cloudflare IP validator for PHP

v1.0.0 2026-03-23 21:11 UTC

Requires

• php: >=8.0

Suggests

• ext-filter: Used for additional input validation in your application stack

Unlicense

README

Fast PHP validation of whether an IP belongs to Cloudflare. This library is heavily optimized: src/CloudflareIpValidator.php, I believe the implementation is about as fast as userland PHP can get. To go faster, you would likely need a C-php-extension.

Install

composer require divinity76/cloudflare-ip-validator

Public API

• Divinity76\CloudflareIpValidator\CloudflareIpValidator
  • isCloudflareIp(string $ip): bool (static)

Usage

<?php
use Divinity76\CloudflareIpValidator\CloudflareIpValidator;

CloudflareIpValidator::isCloudflareIp('173.245.48.1'); // true
CloudflareIpValidator::isCloudflareIp('1.1.1.1'); // false

Alternatively:

<?php

\Divinity76\CloudflareIpValidator\CloudflareIpValidator::isCloudflareIp('173.245.48.1'); // true
\Divinity76\CloudflareIpValidator\CloudflareIpValidator::isCloudflareIp('1.1.1.1'); // false

Future Scope

• Automate CIDR updates via a daily GitHub CI runner that regenerates src/CloudflareIpValidator.php.