awps/font-awesome-php

A PHP library for Font Awesome.

A PHP library for Font Awesome.

This repository contains the necessary data to work with Font Awesome in PHP., _(*1)

Requirements: * Font Awesome 4.7.0 * PHP 5.3+., _(*2)

License * MIT - Details, _(*3)

Installation

With composer:

composer require awps/font-awesome-php

Manually:

require_once 'src/load.php';

Usage

The library contains 2 main classes that are created for public: * Awps\FontAwesome() - Uses a static array of FA icons.(Recommended) * Awps\FontAwesomeReader( $css_path ) - Generates the array from font-awesome.css file. You must define the path to this file., _(*4)

Create an instance:, _(*5)

// Using the reader to dynamically get the icons array. It's resource intensive and you must cache the result.
$css_path = __DIR__ . '/css/font-awesome.css';
$icons    = new Awps\FontAwesomeReader( $css_path );

// .... or better use the static class

$icons = new Awps\FontAwesome();

Next it's easy. You can get the array of icons just by doing this., _(*6)

$icons->getArray();

// Result:
/*
array (
  'fa-glass' => '\\f000',
  'fa-music' => '\\f001',
  'fa-search' => '\\f002',
  ...
*/

API:

->getAllData()

$icons->getAllData();

// Result:
/*
array (
  'fa-glass' => 
  array (
    'unicode' => '\\f000',
    'name' => 'Glass',
    'class' => 'fa-glass',
  ),
  'fa-music' => 
  array (
    'unicode' => '\\f001',
    'name' => 'Music',
    'class' => 'fa-music',
  ),
  ...
*/

->getCssClasses()

$icons->getCssClasses();

// Result:
/*
array (
  'fa-glass' => 'fa-glass',
  'fa-music' => 'fa-music',
  'fa-search' => 'fa-search',
  ...
*/

->getUnicodeKeys()

$icons->getUnicodeKeys();

// Result:
/*
array (
  'fa-glass' => '\\f000',
  'fa-music' => '\\f001',
  'fa-search' => '\\f002',
  'fa-envelope-o' => '\\f003',
  ...
*/

->getReadableNames()

$icons->getReadableNames();

// Result:
/*
array (
  'fa-glass' => 'Glass',
  'fa-music' => 'Music',
  'fa-search' => 'Search',
  ...
*/

->sortByName()

Attention: This modifies the original array. You can reset it back using ->reset() method., _(*7)

$icons->sortByName();

// Result:
/*
array (
  'fa-500px' => '\\f26e',
  'fa-address-book' => '\\f2b9',
  'fa-address-book-o' => '\\f2ba',
  'fa-address-card' => '\\f2bb',
  'fa-address-card-o' => '\\f2bc',
  'fa-adjust' => '\\f042',
  ...
*/

Utilities:

->total()

Return the total number of icons from original array., _(*8)

->getIconUnicode( $icon_class )

Get the unicode by icon class., _(*9)

Example:, _(*10)

$icons->getIconUnicode( 'fa-address-card' );

// Result
// '\f2bb'

->getIconName( $icon_class )

Get the readable icon name by class., _(*11)

Example:, _(*12)

$icons->getIconName( 'fa-address-card' );

// Result
// 'Address card'

->getIcon( $icon_class )

Get the details of a single icon by class., _(*13)

Example:, _(*14)

$icons->getIcon( 'fa-address-card' );

// Result
/*
array (
  'unicode' => '\\f2bb',
  'name' => 'Address card',
  'class' => 'fa-address-card',
)
*/

->getIconByUnicode( $unicode )

Get the details of a single icon by unicode., _(*15)

Example:, _(*16)

$icons->getIconByUnicode( '\\f004' )

// Result
/*
array (
  'unicode' => '\\f004',
  'name' => 'Heart',
  'class' => 'fa-heart',
)
*/

->reset()

Reset the current array to its original state, _(*17)

Example:, _(*18)

$icons->sortByName();

// Array is sorted:
$icons->getArray();

/*
array (
  'fa-500px' => '\\f26e',
  'fa-address-book' => '\\f2b9',
  'fa-address-book-o' => '\\f2ba',
  'fa-address-card' => '\\f2bb',
  ...
);
*/

// Reset it
$icons->reset();

// This one will return the original array
$icons->getArray();

// Result:
/*
array (
  'fa-glass' => '\\f000',
  'fa-music' => '\\f001',
  'fa-search' => '\\f002',
  ...
);
*/