Class: VersionControl_SVN_Command_Commit

Send changes from a working copy to the repository.

Commits must include a commit message option (either with 'm', 'message', 'file' or 'F' keys), but the message itself may be blank.

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

 $switches = array(

  'm [message]'   =>  'Specified commit message',
                      // either 'm' or 'message' may be used
  'F [file]'      =>  'Read commit message data from specified file',
                      // either 'F' or 'file' may be used
  'q [quiet]'     =>  true|false,
                      // prints as little as possible
  'N'             =>  true|false,
                      // operate on single directory only
  'non-recursive' =>  true|false,
                      // operate on single directory only
  'targets'       =>  'ARG',
                      // pass contents of file ARG as additional args
  'force-log'     =>  true|false,
                      // force validity of log message source
  'username'      =>  'Subversion repository login',
  'password'      =>  'Subversion repository password',
  'no-auth-cache' =>  true|false,
                      // Do not cache authentication tokens
  'encoding'      =>  'ARG',
                      // treat value as being in charset encoding ARG
  'config-dir'    =>  'Path to a Subversion configuration directory',
  'changelist     =>  'Changelist to operate on'
 );

If a path is not used in the $args array, the default path of '.' will be assumed.

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.

The editor-cmd option available on the command-line svn client is not available since this class does not operate as an interactive shell session.

Usage example:

 <?php

 require_once 'VersionControl/SVN.php';
 
 // Set up runtime options. Will be passed to all
 // subclasses.
 $options = array('fetchmode' => VERSIONCONTROL_SVN_FETCHMODE_RAW);
 
 // Pass array of subcommands we need to factory
 $svn = VersionControl_SVN::factory(array('checkout'), $options);
 
 // Define any switches and aguments we may need
 $switches = array('m' => 'Bug #1234 fixed!', 'username' => 'user', 'password' => 'pass');
 $args = array('/path/to/working_copy');
 
 // Run command
 try {
     print_r($svn->commit->run($args, $switches));
 } catch (VersionControl_SVN_Exception $e) {
     print_r($e->getMessage());
 }
 ?>

$requiredSwitches = array('m|message|F|file')

[line 144]

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

__construct (Constructor)   [line 149]