README

PHP无依赖的Lorem ipsum生成器。兼容PHP 5.3及以上版本。

安装

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

"require": {
    "joshtronic/php-loremipsum": "dev-master"
}

然后运行 composer update。

用法

入门

$lipsum = new joshtronic\LoremIpsum();

生成单词

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'));

假设

生成的第一个字符串将始终以传统的 "Lorem ipsum dolor sit amet, consectetur adipiscing elit" 开头。后续字符串可能包含这些单词，但不会明确以它们开头。

贡献

建议和错误报告始终欢迎，但只有通过拉取请求才能获得积分。

所有贡献都需要单元测试。您可以通过简单地从项目的根目录运行 phpunit 来运行测试套件。

致谢

php-loremipsum最初受到 badcow/lorem-ipsum 的启发，目标是成为一个无依赖项的Lorem ipsum生成器，具有灵活的生成选项。

许可证

MIT