README

用于处理HTML字符串截断操作的PHP库

特性

• 保持开放/关闭标签的一致性，截断HTML字符串
• 无外部依赖。
• PSR-4兼容。
• 兼容PHP >= 5.3.3 以及
• Symfony2 和 Twig 的集成。

安装

您可以通过 Composer 安装 urodoz/truncateHTML

$ composer require urodoz/truncate-html:@stable

使用方法

截断HTML字符串

use Urodoz\Truncate\TruncateService;

$truncateService = new TruncateService();
echo $truncateService->truncate($htmlString, 100); //Truncating to 100 characters

集成

Symfony2

TruncateHTML 包含一个用于在 Symfony2 应用程序中作为服务使用的 Symfony2 扩展和服务定义。代码位于 Urodoz\Truncate\Bridge\Symfony 命名空间中，您只需将扩展类添加到您的 AppKernel.php

# app/AppKernel.php

class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Urodoz\Truncate\Bridge\Symfony\UrodozTruncateBundle(),
        );
        // ...
    }

    // ...
}

现在您可以在应用程序的任何地方使用 urodoz_truncate 服务，例如，在您的控制器中

$truncatedString = $this->get('urodoz_truncate')->truncate($htmlString, 100);

Twig

如果您使用的是 Symfony2 框架与 Twig，您可以在设置完 Symfony2 集成（见上文）后，在模板中使用 Twig 过滤器 truncateHTML。

{{ truncateHTML(content, 250) }}

如果您在 Symfony2 框架外使用 Twig，您首先需要将扩展添加到您的环境中

use Urodoz\Truncate\Bridge\Twig\TruncateExtension;
use Urodoz\Truncate\TruncateService;

$twig = new Twig_Environment($loader);
$twig->addFunction(new TruncateExtension(TruncateService::create()));

您可以在 Twig 文档 中找到有关注册扩展的更多信息。

作者

• Albert Lacarta

许可证

MIT 许可证 (MIT)

版权所有 (c) 2014 Albert Lacarta

特此授予任何人免费获得本软件及其相关文档副本（“软件”）的副本的权利，以不受限制地处理软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本，并允许向获得软件副本的人提供这样做，前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供，不提供任何形式的保证，无论是明示的还是暗示的，包括但不限于适销性、针对特定目的的适用性和非侵权性。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任承担责任，无论此类责任是基于合同、侵权或其他法律，源于、因之而产生或与软件或其使用或其他交易有关。