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

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

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

软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性保证。在任何情况下，作者或版权持有人均不对任何索赔、损害或其他责任承担责任，无论这些责任是因合同、侵权或其他方式引起的，无论这些责任是否与软件或其使用或其他交易有关。