2017 © Pedro Peláez
 

library asset

* PHP library for handling styles and scripts: Add, minify, unify and print.

image

josantonius/asset

* PHP library for handling styles and scripts: Add, minify, unify and print.

  • PHP
  • 2 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 8 Versions
  • 12 % Grown

The README.md

PHP Asset library

Latest Stable Version License Total Downloads CI CodeCov PSR1 PSR4 PSR12, (*1)

Translations: Español, (*2)

PHP library for handling HTML links and scripts., (*3)

Requirements

  • Operating System: Linux | Windows., (*4)

  • PHP versions: 8.1 | 8.2., (*5)

Installation

The preferred way to install this extension is through Composer., (*6)

To install PHP Asset library, simply:, (*7)

composer require josantonius/asset

The previous command will only install the necessary files, if you prefer to download the entire source code you can use:, (*8)

composer require josantonius/asset --prefer-source

You can also clone the complete repository with Git:, (*9)

git clone https://github.com/josantonius/php-asset.git

Available Classes

Asset Class

Josantonius\Asset\Asset, (*10)

Print the added scripts for the body:, (*11)

public function outputBodyScripts(): string;

Print the added scripts for the head:, (*12)

public function outputHeadScripts(): string;

Print the added links:, (*13)

public function outputLinks(): string;

Asset Facade

Josantonius\Asset\Facades\Asset, (*14)

Add body script:, (*15)

/**
 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script
 */
public static function addBodyScript(
    null|bool   $async          = null,
    null|string $crossorigin    = null,
    null|bool   $defer          = null,
    null|string $fetchpriority  = null,
    null|string $integrity      = null,
    null|bool   $nomodule       = null,
    null|string $nonce          = null,
    null|string $referrerpolicy = null,
    null|string $src            = null,
    null|string $type           = null
): BodyScript;

Add head script:, (*16)

/**
 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script
 */
public static function addHeadScript(
    null|bool   $async          = null,
    null|string $crossorigin    = null,
    null|bool   $defer          = null,
    null|string $fetchpriority  = null,
    null|string $integrity      = null,
    null|bool   $nomodule       = null,
    null|string $nonce          = null,
    null|string $referrerpolicy = null,
    null|string $src            = null,
    null|string $type           = null
): HeadScript;

Add link:, (*17)

/**
 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/link
 */
public static function addLink(
    null|string $as             = null,
    null|string $crossorigin    = null,
    null|bool   $disabled       = null,
    null|string $fetchpriority  = null,
    null|string $href           = null,
    null|string $hreflang       = null,
    null|string $imagesizes     = null,
    null|string $imagesrcset    = null,
    null|string $integrity      = null,
    null|string $media          = null,
    null|string $prefetch       = null,
    null|string $referrerpolicy = null,
    null|string $rel            = null,
    null|string $sizes          = null,
    null|string $target         = null,
    null|string $title          = null,
    null|string $type           = null,
): Link;

Print the added scripts for the body:, (*18)

public static function outputBodyScripts(): string;

Print the added scripts for the head:, (*19)

public static function outputHeadScripts(): string;

Print the added links:, (*20)

public static function outputLinks(): string;

BodyScript Class

Josantonius\Asset\Elements\BodyScript, (*21)

Add body script:, (*22)

/**
 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script
 */
public function __construct(
    private null|bool   $async          = null,
    private null|string $crossorigin    = null,
    private null|bool   $defer          = null,
    private null|string $fetchpriority  = null,
    private null|string $integrity      = null,
    private null|bool   $nomodule       = null,
    private null|string $nonce          = null,
    private null|string $referrerpolicy = null,
    private null|string $src            = null,
    private null|string $type           = null
);

HeadScript Class

Josantonius\Asset\Elements\HeadScript, (*23)

Add head script:, (*24)

/**
 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script
 */
public function __construct(
    private null|bool   $async          = null,
    private null|string $crossorigin    = null,
    private null|bool   $defer          = null,
    private null|string $fetchpriority  = null,
    private null|string $integrity      = null,
    private null|bool   $nomodule       = null,
    private null|string $nonce          = null,
    private null|string $referrerpolicy = null,
    private null|string $src            = null,
    private null|string $type           = null
);

