包简介

Early-stage SEO troubleshooting tool for Laravel 12 Blade templates. Detects missing SEO elements and can fix basic structural issues - content still needs manual work.

README 文档

README

⚠️ Alpha Version Warning: This is an early development tool with limitations. It's not production-ready.

A basic SEO troubleshooting tool for Laravel 12 Blade templates. Scans your templates for missing SEO elements and can fix some basic structural issues.

What This Tool Actually Does

✅ What It Can Do:

Scan Blade templates for missing SEO elements (meta tags, Open Graph, etc.)
Generate reports showing what's missing
Add basic structural elements like viewport meta tag, canonical URLs, favicon links
Create file backups before making changes
Output results in table or JSON format

❌ What It Cannot Do:

Write meta descriptions, titles, or any content for you
Guarantee SEO success or rankings
Fix semantic or content-related SEO issues
Replace proper SEO strategy and planning
Handle complex template logic or dynamic content perfectly

🎯 Realistic Use Case: This is a development helper to quickly identify missing SEO elements in your templates. You still need to write the actual SEO content yourself.

Installation

composer require probeforge/seoforge:@dev

Quick Usage

Check what's missing:

php artisan seo:audit

Fix basic structural issues:

php artisan seo:fix --issues=viewport,canonical --backup

Get JSON output for scripts:

php artisan seo:audit --json

What Gets Checked

Level A (Basic):

Title tags, meta descriptions, canonical URLs, viewport, lang attribute

Level AA (Social):

Open Graph tags, Twitter cards, image alt attributes, heading hierarchy

Level AAA (Advanced):

Schema markup, meta keywords, favicons, preconnect hints, hreflang

What Can Be Auto-Fixed

Only basic structural elements:

viewport - Adds viewport meta tag
canonical - Adds canonical URL link
favicon - Adds favicon link
language - Adds lang attribute to html tag
meta_robots - Adds robots meta tag
preconnect - Adds preconnect/DNS prefetch
apple_touch_icon - Adds Apple touch icon

Important: The tool cannot create content like meta descriptions or titles - that's your job!

Commands

`seo:audit`

php artisan seo:audit [--path=] [--level=A|AA|AAA] [--json]

`seo:fix`

php artisan seo:fix [--path=] [--backup] [--issues=viewport,canonical]

Example Blade Setup

<!DOCTYPE html>
<html lang="@yield('lang', 'en')">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    
    <title>@yield('title', 'Default Title')</title>
    <meta name="description" content="@yield('description', 'Default description')">
    
    <link rel="canonical" href="@yield('canonical', request()->url())">
    <meta name="robots" content="@yield('robots', 'index,follow')">
    
    <!-- Open Graph -->
    <meta property="og:title" content="@yield('og_title', 'Default Title')">
    <meta property="og:description" content="@yield('og_description', 'Default description')">
    
    <link rel="icon" href="{{ asset('favicon.ico') }}">
</head>
<body>
    @yield('content')
</body>
</html>

Then in your pages:

@extends('layouts.app')

@section('title', 'About Us - My Site')
@section('description', 'Learn about our company and mission.')
@section('og_title', 'About Our Company')

@section('content')
    <h1>About Us</h1>
    <p>Content goes here...</p>
@endsection

Known Issues & Limitations

Table formatting can be messy in some terminals
Regex detection may have false positives/negatives
Cannot handle complex Blade logic
Windows path handling has some edge cases
Does not validate content quality, only presence
Cannot generate meaningful content

Configuration

Optional - publish config:

php artisan vendor:publish --provider="ProbeForge\SEOForge\SeoForgeServiceProvider"

Is This For Me?

Yes, if you want to:

Quickly scan templates for missing SEO elements
Get a basic SEO checklist for your Laravel app
Add basic structural SEO elements automatically

No, if you expect:

AI-generated meta descriptions or titles
Complete SEO optimization
Production-ready SEO automation
Marketing or content strategy advice

Contributing

This is alpha software. Contributions welcome, but expect breaking changes.

License

MIT License. See LICENSE.md.

Bottom Line: This tool finds missing SEO elements and adds basic tags. You still need to write the actual SEO content yourself. It's a starting point, not a complete solution.

probeforge/seoforge 适用场景与选型建议

probeforge/seoforge 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 1 次下载、GitHub Stars 达 0，最近一次更新时间为 2025 年 06 月 02 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「seo」「Audit」「templates」「optimization」「laravel」「open-graph」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 probeforge/seoforge 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 probeforge/seoforge 我们能提供哪些服务？

定制开发 / 二次开发

基于 probeforge/seoforge 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 probeforge/seoforge 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

shoot/shoot 40

Shoot aims to make providing data to your templates more manageable

maiconpinto/cakephp-adminlte-theme 171

CakePHP 4.x AdminLTE Theme.

superbig/craft-audit 20

Log adding/updating/deleting of elements

bookdown/themes 11

Bookdown.io With Bootswatch Styles And Prism Syntax Highlighting

damienharper/auditor-doctrine-provider 2

Doctrine ORM provider for the auditor audit-log library.

backstageel/cakephp-gentelella-theme 43

CakePHP 3.x Gentelella Theme.

probeforge/seoforge

包简介

关键字：