shel / crawler
Allows crawling of sitemaps and node-trees
Installs: 1 497
Dependents: 0
Suggesters: 0
Security: 0
Stars: 7
Watchers: 4
Forks: 1
Open Issues: 0
Type:neos-plugin
Requires
- php: >=7.4
- ext-curl: *
- ext-libxml: *
- ext-simplexml: *
- chuyskywalker/rolling-curl: ~3.1
- neos/neos: ^5.3 || ^7.3 || ^8.0
README
Crawler for Neos CMS nodes and sites. It can be used to warm up the caches after a release or dump your site as html files.
Installation
Run the following command in your project
composer require shel/crawler
Usage
To crawl all pages based on a single sitemap run
./flow crawler:crawlsitemap --url=http://huve.de.test/sitemap.xml --simultaneousLimit=10 --delay=0
To crawl all pages based on all sitemaps listed in a robots.txt file
./flow crawler:crawlrobotstxt --url=http://huve.de.test/robots.txt --simultaneousLimit=10 --delay=0
Node based crawling
This command will try to generate all page html without using actual requests and only renders them internally. Due to the complexity of the page context, this might not give the desired results, but the resulting html of alle crawled pages can be stored for further usage.
This can be much faster as all pages are rendered in one process and all caches are reused.
To make this work, you need make provide a valid hostname.
This can be done via one of the following ways:
- have an active domain setup for a site (recommended, the crawler will use the first active domain)
- set the
Neos.Flow.http.baseUri
setting for Neos in yourSettings.yaml
- provide the
baseUri
in general via the environment variableCRAWLER_BASE_URI
and use the example inConfiguration/Production/Settings.yaml
./flow crawler:crawlnodes --siteNodeName <sitename>
To crawl all sites based on their primary active domain:
./flow crawler:crawlsites
To crawl all sites based on their primary active domain and use the URLs listed in robots.txt:
./flow crawler:crawlsites --method robotstxt
Experimental static file cache
By providing the outputPath
you can store all crawled content as html files.
./flow crawler:crawlnodes --siteNodeName <sitename> --outputPath=Web/cache
You can use this actually as a super simple static file cache by adapting your webserver configuration. There is an example for nginx:
# Serve a cached page matching the request if it exists location / { default_type "text/html"; try_files /cache/$uri $uri $uri/ /index.php?$args; } # Serve cache/index(.html) instead of / if it exists location = / { default_type "text/html"; try_files /cache/index.html /cache/index /index.php?$args; }
You replace the existing try_files
part with the given code and adapt the path cache
if you use a different one.
This cache feature is really experimental, and you are currently in charge of keeping the files up-to-date and removing old ones.
- Doesn't clear cache
- Doesn't update automatically on publish
- Ignores Fusion caching configuration
- Shortcuts are ignored (open TODO)
Contributing
Contributions or sponsorships are very welcome.