Присвоение новому пакету правильного имени
Одна из самых важных задач при добавлении вашего кода в PEAR -
это нахождение наиболее подходящего имени для вашего пакета.
Общие правила наименования пакетов таковы:
<Категория>_<Имя>. Имя
<Категории> должно быть выбрано
из уже существуеющего списка категорий PEAR (например,
"HTTP", "Net", "HTML").
Вторая часть имени - это имя самого пакета (например,
"Upload", "Portscan", "Table").
Если вы считаете, что ваш пакет не подходит ни к одной из существующих
категорий, вы можете попросить создать новую. Однако, мы стараемся
сохранить как можно более простую структуру категорий.
В качестве исключений из общих правил, имя пакета может содержать
более одного имени категории. Например, пакет HTML_Template_PHPLIB
: множество категорий в имени пакет означает, что пакет
PHPLIB является частью категории
Template, которая, в свою очередь, принадлежит к категории
HTML. В данном случае имя формируется именно по такому
принципу потому, что в PEAR могут существовать шаблонные системы, которые
не будут работать с HTML, а будут предназначены для использования с другими
технологиями.
Если вы хотите получить совет или нуждаетесь в помощи при выборе имени
пакета - спросите в
листе разработчиков.
Процедура выпуска релизов
Для начала, чтобы получить возможность добавить ваш пакет в PEAR,
вы должны получить
эккаунт на pear.php.net.
Перед выпуском первого релиза вашего пакета, вам следует
зарегистрировать сам пакет. Для этого вы должны зайти
сюда
и заполнить соответствующие поля формы. Пожалуйста, выбирайте
имя пакета, которое будет соответстовать пункту первому этой главы.
После регистрации пакета, вы сможете выпустить первую версию пакета.
Перед этим необходимо создать файл описания пакета.
Этот файл в формате XML, с именем package.xml
должен находиться в корневой директории исходников пакета.
Дополнительная информация о файлах описаний пакетов находится
здесь.
После того, как вы создали этот файл, запустите
в корневой директории пакета.
Эта команда создаст файл .tgz в той же директории.
В нашем примере это будет файл с именем Money_Fast-1.0.tgz.
Теперь заходите на эту
страницу и загружайте tgz-файл на сервер. После этого выпуск
версии 1.0 пакета уже можно считать состоявшимся.