Josantonius\Asset\Elements\Link, (*25)

Add link:, (*26)

/**
 * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/link
 */
public function __construct(
    private null|string $as             = null,
    private null|string $crossorigin    = null,
    private null|bool   $disabled       = null,
    private null|string $fetchpriority  = null,
    private null|string $href           = null,
    private null|string $hreflang       = null,
    private null|string $imagesizes     = null,
    private null|string $imagesrcset    = null,
    private null|string $integrity      = null,
    private null|string $media          = null,
    private null|string $prefetch       = null,
    private null|string $referrerpolicy = null,
    private null|string $rel            = null,
    private null|string $sizes          = null,
    private null|string $target         = null,
    private null|string $title          = null,
    private null|string $type           = null,
);

Usage

Example of use for this library:, (*27)

Add body script

use Josantonius\Asset\Elements\BodyScript;

new BodyScript(
    src: 'https://example.com/script.js'
);

use Josantonius\Asset\Facades\Asset;

Asset::addBodyScript(
    src: 'script.js',
    type: 'text/javascript'
);

Add head script

use Josantonius\Asset\Elements\HeadScript;

new HeadScript(
    src: 'script.js',
    type: 'module'
);

use Josantonius\Asset\Facades\Asset;

Asset::addHeadScript(
    crossorigin: 'anonymous',
    defer: true,
    integrity: 'sha256-n9+',
    src: 'https://example.com/script.js',
    type: 'text/javascript'
);

use Josantonius\Asset\Elements\Link;

new Link(
    crossorigin: 'anonymous',
    href: 'https://example.com/style.css',
    integrity: 'sha256-n9+',
    media: 'all',
    rel: 'stylesheet'
);

use Josantonius\Asset\Facades\Asset;

Asset::addLink(
    href: 'https://example.com/style.css',
    rel: 'stylesheet'
);

Print the added scripts for the body

use Josantonius\Asset\Asset;

$asset = new Asset();

echo $asset->outputBodyScripts();

use Josantonius\Asset\Facades\Asset;

echo Asset::outputBodyScripts();

use Josantonius\Asset\Asset;

$asset = new Asset();

echo $asset->outputHeadScripts();

use Josantonius\Asset\Facades\Asset;

echo Asset::outputHeadScripts();

use Josantonius\Asset\Asset;

$asset = new Asset();

echo $asset->outputLinks();

use Josantonius\Asset\Facades\Asset;

echo Asset::outputLinks();

Full example

index.php, (*28)

use Josantonius\Asset\Elements\Link;
use Josantonius\Asset\Elements\BodyScript;
use Josantonius\Asset\Elements\HeadScript;

new BodyScript(src: 'foo.js', async: true);
new BodyScript(src: 'bar.js', type: 'text/javascript');

new HeadScript(src: 'https://example.com/foo.js', type: 'module');
new HeadScript(src: 'https://example.com/bar.js', defer: true);

new Link(href: 'https://example.com/foo.css', rel: 'stylesheet');
new Link(href: 'https://example.com/bar.css', rel: 'stylesheet', media: 'all');

page.html, (*29)

<?php
use Josantonius\Asset\Asset;
$asset = new Asset();
?>
<html>
  <head>
    <?= $asset->outputLinks() ?>
    <?= $asset->outputHeadScripts() ?>
  </head>
  <body>
    <?= $asset->outputBodyScripts() ?>
  </body>
</html>

Result:, (*30)

<html>
  <head>
    <link href="https://example.com/foo.css" rel="stylesheet">
    <link href="https://example.com/bar.css" rel="stylesheet" media="all">
    <script src="https://example.com/foo.js" type="module"></script>
    <script defer src="https://example.com/bar.js"></script>
  </head>
  <body>
    <script async src="foo.js"></script>
    <script src="bar.js" type="text/javascript"></script>
  </body>
</html>

Full example using the facade

index.php, (*31)

use Josantonius\Asset\Facades\Asset;

Asset::addBodyScript(src: 'foo.js', async: true);
Asset::addBodyScript(src: 'bar.js', type: 'text/javascript');

