包简介

Seoquent - A powerful all-in-one Laravel SEO package. Meta tags, Open Graph, Twitter Cards, JSON-LD structured data, sitemap generation, robots.txt, and per-model SEO management.

README 文档

README

All-in-one SEO for Laravel 10+. One line in your controller, one directive in your blade — done.

The Problem

SEO in Laravel is a mess. You end up with:

Meta tags scattered across every Blade view
Open Graph and Twitter Cards copy-pasted and forgotten
No structured data (JSON-LD), so Google shows plain blue links instead of rich results
Sitemap and robots.txt managed manually or with separate packages
Every model needs its own SEO logic, duplicated everywhere

You spend more time wiring SEO tags than building your actual app.

The Solution

Seoquent handles everything from one place. Set your SEO in the controller, drop one directive in your layout — the package generates all the meta tags, Open Graph, Twitter Cards, JSON-LD, sitemap, and robots.txt automatically.

// Controller
Seo::title('My Post')->description('...')->image('...');

<!-- Layout -->
<head>
    @seoHead
</head>

That's it. No more scattered tags. No more forgetting Open Graph. No more missing structured data.

Features

Meta Tags — title, description, keywords, robots, canonical, author
Open Graph — auto-generated from meta tags, fully customizable
Twitter Cards — auto-generated from Open Graph, fully customizable
JSON-LD Structured Data — Article, Product, FAQ, Breadcrumbs, Organization, LocalBusiness, and custom schemas
XML Sitemap — auto-generated from static URLs and Eloquent models, cached, served at /sitemap.xml
Dynamic robots.txt — configurable allow/disallow rules, served at /robots.txt
Per-Model SEO — HasSeo trait to store and load SEO data from the database for any model
Blade Directives — @seoHead and @seoJsonLd, zero config rendering
Smart Fallbacks — Twitter falls back to Open Graph, Open Graph falls back to meta tags
Fluent API — chainable, readable, easy to use
Laravel 10, 11, 12 — fully compatible

Install

composer require ibrahim-eng12/seoquent

3 Steps to Full SEO

1. Set SEO in your controller

use IbrahimEng12\Seoquent\Facades\Seo;

public function show(Post $post)
{
    Seo::title($post->title)
        ->description($post->excerpt)
        ->image($post->cover_image);

    return view('posts.show', compact('post'));
}

2. Add the directive to your layout

<head>
    @seoHead
</head>

3. That's it. This is what gets rendered:

<title>My Post Title | App Name</title>
<meta name="description" content="Post excerpt here...">
<meta name="robots" content="index, follow">
<link rel="canonical" href="https://yoursite.com/posts/my-post">

<meta property="og:title" content="My Post Title">
<meta property="og:description" content="Post excerpt here...">
<meta property="og:type" content="website">
<meta property="og:url" content="https://yoursite.com/posts/my-post">
<meta property="og:image" content="https://yoursite.com/cover.jpg">

<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="My Post Title">
<meta name="twitter:description" content="Post excerpt here...">
<meta name="twitter:image" content="https://yoursite.com/cover.jpg">

All from 3 lines of code.

What's Included

Feature	Auto-generated	Route
Meta tags (title, description, robots, canonical)	Yes	-
Open Graph tags	Yes (falls back to meta)	-
Twitter Cards	Yes (falls back to meta)	-
JSON-LD structured data	Yes	-
XML Sitemap	Yes	`/sitemap.xml`
Dynamic robots.txt	Yes	`/robots.txt`
Per-model SEO (database)	Optional	-

API Reference

Basic SEO

Seo::title('Page Title');
Seo::description('Page description');
Seo::keywords(['keyword1', 'keyword2']);
Seo::image('https://example.com/image.jpg');
Seo::canonical('https://example.com/page');
Seo::author('Ibrahim');
Seo::robots('index, follow');
Seo::noIndex();

All methods are chainable:

Seo::title('About Us')
    ->description('Learn more about our company')
    ->keywords('company, about, team')
    ->image('https://example.com/about.jpg')
    ->author('Ibrahim');

Title Customization

// Default output: "Page Title | App Name"
Seo::title('Page Title');

// Remove suffix: "Page Title"
Seo::meta()->withoutTitleSuffix();

// Change separator: "Page Title - App Name"
Seo::meta()->titleSeparator(' - ');

Open Graph

Falls back to your meta title/description automatically. Override when needed:

Seo::openGraph()
    ->title('Custom OG Title')
    ->description('Custom OG Description')
    ->type('article')
    ->image('https://example.com/og.jpg', 1200, 630, 'Alt text')
    ->siteName('My Site')
    ->locale('en_US');

Twitter Cards

Falls back to Open Graph, then meta tags. Override when needed:

Seo::twitter()
    ->card('summary_large_image')
    ->site('@mysite')
    ->creator('@author')
    ->title('Custom Twitter Title')
    ->image('https://example.com/twitter.jpg', 'Alt text');

JSON-LD Structured Data

Add @seoJsonLd to your layout (before </body>), then use any of these:

// Article
Seo::jsonLd()->article(
    title: 'My Article',
    author: 'Ibrahim',
    datePublished: '2025-01-01',
    dateModified: '2025-01-15',
    image: 'https://example.com/article.jpg',
);

