Compiles all of HTML Purifier's library files into one big file named HTMLPurifier.standalone.php. More...

Data Structures
class	MergeLibraryFSTools
	Custom FSTools for this script that overloads some behavior. More...

Functions
	replace_includes ($text)
	Replaces the includes inside PHP source code with the corresponding source. More...

	remove_php_tags ($text)
	Removes leading PHP tags from included files. More...

	make_dir_standalone ($dir)
	Copies the contents of a directory to the standalone directory. More...

	make_file_standalone ($file)
	Copies the contents of a file to the standalone directory. More...

	copy_and_remove_includes ($file, $sfile)
	Copies a file to another location recursively, if it is a PHP file remove includes. More...

	replace_includes_callback ($matches)

Variables
	$GLOBALS ['loaded'] = array()
	Global hash that tracks already loaded includes. More...

	$FS = new MergeLibraryFSTools()

	$contents = replace_includes(file_get_contents('HTMLPurifier.includes.php'))

Detailed Description

Compiles all of HTML Purifier's library files into one big file named HTMLPurifier.standalone.php.

This is usually called during the release process.

Definition in file generate-standalone.php.

Function Documentation

◆ copy_and_remove_includes()

copy_and_remove_includes	(	$file,
		$sfile
	)

Copies a file to another location recursively, if it is a PHP file remove includes.

Parameters

string	$file	Original file
string	$sfile	New location of file

Definition at line 97 of file generate-standalone.php.

References $contents, $file, and replace_includes().

Referenced by MergeLibraryFSTools\copy(), and make_file_standalone().

 {
     $contents = file_get_contents($file);
     if (strrchr($file, '.') === '.php') $contents = replace_includes($contents);
     return file_put_contents($sfile, $contents);
 }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ make_dir_standalone()

make_dir_standalone ( $dir )

Copies the contents of a directory to the standalone directory.

Parameters

string $dir Directory to copy

Definition at line 73 of file generate-standalone.php.

References $FS.

 {
     global $FS;
     return $FS->copyr($dir, 'standalone/' . $dir);
 }

◆ make_file_standalone()

make_file_standalone ( $file )

Copies the contents of a file to the standalone directory.

Parameters

string $file File to copy

Definition at line 83 of file generate-standalone.php.

References $file, $FS, and copy_and_remove_includes().

 {
     global $FS;
     $FS->mkdirr('standalone/' . dirname($file));
     copy_and_remove_includes($file, 'standalone/' . $file);
     return true;
 }

Here is the call graph for this function:

◆ remove_php_tags()

remove_php_tags ( $text )

Removes leading PHP tags from included files.

Assumes that there is no trailing tag. Also removes vim modelines.

Note: This is safe for files that have internal <?php

Parameters

string $text Text to have leading PHP tag from

Definition at line 63 of file generate-standalone.php.

References $text.

Referenced by replace_includes_callback().

 {
     $text = preg_replace('#// vim:.+#', '', $text);
     return substr($text, 5);
 }

Here is the caller graph for this function:

◆ replace_includes()

replace_includes ( $text )

Replaces the includes inside PHP source code with the corresponding source.

Parameters

string $text PHP source code to replace includes from

Definition at line 47 of file generate-standalone.php.

References $text.

Referenced by copy_and_remove_includes(), and replace_includes_callback().

 {
     // also remove vim modelines
     return preg_replace_callback(
         "/require(?:_once)? ['\"]([^'\"]+)['\"];/",
         'replace_includes_callback',
         $text
     );
 }

Here is the caller graph for this function:

◆ replace_includes_callback()

replace_includes_callback ( $matches )

Parameters

$matches preg_replace_callback matches array, where index 1 is the filename to include

Definition at line 108 of file generate-standalone.php.

References $file, $GLOBALS, array, remove_php_tags(), and replace_includes().

 {
     $file = $matches[1];
     $preserve = array(
       // PEAR (external)
       'XML/HTMLSax3.php' => 1
     );
     if (isset($preserve[$file])) {
         return $matches[0];
     }
     if (isset($GLOBALS['loaded'][$file])) return '';
     $GLOBALS['loaded'][$file] = true;
     return replace_includes(remove_php_tags(file_get_contents($file)));
 }