README

PHP Lorem ipsum 生成器，允许使用自定义单词文件替代常规的 boring-ipsum。

来源

曾经有一次，我试图再次找到一个 lorem ipsum 生成器来生成 cupcake ipsum、bacon ipsum 或其他不同的 ipsum。我偶然发现了 Josh Sherman 的优秀 PHP 生成器实现，在 https://github.com/joshtronic/php-loremipsum。我 fork 了它并稍作修改，但最终意识到我想要的是一个可以更改源单词的生成器，可能甚至是在同一页面上……谁知道呢。因此，我决定这超出了 fork 的范畴。 :)

因此，从 php-loremipsum 演变而来，产生了 lotsa-ipsum，其想法是它可以使用不同的源单词文件，并随着时间的推移增加可用的选项。本项目的大部分工作归功于 Josh Sherman 的原始 php-loremipsum。

安装

首选的安装方法是使用 composer。首先将以下内容添加到您的 composer.json

"require": {
    "briangibbins/php-lotsaipsum": "dev-master"
}

然后运行 composer update

使用方法

入门（仅使用 boring ipsum，默认选项）

$lipsum = new briangibbins\LotsaIpsum();

要使用非 lorem 单词集开始

其中单词集是一个字符串，包含 src/lang 目录中单词集的名称（不带 .json 扩展名）。

$lipsum = new briangibbins\LotsaIpsum('elvish');

在初始化后更改到不同的单词集

$lipsum->useWords('elvish');

单词集

• elvish（来自托尔金 - 实际上是昆雅语）
• lotr（非精灵语的托尔金）
• meat（如培根和烤肉）
• patriot（如感恩节时的叔叔）
• lorem（只是常规的枯燥内容）

以下说明来自 Josh Sherman 的原始 php-loremipsum。为什么重新发明轮子？感谢 Josh。

生成单词

echo '1 word: '  . $lipsum->word();
echo '5 words: ' . $lipsum->words(5);

生成句子

echo '1 sentence:  ' . $lipsum->sentence();
echo '5 sentences: ' . $lipsum->sentences(5);

生成段落

echo '1 paragraph:  ' . $lipsum->paragraph();
echo '5 paragraphs: ' . $lipsum->paragraphs(5);

使用 HTML 标签包装文本

如果您想用标签包装生成的文本，将其作为第二个参数传递

echo $lipsum->paragraphs(3, 'p');

// Generates: <p>Lorem ipsum...</p><p>...</p><p>...</p>

也可以指定多个标签

echo $lipsum->sentences(3, ['article', 'p']);

// Generates: <article><p>...</p></article><article><p>...</p></article><article><p>...</p></article>

并且您可以使用 $1 进行回引用

echo $lipsum->words(3, '<li><a href="$1">$1</a></li>');

// Generates: <li><a href="...">...</a></li><li><a href="...">...</a></li><li><a href="...">...</a></li>

作为数组返回

也许您想要一个数组而不是字符串

print_r($lipsum->wordsArray(5));
print_r($lipsum->sentencesArray(5));
print_r($lipsum->paragraphsArray(5));

即使返回数组，您仍然可以使用标记进行包装

print_r($lipsum->wordsArray(5), 'li');