Class: VersionControl_SVN_Switch

VersionControl_SVN
   |
   --VersionControl_SVN_Switch

[line 150]
Subversion Switch command manager class

Update the working copy to a different URL.

From 'svn switch --help':

usage: 1. switch URL [PATH] 2. switch --relocate FROM TO [PATH...]

1. Update the working copy to mirror a new URL within the repository. This behaviour is similar to 'svn update', and is the way to move a working copy to a branch or tag within the same repository.

2. Rewrite working copy URL metadata to reflect a syntactic change only. This is used when repository's root URL changes (such as a schema or hostname change) but your working copy still reflects the same directory within the same repository.

Conversion of the above usage example to VersionControl_SVN_Switch:

 <?php

 require_once 'VersionControl/SVN.php';
 
 // Setup error handling -- always a good idea!
 $svnstack = &PEAR_ErrorStack::singleton('VersionControl_SVN');
 
 // Set up runtime options. Will be passed to all
 // subclasses.
 $options = array('fetchmode' => VERSIONCONTROL_SVN_FETCHMODE_RAW);
 
 $switches = array('relocate' => 'true');
 $args = array(
  'svn://svn.example.com/repos/TestProj/trunk',
  'svn://svn.example.com/repos/TestProj_Fork/trunk',
  '/path/to/working/copy'
 );
 
 $svn = VersionControl_SVN::factory(array('switch'), $options);
 print_r($svn->switch->run($args));
 
 if (count($errs = $svnstack->getErrors())) {
     foreach ($errs as $err) {
         echo '<br />'.$err['message']."<br />\n";
         echo "Command used: " . $err['params']['cmd'];
     }
 }
 ?>

$switches is an array containing one or more command line options defined by the following associative keys:

 $switches = array(

  'r [revision]'  =>  'ARG (some commands also take ARG1:ARG2 range)
                        A revision argument can be one of:
                           NUMBER       revision number
                           "{" DATE "}" revision at start of the date
                           "HEAD"       latest in repository
                           "BASE"       base rev of item's working copy
                           "COMMITTED"  last commit at or before BASE
                           "PREV"       revision just before COMMITTED',
                      // either 'r' or 'revision' may be used
  'N'             =>  true|false,
                      // operate on single directory only
  'non-recursive' =>  true|false,
                      // operate on single directory only
  'q [quiet]'     =>  true|false,
                      // print as little as possible
  'diff3-cmd'     =>  'ARG',
                      // use ARG as merge command
  'relocate'      =>  true|false,
                      // relocate via URL-rewriting
  'username'      =>  'Subversion repository login',
  'password'      =>  'Subversion repository password',
  'no-auth-cache' =>  true|false,
                      // Do not cache authentication tokens
  'config-dir'    =>  'Path to a Subversion configuration directory
 );

Note: Subversion does not offer an XML output option for this subcommand

The non-interactive option available on the command-line svn client may also be set (true|false), but it is set to true by default.

$args = array()

[line 185]

Command-line arguments that should be passed outside of those specified in switches.

$min_args =  1

[line 194]

Minimum number of args required by this subcommand.

See Version Control with Subversion, Subversion Complete Reference for details on arguments for this subcommand.

$passthru =  false

[line 210]

Use exec or passthru to get results from command.

$required_switches = array()

[line 203]

Switches required by this subcommand.

See Version Control with Subversion, Subversion Complete Reference for details on arguments for this subcommand.

$valid_switches = array('r',
                                'revision',
                                'N',
                                'non-recursive',
                                'non_recursive',
                                'q',
                                'quiet',
                                'diff3-cmd',
                                'relocate',
                                'username',
                                'password',
                                'no-auth-cache',
                                'no_auth_cache',
                                'non-interactive',
                                'non_interactive',
                                'config-dir',
                                'config_dir'
                                )

[line 158]

Valid switches for svn switch

parseOutput   [line 315]

---

parseOutputArray   [line 349]

---

prepare   [line 223]

---