メンテナンスされていないパッケージを引き継ぐ

Edited By

Arnaud Limbourg

$Date: 2008-10-09 15:17:31 $

PEAR のウェブサイト において 「メンテナンスされていない (unmaintained)」とされている パッケージの新しいメンテナになりたい場合、どのような 手続きが必要になるのかを以下の節で説明します。

  1. まず最初に、PEAR 品質管理 (QA) メーリングリスト で意思を表明します。 それまでに PEAR の活動に参加したことがない場合、あなた自身のことや なぜメンテナを引き継ごうと思ったのかについて簡単に 説明しておくとよいでしょう。
  2. QA チームは、あなたがメンテナを引き継ぐことが可能かどうかを判断し、 拒否する場合はその理由を説明します。許可された場合、もしあなたが まだ PEAR ウェブサイトのアカウントを持っていなければ、 アカウントを申請します。 PEAR グループがこのアカウントを承認した後に、QA チームは あなたをそのパッケージの主メンテナとして任命します。
  3. パッケージのソースが PHP の CVS リポジトリ内にある場合、CVS のアカウントも必要となります。CVS のアカウントは、 PHP ウェブサイト から申請します。申請フォームの purpose 欄には、 PEAR QA チームからアカウントを取得するように言われたということを 記入してください。そうすることによって申請が迅速に 処理されるようになります。CVS アカウントは PHP グループによって管理されているので、残念ながら PEAR 側にはこの手続きに対する権限があまりないのです。
    もしすでに cvs.php.net の CVS アカウントを 保持している場合、必要な作業は、該当パッケージが存在する モジュールに対する "カルマ" を追加してもらうだけです。 カルマを申請するには、PEAR グループ宛てにメールを送ります (このメールの中でも、 あなたが QA チームとの間で事前に調整済みであることを 説明するようにしましょう)。
  4. すべてが順調に進めば、あなたはこれで、メンテナンスされていなかった パッケージの新しい主メンテナとなります。何か問題がある場合は、 QA メーリングリスト に問い合わせてください。
投稿内容の変更 (Previous) PEAR Developer Guide (Next)
Last updated: Thu, 28 Aug 2014 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

Note by: doconnor
PEAR has started the process of migrating packages over to github; as they fall unmaintained.

There's a migration tool for this @ https://github.com/pear/pear-svn-git

By utilising github; new maintainers can quickly contribute patches via a local fork.

Note by: doconnor
Coding standards and unit tests.

PEAR has some pretty picky standards for acceptance, and some pretty picky people.

If you are contributing a patch or looking to move forward with package maintainence, make sure you've read our coding standard. There are even tools to help you check for conformance - like PHP_CodeSniffer http://pear.php.net/php_codesniffer

Even more loved by us PEAR folk is unit test coverage.

We use either simple phpt tests, or PHPUnit tests (http://phpunit.de).

We have a CI server, which runs hourly.
http://test.pear.php.net/unit-test-results/

Making sure your contributions don't break tests, and even adding further test coverage is a sure fire way to get your foot in the door with PEAR.


To run, from an svn checkout of your package:
# If the package uses simple tests
pear run-tests -r tests/

# Or if it's PHPUnit enabled
php tests/AllTests.php

Gotten stuck, because there's lots of existing broken tests? Or the tests don't run?
File a bug :)
Note by: doconnor
What else do you need to know about taking over a pear package?

We're a friendly bunch, but a busy bunch - so if we are giving you the silent treatment or being a bit picky, don't despair.

We are on a variety of mediums, from mailing lists to IRC - if you aren't sure of what to do next or how to progress things, why not chat to us.

All of the details are on the home page - http://pear.php.net/
Note by: doconnor
Another great step that will get you brownie points - take a look at open bug reports for the package.

If you can fix or improve them, why not do a patch?

Grabbing the source is easy.
1) svn checkout http://svn.php.net/repository/pear/packages/Foo/trunk Foo
2) Make your changes
3) svn diff > mypatch.txt
4) File a bug report/feature request and upload your patch