mymedia.class.php – klasa służąca do pobierania plików z wrzuta.pl, youtube.com i owned.com

Siedziałem sobie wczoraj w nocy wyrwany w połowie pisania frameworka pod pewien projekt zastanawiając się co tu można by było dla rekreacji zrobić. Skacząc od strony do strony napotkałem kilka rozwiązań obsługi ściągania plików z serwisu wrzuta.pl. Przykładem takiego skryptu może być ten umieszczony na ninfo.pl, który ostatecznie przekonał mnie do napisania małej klasy obsługi serwisów emitujących multimedia. Szybko zapoznałem się z skryptem, następnie komentarzami na powyższej stronie i imaginując sobie w głowie działanie mojej przyszłej klasy przystąpiłem do pisania…

Szczytem optymalizacji ona na pewno nie jest, nie mniej jednak starałem się szybko testować różne rozwiązania, aby chociaż po części wykorzystać te bardziej korzystne elementy PHP (pomimo, że lepiej byłoby do takich celów zastosować inne języki programowania). Wykorzystując m.in obsługę wyjątków zmuszam bezpośrednio wszystkich potencjalnych użytkowników do instalacji klasy na serwerach z PHP5. Po za tym specyfika generowania linków na serwisach Wrzuta i YouTube spowodowała, że musiałem napisać dwie typy metod pobierających te linki:

• opierającą się na pobraniu nagłówków zgodnych z ID (aktualnie dla Wrzuty),
• wykorzystującą cURL’a w celu pobrania zawartości strony i z jej zawartości generującą link (aktualnie dla YouTube-a).

Fakt ten powoduje, że wraz z PHP5 musi być dostępna obsługa biblioteki cURL.

Pewnie co poniektórym osobom nasunęła się przed chwilą myśl w stylu: „co za kretyn! cURLem pobiera całą stronę…”. Faktycznie pomysł jest dość zasobożerny. Przetestowałem jednak na współdzielonej maszynie użycie curl_exec();, fsockopen(); i file_get_content();. Z kilku przeprowadzonych po sobie testów wynikło, że pierwsza funkcja jest o około 0,2 sekundy szybsza niż dwie kolejne. Wyników oczywiście nie mogę potwierdzić dla każdego przypadku i każdej maszyny, ale w moim wypadku wybór był jednoznaczny. Nie mniej jednak jeśli ktoś ma jakieś konstruktywne propozycje na temat innej obsługi „wyciągania” linków z YouTube-a – zapraszam do komentowania pod wpisem.

Na koniec tego teoretycznego wstępu warto chyba odpowiedzieć, dlaczego wybrałem akurat te i tylko te dwa serwisy? Odpowiedź jest prosta. Po pierwsze dlatego, że wszędzie napotykałem jak już tylko na rozwiązania dotyczące serwisu Wrzuta (i to dla plików audio). Podobnych dla YT nie znalazłem (możliwe, że źle szukałem ;]). Dlaczego tylko te dwa broadcastery? Domniemam, że sporą część przynajmniej tych najbardziej nam, Polakom znanych da się obsłużyć poprzez działanie na nagłówkach, bądź zawartości strony. Dlatego dwie służące do tego metody mogą w przyszłości posłużyć do obsługi innych tego typu stron. Możliwe, że pod OWS-em wraz z resztą załogi poprawimy, zoptymalizujemy i rozwiniemy klasę… kiedyś ;]

Ze strony praktycznej pierwsze co powinno się zrobić, to ściągnąć kod klasy z mojego małego repozytorium. Jak widać zawarłem tam kilka zdań i przykładów, skrupulatniej omówionych niż tutaj.

Po ściągnięciu należy zainkludować plik klasy po czym utworzyć jej nową instancję.

// wywołanie obsługi wyjątków w celu ewentualnego wyłapania błędu
try {
$instance			= &mymedia::getInstance(); // wywołanie metody wzorca singletona
$instance->downloadFile('763DcD2d6w', 'wrzuta', 'audio', true, ''); // metoda wywoływana w celu ściągnięcia pliku
}
catch ( Exception $exception )
{
print 'Exception: <strong>' . $exception->getMessage() . '</strong> on line ' . $exception->getLine();
}

Tworzenie instancji, jak i wywoływanie metody odbywa się w bloku obsługi wyjątków, ponieważ w przeciwnym wypadku na nic zdałoby się samo ich rzutowanie wewnątrz klasy. Dzięki temu w wypadku popełnienia błędu w podanych parametrach, bądź nie istnienia pliku na serwerze skrypt nas o tym powiadomi.

Cała zabawa dla programisty ogranicza się do użycia metody $instance->downloadFile(args); przyjmującej od jednego do pięciu argumentów.

$instance->downloadFile(id_pliku, nazwa_serwisu[aktualnie: wrzuta|youtube], typ_pliku[aktualnie: audio|video|image], ściągnąć_plik[aktualnie: true|false], nazwa_pliku_przy_sciagnieciu[aktualnie: wrzuta]);

Przykład obrazujący wywołanie:

print $instance->downloadFile('4kv29vXZqpk', 'youtube', 'video', false); // zostanie wyświetlony tylko bezpośredni link do pliku na ekranie

Sugestie, czy zauważone błędy proszę kierować w komentarzach.

Edycja 09.08.08:
Zapraszam do ściągania wersji 1.1. Zawarłem w niej trzy poprawki i dodałem obsługę serwisu owned.com. Jedna z poprawek wymaga teraz, aby w wypadku ponownego użycia klasy w czasie jednego przeładowania strony i występowania nieprawidłowych wyników użyć samemu po każdym wywołaniu metody ściągającej funkcję czyszczącą zmienne klasy (wg. przykładu $instance->flush();). Więcej informacji zawarłem tutaj.

Uruchomiłem także specjalną testową stronę na której można obejrzeć działanie klasy w praktyce.