web - tec / PHP 5 для начинающи

572 Глава 14

Как это работает

Как и в примере с пакетом HTML_TreeMenu, всю основную работу приложение вы+ полняет в начале, а затем в случае необходимости отображает информацию, аккурат+ но вставленную в HTML+код. Код пакета MP3_ID лаконичен благодаря тому, что в нем нет зависимостей и его можно использовать сразу после установки.

В первой строке require+функция загружает модуль:

require_once 'MP3/Id.php';

Объект класса пока не создается, потому что в этом нет необходимости.

Сначала нужно просмотреть каталог MP3+файлов и создать ассоциативный массив, в котором будет храниться время доступа к файлам:

static $MY_MP3_DIR = "/home/ed/mp3"; # Измените это значение! $objDir = dir($MY_MP3_DIR);

$intNumFiles = 0;

$arFileTimeHash = Array();

# Пройти по всем найденным файлам в списке

while (false !== ($strEntry = $objDir->read())) {

#Проверить, является ли текущий файл MP3-файлом,

#а не каталогом или файлом другого типа!

if (eregi("\.mp3$", $strEntry)) {

$arFileTimeHash[$strEntry] = fileatime($MY_MP3_DIR . "/" . $strEntry); $intNumFiles++;

};

};

Полезный Dir+объект позволяет просмотреть необходимый каталог. К сожале+ нию, он не дает возможности фильтровать вывод. При создании листинга каталога существует вероятность, что в результате будет выведено большое количество ненуж+ ной информации.

Чтобы обойти эту проблему, можно пропускать все возвращаемые Dir+объектом ре+ зультаты через регулярное выражение. Описание регулярных выражений ++++++ большая те+ ма, которая вкратце рассматривалась в главе 5. Применяемое здесь регулярное выраже+ ние, .mp3$, передается нечувствительному к регистру символов методу сравнения, eregi, который проверяет, заканчивается ли запись строкой .mp3. Если это так, то, скорее все+ го, данный файл является MP3+файлом и его следует включить в ассоциативный массив.

Ключами ассоциативного массива являются имена файлов (без путей), а значения+ ми ++++++ время последнего доступа к соответствующим файлам, которое можно получить, используя функцию fileatime. Значение переменной $intNumFiles, которое будет использоваться позднее, увеличивается на единицу после нахождения каждого файла.

Не нарушая связь значений и ключей ассоциативного массива, можно заставить PHP+функцию arsort отсортировать его по значениям в обратном порядке:

#Отсортировать список файлов по дате последнего доступа и

#поместить список в обычный массив для последующего отображения

arsort($arFileTimeHash);

В этом примере ключом элемента массива является имя файла, а значением ++++++

время доступа, т.е. после сортировки массива файлы, к которым недавно осуществ+ лялся доступ, окажутся первыми.

После этого отсортированный массив преобразуется в обычный индексирован+ ный массив, каждый элемент которого является ассоциативным массивом с двумя ключами: FILENAME (имя файла) и ACCESSED (время доступа к файлу):

$intThisArrayIndex = 0;

foreach ($arFileTimeHash as $strFilename => $intAccessTime)

574 Глава 14

Что делать, если найдена проблема?

При использовании этого интересного приложения возможно появление неболь+ шой проблемы. Если запустить сценарий один раз, то все будет работать нормально, но если запустить его дважды (нажать кнопку ‘‘Обновить’’ в Web+браузере), то колон+ ка ‘‘время последнего прослушивания’’ будет выглядеть необычно.

Это не ошибка, а скорее случайная функция. Чтобы считать ID+тег MP3+файла, фактически необходимо осуществить доступ к этому файлу, в результате чего изменя+ ется время последнего доступа к нему. Поэтому при повторном запуске приложения время доступа к MP3+файлу равно времени запуска сценария, а не времени последнего прослушивания файла.

Есть простой способ обойти эту проблему ++++++ использование PHP+функции touch. Сразу после доступа к файлу и получения IDv3+сведений следует, используя функцию touch, установить время доступа к файлу, равное его предыдущему значению. К со+ жалению, данный метод работает, только если владельцем MP3+файлов является тот же пользователь, от имени которого работает процесс Web+сервера.

