How Code with PHP Keeps Its Tutorials Working
Code with PHP has hundreds of lessons in one open repository. A routine update can move a chapter, leave an old link behind, or quietly introduce a second address for the same tutorial. During a November 2026 audit, our crawl found 73 missing destinations linked from published pages. Four Laravel CRM topics also had unfinished lesson pages.
What changed
Section titled “What changed”We used the existing Astro build to check the output readers and search engines receive. The check starts with the sitemap, opens each listed page, and looks for missing destinations, invalid canonical URLs, missing descriptions, and missing social previews. It also checks the Markdown copies and the redirect target map. GitHub Actions runs it on every pull request and before publishing. Read the checker
For the Laravel course, we replaced four placeholders with examples for a REST API, Sanctum, queues, and Horizon. We kept drafts out of the live catalogue and mapped three retired chapter addresses to their replacements. GitHub Pages serves these as HTML redirects, so the checker opens each old file and verifies its target. Read the changes in pull request #31
What we measured
Section titled “What we measured”The release check covered 328 sitemap pages. A fresh public crawl found that none still linked to the 73 missing destinations from the audit. Those numbers describe the November release. We use Search Console and Cloudflare Web Analytics for impressions, clicks, and referrals over time. Build and deployment
One lesson from the work was to check finished HTML as well as source Markdown. Astro generates some navigation, metadata, and redirects at build time. Checking those files catches problems that a scan of Markdown links would miss.
To try the same check, clone the Code with PHP repository, install the Node dependencies with npm ci, and run:
npm run buildnpm run check:seo