Documentation du code de SPIP et de ses plugins

Compresseur

compresseur.php

Fonctions d'aide pour le compresseur

Table of Contents

Functions

compresseur_ecrire_balise_js_dist()  : string
Ecrire la balise javascript pour insérer le fichier compressé
compresseur_ecrire_balise_css_dist()  : string
Ecrire la balise CSS pour insérer le fichier compressé
compresseur_extraire_balises_css_dist()  : array<string|int, mixed>
Extraire les balises CSS à compacter
compresseur_extraire_balises_js_dist()  : array<string|int, mixed>
Extraire les balises JS à compacter
compacte_head_files()  : string
Compacter (concaténer+minifier) les fichiers format CSS ou JS du head.
compresseur_liste_fonctions_prepare_css()  : array<string|int, mixed>
Lister les fonctions de préparation des feuilles css avant minification
compresseur_callback_prepare_css()  : bool|int|null|string
Préparer un fichier CSS avant sa minification
compresseur_callback_prepare_css_inline()  : string
Préparer du contenu CSS inline avant minification
css_resolve_atimport()  : string
Resoudre et inliner les @import ceux-ci ne peuvent etre presents qu'en debut de CSS et on ne veut pas changer l'ordre des directives
css_regroup_atimport()  : bool|string
Regrouper les @import restants dans la CSS concatenee en debut de celle-ci
css_url_statique_ressources()  : mixed
Remplacer l'URL du site par une url de ressource genre static.example.org qui evite les echanges de cookie pour les ressources images (peut aussi etre l'URL d'un CDN ou autre provider de ressources statiques)

Functions

compresseur_ecrire_balise_js_dist()

Ecrire la balise javascript pour insérer le fichier compressé

compresseur_ecrire_balise_js_dist(string &$flux, int $pos, string $src[, string $comments = '' ]) : string

C'est cette fonction qui décide où il est le plus pertinent d'insérer le fichier, et dans quelle forme d'ecriture

Parameters
$flux : string

Contenu du head nettoyé des fichiers qui ont été compressé

$pos : int

Position initiale du premier fichier inclu dans le fichier compressé

$src : string

Nom du fichier compressé

$comments : string = ''

Commentaires à insérer devant

Return values
string

Code HTML de la balise <script>

compresseur_ecrire_balise_css_dist()

Ecrire la balise CSS pour insérer le fichier compressé

compresseur_ecrire_balise_css_dist(string &$flux, int $pos, string $src[, string $comments = '' ][, string $media = '' ]) : string

C'est cette fonction qui décide ou il est le plus pertinent d'insérer le fichier, et dans quelle forme d'écriture

Parameters
$flux : string

Contenu du head nettoyé des fichiers qui ont ete compressé

$pos : int

Position initiale du premier fichier inclu dans le fichier compressé

$src : string

Nom du fichier compressé

$comments : string = ''

Commentaires à insérer devant

$media : string = ''

Type de media si précisé (print|screen...)

Return values
string

Code HTML de la balise

compresseur_extraire_balises_css_dist()

Extraire les balises CSS à compacter

compresseur_extraire_balises_css_dist(string $flux, string $url_base) : array<string|int, mixed>
Parameters
$flux : string

Contenu HTML dont on extrait les balises CSS

$url_base : string
Return values
array<string|int, mixed>

Couples (balise => src)

compresseur_extraire_balises_js_dist()

Extraire les balises JS à compacter

compresseur_extraire_balises_js_dist(string $flux, string $url_base) : array<string|int, mixed>
Parameters
$flux : string

Contenu HTML dont on extrait les balises CSS

$url_base : string
Return values
array<string|int, mixed>

Couples (balise => src)

compacte_head_files()

Compacter (concaténer+minifier) les fichiers format CSS ou JS du head.

compacte_head_files(string $flux, string $format) : string

Repérer fichiers statiques vs. url squelettes Compacte le tout dans un fichier statique posé dans local/

Parameters
$flux : string

Contenu du de la page html

$format : string

css ou js

Return values
string

Contenu compressé du de la page html

compresseur_liste_fonctions_prepare_css()

Lister les fonctions de préparation des feuilles css avant minification

compresseur_liste_fonctions_prepare_css() : array<string|int, mixed>
Return values
array<string|int, mixed>

Liste des fonctions à appliquer sur les feuilles CSS

compresseur_callback_prepare_css()

Préparer un fichier CSS avant sa minification

& compresseur_callback_prepare_css(string &$css[, bool|string $is_inline = false ][, string $fonctions = null ]) : bool|int|null|string
Parameters
$css : string
$is_inline : bool|string = false
$fonctions : string = null
Return values
bool|int|null|string

compresseur_callback_prepare_css_inline()

Préparer du contenu CSS inline avant minification

& compresseur_callback_prepare_css_inline(string &$contenu, string $url_base[, string $filename = '' ][, array<string|int, mixed> $fonctions = null ]) : string
Parameters
$contenu : string

contenu de la CSS

$url_base : string

url de la CSS ou de la page si c'est un style inline

$filename : string = ''

nom du fichier de la CSS (ou vide si c'est un style inline)

$fonctions : array<string|int, mixed> = null

liste des fonctions appliquees a la CSS

Return values
string

css_resolve_atimport()

Resoudre et inliner les @import ceux-ci ne peuvent etre presents qu'en debut de CSS et on ne veut pas changer l'ordre des directives

css_resolve_atimport(string $contenu, string $url_base, string $filename) : string
Parameters
$contenu : string
$url_base : string
$filename : string
Return values
string

css_regroup_atimport()

Regrouper les @import restants dans la CSS concatenee en debut de celle-ci

css_regroup_atimport(string $nom_tmp, string $nom) : bool|string
Parameters
$nom_tmp : string
$nom : string
Return values
bool|string

css_url_statique_ressources()

Remplacer l'URL du site par une url de ressource genre static.example.org qui evite les echanges de cookie pour les ressources images (peut aussi etre l'URL d'un CDN ou autre provider de ressources statiques)

css_url_statique_ressources(string $contenu, string $url_base, string $filename) : mixed
Parameters
$contenu : string
$url_base : string
$filename : string

        
On this page

Search results