Class: VersionControl_SVN

String to prepend to command string. Helpful for setting exec() environment variables, such as: export LANG=en_US.utf8 && ... to support non-ASCII file and directory names.

Access: public

Type:

string

[ Top ]

$shortcuts = array(

            'praise'    => 'Blame',
            'annotate'  => 'Blame',
            'ann'       => 'Blame',
            'co'        => 'Checkout',
            'ci'        => 'Commit',
            'cp'        => 'Copy',
            'del'       => 'Delete',
            'remove'    => 'Delete',
            'rm'        => 'Delete',
            'di'        => 'Diff',
            'ls'        => 'List',
            'mv'        => 'Move',
            'rename'    => 'Move',
            'ren'       => 'Move',
            'pdel'      => 'Propdel',
            'pd'        => 'Propdel',
            'pget'      => 'Propget',
            'pg'        => 'Propget',
            'plist'     => 'Proplist',
            'pl'        => 'Proplist',
            'pset'      => 'Propset',
            'ps'        => 'Propset',
            'stat'      => 'Status',
            'st'        => 'Status',
            'sw'        => 'Switch',
            'up'        => 'Update'
        )

[line 167]

Reference array of subcommand shortcuts. Provided for convenience for those who prefer the shortcuts they're used to using with the svn command-line tools.

You may specify your own shortcuts by passing them in to the factory. For example:

 <?php

 require_once 'VersionControl/SVN.php';
 
 $options['shortcuts'] = array('boot' => 'Delete', 'checkin' => 'Commit');
 
 $svn = VersionControl_SVN::factory(array('boot', 'checkin'), $options);
 
 $switches = array('username' => 'user', 'password' => 'pass', 'force' => true);
 $args = array('svn://svn.example.com/repos/TestProject/file_to_delete.txt');
 
 $svn->boot->run($switches, $args);
 
 ?>

Access: public

Type:

array

[ Top ]

$svn_cmd_parser =

[line 263]

XML::Parser class to use for parsing XML output

Access: public

Type:

string

[ Top ]

$svn_path = '/usr/local/bin/svn'

[line 214]

Location of the svn client binary installed as part of Subversion

Access: public

Type:

string

[ Top ]

$switches = array()

[line 233]

Array of switches to use in building svn command

Access: public

Type:

array

[ Top ]

$use_escapeshellcmd = true

[line 206]

Indicates whether commands passed to the exec() function in the run method should be passed through escapeshellcmd().

NOTE: this variable is ignored on Windows machines!

Access: public

Type:

bool

[ Top ]

Method Detail

apiVersion [line 718]

string apiVersion(
)

Return the VersionControl_SVN API version

Return: the VersionControl_SVN API version number
Access: public

[ Top ]

checkCommandRequirements [line 575]

mixed checkCommandRequirements(
)

Standardized validation of requirements for a command class.

Return: true if all requirements are met, false if requirements are not met. Details of failures are pushed into the PEAR_ErrorStack for VersionControl_SVN
Access: public

[ Top ]

declareErrorMessages [line 325]

array declareErrorMessages(
)

Set up VersionControl_SVN error message templates for PEAR_ErrorStack.

Access: public

[ Top ]

factory [line 409]

mixed &factory(
string
$command, [array
$options = array()])

Create a new VersionControl_SVN command object.

$options is an array containing multiple options defined by the following associative keys:

 array(

  'url'           => 'Subversion repository URL',
  'username'      => 'Subversion repository login',
  'password'      => 'Subversion repository password',
  'config_dir'    => 'Path to a Subversion configuration directory',
                     // [DEFAULT: null]
  'dry_run'       => true/false,
                     // [DEFAULT: false]
  'encoding'      => 'Language encoding to use for commit messages',
                     // [DEFAULT: null]
  'svn_path'      => 'Path to the svn client binary installed as part of Subversion',
                     // [DEFAULT: /usr/local/bin/svn]
 )

Example 1.

 <?php

 require_once 'VersionControl/SVN.php';
 
 $options = array(
      'url'        => 'https://www.example.com/repos',
      'path'       => 'your_project',
      'username'   => 'your_login',
      'password'   => 'your_password',
 );
 
 // Run a log command
 $svn = VersionControl_SVN::factory('log', $options);
 
 print_r($svn->run());
 ?>

Return: a newly created VersionControl_SVN command object, or PEAR_ErrorStack constant on error
Access: public

Parameters:

string	`$command`	—	The Subversion command
array	`$options`	—	An associative array of option names and their values

[ Top ]

fetchCommands [line 482]

mixed fetchCommands(
)

Scan through the SVN directory looking for subclasses.

Return: array on success, false on failure
Access: public

[ Top ]

fetchShortcuts [line 512]

array fetchShortcuts(
)

Return the array of pre-defined shortcuts (also known as Alternate Names) for Subversion commands.

Access: public

[ Top ]

init [line 444]

mixed init(
string
$command, array
$options)

Initialize an object wrapper for a Subversion subcommand.

Return: object on success, false on failure
Access: public

Parameters:

string	`$command`	—	The Subversion command
array	`$options`	—	An associative array of option names and their values

[ Top ]

parseOutput [line 703]

mixed parseOutput(
array
$out)

Handle output parsing chores.

This bare-bones function should be overridden by the command class.

Return: Returns output requested by fetchmode (if available), or raw output if desired fetchmode is not available.
Access: public

Overridden in child classes as:

VersionControl_SVN_Propget::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Propdel::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Move::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Import::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Merge::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Blame::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Mkdir::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Log::parseOutput(): Handles output parsing of output of Log command.

VersionControl_SVN_Delete::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Add::parseOutput(): Handles output parsing of output of command.

VersionControl_SVN_Switch::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_List::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Export::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Revert::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Copy::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Info::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Diff::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Propset::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Commit::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Update::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Cat::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Checkout::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Status::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Resolved::parseOutput(): Handles output parsing of standard and verbose output of command.

VersionControl_SVN_Proplist::parseOutput(): Handles output parsing of standard and verbose output of command.

Parameters:

array $out — Array of output captured by exec command in run

[ Top ]

prepare [line 557]

boolean prepare(
)

Prepare the command switches.

This function should be overloaded by the command class.

Overridden in child classes as:

VersionControl_SVN_Propget::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Propdel::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Move::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Import::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Merge::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Blame::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Mkdir::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Log::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Delete::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Add::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Switch::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_List::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Export::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Revert::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Copy::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Info::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Diff::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Cleanup::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Propset::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Commit::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Update::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Cat::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Checkout::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Status::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Resolved::prepare(): Prepare the svn subcommand switches.

VersionControl_SVN_Proplist::prepare(): Prepare the svn subcommand switches.

[ Top ]

run [line 633]

mixed run(
[array
$args = array()], [array
$switches = array()])

Run the command with the defined switches.

Return: specified output on success, or false on failure.
Access: public

Parameters:

array	`$args`	—	Arguments to pass to Subversion
array	`$switches`	—	Switches to pass to Subversion

[ Top ]

setOptions [line 529]

boolean setOptions(
[array
$options = array()])

Allow for overriding of previously declared options.

Parameters:

array $options — An associative array of option names and their values

[ Top ]