svn_status

(PECL svn >= 0.1.0)

svn_statusReturns the status of working copy files and directories

说锟斤拷

svn_status ( string $path [, int $flags = 0 ] ) : array

Returns the status of working copy files and directories, giving modifications, additions, deletions and other changes to items in the working copy.

锟斤拷锟斤拷

path

Local path to file or directory to retrieve status of.

Note: 锟斤拷锟铰凤拷锟斤拷锟斤拷锟斤拷锟絇HP执锟斤拷锟侥硷拷锟斤拷锟斤拷目录锟斤拷为锟斤拷前锟斤拷锟斤拷目录锟斤拷锟叫斤拷锟斤拷锟斤拷锟斤拷锟较o拷锟斤拷锟斤拷萁疟锟斤拷锟斤拷锟侥柯硷拷锟斤拷锟�, 使锟斤拷realpath() 锟斤拷 dirname(__FILE__)锟斤拷

flags

Any combination of Svn::NON_RECURSIVE, Svn::ALL (regardless of modification status), Svn::SHOW_UPDATES (entries will be added for items that are out-of-date), Svn::NO_IGNORE (disregard svn:ignore properties when scanning for new files) and Svn::IGNORE_EXTERNALS.

锟斤拷锟斤拷值

Returns a numerically indexed array of associative arrays detailing the status of items in the repository:

Array (
    [0] => Array (
        // information on item
    )
    [1] => ...
)

The information on the item is an associative array that can contain the following keys:

path
String path to file/directory of this entry on local filesystem.
text_status
Status of item's text. 锟轿硷拷 状态锟斤拷锟斤拷锟叫憋拷 锟斤拷每锟斤拷艿锟街�.
repos_text_status
Status of item's text in repository. Only accurate if update was set to TRUE. 锟轿硷拷 状态锟斤拷锟斤拷锟叫憋拷 锟斤拷每锟斤拷艿锟街�.
prop_status
Status of item's properties. 锟轿硷拷 状态锟斤拷锟斤拷锟叫憋拷 锟斤拷每锟斤拷艿锟街�.
repos_prop_status
Status of item's property in repository. Only accurate if update was set to TRUE. 锟轿硷拷 状态锟斤拷锟斤拷锟叫憋拷 锟斤拷每锟斤拷艿锟街�.
locked
Whether or not the item is locked. (Only set if TRUE.)
copied
Whether or not the item was copied (scheduled for addition with history). (Only set if TRUE.)
switched
Whether or not the item was switched using the switch command. (Only set if TRUE)

These keys are only set if the item is versioned:

name
Base name of item in repository.
url
URL of item in repository.
repos
Base URL of repository.
revision
Integer revision of item in working copy.
kind
Type of item, i.e. file or directory. 锟轿硷拷 锟斤拷锟酵筹拷锟斤拷锟叫憋拷 锟斤拷取锟斤拷锟杰碉拷值.
schedule
Scheduled action for item, i.e. addition or deletion. Constants for these magic numbers are not available, they can be emulated by using:
<?php
if (!defined('svn_wc_schedule_normal')) {
    
define('svn_wc_schedule_normal',  0); // nothing special
    
define('svn_wc_schedule_add',     1); // item will be added
    
define('svn_wc_schedule_delete',  2); // item will be deleted
    
define('svn_wc_schedule_replace'3); // item will be added and deleted
}
?>
deleted
Whether or not the item was deleted, but parent revision lags behind. (Only set if TRUE.)
absent
Whether or not the item is absent, that is, Subversion knows that there should be something there but there isn't. (Only set if TRUE.)
incomplete
Whether or not the entries file for a directory is incomplete. (Only set if TRUE.)
cmt_date
Integer Unix timestamp of last commit date. (Unaffected by update.)
cmt_rev
Integer revision of last commit. (Unaffected by update.)
cmt_author
String author of last commit. (Unaffected by update.)
prop_time
Integer Unix timestamp of last up-to-date time for properties
text_time
Integer Unix timestamp of last up-to-date time for text

注锟斤拷

Warning

锟剿猴拷锟斤拷锟斤拷实锟斤拷锟斤拷锟侥★拷锟剿猴拷锟斤拷锟侥憋拷锟襟,帮拷锟斤拷锟斤拷锟狡硷拷锟斤拷锟斤拷锟斤拷牡锟斤拷锟斤拷锟斤拷锟斤拷锟轿达拷锟斤拷锟� PHP 锟斤拷锟斤拷锟芥本锟斤拷未通知锟酵憋拷锟睫改★拷使锟矫憋拷锟斤拷锟斤拷锟斤拷锟斤拷锟皆碉拷 锟斤拷

锟斤拷锟斤拷

Example #1 Basic example

This example demonstrates a basic, theoretical usage of this function.

<?php
print_r
(svn_status(realpath('wc')));
?>

锟斤拷锟斤拷锟斤拷锟教碉拷锟斤拷锟斤拷锟斤拷锟斤拷冢锟�

Array (
    [0] => Array (
        [path] => /home/bob/wc/sandwich.txt
        [text_status] => 8 // item was modified
        [repos_text_status] => 1 // no information available, use update
        [prop_status] => 3 // no changes
        [repos_prop_status] => 1 // no information available, use update
        [name] => sandwich.txt
        [url] => http://www.example.com/svnroot/deli/trunk/sandwich.txt
        [repos] => http://www.example.com/svnroot/
        [revision] => 123
        [kind] => 1 // file
        [schedule] => 0 // no special actions scheduled
        [cmt_date] => 1165543135
        [cmt_rev] => 120
        [cmt_author] => Alice
        [prop_time] => 1180201728
        [text_time] => 1180201729
    )
)

锟轿硷拷