Pull to refresh

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

PHP *Programming *
Tutorial
image
После моего предыдущего поста о выборе легкого Фреймворка я погуглил и увидел что для некоторых из них нет ни одного русскоязычного туториала. Так вот я решил написать серию постов дабы заполнить эту нишу. Я думаю стоит начать с тех на которых я в конце остановился, а так как для 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('/');
	}


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

Если вы ожидали более сложного контроллера или конфигурации то их нет, да и самого фреймворка почти не заметно, это и позволяет сконцентрироваться как раз на написании своего кода вместо изучения чужого.
Надеюсь пост вам понравился, а в другой раз мы будем учится писать на Lithium.
Tags:
Hubs:
Total votes 35: ↑26 and ↓9 +17
Views 19K
Comments Comments 17