rny/slugutf8

generate UTF-8 URL slug

1.0.1 2016-10-28 18:56 UTC

This package is not auto-updated.

Last update: 2024-06-08 18:21:57 UTC


README

Build Status

SlugUtf8 is a simple library to generate friendly URL slug from a UTF-8 string. It keeps most of the UTF-8 charaters unchanged to better support Chinese/Japanese. SlugUtf8 is modified from https://gist.github.com/sgmurphy/3098978

Highlights

  • Removes all special characters but keeps UTF-8 charaters unchanged.
  • Support Chinese / Japanese.
  • Dot between numbers is unchanged, e.g. 3.8.5
  • Composer ready, PSR-4 compatible.
  • PHPUnit tested.

Install

Install SlugUtf8 using Composer.

$ composer require rny/slugutf8

Usage

use Rny\SlugUtf8\SlugUtf8;

$slug = SlugUtf8::SlugUtf8($str);
$slug = \Rny\SlugUtf8\SlugUtf8::SlugUtf8($str);
$options = array(
    'delimiter' => '-',
    'limit' => null,
    'lowercase' => true,
    'replacements' => array(),
    'transliterate' => false,
    'strip_non_utf8' => false,
);
$slug = \Rny\SlugUtf8\SlugUtf8::SlugUtf8($str, $options);

Testing

$ composer test