serversideup/cfspeedtest

Distribute cfspeedtest as a Composer package.

v2025.09.09.0 2025-09-09 21:57 UTC

GPL-3.0-or-later

• Dan Pastori
• Jay Rogers

README

Goal: Make the cfspeedtest CLI from Cloudflare Speed Test easily available in PHP projects via Composer, without requiring Rust or manual installs.

• Upstream project: code-inflation/cfspeedtest
• What this package does: Vendors prebuilt cfspeedtest binaries and exposes a tiny wrapper so you can run it as vendor/bin/cfspeed inside your PHP app or CI.
• What it does not do: It does not modify upstream code or behavior. It only redistributes the binaries and adds a small launcher script.

Installation

composer require serversideup/cfspeedtest

Usage

After installation, the executable is available at vendor/bin/cfspeed:

vendor/bin/cfspeedtest --help
vendor/bin/cfspeedtest --output-format json-pretty

You can pass through all flags supported by upstream cfspeedtest (see upstream README for full options).

How it works

• This package ships platform-specific upstream binaries in bin/ and a tiny launcher at bin/cfspeedtest.
• When you run vendor/bin/cfspeedtest, the launcher detects your OS/architecture and executes the matching bundled binary.
• Binaries are taken as-is from upstream releases and simply renamed to include their target triple (e.g., cfspeedtest_aarch64-unknown-linux-gnu).

Supported platforms

Currently bundled targets:

• aarch64-apple-darwin (Apple Silicon macOS)
• x86_64-unknown-linux-gnu (Linux x86_64)
• aarch64-unknown-linux-gnu (Linux ARM64)

Notes:

• Intel macOS is not currently supported by the launcher. On unsupported systems, the script will exit with an error.
• Windows is not supported.

Versioning

This package tracks upstream releases and republishes their binaries.

Security & provenance

• You are executing a prebuilt third-party binary within your PHP project/CI.
• Binaries originate from upstream GitHub Releases of cfspeedtest. Consider verifying checksums/signatures against the upstream release assets when appropriate.

License

• This Composer package: GPL-3.0-or-later (see composer.json).
• Upstream cfspeedtest: MIT License. See upstream project for details.

Credits and attribution

• All credit for the cfspeedtest implementation goes to the upstream maintainers: code-inflation/cfspeedtest.
• This repository is an independent, open-source redistribution for Composer-based workflows and is not affiliated with or maintained by the upstream project.