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

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

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

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