PHP 日本大会 2024

svn_log

(PECL svn >= 0.1.0)

svn_log返回仓库 URL 的提交日志消息

描述

svn_log(
    字符串 $repos_url,
    整数 $start_revision = ?,
    整数 $end_revision = ?,
    整数 $limit = 0,
    整数 $flags = SVN_DISCOVER_CHANGED_PATHS | SVN_STOP_ON_COPY
): 数组

svn_log() 返回仓库 URL repos_url 中项目的完整历史记录,如果设置了 start_revision,则返回特定修订版的历史记录。此函数等效于 svn log --verbose -r $start_revision $repos_url

参数

repos_url

要从中检索日志历史记录的项目的仓库 URL。

start_revision

要检索的第一个日志的修订版号。使用 SVN_REVISION_HEAD 从最新修订版检索日志。

end_revision

要检索的最后一个日志的修订版号。如果指定,则默认为 start_revision,否则默认为 SVN_REVISION_INITIAL

limit

要检索的日志数量。

flags

SVN_OMIT_MESSAGESSVN_DISCOVER_CHANGED_PATHSSVN_STOP_ON_COPY 的任意组合。

返回值

成功时,此函数返回一个文件列表数组,格式如下:

[0] => Array, ordered most recent (highest) revision first
(
    [rev] => integer revision number
    [author] => string author name
    [msg] => string log message
    [date] => string date formatted per ISO 8601, i.e. date('c')
    [paths] => Array, describing changed files
        (
            [0] => Array
                (
                    [action] => string letter signifying change
                    [path] =>  absolute repository path of changed file
                )
            [1] => ...
        )
)
[1] => ...

注意:

即使没有日志消息或只有一个日志消息,输出始终为数值索引的数组。

action 的值是 » 第一列中的状态输出 的一个子集,可能的值为

操作
字母 描述
M 项目/属性已修改
A 项目已添加
D 项目已删除
R 项目已替换

如果项目没有更改,则返回空数组。

示例

示例 #1 svn_log() 示例

<?php
print_r
( svn_log('http://www.example.com/', 23) );
?>

以上示例将输出类似以下内容:

Array
(
    [0] => Array
    (
        [rev] => 23
        [author] => 'joe'
        [msg] => 'Add cheese and salami to our sandwich.'
        [date] => '2007-04-06T16:00:27-04:00'
        [paths] => Array
            (
                [0] => Array
                    (
                        [action] => 'M'
                        [path] =>  '/sandwich.txt'
                    )
            )
    )
)

备注

警告

此函数为 *实验性* 函数。此函数的行为、名称和周围文档可能会在 PHP 的未来版本中未经通知而更改。使用此函数需自行承担风险。

添加备注

用户贡献的笔记 1 条笔记

0
php dot net at gnur dot nl
13 年前
请注意,不提供修订版就使用 svn_log 比提供修订版要慢得多。示例

$ time php -r "svn_log('https://127.0.0.1/svn/shopadsl');"

实际 0 分 2.140 秒
用户 0 分 0.140 秒
系统 0 分 0.000 秒



$ time php -r "svn_log('https://127.0.0.1/svn/shopadsl', 0, 45);"

实际 0 分 0.063 秒
用户 0 分 0.024 秒
系统 0 分 0.016 秒
To Top