Stars: 585
Forks: 87
Pull Requests: 56
Issues: 31
Watchers: 20
Last Updated: 2023-06-14 13:16:35
CLI tool to crawl a website and check HTTP status codes
License: MIT License
Languages: PHP, JavaScript, Shell
This repository provides a tool to check the HTTP status code of every link on a given website.
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
This package can be installed via Composer:
composer global require spatie/http-status-check
This tool will scan all links on a given website:
http-status-check scan https://example.com
It outputs a line per link found. Here's an example on Laracast website scan:
When the crawling process is finished a summary will be shown.
By default the crawler uses 10 concurrent connections to speed up the crawling process. You can change that number by passing a different value to the --concurrency
option:
http-status-check scan https://example.com --concurrency=20
You can also write all urls that gave a non-2xx or non-3xx response to a file:
http-status-check scan https://example.com --output=log.txt
When the crawler finds a link to an external website it will by default crawl that link as well. If you don't want the crawler to crawl such external urls use the --dont-crawl-external-links
option:
http-status-check scan https://example.com --dont-crawl-external-links
By default, requests timeout after 10 seconds. You can change this by passing the number of seconds to the --timeout
option:
http-status-check scan https://example.com --timeout=30
By default, the crawler will respect robots data. You can ignore them though with the --ignore-robots
option:
http-status-check scan https://example.com --ignore-robots
If your site requires a basic authentification, you can use the --auth
option:
http-status-check scan https://example.com --auth=username:password
To run the tests, first make sure you have Node.js installed. Then start the included node based server in a separate terminal window:
cd tests/server
npm install
node server.js
With the server running, you can start testing:
vendor/bin/phpunit
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
If you've found a bug regarding security please mail [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.