533 lines
20 KiB
PHP
Executable File
533 lines
20 KiB
PHP
Executable File
<?php
|
|
/**
|
|
* Class Minify
|
|
* @package Minify
|
|
*/
|
|
|
|
/**
|
|
* Minify_Source
|
|
*/
|
|
require_once 'Minify/Source.php';
|
|
|
|
/**
|
|
* Minify - Combines, minifies, and caches JavaScript and CSS files on demand.
|
|
*
|
|
* See README for usage instructions (for now).
|
|
*
|
|
* This library was inspired by {@link mailto:flashkot@mail.ru jscsscomp by Maxim Martynyuk}
|
|
* and by the article {@link http://www.hunlock.com/blogs/Supercharged_Javascript "Supercharged JavaScript" by Patrick Hunlock}.
|
|
*
|
|
* Requires PHP 5.1.0.
|
|
* Tested on PHP 5.1.6.
|
|
*
|
|
* @package Minify
|
|
* @author Ryan Grove <ryan@wonko.com>
|
|
* @author Stephen Clay <steve@mrclay.org>
|
|
* @copyright 2008 Ryan Grove, Stephen Clay. All rights reserved.
|
|
* @license http://opensource.org/licenses/bsd-license.php New BSD License
|
|
* @link http://code.google.com/p/minify/
|
|
*/
|
|
class Minify {
|
|
|
|
const VERSION = '2.1.3';
|
|
const TYPE_CSS = 'text/css';
|
|
const TYPE_HTML = 'text/html';
|
|
// there is some debate over the ideal JS Content-Type, but this is the
|
|
// Apache default and what Yahoo! uses..
|
|
const TYPE_JS = 'application/x-javascript';
|
|
|
|
/**
|
|
* How many hours behind are the file modification times of uploaded files?
|
|
*
|
|
* If you upload files from Windows to a non-Windows server, Windows may report
|
|
* incorrect mtimes for the files. Immediately after modifying and uploading a
|
|
* file, use the touch command to update the mtime on the server. If the mtime
|
|
* jumps ahead by a number of hours, set this variable to that number. If the mtime
|
|
* moves back, this should not be needed.
|
|
*
|
|
* @var int $uploaderHoursBehind
|
|
*/
|
|
public static $uploaderHoursBehind = 0;
|
|
|
|
/**
|
|
* If this string is not empty AND the serve() option 'bubbleCssImports' is
|
|
* NOT set, then serve() will check CSS files for @import declarations that
|
|
* appear too late in the combined stylesheet. If found, serve() will prepend
|
|
* the output with this warning.
|
|
*
|
|
* @var string $importWarning
|
|
*/
|
|
public static $importWarning = "/* See http://code.google.com/p/minify/wiki/CommonProblems#@imports_can_appear_in_invalid_locations_in_combined_CSS_files */\n";
|
|
|
|
/**
|
|
* Specify a cache object (with identical interface as Minify_Cache_File) or
|
|
* a path to use with Minify_Cache_File.
|
|
*
|
|
* If not called, Minify will not use a cache and, for each 200 response, will
|
|
* need to recombine files, minify and encode the output.
|
|
*
|
|
* @param mixed $cache object with identical interface as Minify_Cache_File or
|
|
* a directory path, or null to disable caching. (default = '')
|
|
*
|
|
* @param bool $fileLocking (default = true) This only applies if the first
|
|
* parameter is a string.
|
|
*
|
|
* @return null
|
|
*/
|
|
public static function setCache($cache = '', $fileLocking = true)
|
|
{
|
|
if (is_string($cache)) {
|
|
require_once 'Minify/Cache/File.php';
|
|
self::$_cache = new Minify_Cache_File($cache, $fileLocking);
|
|
} else {
|
|
self::$_cache = $cache;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Serve a request for a minified file.
|
|
*
|
|
* Here are the available options and defaults in the base controller:
|
|
*
|
|
* 'isPublic' : send "public" instead of "private" in Cache-Control
|
|
* headers, allowing shared caches to cache the output. (default true)
|
|
*
|
|
* 'quiet' : set to true to have serve() return an array rather than sending
|
|
* any headers/output (default false)
|
|
*
|
|
* 'encodeOutput' : set to false to disable content encoding, and not send
|
|
* the Vary header (default true)
|
|
*
|
|
* 'encodeMethod' : generally you should let this be determined by
|
|
* HTTP_Encoder (leave null), but you can force a particular encoding
|
|
* to be returned, by setting this to 'gzip' or '' (no encoding)
|
|
*
|
|
* 'encodeLevel' : level of encoding compression (0 to 9, default 9)
|
|
*
|
|
* 'contentTypeCharset' : appended to the Content-Type header sent. Set to a falsey
|
|
* value to remove. (default 'utf-8')
|
|
*
|
|
* 'maxAge' : set this to the number of seconds the client should use its cache
|
|
* before revalidating with the server. This sets Cache-Control: max-age and the
|
|
* Expires header. Unlike the old 'setExpires' setting, this setting will NOT
|
|
* prevent conditional GETs. Note this has nothing to do with server-side caching.
|
|
*
|
|
* 'rewriteCssUris' : If true, serve() will automatically set the 'currentDir'
|
|
* minifier option to enable URI rewriting in CSS files (default true)
|
|
*
|
|
* 'bubbleCssImports' : If true, all @import declarations in combined CSS
|
|
* files will be move to the top. Note this may alter effective CSS values
|
|
* due to a change in order. (default false)
|
|
*
|
|
* 'debug' : set to true to minify all sources with the 'Lines' controller, which
|
|
* eases the debugging of combined files. This also prevents 304 responses.
|
|
* @see Minify_Lines::minify()
|
|
*
|
|
* 'minifiers' : to override Minify's default choice of minifier function for
|
|
* a particular content-type, specify your callback under the key of the
|
|
* content-type:
|
|
* <code>
|
|
* // call customCssMinifier($css) for all CSS minification
|
|
* $options['minifiers'][Minify::TYPE_CSS] = 'customCssMinifier';
|
|
*
|
|
* // don't minify Javascript at all
|
|
* $options['minifiers'][Minify::TYPE_JS] = '';
|
|
* </code>
|
|
*
|
|
* 'minifierOptions' : to send options to the minifier function, specify your options
|
|
* under the key of the content-type. E.g. To send the CSS minifier an option:
|
|
* <code>
|
|
* // give CSS minifier array('optionName' => 'optionValue') as 2nd argument
|
|
* $options['minifierOptions'][Minify::TYPE_CSS]['optionName'] = 'optionValue';
|
|
* </code>
|
|
*
|
|
* 'contentType' : (optional) this is only needed if your file extension is not
|
|
* js/css/html. The given content-type will be sent regardless of source file
|
|
* extension, so this should not be used in a Groups config with other
|
|
* Javascript/CSS files.
|
|
*
|
|
* Any controller options are documented in that controller's setupSources() method.
|
|
*
|
|
* @param mixed instance of subclass of Minify_Controller_Base or string name of
|
|
* controller. E.g. 'Files'
|
|
*
|
|
* @param array $options controller/serve options
|
|
*
|
|
* @return mixed null, or, if the 'quiet' option is set to true, an array
|
|
* with keys "success" (bool), "statusCode" (int), "content" (string), and
|
|
* "headers" (array).
|
|
*/
|
|
public static function serve($controller, $options = array())
|
|
{
|
|
if (is_string($controller)) {
|
|
// make $controller into object
|
|
$class = 'Minify_Controller_' . $controller;
|
|
if (! class_exists($class, false)) {
|
|
require_once "Minify/Controller/"
|
|
. str_replace('_', '/', $controller) . ".php";
|
|
}
|
|
$controller = new $class();
|
|
}
|
|
|
|
// set up controller sources and mix remaining options with
|
|
// controller defaults
|
|
$options = $controller->setupSources($options);
|
|
$options = $controller->analyzeSources($options);
|
|
self::$_options = $controller->mixInDefaultOptions($options);
|
|
|
|
// check request validity
|
|
if (! $controller->sources) {
|
|
// invalid request!
|
|
if (! self::$_options['quiet']) {
|
|
header(self::$_options['badRequestHeader']);
|
|
echo self::$_options['badRequestHeader'];
|
|
return;
|
|
} else {
|
|
list(,$statusCode) = explode(' ', self::$_options['badRequestHeader']);
|
|
return array(
|
|
'success' => false
|
|
,'statusCode' => (int)$statusCode
|
|
,'content' => ''
|
|
,'headers' => array()
|
|
);
|
|
}
|
|
}
|
|
|
|
self::$_controller = $controller;
|
|
|
|
if (self::$_options['debug']) {
|
|
self::_setupDebug($controller->sources);
|
|
self::$_options['maxAge'] = 0;
|
|
}
|
|
|
|
// determine encoding
|
|
if (self::$_options['encodeOutput']) {
|
|
if (self::$_options['encodeMethod'] !== null) {
|
|
// controller specifically requested this
|
|
$contentEncoding = self::$_options['encodeMethod'];
|
|
} else {
|
|
// sniff request header
|
|
require_once 'HTTP/Encoder.php';
|
|
// depending on what the client accepts, $contentEncoding may be
|
|
// 'x-gzip' while our internal encodeMethod is 'gzip'. Calling
|
|
// getAcceptedEncoding(false, false) leaves out compress and deflate as options.
|
|
list(self::$_options['encodeMethod'], $contentEncoding) = HTTP_Encoder::getAcceptedEncoding(false, false);
|
|
}
|
|
} else {
|
|
self::$_options['encodeMethod'] = ''; // identity (no encoding)
|
|
}
|
|
|
|
// check client cache
|
|
require_once 'HTTP/ConditionalGet.php';
|
|
$cgOptions = array(
|
|
'lastModifiedTime' => self::$_options['lastModifiedTime']
|
|
,'isPublic' => self::$_options['isPublic']
|
|
,'encoding' => self::$_options['encodeMethod']
|
|
);
|
|
if (self::$_options['maxAge'] > 0) {
|
|
$cgOptions['maxAge'] = self::$_options['maxAge'];
|
|
}
|
|
$cg = new HTTP_ConditionalGet($cgOptions);
|
|
if ($cg->cacheIsValid) {
|
|
// client's cache is valid
|
|
if (! self::$_options['quiet']) {
|
|
$cg->sendHeaders();
|
|
return;
|
|
} else {
|
|
return array(
|
|
'success' => true
|
|
,'statusCode' => 304
|
|
,'content' => ''
|
|
,'headers' => $cg->getHeaders()
|
|
);
|
|
}
|
|
} else {
|
|
// client will need output
|
|
$headers = $cg->getHeaders();
|
|
unset($cg);
|
|
}
|
|
|
|
if (self::$_options['contentType'] === self::TYPE_CSS
|
|
&& self::$_options['rewriteCssUris']) {
|
|
reset($controller->sources);
|
|
while (list($key, $source) = each($controller->sources)) {
|
|
if ($source->filepath
|
|
&& !isset($source->minifyOptions['currentDir'])
|
|
&& !isset($source->minifyOptions['prependRelativePath'])
|
|
) {
|
|
$source->minifyOptions['currentDir'] = dirname($source->filepath);
|
|
}
|
|
}
|
|
}
|
|
|
|
// check server cache
|
|
if (null !== self::$_cache) {
|
|
// using cache
|
|
// the goal is to use only the cache methods to sniff the length and
|
|
// output the content, as they do not require ever loading the file into
|
|
// memory.
|
|
$cacheId = 'minify_' . self::_getCacheId();
|
|
$fullCacheId = (self::$_options['encodeMethod'])
|
|
? $cacheId . '.gz'
|
|
: $cacheId;
|
|
// check cache for valid entry
|
|
$cacheIsReady = self::$_cache->isValid($fullCacheId, self::$_options['lastModifiedTime']);
|
|
if ($cacheIsReady) {
|
|
$cacheContentLength = self::$_cache->getSize($fullCacheId);
|
|
} else {
|
|
// generate & cache content
|
|
$content = self::_combineMinify();
|
|
self::$_cache->store($cacheId, $content);
|
|
if (function_exists('gzencode')) {
|
|
self::$_cache->store($cacheId . '.gz', gzencode($content, self::$_options['encodeLevel']));
|
|
}
|
|
}
|
|
} else {
|
|
// no cache
|
|
$cacheIsReady = false;
|
|
$content = self::_combineMinify();
|
|
}
|
|
if (! $cacheIsReady && self::$_options['encodeMethod']) {
|
|
// still need to encode
|
|
$content = gzencode($content, self::$_options['encodeLevel']);
|
|
}
|
|
|
|
// add headers
|
|
$headers['Content-Length'] = $cacheIsReady
|
|
? $cacheContentLength
|
|
: strlen($content);
|
|
$headers['Content-Type'] = self::$_options['contentTypeCharset']
|
|
? self::$_options['contentType'] . '; charset=' . self::$_options['contentTypeCharset']
|
|
: self::$_options['contentType'];
|
|
if (self::$_options['encodeMethod'] !== '') {
|
|
$headers['Content-Encoding'] = $contentEncoding;
|
|
}
|
|
if (self::$_options['encodeOutput']) {
|
|
$headers['Vary'] = 'Accept-Encoding';
|
|
}
|
|
|
|
if (! self::$_options['quiet']) {
|
|
// output headers & content
|
|
foreach ($headers as $name => $val) {
|
|
header($name . ': ' . $val);
|
|
}
|
|
if ($cacheIsReady) {
|
|
self::$_cache->display($fullCacheId);
|
|
} else {
|
|
echo $content;
|
|
}
|
|
} else {
|
|
return array(
|
|
'success' => true
|
|
,'statusCode' => 200
|
|
,'content' => $cacheIsReady
|
|
? self::$_cache->fetch($fullCacheId)
|
|
: $content
|
|
,'headers' => $headers
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Return combined minified content for a set of sources
|
|
*
|
|
* No internal caching will be used and the content will not be HTTP encoded.
|
|
*
|
|
* @param array $sources array of filepaths and/or Minify_Source objects
|
|
*
|
|
* @param array $options (optional) array of options for serve. By default
|
|
* these are already set: quiet = true, encodeMethod = '', lastModifiedTime = 0.
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function combine($sources, $options = array())
|
|
{
|
|
$cache = self::$_cache;
|
|
self::$_cache = null;
|
|
$options = array_merge(array(
|
|
'files' => (array)$sources
|
|
,'quiet' => true
|
|
,'encodeMethod' => ''
|
|
,'lastModifiedTime' => 0
|
|
), $options);
|
|
$out = self::serve('Files', $options);
|
|
self::$_cache = $cache;
|
|
return $out['content'];
|
|
}
|
|
|
|
/**
|
|
* On IIS, create $_SERVER['DOCUMENT_ROOT']
|
|
*
|
|
* @param bool $unsetPathInfo (default false) if true, $_SERVER['PATH_INFO']
|
|
* will be unset (it is inconsistent with Apache's setting)
|
|
*
|
|
* @return null
|
|
*/
|
|
public static function setDocRoot($unsetPathInfo = false)
|
|
{
|
|
if (isset($_SERVER['SERVER_SOFTWARE'])
|
|
&& 0 === strpos($_SERVER['SERVER_SOFTWARE'], 'Microsoft-IIS/')
|
|
) {
|
|
$_SERVER['DOCUMENT_ROOT'] = rtrim(substr(
|
|
$_SERVER['PATH_TRANSLATED']
|
|
,0
|
|
,strlen($_SERVER['PATH_TRANSLATED']) - strlen($_SERVER['SCRIPT_NAME'])
|
|
), '\\');
|
|
if ($unsetPathInfo) {
|
|
unset($_SERVER['PATH_INFO']);
|
|
}
|
|
require_once 'Minify/Logger.php';
|
|
Minify_Logger::log("setDocRoot() set DOCUMENT_ROOT to \"{$_SERVER['DOCUMENT_ROOT']}\"");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @var mixed Minify_Cache_* object or null (i.e. no server cache is used)
|
|
*/
|
|
private static $_cache = null;
|
|
|
|
/**
|
|
* @var Minify_Controller active controller for current request
|
|
*/
|
|
protected static $_controller = null;
|
|
|
|
/**
|
|
* @var array options for current request
|
|
*/
|
|
protected static $_options = null;
|
|
|
|
/**
|
|
* Set up sources to use Minify_Lines
|
|
*
|
|
* @param array $sources Minify_Source instances
|
|
*
|
|
* @return null
|
|
*/
|
|
protected static function _setupDebug($sources)
|
|
{
|
|
foreach ($sources as $source) {
|
|
$source->minifier = array('Minify_Lines', 'minify');
|
|
$id = $source->getId();
|
|
$source->minifyOptions = array(
|
|
'id' => (is_file($id) ? basename($id) : $id)
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Combines sources and minifies the result.
|
|
*
|
|
* @return string
|
|
*/
|
|
protected static function _combineMinify()
|
|
{
|
|
$type = self::$_options['contentType']; // ease readability
|
|
|
|
// when combining scripts, make sure all statements separated and
|
|
// trailing single line comment is terminated
|
|
$implodeSeparator = ($type === self::TYPE_JS)
|
|
? "\n;"
|
|
: '';
|
|
// allow the user to pass a particular array of options to each
|
|
// minifier (designated by type). source objects may still override
|
|
// these
|
|
$defaultOptions = isset(self::$_options['minifierOptions'][$type])
|
|
? self::$_options['minifierOptions'][$type]
|
|
: array();
|
|
// if minifier not set, default is no minification. source objects
|
|
// may still override this
|
|
$defaultMinifier = isset(self::$_options['minifiers'][$type])
|
|
? self::$_options['minifiers'][$type]
|
|
: false;
|
|
|
|
if (Minify_Source::haveNoMinifyPrefs(self::$_controller->sources)) {
|
|
// all source have same options/minifier, better performance
|
|
// to combine, then minify once
|
|
foreach (self::$_controller->sources as $source) {
|
|
$pieces[] = $source->getContent();
|
|
}
|
|
$content = implode($implodeSeparator, $pieces);
|
|
if ($defaultMinifier) {
|
|
self::$_controller->loadMinifier($defaultMinifier);
|
|
$content = call_user_func($defaultMinifier, $content, $defaultOptions);
|
|
}
|
|
} else {
|
|
// minify each source with its own options and minifier, then combine
|
|
foreach (self::$_controller->sources as $source) {
|
|
// allow the source to override our minifier and options
|
|
$minifier = (null !== $source->minifier)
|
|
? $source->minifier
|
|
: $defaultMinifier;
|
|
$options = (null !== $source->minifyOptions)
|
|
? array_merge($defaultOptions, $source->minifyOptions)
|
|
: $defaultOptions;
|
|
if ($minifier) {
|
|
self::$_controller->loadMinifier($minifier);
|
|
// get source content and minify it
|
|
$pieces[] = call_user_func($minifier, $source->getContent(), $options);
|
|
} else {
|
|
$pieces[] = $source->getContent();
|
|
}
|
|
}
|
|
$content = implode($implodeSeparator, $pieces);
|
|
}
|
|
|
|
if ($type === self::TYPE_CSS && false !== strpos($content, '@import')) {
|
|
$content = self::_handleCssImports($content);
|
|
}
|
|
|
|
// do any post-processing (esp. for editing build URIs)
|
|
if (self::$_options['postprocessorRequire']) {
|
|
require_once self::$_options['postprocessorRequire'];
|
|
}
|
|
if (self::$_options['postprocessor']) {
|
|
$content = call_user_func(self::$_options['postprocessor'], $content, $type);
|
|
}
|
|
return $content;
|
|
}
|
|
|
|
/**
|
|
* Make a unique cache id for for this request.
|
|
*
|
|
* Any settings that could affect output are taken into consideration
|
|
*
|
|
* @return string
|
|
*/
|
|
protected static function _getCacheId()
|
|
{
|
|
return md5(serialize(array(
|
|
Minify_Source::getDigest(self::$_controller->sources)
|
|
,self::$_options['minifiers']
|
|
,self::$_options['minifierOptions']
|
|
,self::$_options['postprocessor']
|
|
,self::$_options['bubbleCssImports']
|
|
)));
|
|
}
|
|
|
|
/**
|
|
* Bubble CSS @imports to the top or prepend a warning if an
|
|
* @import is detected not at the top.
|
|
*/
|
|
protected static function _handleCssImports($css)
|
|
{
|
|
if (self::$_options['bubbleCssImports']) {
|
|
// bubble CSS imports
|
|
preg_match_all('/@import.*?;/', $css, $imports);
|
|
$css = implode('', $imports[0]) . preg_replace('/@import.*?;/', '', $css);
|
|
} else if ('' !== self::$importWarning) {
|
|
// remove comments so we don't mistake { in a comment as a block
|
|
$noCommentCss = preg_replace('@/\\*[\\s\\S]*?\\*/@', '', $css);
|
|
$lastImportPos = strrpos($noCommentCss, '@import');
|
|
$firstBlockPos = strpos($noCommentCss, '{');
|
|
if (false !== $lastImportPos
|
|
&& false !== $firstBlockPos
|
|
&& $firstBlockPos < $lastImportPos
|
|
) {
|
|
// { appears before @import : prepend warning
|
|
$css = self::$importWarning . $css;
|
|
}
|
|
}
|
|
return $css;
|
|
}
|
|
}
|