Download the PHP package elliotjreed/cloudflare-cache-purge without Composer
On this page you can find all versions of the php package elliotjreed/cloudflare-cache-purge. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download elliotjreed/cloudflare-cache-purge
More information about elliotjreed/cloudflare-cache-purge
Files in elliotjreed/cloudflare-cache-purge
Package cloudflare-cache-purge
Short Description A PHP wrapper for Cloudflare's API, for listing Zones and purging the cache.
License MIT
Homepage https://github.com/elliotjreed/cloudflare-api-php
Informations about the package cloudflare-cache-purge
Cloudflare Cache Purge for PHP
PHP 8.1 or above is required.
This library allows the listing of Cloudflare "Zones" and purging files from the Cloudflare cache within a Zone.
It could be used as part of a deployment process for example.
Usage
Cloudflare API Token
To generate a Cloudflare API token visit dash.cloudflare.com/profile/api-tokens and generate a new API token with "Zone" read and "Cache" purge permissions.
Listing Zones
Purging files from Cache within a Zone
The Zone ID can be retrieved from either the Cloudlare dashboard (under "API" and "Zone ID" on the right) or by using ElliotJReed\Zones
.
Development
PHP 8.0 or above and Composer is expected to be installed.
Installing Composer
For instructions on how to install Composer visit getcomposer.org.
Installing
After cloning this repository, change into the newly created directory and run:
or if you have installed Composer locally in your current directory:
This will install all dependencies needed for the project.
Henceforth, the rest of this README will assume composer
is installed globally (ie. if you are using composer.phar
you will need to use composer.phar
instead of composer
in your terminal / command-line).
Running the Tests
Unit tests
Unit testing in this project is via PHPUnit.
All unit tests can be run by executing:
Debugging
To have PHPUnit stop and report on the first failing test encountered, run:
Static analysis
Static analysis tools can point to potential "weak spots" in your code, and can be useful in identifying unexpected side-effects.
[Psalm is configured at its highest level, meaning false positives are quite likely.
All static analysis tests can be run by executing:
Code formatting
A standard for code style can be important when working in teams, as it means that less time is spent by developers processing what they are reading (as everything will be consistent).
Code formatting is automated via PHP-CS-Fixer.
PHP-CS-Fixer will not format line lengths which do form part of the PSR-2 coding standards so these will produce warnings when checked by PHP Code Sniffer.
These can be run by executing:
Running everything
All of the tests can be run by executing:
Outdated dependencies
Checking for outdated Composer dependencies can be performed by executing:
Validating Composer configuration
Checking that the composer.json is valid can be performed by executing:
Running via GNU Make
If GNU Make is installed, you can replace the above composer
command prefixes with make
.
All of the tests can be run by executing:
Github Actions
Look at the example in .github/workflows/php.yml.
Built With
License
This project is licensed under the MIT License - see the LICENCE.md file for details.