# lib_autolink - PHP HTML link formatting library

[![Build Status](https://github.com/iamcal/lib_autolink/actions/workflows/php.yml/badge.svg)](https://github.com/iamcal/lib_autolink/actions)
[![Latest Stable Version](http://img.shields.io/packagist/v/iamcal/lib_autolink.svg?style=flat)](https://packagist.org/packages/iamcal/lib_autolink)

Find URLs in HTML that are not already links, and make them into links.

Looking to do this in JavaScript? https://github.com/iamcal/autolink-js


## Usage

    include('lib_autolink.php');


    # simple mode
    $html = autolink($html);

    # truncate URLs longer than 20 characters
    $html = autolink($html, 20);

    # insert some magic into the <a> tags
    $html = autolink($html, 30, ' class="mylink"');

    # By default if the display url is truncated, a title attribute is added to the link, if you don't want this, add a 4th parameter of false
    $html = autolink($html, 30, ' class="mylink"', false);

    # link up email address
    $html = autolink_email($html);


## Testing

If you have perl's <a href="http://search.cpan.org/dist/Test-Harness/">Test::Harness</a> installed (you almost certainly do), you can 
run the tests using:

    prove --exec 'php' t/*.t