Более сложное решение предполагает периодическое индексирование MP3+ файлов в базе данных, чтобы не нужно было считывать IDv3+теги каждый раз, когда пользователь посещает Web+страницу; затем можно обращаться к базе данных, остав+ ляя время доступа к файлу нетронутым. Реализация этого способа ++++++ хорошее упраж+ нение для читателей.

Время доступа к файлу ****** свойство, которое операционная система предоставляет PHP. В зависимости от используемой операционной системы и от файловой системы сервера это свойство может быть недоступно в PHP. В таком случае вместо времени доступа можно использовать время последнего изменения файла. Это означает, что данные, возвращаемые сценарием, не будут абсолютно точными. Поэтому если планируется развернуть такое приложение в реальной среде, прежде чем предоставлять к нему общий доступ, желательно обеспечить проверку возвращаемых результатов.

Создание приложения с использованием двух PEAR-компонентов

Объединим полученные навыки работы с PEAR и создадим новое приложение с нуля. Ниже рассматривается пример создания полезного приложения с использова+ нием двух уже описанных PEAR+компонентов ++++++ HTML_TreeMenu и MP3_ID.

Приложение

В наши дни некоторые из самых передовых Internet+радиостанций, а также обыч+ ные радиостанции, имеющие свои Web+сайты, предлагают своим слушателям возмож+ ность заказывать на этих сайтах любимые песни.

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

Постоянные поступления в архив, которые обычно состоят из MP3+файлов, могут сильно усложнять поддержку запросной части Web+сайта, поэтому желательно иметь способ динамической генерации и удобного форматирования списка запросов.

