aklump / check-pages
Very simple QA for websites.
Fund package maintenance!
Buy Me A Coffee
Requires
- php: ^7.4 || ^8
- ext-curl: *
- ext-dom: *
- ext-json: *
- aklump/local-timezone: ^0.0.1
- aklump/loft-lib: ^2
- behat/mink: ^1.8
- chrome-php/chrome: ^1.8
- dflydev/dot-access-data: ^3.0
- dmore/chrome-mink-driver: ^2.7
- guzzlehttp/guzzle: ^6.3 || ^7.0
- justinrainbow/json-schema: ^5.2
- laminas/laminas-xml2json: ^3.2
- ramsey/collection: ^1.3
- shanethehat/pretty-xml: ^1.0
- spatie/browsershot: ^3.57
- spatie/url: ^2.4
- symfony/config: ^4.4 || ^5.4 || ^6
- symfony/console: ^4.4 || ^5.4 || ^6
- symfony/css-selector: ^3.4|^4.0|^5.0
- symfony/dependency-injection: ^4.4 || ^5.4 || ^6
- symfony/dom-crawler: ^5.0
- symfony/event-dispatcher: ^4.4 || ^5.4 || ^6
- symfony/expression-language: ^4.4 || ^5.4 || ^6
- symfony/yaml: ^3.4 || ^4 || ^5 || ^6
- wikimedia/composer-merge-plugin: ^2.1
Requires (Dev)
- aklump/phpswap: ^0.0.7
- drupal/coder: ^8.3
- phpunit/phpunit: ^9.5
- squizlabs/php_codesniffer: ^3.5
- dev-master
- 0.23.4
- 0.23.3
- 0.23.2
- 0.23.1
- 0.23.0
- 0.22.0
- 0.21.0
- 0.20.1
- 0.20.0
- 0.19.1
- 0.19.0
- 0.18.0
- 0.17.0
- 0.16.8
- 0.16.7
- 0.16.6
- 0.16.5
- 0.16.4
- 0.16.3
- 0.16.2
- 0.16.1
- 0.16.0
- 0.15.2
- 0.15.1
- 0.15.0
- 0.14.0
- 0.13.1
- 0.13.0
- 0.12.0
- 0.11.1
- 0.11.0
- 0.10.2
- 0.10.1
- 0.10.0
- 0.9.0
- 0.7.2
- 0.7.1
- 0.7.0
- 0.5.2
- 0.5.1
- 0.5.0
- 0.4.0
- 0.2.13
- 0.2.12
- 0.2.11
- 0.2.10
- 0.2.9
- 0.2.8
- 0.2.7
- 0.2.6
- 0.2.5
- 0.2.4
- 0.2.3
- 0.2.2
- 0.2.1
- 0.2.0
- 0.1.3
- 0.1.2
This package is auto-updated.
Last update: 2025-09-20 02:20:01 UTC
README
Very Simple QA for HTTP
Heavy Development
⚠️ Use at your own risk. This project is under heavy development and is undergoing changes pretty regularly.
Summary
This project intends to provide a process of QA testing of a website, which is very fast to implement and simple to maintain. You write your tests using YAML and they can be as simple as checking for a 200 HTTP response on the homepage. PHP is working under-the-hood, but general use does not require you to know PHP.
Simple Test Syntax
Assert the homepage loads.
- visit: /
Assert the admin section is protected.
- visit: /admin why: Make sure the `/admin` path returns 403 forbidden when not logged in. status: 403
In a third test we can assert there is one logo image on the homepage, like so:
- visit: / find: - dom: '#logo img' count: 1
Lastly, make sure there are no unprocessed tokens on the page (a.k.a. a substring does not appear):
- visit: / find: - not contains: '[site:name]'
For more code examples explore the /examples directory.
Installation
Execute the following snippet in your terminal, which will install Check Pages in your home directory. Composer is required for this to work.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/aklump/check-pages/refs/heads/master/setup-check-pages.sh)"
- Test your installaion by typing
checkpagesin a new terminal window.- If you see a Composer PHP version warning then you will need to setup an alias (see Troubleshooting)
- You should see the welcome screen if installation is working properly.
Quick Start
Initialize Your Project
cd my/project/rootmkdir bin(do this only if you want the binary(ies) to be installed here.)checkpages init- Review the output for any important messages.
Run the Demonstration Tests
bin/run_check_pages_tests.sh- If you are online, you should see passing tests.
- Try again with maximim verbosity
bin/run_check_pages_tests.sh -vvv
See Troubleshooting if you experiences problems.