PHP 8.4.2 Released!

    svn_log

    (PECL svn >= 0.1.0)

    svn_log — 指定したリポジトリ URL のコミットログメッセージを返す

    説明

    svn_log(
        string $repos_url,
        int $start_revision = ?,
        int $end_revision = ?,
        int $limit = 0,
        int $flags = SVN_DISCOVER_CHANGED_PATHS | SVN_STOP_ON_COPY
    ): array

    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_MESSAGES、 SVN_DISCOVER_CHANGED_PATHS および SVN_STOP_ON_COPY の任意の組み合わせ。

    戻り値

    成功した場合は、この関数は次のような構造の配列を返します。 

    [0] => Array (最新のリポジトリから順に並びます)
(
    [rev] => リビジョン番号
    [author] => コミットした人の名前
    [msg] => ログメッセージ
    [date] => ISO 8601 形式、つまり date('c') と同じ形式の日付文字列
    [paths] => Array (変更したファイルについての説明)
        (
            [0] => Array
                (
                    [action] => 変更の種類を表す文字
                    [path] =>  変更されたファイルの絶対パス
                )
            [1] => ...
        )
)
[1] => ...

    注意:

    出力は、常に数値添字の二次元配列となります。 ログメッセージがなかったり、ひとつだけだったりする場合でも同じです。

    action の値は、 » status の出力の最初の列の内容 のサブセットで、以下のいずれかとなります。

    アクション
    文字 説明
    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] => 'チーズとサラミをサンドイッチに追加した。'
        [date] => '2007-04-06T16:00:27-04:00'
        [paths] => Array
            (
                [0] => Array
                    (
                        [action] => 'M'
                        [path] =>  '/sandwich.txt'
                    )
            )
    )
)

    注意

    警告

    この関数は、 実験的 なものです。この関数の動作・ 名前・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP のリリースにおいて変更される可能性があります。 この関数は自己責任で使用してください。

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    0
    php dot net at gnur dot nl
    13 years ago
    Please not that using svn_log without giving revisions is much, much slower then with revisions. Examples:

    $ time php -r "svn_log('http://localhost/svn/shopadsl');"

    real 0m2.140s
    user 0m0.140s
    sys 0m0.000s

    VS

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

    real 0m0.063s
    user 0m0.024s
    sys 0m0.016s
    ＋add a note
    To Top