包简介

Canonical URL Symfony bundle

README 文档

README

The CanonicalUrlBundle is a Symfony bundle to redirect requests from multiple URLs for the same resource to a single canonical URL.

For example, if you had a resource named /about-us for your site example.org it could potentially be accessed with:

http://example.org/about-us
http://example.org/about-us/
http://www.example.org/about-us
http://www.example.org/about-us/
https://example.org/about-us
https://example.org/about-us/
https://www.example.org/about-us
https://www.example.org/about-us/

When a user requests the resource with any of the above URLs, CanonicalUrlBundle will build a canonical URL based on a predefined site URL and will perform an HTTP redirect to it if the request URL does not match.

The bundle can also add a <link rel="canonical"> tag to your Twig templates, see the Usage section for how.

Installation

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:

$ composer require camelot/canonical-url-bundle

Applications that don't use Symfony Flex

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

$ composer require camelot/canonical-url-bundle

This command requires you to have Composer installed globally, as explained in the [installation chapter][composer] of the Composer documentation.

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the config/bundles.php file of your project:

// config/bundles.php

return [
    // ...
    Camelot\CanonicalUrl\CamelotCanonicalUrl::class => ['all' => true],
];

Step 3: Configure the Bundle

Add your configuration for the bundle to config/packages/camelot_canonical_url.yml:

camelot_canonical_url:
    redirect:       true                  # Set to false disable redirects if you just want to use the canonical link tag
    redirect_code:  301                   # Leave this at 301 for SEO
    trailing_slash: false                 # Set to true if your routes and canonical URLs contain a trailing slash

Set the Symfony Router default URI in config/packages/routing.yaml

framework:
    router:
        # ...
        default_uri: 'https://example.org'

Usage

To add a <link rel="canonical"> tag to your pages include the following code in the <head> of a twig template:

{{ camelot_canonical_link_tag() }}

The href attribute will default to the canonical URL for the current request, but this can be overridden:

{{ camelot_canonical_link_tag('https://example.org/my-custom-link') }}

License

This bundle is released under the MIT license

camelot/canonical-url-bundle 适用场景与选型建议

camelot/canonical-url-bundle 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 152 次下载、GitHub Stars 达 3，最近一次更新时间为 2019 年 07 月 30 日，在 PHP 生态内属于活跃度较高的组件。

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

围绕 camelot/canonical-url-bundle 我们能提供哪些服务？

定制开发 / 二次开发

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

BUG 修复 & 性能优化

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

项目外包 & 长期维护

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

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

camelot/canonical-url-bundle

包简介