Download the PHP package timurturdyev/simple-seo without Composer
On this page you can find all versions of the php package timurturdyev/simple-seo. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download timurturdyev/simple-seo
More information about timurturdyev/simple-seo
Files in timurturdyev/simple-seo
Package simple-seo
Short Description Framework-agnostic SEO head markup builder: meta, Open Graph, Twitter/X Cards and JSON-LD, with a lazy Laravel integration layer.
License MIT
Homepage https://github.com/TimurTurdyev/simple-seo
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package simple-seo
simple-seo
Meta-теги, Open Graph, карточки Twitter/X и JSON-LD для PHP 8.2+. Ядро без зависимостей, слой для Laravel 11/12 в том же пакете.
Я написал этот пакет на замену artesaos/seotools в своих проектах. Из старого пакета взята только идея, реализация и API новые. Две вещи, которые меня в нём раздражали, здесь устроены иначе:
Дефолты из конфига не липнут к странице. Они подставляются при рендере, если страница ничего не задала. Не нужен хак setDescription(false), есть честный withoutDefaults().
JSON-LD собирается коллекцией. Каждый add() это отдельная сущность, две и больше склеиваются в @graph. Нет "текущего блока", который можно случайно перетереть вызовом из другого места шаблона.
Остальное по мелочи: скалярные сеттеры заменяют значение, списочные накапливают, robots задаётся методами noindex() / maxSnippet(120) вместо строки, весь вывод экранирован, JSON-LD кодируется с защитой от закрывающего script-тега. PHPStan на максимальном уровне, поведение закрыто тестами.
Установка
В Laravel провайдер и фасад подхватятся сами. Конфиг с дефолтами публикуется по желанию:
Laravel
В layout, в head:
Верхний уровень раскидывает значения сам: title() заполняет meta, og и twitter разом, canonical() дублируется в og:url, image() уходит в og и twitter. Когда нужен контроль, спускайся в секцию:
Секция twitter молчит, пока страница не задаст явное значение: X умеет читать og-теги, дублировать их незачем.
Модель может описать свою разметку сама через контракт HasSeo:
Тогда в контроллере остаётся одна строка:
При app.debug директива дописывает html-комментарий: какое поле пришло со страницы, какое из конфига. Сами значения не светятся.
Вне Laravel
Хелпера seo() и директивы тут нет, остальной API тот же. Собери менеджер при бутстрапе:
В шаблоне:
Вывод экранирован, оборачивать не нужно.
Под PHP-FPM больше ничего не требуется. Под RoadRunner, Swoole и в прочих воркерах вызывай $seo->reset() между запросами или создавай свежий инстанс. В Symfony и Yii регистрируй фабрику в контейнере и бери дефолты из своего конфига. Классы из src/Laravel/ в таких проектах не загружаются, функция seo() объявлена через function_exists и никому не мешает. В Laravel менеджер привязан как scoped, Octane сбрасывает его сам.
Схемы JSON-LD
Готовые билдеры: Product, Offer, AggregateOffer, AggregateRating, Article, BlogPosting, Person, QAPage, Question, Answer, BreadcrumbList, Organization, WebSite, LocalBusiness.
Позиции хлебных крошек нумеруются сами. Под типы, которые Google перестал показывать (FAQ и подобные), билдеров нет: экзотику передавай массивом или через ->property().
Для страниц вопрос-ответ есть связка QAPage:
answerCount подставится сам из числа размеченных ответов, явный ->answerCount() сильнее. Строка в author() превращается в Person, готовые Person и Organization проходят как есть. По правилам Google такая разметка валидна на странице, где главное содержимое - один вопрос с ответами.
Сущность страницы можно собрать из уже заданных значений, не дублируя их:
fromPage() при рендере подставит name из title (без суффикса), description, image из og-картинок и url из canonical. Второй аргумент дополняет и перекрывает, null-поля выпадают из JSON, поэтому условные куски пишутся тернарником. Работает с любым типом от Thing: Article, Recipe, Event и так далее.
Два уточнения. Сущности сайта (Organization, WebSite, LocalBusiness) через fromPage() собирать не надо - он возьмёт заголовок страницы вместо имени организации; их добавляй обычным add() в layout. Типы с нестандартными обязательными полями (JobPosting хочет title, VideoObject хочет thumbnailUrl) добирай через второй аргумент.
Миграция с artesaos/seotools
Таблица соответствий вызовов, маппинг конфига и отличия поведения: docs/migration-from-artesaos.md.
Разработка
Лицензия MIT.
English
Meta, Open Graph, Twitter/X cards and JSON-LD for PHP. Plain PHP 8.2+ core with zero runtime deps, lazy Laravel 11/12 layer in the same package. Config values resolve as render-time fallbacks, every jsonLd()->add() is an independent entity, robots directives are typed methods, output is escaped. jsonLd()->fromPage('Product', $overrides) builds a page entity from the already set title, description, image and canonical at render time. Typed QAPage, Question and Answer builders cover Q&A pages, answerCount is derived from the marked up answers unless set explicitly. Install via composer, set page values with seo(), print with @seo or $seo->render(). Migration notes live in docs/migration-from-artesaos.md.