// Organization
Seo::jsonLd()->organization('Company Name', 'https://example.com', 'https://example.com/logo.png');

// Breadcrumbs
Seo::jsonLd()->breadcrumbs([
    ['name' => 'Home', 'url' => '/'],
    ['name' => 'Blog', 'url' => '/blog'],
    ['name' => 'Current Post'],
]);

// FAQ
Seo::jsonLd()->faq([
    ['question' => 'What is this?', 'answer' => 'A Laravel SEO package.'],
    ['question' => 'Is it free?', 'answer' => 'Yes, MIT licensed.'],
]);

// Product
Seo::jsonLd()->product(
    name: 'Product Name',
    description: 'Description',
    brand: 'Brand',
    price: 29.99,
    currency: 'USD',
    availability: 'InStock',
);

// Local Business
Seo::jsonLd()->localBusiness(
    name: 'My Business',
    address: '123 Main St',
    phone: '+1234567890',
);

// Website with search action
Seo::jsonLd()->website('My Site', 'https://example.com', 'https://example.com/search?q=');

// Any custom schema
Seo::jsonLd()->addSchema([
    '@context' => 'https://schema.org',
    '@type' => 'Event',
    'name' => 'My Event',
    'startDate' => '2025-06-01',
]);

XML Sitemap

Register URLs in a service provider's boot() method:

use IbrahimEng12\Seoquent\Facades\Seo;

// Static pages
Seo::sitemap()
    ->add(url('/'), now()->toIso8601String(), 'daily', 1.0)
    ->add(url('/about'), null, 'monthly', 0.8);

// From Eloquent models (auto-generates URLs)
Seo::sitemap()->addModel(
    modelClass: \App\Models\Post::class,
    routeName: 'posts.show',
    routeKey: 'slug',
    changefreq: 'weekly',
    priority: 0.8,
    queryCallback: fn ($query) => $query->where('published', true),
);

Served at /sitemap.xml. Cached by default.

Per-Model SEO (Database)

Publish the migration first:

php artisan vendor:publish --tag=seoquent-migrations
php artisan migrate

Add the trait to your model:

use IbrahimEng12\Seoquent\Traits\HasSeo;

class Post extends Model
{
    use HasSeo;
}

Save SEO data:

$post->setSeo([
    'title' => 'Custom SEO Title',
    'description' => 'Custom description',
    'og_image' => 'https://example.com/image.jpg',
    'keywords' => ['laravel', 'seo'],
]);

Apply it in your controller:

public function show(Post $post)
{
    $post->applySeo(); // loads all stored SEO data into Seoquent

    return view('posts.show', compact('post'));
}

Delete SEO data:

$post->deleteSeo();

Blade Directives

@seoHead      {{-- meta + open graph + twitter cards --}}
@seoJsonLd    {{-- JSON-LD structured data --}}

Or use Blade components:

<x-seoquent::meta />
<x-seoquent::jsonld />

Configuration

php artisan vendor:publish --tag=seoquent-config

All defaults can be set in config/seoquent.php:

'defaults' => [
    'title'           => env('APP_NAME', 'Laravel'),
    'title_separator' => ' | ',
    'title_suffix'    => env('APP_NAME', 'Laravel'),
    'description'     => '',
    'robots'          => 'index, follow',
],

'open_graph' => [
    'type'      => 'website',
    'site_name' => env('APP_NAME'),
    'image'     => null,  // default OG image for all pages
],

'twitter' => [
    'card'    => 'summary_large_image',
    'site'    => null,  // @username
    'creator' => null,  // @username
],

'sitemap' => [
    'enabled'        => true,
    'cache_enabled'  => true,
    'cache_duration' => 3600,
],

'robots' => [
    'enabled'  => true,
    'allow'    => ['/'],
    'disallow' => [],
],

'database' => [
    'enabled'    => true,
    'table_name' => 'seo_meta',
],

Publishing

php artisan vendor:publish --tag=seoquent-config       # Config
php artisan vendor:publish --tag=seoquent-migrations    # Migration
php artisan vendor:publish --tag=seoquent-views         # Blade views

Requirements

PHP 8.1+
Laravel 10, 11, or 12

License

MIT - See LICENSE

ibrahim-eng12/seoquent 适用场景与选型建议

ibrahim-eng12/seoquent 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 6 次下载、GitHub Stars 达 14，最近一次更新时间为 2026 年 02 月 09 日，在 PHP 生态内属于活跃度较高的组件。

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

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

围绕 ibrahim-eng12/seoquent 我们能提供哪些服务？

定制开发 / 二次开发

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

BUG 修复 & 性能优化

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

项目外包 & 长期维护

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

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

与 ibrahim-eng12/seoquent 相关的其它包

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

octave/sitemap-bundle 0

Symfony sitemap generator

asika/sitemap 19

PHP Simple Sitemap Generator

webnuvola/laravel-json-ld 5

Laravel wrapper for torann/json-ld

sweetrdf/json-ld 3

JSON-LD Processor for PHP

webignition/web-resource-interfaces 1

Interfaces for web resource models and services to retrieve and create them

novius/laravel-meta 0

Help to manage meta data on Laravel Eloquent model

ibrahim-eng12/seoquent

包简介

关键字：