README

警告：此包是https://symfonycasts.com/screencast/symfony-bundle 中创建的一个示例包，不应在真实应用程序中作为依赖项使用！

Hello LoremIpsumBundle!

LoremIpsumBundle 是一种在您的 Symfony 应用程序中生成 "假文本" 的方法，但比普通的 lorem ipsum 稍微有趣一些。

使用以下命令安装包

composer require knpuniversity/lorem-ipsum-bundle --dev

然后...就完成了！如果您不是使用 Symfony Flex，您还需要在您的 AppKernel.php 文件中启用 KnpU\LoremIpsumBundle\KnpULoremIpsumBundle。

用法

此包提供用于生成假文本的单个服务，您可以通过使用 KnpUIpsum 类型提示来自动注入。

// src/Controller/SomeController.php

use KnpU\LoremIpsumBundle\KnpUIpsum;
// ...

class SomeController
{
    public function index(KnpUIpsum $knpUIpsum)
    {
        $fakeText = $knpUIpsum->getParagraphs();

        // ...
    }
}

您也可以使用 ID knpu_lorem_ipsum.knpu_ipsum 直接访问此服务。

配置

可以通过创建一个新的 config/packages/knpu_lorem_ipsum.yaml 文件直接配置生成的文本的一些部分。默认值如下

# config/packages/knpu_lorem_ipsum.yaml
knpu_lorem_ipsum:

    # Whether or not you believe in unicorns
    unicorns_are_real:    true

    # How much do you like sunshine?
    min_sunshine:         3

扩展单词列表

如果您感到特别有创造力和兴奋，您可以向单词生成器添加自己的单词！

为此，创建一个实现 WordProviderInterface 的类

namespace App\Service;

use KnpU\LoremIpsumBundle\WordProviderInterface;

class CustomWordProvider implements WordProviderInterface
{
    public function getWordList(): array
    {
        return ['beach'];
    }
}

然后...就完成了！如果您使用的是标准服务配置，您的新类将自动注册为服务并由系统使用。如果不是这样，您需要将此类注册为服务，并将其标记为 knpu_ipsum_word_provider。

贡献

当然，开源是靠每个人的能力为公共利益贡献一点点时间推动的。如果您想看到某个功能或添加一些自己的快乐单词，那太棒了！您可以提出请求——但是创建 pull request 是完成任务的更好方式。

无论如何，请放心提交问题或 pull request：所有贡献和问题都深受欢迎 :)。