Добавление кода

Присвоение новому пакету правильного имени

Одна из самых важных задач при добавлении вашего кода в PEAR - это нахождение наиболее подходящего имени для вашего пакета.

Общие правила наименования пакетов таковы: <Категория>_<Имя>. Имя <Категории> должно быть выбрано из уже существуеющего списка категорий PEAR (например, "HTTP", "Net", "HTML"). Вторая часть имени - это имя самого пакета (например, "Upload", "Portscan", "Table").

Если вы считаете, что ваш пакет не подходит ни к одной из существующих категорий, вы можете попросить создать новую. Однако, мы стараемся сохранить как можно более простую структуру категорий.

В качестве исключений из общих правил, имя пакета может содержать более одного имени категории. Например, пакет HTML_Template_PHPLIB : множество категорий в имени пакет означает, что пакет PHPLIB является частью категории Template, которая, в свою очередь, принадлежит к категории HTML. В данном случае имя формируется именно по такому принципу потому, что в PEAR могут существовать шаблонные системы, которые не будут работать с HTML, а будут предназначены для использования с другими технологиями.

Если вы хотите получить совет или нуждаетесь в помощи при выборе имени пакета - спросите в листе разработчиков.

Представление кода разработчикам PEAR

Второй шаг, который вам необходимо выполнить для добавления вашего пакета в PEAR - это представление пакета в рассылке разработчиков. Обычно такое представление вызывает порождает обсуждение и небольшое голосование, в котором разработчики будут отдавать свои голоса "за" или "против" вашего предложения. Конечно, вам стоит поучаствовать в этой дискуссии. Получение от разработчика "+1" означает, что ему нравится ваше предложение, получение "-1" - наоборот, это голос "против". При получении более пяти "+1" вы можете перейти к следующему шагу.

Получение эккаунтов

На данный момент можно отличить два вида эккаунтов, которые относятся к PEAR:

1. учетная запись Pear.php.net

   Эта учетная запись нужна вам для того, чтобы вы могли добавлять релизы вашего пакета. С этим эккаунтом вы сможете получить доступ к необходимым страницам на pear.php.net для загрузки новых релизов.

2. учетная запись на сервере CVS

   Если вы хотите управлять вашим кодом с помощью CVS, то вы можете получить эккаунт на CVS для получения доступа к модулю pear на cvs.php.net. Это значительно облегчит участие других разработчиков в разработке вашего пакета.

   Если у вас уже есть репозиторий CVS где-то в другом месте (например, на SourceForge) или вы не хотите управлять своим кодом с помощью CVS, то CVS-эккаунт вам не нужен.

Для того, чтобы получить эккаунт на pear.php.net, зайдите на страницу запроса эккаунта в PEAR и заполните форму. Администраторы PEAR получат ваш запрос и создадут вам учетную запись, если найдут причины для этого достаточными. Вам сообщат о конечном результате по е-мэйлу. Учтите, что вам не нужен эккаунт для того, чтобы загружать себе пакеты с pear.php.net.

Для того, чтобы получить CVS-эккаунт, зайдите сюда и заполните соответствующие поля. Вопрос о создании вам эккаунта будет решаться участниками PHP Group.

Процедура выпуска релизов

Для начала, чтобы получить возможность добавить ваш пакет в PEAR, вы должны получить эккаунт на pear.php.net.

Перед выпуском первого релиза вашего пакета, вам следует зарегистрировать сам пакет. Для этого вы должны зайти сюда и заполнить соответствующие поля формы. Пожалуйста, выбирайте имя пакета, которое будет соответстовать пункту первому этой главы.

После регистрации пакета, вы сможете выпустить первую версию пакета.

Перед этим необходимо создать файл описания пакета. Этот файл в формате XML, с именем package.xml должен находиться в корневой директории исходников пакета.

Дополнительная информация о файлах описаний пакетов находится здесь.

После того, как вы создали этот файл, запустите

                   $ pear package                 

в корневой директории пакета. Эта команда создаст файл .tgz в той же директории. В нашем примере это будет файл с именем Money_Fast-1.0.tgz.

Теперь заходите на эту страницу и загружайте tgz-файл на сервер. После этого выпуск версии 1.0 пакета уже можно считать состоявшимся.