Разрабатываемое приложение обладает указанными функциями. Оно предостав+ ляет все MP3+файлы в каталоге сервера в виде иерархического списка (используя

576 Глава 14

<node text="Extreme Temper Loss" icon="document.gif" link="radiorequest.php?requestfile=9991885931035.mp3" />

</node>

<node text="Massive Pitch Correction" icon="folder.gif"> <node text="How long ago" icon="document.gif"

link="radiorequest.php?requestfile=9991885931036.mp3" /> <node text="Ten minutes to Sunrise" icon="document.gif"

link="radiorequest.php?requestfile=9991885931037.mp3" /> </node>

</treemenu>

В данном случае в коллекции MP3+записей имеется два исполнителя: ‘‘Extreme Metal Grinding’’ и ‘‘Massive Pitch Correction’’ (это не самая большая радиостанция в мире). На+ звания песен обоих исполнителей размещаются в соответствующих узлах иерархии.

Название каждой песни представляет собой ссылку на страницу radiorequest.php; в ссылке передается GET+параметр requestFile. Имя MP3+файла передается потому, что диджею удобнее использовать имя файла, а не IDv3+тег. PHP+функция urlencode() гарантирует, что имя файла перед передачей будет преобразовано в необходимую для URL форму.

Чтобы проверить, как страница выглядит после обработки HTML_TreeMenu, мож+ но использовать код из примера в первом разделе ‘‘Практика’’ этой главы и вставить XML+код в файл treemenutest2.xml. Затем необходимо модифицировать файл treemenutest.php, указав в нем корректное имя XML+файла:

$objXMLTree = new XMLHTMLTree("treemenutest2.xml");

Запустите Web+браузер и снова откройте в нем страницу treemenutest.php. Ре+ зультат работы сценария показан на рис. 14.3.

Рис. 14.3.

PEAR 577

Теперь страница заказов выглядит так, как нужно (хотя HTML+код можно немного исправить). Необходимо только определить, каким образом подобный код будет ге+ нерироваться динамически на основании содержимого каталога MP3+файлов.

Практика Создание двухуровневого, двухкомпонентного PEAR-приложения

Работа кода для обоих компонентов подробнее описывается после листингов.

Сценарий radiogeneratexml.php

Создайте новый файл, вставьте в него следующий код и сохраните его под именем radiogeneratexml.php. Именно этот уровень автоматически генерирует XML+код для дерева навигации на основании содержимого каталога MP3+файлов. Поместите файл в каталог, доступный Web+серверу.

<?php

header("Content-Type: text/xml\n\n");

require_once 'MP3/Id.php';

static $strMyMP3Directory = "/home/ed/mp3"; $objDir = dir($strMyMP3Directory); $intNumFiles = 0;

$arMP3Files = Array();

// Пройти в цикле по всем файлам и поместить их имена в массив

while (false !== ($strEntry = $objDir->read())) { // Проверить, является ли этот файл MP3-файлом

if (eregi("\.mp3$", $strEntry)) {

$arMP3Files[] = $strMyMP3Directory . "/" . $strEntry;

};

};

//Создать объект класса MP3_ID $objMP3ID = new MP3_Id();

//Создать массив уникальных имен исполнителей $arArtists = Array();

$arTestArtists = Array();

for ($i=0; $i<=sizeof($arMP3Files)-1; $i++) { $strPath = $arMP3Files[$i];

$intResult = $objMP3ID->read ($strPath);

$strArtist = $objMP3ID->getTag ("artists", "Unknown Artist");

$strTestArtist = strtoupper(preg_replace("/[{}\^{}A-Za-z0-9]/", "", $strArtist));

//Проверить, находится ли имя данного исполнителя (после того

//как необычные символы удалены и все буквы

//переведены в верхний регистр) в массиве – если нет, то

//добавить исполнителя в массив

if (in_array($strTestArtist, $arTestArtists) == false) { array_push($arArtists, $strArtist);

//Обратите внимание, для добавления имен в массив $arArtists

//используются исходное количество пробелов и регистр символов...

array_push($arTestArtists, $strTestArtist);

};

};

//Для каждого исполнителя создается массив, содержащий все

//имена файлов его песен, а также названия песен

$arTracks = Array();

//Кроме того, чтобы предотвратить повторное считывание информации

//о песнях, создается массив всех уже вычисленных индексов песен

$arAlreadyAccountedForSongIndices = Array(); for ($i=0; $i<=sizeof($arArtists)-1; $i++) {

578 Глава 14

$strArtistName = $arArtists[$i]; $strTestArtistName = $arTestArtists[$i];

$arTracks[$strArtistName] = Array();

// Определяем, какие песни написаны данным исполнителем for ($j=0; $j<=sizeof($arMP3Files)-1; $j++) {

if (in_array($j, $arAlreadyAccountedForSongIndices) == false) { $strPath = $arMP3Files[$j];

$intResult = $objMP3ID->read ($strPath);

$strThisArtist = $objMP3ID->getTag ("artists", "Unknown Artist"); $strThisTestArtist = strtoupper(preg_replace("/[^A-Za-z0-9]/",

"", $strThisArtist));

if ($strThisTestArtist == $strTestArtistName) {

//Эта песня действительно принадлежит проверяемому

//исполнителю, поэтому вводим ее индекс в массив

//$arAlreadyAccountedForSongIndices, чтобы не

//проверять ее снова

array_push($arAlreadyAccountedForSongIndices, $j);

//Получаем название песни и ссылку для ее заказа и

//помещаем их во временный массив

$arSongHash["TITLE"] = $objMP3ID->getTag ("name", "Unknown Title"); $strSongFilename = str_replace("$strMyMP3Directory" . "/", "",

$arMP3Files[$j]);

//Создаем ссылку по имени файла, обработав имя файла

//с помощью функции urlencode

$arSongHash["LINK"] = "radiorequest.php?requestfile=" . urlencode($strSongFilename);

//Помещаем в массив следующий доступный индекс

//$arTracks[имя исполнителя]

array_push($arTracks[$strArtistName], $arSongHash); };

};

};

};

// Сортируем массив по именам исполнителей по //возрастанию (от A до Z), используя функцию ksort

ksort($arTracks);

// Выводим подходящий XML-код

?>

<treemenu>

<?php foreach ($arTracks as $artist_name => $arHash) { ?> <node text="<?=$artist_name?>" icon="folder.gif">

<?php for ($i=0; $i<=sizeof($arHash)-1; $i++) { ?>

<node text="<?=htmlentities($arHash[$i]["TITLE"])?>" icon="document.gif" link="<?=htmlentities($arHash[$i]["LINK"])?>" />

<?php }; ?> </node> <?php }; ?> </treemenu>

Сценарий radiorequest.php

Создайте новый файл и введите в него следующий код. Сохраните файл с именем radiorequest.php и поместите его в тот же каталог сервера, в котором находится файл radiogeneratexml.php. Сценарий отображает дерево навигации по доступ+ ным для заказа MP3+записям, сгенерированное сценарием radiogeneratexml.php, и обрабатывает сделанные пользователями заказы.

<?php

static $strMyMP3Directory = "/home/ed/mp3"; static $strMyDJsEmailAddress = "ed@example.com";