Utilisation en ligne de commande
Prérequis
Rendre le fichier cssmin exécutable.
Sous Linux, on peut taper dans une console :
chmod +x cssmin
Sous Linux, on peut placer le fichier cssmin dans le dossier : /home/nom_de_votre_user/bin qui est dans le PATH ("echo $PATH" en console pour le constater) afin d'être appelable de partout.
Sous Windows, éditer le fichier cssmin, et remplacer la première
ligne :
#!/usr/bin/php
par le chemin vers votre exécutable PHP, par exemple :
#!c:\php5\php.exe
Liste des options
Pour les obtenir une aide et la liste des options disponibles,
faites :
cssmin -h
Exemples simples
Pour minifier le fichier style.css, rendez vous dans son dossier,
en console et faites :
cssmin style.css style-min.css
Cela créera le fichier style-min.css qui sera minifié.
Pour minifier dans le même fichier, faites :
cssmin -r style.css
Cela remplacera style.css par sa version minifiée.
Utilisation avancée
MAX CssMin est compatible avec les pipes. Cela signifie qu'il peut lire sur l'entrée standard et écrire sur la sortie standard.
Pour minifier le fichier style.css et écrire sur la sortie standard,
faites :
cssmin style.css
Pour rediriger cette sortie standard vers un fichier, par exemple
style-min.css, en l'écrasant s'il existe, faites :
cssmin style.css > style-min.css
Un exemple. Admettons que vous ayez les fichiers suivants : a.css, b.css et c.css.
Vous pouvez les concaténer en un seul fichier all.css minifié en
faisant :
cat a.css b.css c.css | cssmin > all.css
Ou bien :
cat *.css | cssmin > all.css
Utilisation en classe PHP
Il faut inclure le fichier MAX_CssMin.class.php contenant la classe MAX_CssMin et appeler la fonction statique MAX_CssMin::run().
Exemple :
<?php
require "MAX_CssMin.class.php";
// Admettons que $mon_css contienne le code CSS à minifier
$mon_css = " ... mon code CSS ... ";
$css_min = MAX_CssMin::run($mon_css);
// $css_min contient alors la version minifiée
?>
Vous pouvez consulter le fichier cssmin.php dans le répertoire exemples de l'archive pour un exemple à peine plus poussé.
