Создаем видеобиблиотеку с PHPixie

LPJ0d3K
После моего предыдущего поста о выборе легкого Фреймворка я погуглил и увидел что для некоторых из них нет ни одного русскоязычного туториала. Так вот я решил написать серию постов дабы заполнить эту нишу. Я думаю стоит начать с тех на которых я в конце остановился, а так как для Silex написано уже достаточно много то этот пост будет посвящен PHPixie.

Для тех кто не читал моего сравнения фреймворков, PHPixie — маленький и по моим меркам очень быстрый фреймворк с модульной структурой, хорошо реализованным DI, отсутствием статиков и простой архитектурой.

На официальном сайте все туториалы написаны на примере фей, я же попробую быть оригинальным и мы создадим библиотеку видео из Youtube. То есть мы сможем добавлять, удалять и просматривать видео. А еще по дороге научимся использовать API самого ютуба для получения мета информации и тамбнейлов.

Создание проекта

PHPixie можно установить либо используя Composer, либо скачав снапшот готовой системы с сайта. Разницы почти нет, так как снапшот регулярно обновляется и являет собой базовой проект с проинсталлированными тремя библиотеками (core, db и orm). Для простоты будем использовать второй метод, ссылка на снапшот здесьphpixie.com/phpixie.zip. Сервер надо настроить на папку /web/ внутри проекта. Вот и все, теперь можем зайти на наш хост и увидеть маленькое приветствие.

Объект $pixie

Объект $pixie — это имплементация DI Контейнера и Сервис Локатора, нечто похожее на $app в Silex. Он доступен как проперти контроллера и передается практически в каждый конструктор, $pixie также содержит фактори методы для каждого класса фреймворка. Грамотное использование его позволяет полностью избежать связывания классов а следовательно упростить тестирование. В отличии от Silex добавление методов и проперти в $pixie происходит только путем расширения класса. В базовом проекте уже присутстует класс App\Pixie который наследует от PHPixie\Pixie, как раз в него мы можем добавлять свой код чтобы иметь к нему доступ повсюду. Следует обратить внимание на то что это не синглтон и передавать его между классами приходится явно, такой подход был избран для избежания какого-либо глобального состояния в коде, аналогично фреймворк никогда не использует статические методы. Каждый модуль, например db или orm поставляет свой класс с фактори методами, эти классы прописываются в нашем App\Pixie в $modules. Потом мы можем запрашивать их как проперти, например используя $pixie->db->query() и $pixie->orm->get(), что вносит дополнительную структурированность и позволяет избежать супа из методов. В нашем случае менять в App\Pixie нам ничего не нужно.

База данных

Мы будем использовать лишь одну простенькую табличку для хранение информации о видео, вот ее структура:

CREATE TABLE `videos` (
    `id` INT(10) NOT NULL AUTO_INCREMENT,
    `video_id` VARCHAR(20) NOT NULL,
    `title` VARCHAR(255) NOT NULL,
    PRIMARY KEY (`id`)
);

Теперь прописываем настройки соединения к базе в /assets/config/db.php, например:

return array(
    'default' => array(
        'user'=>'root',
        'password' => '',
        'driver' => 'PDO',
        'connection'=>'mysql:host=localhost;dbname=videos'
    )
);

тут, думаю все достаточно тривиально.

Модель

Любая MVC структура начинается с модели, в нашем случае она только одна, Video. Кто знаком с Kohana сразу почувствует себя дома, для создания модели достаточно просто расширить класс \PHPixie\ORM\Model:

namespace App\Model;
class Video extends \PHPixie\ORM\Model{}

Привязка к таблице по умолчанию происходит следуя из имени класса. В нашем случае так оно и есть и менять ничего не нужно. Доступ к модели можно получить используя $pixie. Самые яркие примеры кода:

//Создание и сохранение
$video = $pixie->get('video');
$video->title = 'Test';
$video->save();

//Поиск
$video = $pixie->get('video')->where('title','Test')->find();

//Поиск всех
$videos = $pixie->get('video')->find_all();

Базовая разметка

В базовом проекте который ми скачали есть в наличии подвид контролера, класс App\Pixie. Его работа сводится к тому чтоб рендерить шаблон main.php доступный как проперти $view. Наши контроллеры просто передают разные данные в этот шаблон, включая $subview — имя подшаблона который надо вставить. Мне как раз очень понравилось то, что логика того как работают мастер-страницы и подшаблоны не прописана в самом фреймворке а выносится в сам проект, что позволяет переделать ее по своему усмотрению. Наш main.php будет выглядеть примерно так:

