Приступая к работе с PEAR — низко висящие фрукты PHP

Он также может извлекать и устанавливать напрямую, используя HTTP, загружая пакет почти так же, как это делает браузер. Например, если вам нужна конкретная версия HTML_QuickForm , например 3.1.1, вы можете получить ссылку на файл с домашней страницы пакета — в этом случае http://pear.php.net/get/HTML_QuickForm-3.1 .1.tgz. Затем вы можете напрямую установить его с помощью:

 $ pear install http://pear.php.net/get/HTML_QuickForm-3.1.1.tgz 

Вы также можете установить файлы, которые вы загрузили вручную, из локальной файловой системы следующим образом:

 $ pear install /home/harryf/downloads/HTML_QuickForm-3.1.1.tgz 

Это также означает, что пакет не обязательно должен быть на веб-сайте PEAR (или вообще в части PEAR), чтобы вы могли его использовать. Другие проекты, такие как ISMO Framework , публикуют выпуски, готовые для диспетчера пакетов (файлы .tgz), и их можно установить напрямую, используя тот же подход. Если у вас есть библиотека, которую вы хотели бы упростить для людей, вы можете сделать то же самое.

При попытке установить HTML_QuickForm вы могли столкнуться с проблемой: сообщением об ошибке, в котором говорится, что это зависит от HTML_Common . Некоторые пакеты требуют наличия других пакетов. Если вы посмотрите на домашнюю страницу HTML_QuickForm , внизу, вы заметите, что она зависит от HTML_Common. Это означает, что сначала нужно установить HTML_Common.

Итак, как менеджер пакетов PEAR узнает, что делать с пакетом? Если вы скачаете какую-либо версию HTML_QuickForm, например, в своем браузере и разархивируете ее, вы найдете там файл с именем package.xml . Он содержит всю информацию о том, где должен быть размещен код пакета, относительно вашей директории библиотеки PEAR. Если вы действительно мертвы в воде и не можете установить Диспетчер пакетов, вы можете вручную разархивировать пакет и правильно разместить его в пути включения, основываясь на информации в package.xml (см. Полное описание здесь ). Это последнее средство — зачем делать дополнительную работу для себя?

Еще одна полезная команда, о которой нужно знать, это:

 $ pear upgrade <package_name> 

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

Одна небольшая «ошибка», когда дело доходит до установки пакетов, — это параметр конфигурации «предпочитаемое состояние». В настоящее время это может быть установлено на «stable», «beta», «alpha», «devel» или «snapshot». Теперь представьте, что у вас есть предпочтительный параметрstag_state со значением «stable» (по умолчанию), и вы набрали:

 pear install HTML_QuickForm 

Это приведет к тому, что диспетчер пакетов установит самую новую стабильную версию пакета. Это означает, что, если доступна более новая версия пакета, но разработчики пометили его, скажем, как «бета», он будет игнорироваться в предпочтении более старой, стабильной версии. Для пакетов, которые никогда не имели стабильного выпуска, это может означать, что диспетчер пакетов не позволит вам установить их, пока вы не опустите предпочтительное состояние.

Во всяком случае, этого достаточно, чтобы вы начали. Как видите, благодаря PEAR жизнь стала намного проще.

Мгновенный RSS

ОК — время положить мои деньги туда, где мой рот. Без сомнения, вы уже читали статью Кева о PHP и XML: парсинг RSS 1.0 . В нем объясняются детали создания собственного обработчика SAX для синтаксического анализа RSS 1.0 и показано, как извлечь его из канала SitePoint по адресу http://www.sitepoint.com/rss.php .

Конечно, много написано для написания всего этого кода для обработки XML. Кроме того, если вы пытаетесь получить доступ к каналу из-за прокси-сервера, вам понадобится какой-нибудь HTTP-клиент, способный понимать заголовки, которые генерирует прокси-сервер. Функция PHP fopen () не поможет вам в этом.

Благодаря PEAR вы можете значительно сократить объем работ по анализу RSS-канала. Предполагая, что вы установили XML_Serializer там, вам также нужен PEAR :: HTTP_Request . Я оставлю это вам, чтобы установить его и решить любые проблемы с зависимостями.

Как только у вас установлены необходимые пакеты, используйте этот код:

 <?php  // Include PEAR::HTTP_Request  require_once 'HTTP/Request.php';   // Include PEAR::XML_Unserializer  require_once 'XML/Unserializer.php';   // Create the HTTP_Request object, specifying the URL  $Request = & new HTTP_Request('http://www.sitepoint.com/rss.php');   // Set proxy server as necessary  // $Request->setProxy('proxy.myisp.com', '8080', 'harryf', 'secret');   // Send the request for the feed to the remote server  $ErrorCheck = $Request->sendRequest();   // Check for errors  if ( PEAR::isError($ErrorCheck) ) {    die ( "Connection problem: ".$ErrorCheck->toString() );  }   // Check we got an HTTP 200 status code (if not there's a problem)  if ( $Request->getResponseCode() != '200' ) {    die ( "Request failed: ".$Request->getResponseCode() );  }   // Get the body of the response - the XML document  $xml = $Request->getResponseBody();   // Create an instance of XML_Unserializer  $UnSerializer = &new XML_Unserializer();   // Unserialize the feed and dump the raw array  if ( $UnSerializer->unserialize($xml) ) {    $feed = $UnSerializer->getUnserializedData();    echo "<pre>";    print_r ( $feed );    echo "</pre>";  } else {    die ( "Error unserializing feed" );  }  ?> 

Из приведенного выше примера видно, что кода гораздо меньше, но мы наслаждаемся более детальной обработкой ошибок благодаря PEAR :: HTTP_Request, имеющему некоторое «понимание» протокола HTTP. Кроме того, вы сразу получаете доступ к данным в ленте RSS (не нужно думать о XML). Чтобы закончить, нужно просто пройтись по массиву $feed["item"] и отобразить каждую строку в HTML. На этот раз я не буду обсуждать детали PEAR :: HTTP_Request или XML_Serializer. Пример предназначен только для того, чтобы дать вам представление о том, как PEAR может облегчить вашу жизнь.

Будет ли какой-либо пакет PEAR сэкономить ваше время, зависит от того, знаете ли вы, как его использовать, конечно, и с документацией часто не все в порядке, что часто является проблемой. Я настоятельно советую вам исследовать пакеты, прежде чем планировать их в проекте (а это обычно означает просмотр исходного кода).

В связи с этим вы можете удивиться, почему я не использовал PEAR :: XML_RSS вместо XML_Serializer. Взглянув на источник XML_RSS, я заметил, что он ожидает, что ему будет дан дескриптор файла, из которого он может получить канал. Это вызвало бы проблемы с HTTP_Request, который возвращает ответ в виде строки. XML_RSS должен удовлетворять многим требованиям, но в этом случае мне нужно что-то немного другое.

Заворачивать

Это должно было дать вам достаточно вкуса груша, чтобы начать!

Лично я считаю, что это отличный проект, и я все больше и больше пользуюсь пакетами PEAR, когда это подходит. Конечно, не все идеально, и есть случаи, когда вам нужно использовать хаки и обходные пути, чтобы сформировать пакет в соответствии с вашими потребностями.

У PEAR уже есть что предложить, и, безусловно, это самое большое объединенное усилие по написанию PHP. И чем больше и больше разработчиков PHP отстают от PEAR, тем лучше будет становиться.