svn_status

(PECL svn >= 0.1.0)

svn_status — Returns the status of working copy files and directories

설명

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

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: 상대 경로는 PHP 바이너리가 있는 디렉토리를 현재 작업 디렉토리로 인식합니다. 스크립트의 작업 디렉토리를 얻으려면, 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. 사용할 수 있는 값에 대해서는 status 상수를 참고하십시오.
repos_text_status: Status of item's text in repository. Only accurate if update was set to TRUE. 사용할 수 있는 값에 대해서는 status 상수를 참고하십시오.
prop_status: Status of item's properties. 사용할 수 있는 값에 대해서는 status 상수를 참고하십시오.
repos_prop_status: Status of item's property in repository. Only accurate if update was set to TRUE. 사용할 수 있는 값에 대해서는 status 상수를 참고하십시오.
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. 사용할 수 있는 값에 대해서는 type 상수를 참고하십시오.
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
    )
)

참고

svn_update() - Update working copy
svn_log() - Returns the commit log messages of a repository URL
» SVN documentation for svn status

add a note

User Contributed Notes 1 note

down

-1

matthijs at fragfrog dot nl ¶

13 years ago


There seems to be an undocumented function svn_info (arguably the proper name for this functionality) that does almost the same as svn_status, but ignores the second parameter.

Unfortunately, neither can directly be used to just retrieve the current revision of a working copy, but a combination of svn_status and SVN_NON_RECURSIVE|SVN_ALL will work; simply perform the following command:

<?php
svn_status(ROOT,  SVN_NON_RECURSIVE|SVN_ALL);
?>

Where ROOT is of course the root of the working directory you wish to examine. One of the entries will be that working directory, including its current status.

add a note