Josh Sherman
9f7ee3cb82
* Updated to test again PHP 7.4 and to use that for coverage reporting. * Added PHP nightly builds as an allowable failure. * Added a git ignore as well as a `phpunit` configuration. * Updated the tests and CI configuration to better handle the juggling of PHP and `phpunit` versions. * Updated the coveralls dependency to be the latest and greatest instead of the deprecated package. * Tweaked the README, updated the LICENSE years and bumped this package's version. * Dropped Patreon link in favor of using Github Sponsors.
119 lines
3.1 KiB
Markdown
119 lines
3.1 KiB
Markdown
# php-loremipsum
|
|
|
|
[](https://github.com/joshtronic/php-loremipsum/blob/master/LICENSE)
|
|
|
|
[](https://travis-ci.org/joshtronic/php-loremipsum)
|
|
[](https://coveralls.io/github/joshtronic/php-loremipsum?branch=master)
|
|
[](https://packagist.org/packages/joshtronic/php-loremipsum)
|
|
|
|
Lorem ipsum generator in PHP without dependencies. Compatible with PHP 5.3+.
|
|
|
|
## Installation
|
|
|
|
The preferred installation method is via `composer`. First add the following to
|
|
your `composer.json`:
|
|
|
|
```json
|
|
"require": {
|
|
"joshtronic/php-loremipsum": "dev-master"
|
|
}
|
|
```
|
|
|
|
Then run `composer update`.
|
|
|
|
## Usage
|
|
|
|
### Getting Started
|
|
|
|
```php
|
|
$lipsum = new joshtronic\LoremIpsum();
|
|
```
|
|
|
|
### Generating Words
|
|
|
|
```php
|
|
echo '1 word: ' . $lipsum->word();
|
|
echo '5 words: ' . $lipsum->words(5);
|
|
```
|
|
|
|
### Generating Sentences
|
|
|
|
```php
|
|
echo '1 sentence: ' . $lipsum->sentence();
|
|
echo '5 sentences: ' . $lipsum->sentences(5);
|
|
```
|
|
|
|
### Generating Paragraphs
|
|
|
|
```php
|
|
echo '1 paragraph: ' . $lipsum->paragraph();
|
|
echo '5 paragraphs: ' . $lipsum->paragraphs(5);
|
|
```
|
|
|
|
### Wrapping Text with HTML Tags
|
|
|
|
If you would like to wrap the generated text with a tag, pass it as the second
|
|
parameter:
|
|
|
|
```php
|
|
echo $lipsum->paragraphs(3, 'p');
|
|
|
|
// Generates: <p>Lorem ipsum...</p><p>...</p><p>...</p>
|
|
```
|
|
|
|
Multiple tags can also be specified:
|
|
|
|
```php
|
|
echo $lipsum->sentences(3, ['article', 'p']);
|
|
|
|
// Generates: <article><p>...</p></article><article><p>...</p></article><article><p>...</p></article>
|
|
```
|
|
|
|
And you can back reference using `$1`:
|
|
|
|
```php
|
|
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>
|
|
```
|
|
|
|
### Return as an Array
|
|
|
|
Perhaps you want an array instead of a string:
|
|
|
|
```php
|
|
print_r($lipsum->wordsArray(5));
|
|
print_r($lipsum->sentencesArray(5));
|
|
print_r($lipsum->paragraphsArray(5));
|
|
```
|
|
|
|
You can still wrap with markup when returning an array:
|
|
|
|
```php
|
|
print_r($lipsum->wordsArray(5, 'li'));
|
|
```
|
|
|
|
## Assumptions
|
|
|
|
The first string generated will always start with the traditional "Lorem ipsum
|
|
dolor sit amet, consectetur adipiscing elit". Subsequent strings may contain
|
|
those words but will not explicitly start with them.
|
|
|
|
## Contributing
|
|
|
|
Suggestions and bug reports are always welcome, but karma points are earned for
|
|
pull requests.
|
|
|
|
Unit tests are required for all contributions. You can run the test suite from
|
|
the project's root directory simply by running `phpunit`.
|
|
|
|
## Credits
|
|
|
|
`php-loremipsum` was originally inspired by
|
|
[badcow/lorem-ipsum](https://packagist.org/packages/badcow/lorem-ipsum) with a
|
|
goal of being a dependency free lorem ipsum generator with flexible generation
|
|
options.
|
|
|
|
## License
|
|
|
|
MIT
|