<!DOCTYPE html>
<html>
    <head>
        <link href="//netdna.bootstrapcdn.com/twitter-bootstrap/2.3.0/css/bootstrap-combined.min.css" rel="stylesheet"/>
    </head>
    <body>
        <div class="container">
            <div class="row">
                <div class="offset3 span6">
                    <h2><a href="/">PHPixie Vids</a></h2>

                    <!-- Форма добавления видео -->
                    <form class="form-inline" method="post" action="/videos/add">
                        <input type="text" placeholder="Paste Link…" name="url">
                        <button type="submit" class="btn btn-primary">Add new</button>
                    </form>
                </div>
            </div>
            <div class="row">

                <!-- Подключаем подшаблон -->
                <?php include($subview.'.php'); ?>
            </div>
        </div>
    </body>
</html>

Подшаблонов у нас всего два: list.php (для списка добавленных роликов) и view.php (для просмотра выбранного видео). Вот они:

<!-- /assets/views/list.php -->
<div class="offset3 span6">
    <ul class="thumbnails">
        <?php foreach($videos as $video):?>
            <li class="span3">
                <a class="thumbnail" href="/videos/view/<?php echo $video->id; ?>">

                    <!-- Вот как легко получить тамбнейл видео по айдишке -->
                    <img src="http://img.youtube.com/vi/<?php echo $video->video_id;?>/0.jpg">
                    <div class="caption">
                        <h3><?php echo $video->title;?></h3>
                    </div>
                </a>
            </li>
        <?php endforeach;?>
    </ul>
</div>
<div class="offset3 span6">

    <!-- А вот как вставить видео и включить автопроигрывание-->
    <iframe width="420" height="345" src="http://www.youtube.com/embed/<?php echo $video->video_id; ?>?rel=0&autoplay=1"></iframe>
</div>

Роутинг

Я знаю что вы уже заждались самого кода, но перед тем как мы перейдем к контроллеру нам надо прописать его в /assets/config/routes.php. На самом деле в базовом проекте прописан только один роут и он выглядит как /контроллер/метод/id, что в принципе нас устраивает, но было б очень кстати по менять дефолтный контроллер из Hello на наш Videos.

return array(
    'default' => array('(/<controller>(/<action>(/<id>)))', array(
                    // Дефолтные значения
                    'controller' => 'Videos',
                    'action' => 'index'
                    )
                ),
);

Контроллер

Поскольку нам нужны 3 страницы в контроллере должно быть 3 метода. Вот с чего мы начнем:

namespace App\Controller;

class Videos extends \App\Page {

    public function action_index(){
        $this->view->subview = 'list';
        $this->view->videos  = $this->pixie->orm->get('video')->find_all();
    }

    public function action_add(){
        $this->redirect('/');
        //Об этом чуть позже
    }

    public function action_view(){
        $this->view->subview = 'view';

        //Берем id с URL: /video/view/3
        $id = $this->request->param('id');
        $this->view->video = $this->pixie->orm->get('video')
                                                ->where('id', $id)
                                                ->find();
    }
}

Задачи выбора всех и одного видео тривиальны.
Рассмотрим теперь добавление нового видео. Идентификатор видео в ссылке ютуба передается параметром ‘v’, например www.youtube.com/watch?v=75nBenOWul0, мы можем достать его множеством способов, но наиболее аккуратным мне показался с использованием parse_url(), вот так:

parse_str(parse_url( $url, PHP_URL_QUERY ), $vars );
$video_id = $vars['v']; 

Получить информацию о ролике, в нашем случае его имя, можно используя API по ссылкеyoutube.com/get_video_info?video_id=<id видео>. Используя эти знания мы теперь можем дописать недостающий action_add():

    public function action_add(){
        if($url = $this->request->post('url')){
            parse_str(parse_url( $url, PHP_URL_QUERY ), $vars );
            $video_id = $vars['v']; 
            $response = file_get_contents("http://youtube.com/get_video_info?video_id=".$video_id);
            parse_str($response, $data);
            $video = $this->pixie->orm->get('video');
            $video->title = $data['title'];
            $video->video_id = $video_id;
            $video->save();
        }
        $this->redirect('/');
    }

И вуаля! Вот кстати скриншот результата:
1lb4YXY1

Если вы ожидали более сложного контроллера или конфигурации то их нет, да и самого фреймворка почти не заметно, это и позволяет сконцентрироваться как раз на написании своего кода вместо изучения чужого.
Надеюсь пост вам понравился, а в другой раз мы будем учится писать на Lithium.