This a Linkify Laravel 5 supported package. Its converts URLs and email addresses into clickable links. It works on both snippets of HTML (or plain text) and complete HTML pages.
There are many regex variations shared on the internet for performing this task, but few are robust. Linkify contains a large number of unit tests to counter this.
It does not cover every possible valid-yet-never-used URLs and email addresses in order to handle 'real world' usage (eg no 'gopher://'). This means, for example, that it copes better with punctuation errors.
It uses regex based on John Gruber's Improved Liberal, Accurate Regex Pattern for Matching URLs.
1. Add Linkify to your dependencies:
// composer.json
{
// ...
"require": {
// ...
"nahid/linkify": "1.1.*"
}
}
2. Use Composer to download and install Linkify:
$ php composer.phar update Nahid/linkify
3. open config/app.php
and in providers array add this line
```php
Nahid\Linkify\LinkifyServiceProvider::class,
```
and in aliases array add this line too
```php
'Linkify' => Nahid\Linkify\Facades\Linkify::class,
```
4. Open terminal and goto your project and run this command
```
composer dump-autoload
```
$text = 'This is my text containing a link to www.example.com.';
echo Linkify::process($text);
Will output:
This is my text containing a link to <a href="http://www.example.com">www.example.com</a>.
Options set on the constructor will be applied to all links. Alternatively you can place the options on a method call. The latter will override the former.
$linkify = new \Nahid\Linkify\Linkify(array('attr' => array('class' => 'foo')));
$text = 'This is my text containing a link to www.example.com.';
echo $linkify->process($text);
Will output:
This is my text containing a link to <a href="http://www.example.com" class="foo">www.example.com</a>.
Whereas:
$linkify = new \Nahid\Linkify\Linkify(array('attr' => array('class' => 'foo')));
$text = 'This is my text containing a link to www.example.com.';
echo $linkify->process($text, array('attr' => array('class' => 'bar')));
Will output:
This is my text containing a link to <a href="http://www.example.com" class="bar">www.example.com</a>.
Available options are:
attr
An associative array of HTML attributes to add to the link. For example:
array('attr' => array('class' => 'foo', 'style' => 'font-weight: bold; color: red;')
callback
A closure to call with each url match. The closure will be called for each URL found with three parameters: the url, the caption and a boolean isEmail
(if $isEmail
is true, then $url
is equals to $caption
.
If the callback return a non-null value, this value replace the link in the resulting text. If null is returned, the usual <a href="URL">CAPTION</a>
is used.
$linkify = new \Nahid\Linkify\Linkify(array('callback' => function($url, $caption, $isEmail) {
return '<b>' . $caption . '</b>';
}));
echo $linkify->process('This link will be converted to bold: www.example.com.'));
Classes of Nahid Bin Azhar | > | PHP Link to HTML | > | Download .zip .tar.gz | > | Support forum | > | Blog | > | Latest changes |
|
|
Groups | Applications | Files |
Groups |
HTML | HTML generation and processing | View top rated classes |
PHP 5 | Classes using PHP 5 specific features | View top rated classes |
Text processing | Manipulating and validating text data | View top rated classes |
Parsers | Programming language interpreters and format parsers | View top rated classes |
Applications that use this package |
If you know an application of this package, send a message to the author to add a link here.
Files |
File | Role | Description | ||
---|---|---|---|---|
src (1 directory) | ||||
tests (1 file, 2 directories) | ||||
.travis.yml | Data | Auxiliary data | ||
CHANGELOG.md | Data | Auxiliary data | ||
composer.json | Data | Auxiliary data | ||
LICENSE | Lic. | License text | ||
phpunit.xml.dist | Data | Auxiliary data | ||
README.md | Doc. | Documentation |
Files | / | src | / | Nahid | / | Linkify |
File | Role | Description | ||
---|---|---|---|---|
Facades (1 file) | ||||
Linkify.php | Class | Class source | ||
LinkifyInterface.php | Class | Class source | ||
LinkifyServiceProvider.php | Class | Class source |
Files | / | tests |
File | Role | Description | ||
---|---|---|---|---|
data (7 files) | ||||
Misd (1 directory) | ||||
bootstrap.php | Aux. | Tests bootstrap script |
Files | / | tests | / | data |
File | Role | Description |
---|---|---|
callback.json | Data | Auxiliary data |
email-options.json | Data | Auxiliary data |
email.json | Data | Auxiliary data |
ignore-options.json | Data | Auxiliary data |
ignore.json | Data | Auxiliary data |
url-options.json | Data | Auxiliary data |
url.json | Data | Auxiliary data |
Files | / | tests | / | Misd | / | Linkify | / | Test |
File | Role | Description |
---|---|---|
CallbackTest.php | Class | Class source |
LinkifyTest.php | Class | Class source |
ProcessEmailsTest.php | Class | Class source |
ProcessTest.php | Class | Class source |
ProcessUrlsTest.php | Class | Class source |
Download all files: linkify.tar.gz linkify.zip NOTICE: if you are using a download manager program like 'GetRight', please Login before trying to download this archive.
|