Asset::addHeadScript(src: 'https://example.com/foo.js', type: 'module');
Asset::addHeadScript(src: 'https://example.com/bar.js', defer: true);

Asset::addLink(href: 'https://example.com/foo.css', rel: 'stylesheet');
Asset::addLink(href: 'https://example.com/bar.css', rel: 'stylesheet', media: 'all');

page.html, (*32)

<?php
use Josantonius\Asset\Facades\Asset;
?>
<html>
  <head>
    <?= Asset::outputLinks() ?>
    <?= Asset::outputHeadScripts() ?>
  </head>
  <body>
    <?= Asset::outputBodyScripts() ?>
  </body>
</html>

Result:, (*33)

<html>
  <head>
    <link href="https://example.com/foo.css" rel="stylesheet">
    <link href="https://example.com/bar.css" rel="stylesheet" media="all">
    <script src="https://example.com/foo.js" type="module"></script>
    <script defer src="https://example.com/bar.js"></script>
  </head>
  <body>
    <script async src="foo.js"></script>
    <script src="bar.js" type="text/javascript"></script>
  </body>
</html>

Tests

To run tests you just need composer and to execute the following:, (*34)

git clone https://github.com/josantonius/php-asset.git

cd php-asset

composer install

Run unit tests with PHPUnit:, (*35)

composer phpunit

Run code standard tests with PHPCS:, (*36)

composer phpcs

Run PHP Mess Detector tests to detect inconsistencies in code style:, (*37)

composer phpmd

Run all previous tests:, (*38)

composer tests

TODO

  • [ ] Add new feature
  • [ ] Improve tests
  • [ ] Improve documentation
  • [ ] Improve English translation in the README file
  • [ ] Refactor code for disabled code style rules (see phpmd.xml and phpcs.xml)
  • [ ] Add other HTML elements
  • [ ] Add feature to add code between the <script> tags

Changelog

Detailed changes for each release are documented in the release notes., (*39)

Contribution

Please make sure to read the Contributing Guide, before making a pull request, start a discussion or report a issue., (*40)

Thanks to all contributors! :heart:, (*41)

If this project helps you to reduce your development time, you can sponsor me to support my open source work :blush:, (*42)

License

This repository is licensed under the MIT License., (*43)

Copyright © 2016-present, Josantonius, (*44)

The Versions

06/01 2018

dev-master

9999999-dev

* PHP library for handling styles and scripts: Add, minify, unify and print.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Josantonius

css php asset js hhvm minify print styles scripts load resources unify

06/01 2018

1.1.7

1.1.7.0

* PHP library for handling styles and scripts: Add, minify, unify and print.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Josantonius

css php asset js hhvm minify print styles scripts load resources unify

12/11 2017

1.1.6

1.1.6.0

* PHP library for handling styles and scripts: Add, minify, unify and print.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Josantonius

css php asset js hhvm minify print styles scripts load resources unify

30/10 2017

1.1.5

1.1.5.0

* PHP library for handling styles and scripts: Add, minify, unify and print.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Avatar Josantonius

css php asset js hhvm minify print styles scripts load resources unify

18/09 2017

1.1.4

1.1.4.0

PHP library for save CSS and JS files to be displayed in same place.

  Sources   Download

MIT

The Requires

  • php ^5.6 || ^7.0

 

The Development Requires

by Avatar Josantonius

css php asset js hhvm load resources

18/07 2017

1.1.3

1.1.3.0

PHP library for save CSS and JS files to be displayed in same place.

  Sources   Download

MIT

The Requires

  • php ^5.6 || ^7.0

 

by Avatar Josantonius

css php asset js hhvm load resources

18/03 2017

1.1.2

1.1.2.0

PHP library for save CSS and JS files to be displayed in same place.

  Sources   Download

MIT

The Requires

  • php ^5.6 || ^7.0

 

by Avatar Josantonius

css php asset js hhvm load resources

14/12 2016

1.0.0

1.0.0.0

PHP library for save CSS and JS files to be displayed in same place.

  Sources   Download

MIT

The Requires

  • php >=7.0

 

by Avatar Josantonius

css php asset js hhvm load resources