Source for file config.php
Documentation is available at config.php
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
* phpDocumentor :: docBuilder Web Interface
* Advanced Web Interface to phpDocumentor
* Copyright (c) 2003-2006 Andrew Eddie, Greg Beaver
* This library is free software; you can redistribute it
* and/or modify it under the terms of the GNU Lesser General
* Public License as published by the Free Software Foundation;
* either version 2.1 of the License, or (at your option) any
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
* @category ToolsAndUtilities
* @author Greg Beaver <cellog@php.net>
* @copyright 2003-2006 Andrew Eddie, Greg Beaver
* @license http://www.opensource.org/licenses/lgpl-license.php LGPL
print "phpDocumentor requires PHP version 4.1.0 or greater to function";
if ('@DATA-DIR@' != '@'. 'DATA-DIR@')
$root_dir = 'PhpDocumentor';
$path = '@WEB-DIR@/PhpDocumentor/docbuilder/images/';
* common file information
include_once("PhpDocumentor/phpDocumentor/common.inc.php");
include_once("@WEB-DIR@/PhpDocumentor/docbuilder/includes/utilities.php" );
// find the .ini directory by parsing phpDocumentor.ini and extracting _phpDocumentor_options[userdir]
if (isset ($ini['_phpDocumentor_options']['userdir'])) {
$configdir = $ini['_phpDocumentor_options']['userdir'];
$configdir = '@DATA-DIR@/PhpDocumentor/user';
// set up include path so we can find all files, no matter what
// add my directory to the include path, and make it first, should fix any errors
if (substr(PHP_OS , 0 , 3 ) == 'WIN') {
ini_set('include_path',$GLOBALS['_phpDocumentor_install_dir']. ';'. ini_get('include_path'));
ini_set('include_path',$GLOBALS['_phpDocumentor_install_dir']. ':'. ini_get('include_path'));
* common file information
include_once(" $root_dir/phpDocumentor/common.inc.php" );
include_once(" $root_dir/docbuilder/includes/utilities.php" );
// find the .ini directory by parsing phpDocumentor.ini and extracting _phpDocumentor_options[userdir]
if (isset ($ini['_phpDocumentor_options']['userdir'])) {
$configdir = $ini['_phpDocumentor_options']['userdir'];
$configdir = $_phpDocumentor_install_dir . '/user';
// allow the user to change this at runtime
if (!empty ( $_REQUEST['altuserdir'] )) {
$configdir = $_REQUEST['altuserdir'];
// assign the available converters
"HTML:frames:default" => 'HTML:frames:default',
"HTML:frames:earthli" => 'HTML:frames:earthli',
"HTML:frames:l0l33t" => 'HTML:frames:l0l33t',
"HTML:frames:phpdoc.de" => 'HTML:frames:phpdoc.de',
"HTML:frames:phphtmllib" => 'HTML:frames:phphtmllib',
"HTML:frames:phpedit" => 'HTML:frames:phpedit',
"HTML:frames:DOM/default" => 'HTML:frames:DOM/default',
"HTML:frames:DOM/earthli" => 'HTML:frames:DOM/earthli',
"HTML:frames:DOM/l0l33t" => 'HTML:frames:DOM/l0l33t',
"HTML:frames:DOM/phpdoc.de" => 'HTML:frames:DOM/phpdoc.de',
"HTML:frames:DOM/phphtmllib" => 'HTML:frames:DOM/phphtmllib',
"HTML:Smarty:default" => 'HTML:Smarty:default',
"HTML:Smarty:HandS" => 'HTML:Smarty:HandS',
"HTML:Smarty:PHP" => 'HTML:Smarty:PHP',
"PDF:default:default" => 'PDF:default:default',
"CHM:default:default" => 'CHM:default:default',
"XML:DocBook/peardoc2:default" => 'XML:DocBook/peardoc2:default'
// compile a list of available screen shots
$convScreenShots = array ();
while (($file = readdir( $dir )) !== false ) {
if ($file != '.' && $file != '..') {
if (!is_dir( $path . $file )) {
if (strpos( $file, 'ss_' ) === 0 ) {
$convScreenShots[$key] = $file;
font-family: verdana,sans-serif;
font-family: verdana,sans-serif;
border: solid 1px #000000;
<script src="includes/tabpane.js" language="JavaScript" type="text/javascript"></script>
<link id="webfx-tab-style-sheet" type="text/css" rel="stylesheet" href="includes/tab.webfx.css" />
<script type="text/javascript" language="Javascript">
Creates some global variables
function initializate() {
//The "platform independent" newLine
//Taken from http://developer.netscape.com/docs/manuals/communicator/jsref/brow1.htm#1010426
if (navigator.appVersion.lastIndexOf('Win') != -1) {
/**Adds the contents of the help box as a directory
function addDirectory($object) {
//$a = document.helpForm.fileName.value;
$a = parent.ActionFrame.document.actionFrm.fileName.value;
$a = myReplace( $a, '\\\\', '\\' );
if ($a[$a.length - 1] == $pathdelim) {
$a = $a.substring(0, $a.length - 1);
if ($a.lastIndexOf('.') > 0) {
$a = $a.substring(0,$a.lastIndexOf($pathdelim));
$object.value = prepareString($object.value)+$a;
/**Adds the contents of the converter box to the converters list
function addConverter($object) {
$object.value = prepareString($object.value)+document.dataForm.ConverterSetting.value;
/**Replaces the converters list with the contents of the converter box
function replaceConverter($object) {
$object.value = document.dataForm.ConverterSetting.value;
/**Adds the contents of the help box as a file to the given control
function addFile($object) {
//$a = document.helpForm.fileName.value;
$a = parent.ActionFrame.document.actionFrm.fileName.value;
$a = myReplace($a,'\\\\','\\');
$object.value = prepareString($object.value)+$a;
/**Takes a given string and leaves it ready to add a new string
That is, puts the comma and the new line if needed
function prepareString($myString) {
//First verify that a comma is not at the end
if($myString.lastIndexOf(",") >= $myString.length-2) {
//We have a comma at the end
if($myString.length > 0) {
/**Do the validation needed before sending the from and return a truth value indicating if the form can be sent
//Take out all newLines and change them by nothing
//This could be done by using javascript function's replacebut that was implemented only until Navigator 4.0 and so it is better to use more backward compatible functions like substr
document.dataForm.elements[0].value= stripNewLines(document.dataForm.elements[0].value);
document.dataForm.elements[1].value= stripNewLines(document.dataForm.elements[1].value);
document.dataForm.elements[2].value= stripNewLines(document.dataForm.elements[2].value);
document.dataForm.elements[3].value= stripNewLines(document.dataForm.elements[3].value);
document.dataForm.elements[4].value= stripNewLines(document.dataForm.elements[4].value);
document.dataForm.elements[5].value= stripNewLines(document.dataForm.elements[5].value);
document.dataForm.elements[6].value= stripNewLines(document.dataForm.elements[6].value);
document.dataForm.elements[7].value= stripNewLines(document.dataForm.elements[7].value);
//By returning true we are allowing the form to be submitted
/**Takes a string and removes all the ocurrences of new lines
Could have been implemented a lot easier with replace but it's not very backwards compatible
function stripNewLines( $myString ) {
return myReplace($myString,$newLine,'');
function myReplace($string,$text,$by) {
// Replaces text with by in string
var $strLength = $string.length, $txtLength = $text.length;
if (($strLength == 0) || ($txtLength == 0)) {
var $i = $string.indexOf($text);
if ((!$i) && ($text != $string.substring(0,$txtLength))) {
var $newstr = $string.substring(0,$i) + $by;
if ($i+$txtLength < $strLength) {
$newstr += myReplace($string.substring($i+$txtLength,$strLength),$text,$by);
var screenShots = new Array();
foreach ($converters as $k=> $v) {
echo " \nscreenShots['$k'] = '{$convScreenShots[$k]}'";
echo " \nscreenShots['$k'] = ''";
/** Swaps the converted screen shot image
function swapImage( key ) {
document.screenshot.src = 'images/' + screenShots[key];
<body bgcolor="#ffffff" onload="javascript:initializate()" topmargin="0" leftmargin="0" marginheight="0" marginwidth="0">
<!-- onsubmit="return validate()" -->
<form name="dataForm" action="builder.php" method="get" target="OutputFrame">
<div class="tab-pane" id="tabPane1">
<script type="text/javascript">
var tp1 = new WebFXTabPane( document.getElementById( "tabPane1" ));
<div class="tab-page" id="tab_intro">
<h2 class="tab">Introduction</h2>
Welcome to <b>docBuilder</b>.
<p>This is the new web-interface for running, in our opinion, the best in-code documentation compiler there is: <b>phpDocumentor</b>.</p>
<p>What's new in this release? Heaps of things, but here are the headlines:</p>
<li>Much greater support for PEAR on both windows and linux</li>
<li>CHM, PDF and XML:DocBook/peardoc2 converters are all stable!</li>
<li>New tokenizer-based parser is literally twice as fast as the old parser (requires PHP 4.3.0+)</li>
<li>New external user-level manual parsing and generation allows cross-linking between API docs and DocBook-format tutorials/manuals!</li>
<li>Color syntax source highlighting and cross-referencing with documentation of source code in HTML, CHM and PDF with customizable templating</li>
<li>New Configuration files simplify repetitive and complex documentation tasks</li>
<li>Brand new extensive manual - which can be generated directly from the source using makedocs.ini!</li>
<li>Many improvements to in-code API documentation including new tags, and better handling of in-code html tags</li>
<li>New XML:DocBook/peardoc converter makes generating PEAR manual formats easy for PEAR developers along with the --pear command-line switch</li>
<li>Many new HTML templates, all of them beautiful thanks to Marco von Ballmoos</li>
<li>A brand new web interface thanks to Andrew Eddie!</li>
<div class="tab-page" id="tab_config">
<h2 class="tab">Config</h2>
<table cellspacing="0" cellpadding="3" border="0">
<td colspan="2"><b>Use a pre-created config file for form values.</b></td>
<b>change config directory:</b>
<input size="20" type="text" name="altuserdir" value="" /><input type="SUBMIT" value="Change" name="submitButton" onclick="document.dataForm.target='DataFrame'; document.dataForm.action = 'config.php';document.dataForm.submit();">
if (!empty ($_REQUEST['altuserdir'])) {
print '<br><i>changed to <b>"'. $_REQUEST['altuserdir']. '"</b></i>';
<select name="setting_useconfig">
<option value="" <?php if (empty ($_REQUEST['altuserdir'])) print 'selected'; ?>>don't use config file</option>
if (!empty ($_REQUEST['altuserdir'])) $path = $configdir . PATH_DELIMITER;
foreach($dirs as $configfile)
print '<option value="'. $path. $configfile. '"'. $sel. '>'. $configfile. ".ini</option>\n";
<input type="SUBMIT" value="Go" name="submitButton">
Normally, phpDocumentor uses the form values from this form to set up parsing. In version 1.2, phpDocumentor allows you to "save" form values in configuration files so that you can replicate common complicated documentation tasks with only one time. Just choose a config file below or create a new one and refresh this page to choose it.
<div class="tab-page" id="tab_files">
<h2 class="tab">Files</h2>
<table cellspacing="0" cellpadding="3" border="0">
<td align="right" valign="top" nowrap="nowrap">
<b>Files<br />to parse</b>
<a href="javascript:addFile(document.dataForm.setting_filename)" title="Add the file in the help box">
echo showImage( 'images/rc-gui-install-24.png', '24', '24' );
<textarea rows="5" cols="60" name="setting_filename" class="text"></textarea>
<td valign="top" class="small">
This is a group of comma-separated names of php files or tutorials that will be processed by phpDocumentor.
<td align="right" valign="top" nowrap="nowrap">
<b>Directory<br />to parse</b>
<a href="javascript:addFile(document.dataForm.setting_directory)" title="Add the file in the help box">
echo showImage( 'images/rc-gui-install-24.png', '24', '24' );
<textarea rows="5" cols="60" name="setting_directory" class="text" title=""></textarea>
<td valign="top" class="small">
This is a group of comma-separated directories where php files or tutorials are found that will be processed by phpDocumentor. phpDocumentor automatically parses subdirectories
<td align="right" valign="top" nowrap="nowrap">
<b>Files<br />to ignore</b>
<a href="javascript:addFile(document.dataForm.setting_ignore)" title="Add the file in the help box">
echo showImage( 'images/rc-gui-install-24.png', '24', '24' );
<textarea rows="5" cols="60" class="text" name="setting_ignore"></textarea>
<td valign="top" class="small">
A list of files (full path or filename), and patterns to ignore. Patterns may use wildcards * and ?. To ignore all subdirectories named "test" for example, using "test/" To ignore all files and directories with test in their name use "*test*"
<td align="right" valign="top" nowrap="nowrap">
<b>Packages<br />to parse</b>
<textarea rows="4" cols="60" class="text" name="setting_packageoutput"></textarea>
<td valign="top" class="small">
The parameter packages is a group of comma separated names of abstract packages that will be processed by phpDocumentor. All package names must be separated by commas.
<div class="tab-page" id="tab_output">
<h2 class="tab">Output</h2>
<table cellspacing="0" cellpadding="3" border="0">
<td align="right" valign="top" nowrap="nowrap">
<a href="javascript:addFile(document.dataForm.setting_target)" title="Add the file in the help box">
echo showImage( 'images/rc-gui-install-24.png', '24', '24' );
<input type="text" name="setting_target" size="60" class="text" />
<td valign="top" class="small">
Target is the directory where the output produced by phpDocumentor will reside.
<td align="right" valign="top" nowrap="nowrap">
<b>Output<br />Format</b>
<textarea cols="60" rows="3" name="setting_output" class="text">HTML:Smarty:default</textarea>
Output type:Converter name:template name
echo htmlArraySelect( $converters, 'ConverterSetting', 'size="1" class="text" onchange="swapImage(this.options[this.options.selectedIndex].value);"', 'HTML:Smarty:default' );
<a href="javascript:addConverter(document.dataForm.setting_output)">
Add the converter in the help box
<img name="screenshot" src="images/ss_HTML_Smarty_default.png" width="200" height="200" border="2" alt="Screen Shot">
<td valign="top" class="small">
Outputformat may be HTML, XML, PDF, or CHM (case-sensitive) in version 1.2.
<br />There is only one Converter for both CHM and PDF:<br /><i>default</i>.
<br />There are 2 HTML Converters:<br /><i>frames</i> or <i>Smarty</i>.
<br /><b>frames templates</b> may be any of:
<i>default, earthli, l0l33t, phpdoc.de, phphtmllib, phpedit, DOM/default, DOM/earthli, DOM/l0l33t, DOM/phphtmllib, or DOM/phpdoc.de</i>.
<b>Smarty templates</b> may be any of:
<i>default, HandS, or PHP</i>
<strong>XML:DocBook/peardoc2:default</strong> is the only choice for XML in 1.2.2
<div class="tab-page" id="tab_options">
<h2 class="tab">Options</h2>
<table cellspacing="0" cellpadding="3" border="0">
<td align="right" nowrap="nowrap">
<b>Generated Documentation Title</b>
<input type="text" name="setting_title" size="40" value="Generated Documentation" class="text">
Choose a title for the generated documentation
<b>Default Package Name</b>
<input type="TEXT" name="setting_defaultpackagename" size="40" value="default" class="text" />
Choose a name for the default package
<b>Default Category Name</b>
<input type="TEXT" name="setting_defaultcategoryname" size="40" value="default" class="text" />
Choose a name for the default category. This is only used by the peardoc2 converter
<input type="text" name="setting_customtags" size="40" class="text" />
Custom Tags is a comma-separated list of tags you want phpDocumentor to include as valid tags in this parse. An example would be 'value, size' to allow @value and @size tags.
<b>Parse @access private and @internal/{@internal}}</b>
<input type="checkbox" name="setting_parseprivate" value="on" />
The parameter Parse @access private tells phpDocumentor whether to parse elements with an '@access private' tag in their docblock. In addition, it will turn on parsing of @internal tags and inline {@internal}} sections
<b>Generate Highlighted Source Code</b>
<input type="checkbox" name="setting_sourcecode" value="on" />
The parameter Generate Highlighted Source Code tells phpDocumentor whether to generate highlighted XRef source code similar to PHP-XRef output.
<b>JavaDoc-compliant<br />Description parsing.</b>
<input type="checkbox" name="setting_javadocdesc" value="on" />
Normally, phpDocumentor uses several rules to determine the short description. This switch asks phpDocumentor to simply search for the first period (.) and use it to delineate the short description. In addition, the short description will not be separated from the long description.
<b>PEAR package repository parsing</b>
<input type="checkbox" name="setting_pear" value="on" />
PEAR package repositories have specific requirements:
<li>Every package is in a directory with the same name.</li>
<li>All private data members and methods begin with an underscore (function _privfunction()).</li>
<li>_Classname() is a destructor</li>
This option recognizes these facts and uses them to make assumptions about packaging and access levels. Note that with PHP 5, the destructor option will be obsolete.
<div class="tab-page" id="tab_credits">
<h2 class="tab">Credits</h2>
phpDocumentor written by Joshua Eichorn
<br />Web Interface originally written by Juan Pablo Morales, enhanced by Greg Beaver and super-charged by Andrew Eddie
Joshua Eichorn <a href="mailto:jeichorn@phpdoc.org">jeichorn@phpdoc.org</a>
<br>Juan Pablo Morales <a href=
"mailto:ju-moral@uniandes.edu.co">ju-moral@uniandes.edu.co</a>
<br>Gregory Beaver <a href=
"mailto:cellog@php.net">cellog@php.net</a>
<br>Andrew Eddie <a href=
"mailto:eddieajau@users.sourceforge.net">eddieajau@users.sourceforge.net</a>
If you have any problems with phpDocumentor, please visit the website:
<a href='http://phpdoc.org'>phpdoc.org</a>, or
<a href="http://pear.php.net/bugs/search.php?cmd=display&package_name[]=PhpDocumentor&status=Open">
submit a bug at PEAR</a>.
<!-- Created: Tue Jun 26 18:52:40 MEST 2001 -->
<div class="tab-page" id="tab_links">
<h2 class="tab">Links</h2>
<li><a target="_top" href="http://www.phpdoc.org/manual.php">phpDocumentor manual</a> - Learn how to use phpDocumentor to document your PHP source code</li>
<li><a target="_top" href="http://pear.php.net/package/PhpDocumentor/">phpDocumentor homepage</a> on PEAR</li>
<li><a target="_top" href="http://phpdocu.sourceforge.net/">phpDocumentor homepage</a> on SourceForge</li>
<li><a target="_top" href="http://freshmeat.net/projects/phpdocu">Freshmeat record</a> - subscribe here</li>
<input type="hidden" name="interface" value="web">
<input type="hidden" name="dataform" value="true">
<script type="text/javascript">
tp1.addTabPage( document.getElementById( "tab_intro" ) );
tp1.addTabPage( document.getElementById( "tab_config" ) );
tp1.addTabPage( document.getElementById( "tab_files" ) );
tp1.addTabPage( document.getElementById( "tab_output" ) );
tp1.addTabPage( document.getElementById( "tab_options" ) );
tp1.addTabPage( document.getElementById( "tab_credits" ) );
tp1.addTabPage( document.getElementById( "tab_links" ) );
Documentation generated on Mon, 11 Mar 2019 15:50:12 -0400 by phpDocumentor 1.4.4. PEAR Logo Copyright © PHP Group 2004.
|