README

LoremIpsumBundle 允许你在 Symfony 应用程序中生成“虚构文本”，但比普通的 lorem ipsum 带来更多乐趣。

使用以下命令安装包：

composer require pilonce/pilonce-lorem-ipsum-bundle

然后...就完成了！如果你不使用 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：所有贡献和问题都受到热烈的欢迎 :)。