PHPackages                             abac2500/laravel-robots - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. abac2500/laravel-robots

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

abac2500/laravel-robots
=======================

Библиотека Laravel для генерации файлов Robots

1.0.0(5mo ago)04MITPHPPHP ^8.3

Since Nov 20Pushed 5mo agoCompare

[ Source](https://github.com/Abac2500/laravel-robots)[ Packagist](https://packagist.org/packages/abac2500/laravel-robots)[ RSS](/packages/abac2500-laravel-robots/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (2)Used By (0)

Laravel Robots
==============

[](#laravel-robots)

[![Версия PHP](https://camo.githubusercontent.com/ef0054230522e542bc1f908ac005c6c75888dea255bac910f9015e12095e31d7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e332d626c7565)](https://www.php.net/)[![Версия Laravel](https://camo.githubusercontent.com/ec976ad699fb5ffbb43421eabc292424a8b0bc5bed7a28e11e6349c67e2b6599/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d25354531322e302d726564)](https://laravel.com/)[![Лицензия](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)](LICENSE)

Удобная библиотека для генерации файлов Robots в Laravel.

Возможности
-----------

[](#возможности)

- 🤖 Поддержка основных директив Robots (User-agent, Allow, Disallow, Sitemap, Clean-param)
- 📦 Автоматическая регистрация через Laravel Package Discovery
- 🎯 Callback API для удобной конфигурации User-agent блоков
- 🔍 Встроенный Enum с популярными поисковиками
- 🧪 Базовое покрытие тестами
- 📝 Подробная документация

Требования
----------

[](#требования)

- PHP 8.3 или выше
- Laravel 12.x

Установка
---------

[](#установка)

Установите пакет через Composer:

```
composer require abac2500/laravel-robots
```

Пакет автоматически зарегистрируется благодаря Laravel Package Discovery.

Использование
-------------

[](#использование)

### Базовое использование

[](#базовое-использование)

```
use Abac2500\LaravelRobots\Enums\SearchEngine;
use Abac2500\LaravelRobots\Facades\Robots;
use Abac2500\LaravelRobots\RobotsGenerator;

$robots = Robots::agent(SearchEngine::ALL, fn (RobotsGenerator $robots) =>
    $robots->disallow('/example')
        ->allow('/public')
    )
    ->sitemap('https://example.com/sitemap.xml')
    ->render();

echo $robots;
```

Результат:

```
User-agent: *
Disallow: /example
Allow: /public
Sitemap: https://example.com/sitemap.xml

```

### SearchEngine Enum

[](#searchengine-enum)

Библиотека предоставляет enum с популярными поисковыми системами:

```
use Abac2500\LaravelRobots\Enums\SearchEngine;

SearchEngine::ALL // '*'
SearchEngine::GOOGLEBOT // 'Googlebot'
SearchEngine::GOOGLEBOT_NEWS // 'Googlebot-News'
SearchEngine::GOOGLEBOT_IMAGE // 'Googlebot-Image'
SearchEngine::GOOGLEBOT_VIDEO // 'Googlebot-Video'
SearchEngine::BINGBOT // 'Bingbot'
SearchEngine::SLURP // 'Slurp'
SearchEngine::DUCKDUCKBOT // 'DuckDuckBot'
SearchEngine::BAIDUSPIDER // 'Baiduspider'
SearchEngine::FACEBOT // 'facebot'
SearchEngine::IA_ARCHIVER // 'ia_archiver'
SearchEngine::AHREFSBOT // 'AhrefsBot'
SearchEngine::YANDEX // 'Yandex'
```

### Директивы

[](#директивы)

#### Sitemap

[](#sitemap)

Добавить ссылку на sitemap:

```
// Одна Sitemap
Robots::sitemap('https://example.com/sitemap.xml');

// Несколько Sitemap
Robots::sitemap('https://example.com/sitemap.xml')
    ->sitemap('https://example.com/sitemap-news.xml');
```

#### User-agent

[](#user-agent)

Создать блок директив для User-agent с использованием Callback:

```
// С использованием Enum
Robots::agent(SearchEngine::GOOGLEBOT, fn (RobotsGenerator $robots) =>
    $robots->disallow('/example')
        ->allow('/')
);

// Без Callback
Robots::agent(SearchEngine::BINGBOT)
    ->disallow('/example');
```

#### Disallow

[](#disallow)

Запретить доступ к пути:

```
Robots::agent(SearchEngine::ALL, fn (RobotsGenerator $robots) =>
    $robots->disallow('/example')
);
```

#### Allow

[](#allow)

Разрешить доступ к пути:

```
Robots::agent(SearchEngine::ALL, fn (RobotsGenerator $robots) =>
    $robots->allow('/public')
);
```

#### Clean-param

[](#clean-param)

Директива для поисковых систем (используется Yandex):

```
// Один параметр
Robots::agent(SearchEngine::YANDEX, fn (RobotsGenerator $robots) =>
    $robots->cleanParam('ref')
);

// С указанием пути
Robots::agent(SearchEngine::YANDEX, fn (RobotsGenerator $robots) =>
    $robots->cleanParam('ref', '/example/');
});

// Несколько параметров (объединяются через &)
Robots::agent(SearchEngine::YANDEX, fn (RobotsGenerator $robots) =>
    $robots->cleanParam(['ref', 'utm_source'], '/example/')
);
```

#### Комментарии

[](#комментарии)

Добавить комментарий:

```
Robots::comment('Комментарий');
```

#### Пустые строки

[](#пустые-строки)

Добавить пустую строку для улучшения читаемости:

```
Robots::blank();
```

### Использование в контроллере

[](#использование-в-контроллере)

Создайте маршрут для отдачи Robots:

```
// routes/web.php
use Abac2500\LaravelRobots\Enums\SearchEngine;
use Abac2500\LaravelRobots\Facades\Robots;
use Abac2500\LaravelRobots\RobotsGenerator;

Route::get('/robots.txt', function () {
    $robots = Robots::agent(SearchEngine::ALL, fn (RobotsGenerator $robots) =>
        $robots->disallow('/example')
            ->allow('/')
    )
    ->sitemap(url('/sitemap.xml'))
    ->render();

    return response($robots, 200, [
        'Content-Type' => 'text/plain',
    ]);
});
```

Тестирование
------------

[](#тестирование)

Запустить тесты:

```
composer install
composer test
```

Библиотека включает базовый набор тестов, покрывающих функции.

Лицензия
--------

[](#лицензия)

Этот пакет распространяется под лицензией MIT. Подробности в файле [LICENSE](LICENSE).

Поддержка
---------

[](#поддержка)

Если вы обнаружили ошибку или хотите предложить улучшение, пожалуйста, создайте issue в репозитории проекта.

Автор
-----

[](#автор)

[Abac2500](https://github.com/Abac2500) (Эдуард Кичаев)

---

Сделано с ❤️ для Laravel сообщества

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance70

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

171d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/623a4245030bd2ce74ba17c1276bb7ec334e85f5e86da22ffe06ea708f35cc81?d=identicon)[Abac2500](/maintainers/Abac2500)

---

Top Contributors

[![Abac2500](https://avatars.githubusercontent.com/u/66746248?v=4)](https://github.com/Abac2500 "Abac2500 (1 commits)")

---

Tags

laravelSitemapseorobotsabac2500

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/abac2500-laravel-robots/health.svg)

```
[![Health](https://phpackages.com/badges/abac2500-laravel-robots/health.svg)](https://phpackages.com/packages/abac2500-laravel-robots)
```

###  Alternatives

[spatie/laravel-livewire-wizard

Build wizards using Livewire

4061.0M4](/packages/spatie-laravel-livewire-wizard)[bensampo/laravel-embed

Painless responsive embeds for videos, slideshows and more.

142146.8k](/packages/bensampo-laravel-embed)[calotype/seo

A package containing SEO helpers.

722.6k](/packages/calotype-seo)[dragon-code/pretty-routes

Pretty Routes for Laravel

10058.7k4](/packages/dragon-code-pretty-routes)[fomvasss/laravel-meta-tags

A package to manage SEO (meta-tags, xml-fields, etc.)

3028.9k](/packages/fomvasss-laravel-meta-tags)[watson/nameable

Format names of users into full, familiar and abbreviated forms

299.7k](/packages/watson-nameable)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
