Вредный и его заметки

Ruby для начинающих CMS

Вредный — Sat, 04 Feb 2012 23:24:29 +0000

Данная заметка посвящена целиком Sinatra фреймворку на Ruby, а точнее написанию небольшой, простой CMS. Это ведь следующая стадия после ‘hello, world’ в изучении нового языка. Поехали!

План по реализации CMS

Написание требований (куда без них)
Используемые гемы
Создание необходимых моделей
Написание кода экшнов
Наведения марафета
Деплой на хероку

1. Написание требований

Целью данной CMS должно быть введение новичков, таких же как и я, в богатый и интересный мир Ruby. Поэтому приложение не должно быть перенасыщено функциональстью, чтобы не отвлекать от главных моментов. «Рюшечки» мы всегда сумеем прикрепить. Поэтому основные требования заключаются в следующем:

Backend
- Создание/редактирование/удаление статичных страниц
  - должна будет отображаться форма с текстовыми полями, контентное поле должно быть заменено wysiwyg, я выбрал для этих целей redactor.js (давно хотел с ним познакомиться, видимо, время пришло)
  - у каждой страницы будет две метки времени: метка создания (заполняется автоматически при создании новой страницы) и метки обновления (время изменения страницы)
- Отображение списка страниц в возможностью из него удалить или редактировать любую.
- Должна быть реализована базовая аутентификация, чтобы люди с улицы не смогли проникнуть в «админку»
- Приятный интерфейс
- Редирект на список страниц после создания/редактирования или удаления
Frontend
- Динамически строемое меню, содержащее все страницы в виде ссылок, чтобы можно было «погулять» по разделам
- Приятный интерфейс
- Ссылки вида /contacts.html, чтобы выглядело эстетично.
- При заходе на главную (/) пользователь видит домашнюю страницу, также со списком всех имеющихся страниц.

2. Используемые гемы

Теперь перейдем непосредственно к реализации написанной выше функциональности. В первую очередь нам понадобится data_mapper, гем который очень облегчает жизнь разработчикам, которые используют базы данных, правда некоторые выбирают Active Record, но разъяснение разницы лежит за пределами этой заметки.
Итак, Datamapper — прослойка между БД и объектом — не нужно писать ни строчки sql кода, создавать таблицы напрямую и изменять их структуру. Datamapper возьмет на себя всю эту грязную работу. Сначала установка
sudo apt-get install libsqlite3-dev
На локальной машине мы будем работать с backend’ом в виде sqlite3, на хероку — postgres. Но нам по этому поводу не нужно переживать: всю грязную работу сделают datamapper и heroku.
Устанавливаем необходимый гем командой
gem install data_mapper
Чтобы не томить нетерпеливых сразу приведу конечный Gemfile, вот так он выглядит у меня:

1
2
3
4
5

source :rubygems
gem 'data_mapper'
gem 'sinatra'
gem 'dm-postgres-adapter'
gem 'dm-sqlite-adapter'

3. Создание необходимых моделей

Модель, спешу я вас обрадовать или огорчить, будет у нас всего одна — это Страница. Для нашего скромного и минималистичного приложения ее будет более чем достаточно. Сначала отвлечемся на config.ru — файл, без которого наше приложения на запустится (о нем я писал в заметке о деплое ruby приложения). Собственно config.ru:

1 2	require './bootstrap.rb' run Sinatra::Application

Здесь, надеюсь, не нужно разъяснения. Далее мы подходим к модели поближе. Перед тем, как описывать подель, нам необходимо подготовить соединение, где-то ведь нам необходимо данные сохранять.

1
2
3
4
5
6
7

# coding: utf-8

require 'rubygems'
require 'sinatra'
require 'data_mapper'

DataMapper.setup(:default, ENV['DATABASE_URL'] || 'sqlite:./db/page.db')

Первая строчка необходима для того, чтобы можно было в исходный код писать символы в utf-8 кодировке. Далее тремя последующими строчками мы подключаем необходимые файлы, один из которых Sinatra, другой — Datamapper. Последняя строчка самая интересная. Она сообщает Datamapper’у, что если не установлена переменная окружения DATABASE_URL (значит, мы на heroku сервере), то использовать локальную базу данных, которая будет находится в папке db.

Теперь непосредственно модель, которая представляет собой класс (неожиданно, неправда ли?), к котому строкой include DataMapper::Resource добавляется множество методов для манипуляции самого Datamapper’а. Точнее вся это функциональность добавляется не к самому класса, к инстансам этого класса. Код модели представлен чуть ниже:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

class Page
include DataMapper::Resource

property :id, Serial
property :name, String
property :alias, String
property :short, Text
property :full, Text
property :seo_title, String
property :seo_keywords, String
property :seo_description, String
property :created_at, DateTime
property :updated_at, DateTime
end

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

1 2	DataMapper.finalize #DataMapper.auto_migrate!

Первая строка говорит Datamapper’у, что все, хватит, больше мы добавлять поля не будем, поэтому можешь не беспокоиться, закоментированная же строка применялась мною на этапе разработки, потому что количество столбцов и их тип менялись очень часто.
С моделью в общих чертах разобрались, все необходимые моменты будут расталкованы мною чуть дальше, когда мы коснемся момента реализации.

4. Написание кода экшнов

На стороне backend’а у нас будет 6 так называемых экшнов, т.е. действий, которые будут выполняться в зависимости от контекста.

Создание страницы:

1
2
3

get '/admin/create' do
erb :create_form
end

Здесь все просто, когда пользователь запрашивает страницу /admin/create (метод get), ему нужно отобразить форму для добавления новой страницы (erb :create_form — рендерит ./views/create_form.erb). Код формы выглядит очень просто:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

<h3>Форма страницы</h3>
<form method="post" action="/admin/create">
<label for="name">Имя страницы:</label>
<input id="name" type="text" name="name" value="">
<br>

<label for="alias">Псевдоним:</label>
<input id="alias" type="text" name="alias" value="">
<br>

<label for="short">Краткое описание:</label>
<input id="short" type="text" name="short" value="">
<br>

<label for="full">Контент:</label>
<textarea id="full" class="wysiwyg" name="full"></textarea>
<br>

<label for="seo_title">SEO заголовок:</label>
<input id="seo_title" type="text" name="seo_title" value="">
<br>

<label for="seo_keywords">SEO ключевые слова:</label>
<input id="seo_keywords" type="text" name="seo_keywords" value="">
<br>

<label for="seo_description">SEO описание:</label>
<textarea name="seo_description" id="seo_description" rows="2"></textarea>
<br>

<input type="submit" name="submit" value="Создать" class="btn btn-primary">

</form>

Единственно место, на которое стоит обратить внимание это свойства тега form, а именно

1	method="post" action="/admin/create"

, тем самым мы устанавливаем метод отправки формы в post (по умолчанию все формы отправляются get-методом) на страницу /admin/create, где мы полученные данные и будем поджидать, чтобы записать в базу данных.

Сохранение страницы:

1
2
3
4
5
6

post '/admin/create' do
params.delete 'submit'
params[:updated_at] = params[:created_at] = Time.now
@page = Page.create(params)
redirect '/admin/pages'
end

params — содержит все переменные нам переданные. Для начала нам необходимо исключить свойство submit (это кнопка отправки формы), которого нет в нашей модели. Дальше мы присваеваем меткам и создания, и обновления текущее время и дату, а команда Page.create(params) — создает новую запись в таблице и сохраняет ее с переданными нами из формы данными. Последняя строчка перенаправляет пользователя на страницу, где отображаются все записи, мы к ней еще вернемся.

Редактирование страницы:

С этим моментом все очень похоже, кроме нескольких моментов: 1) перед отправкой формы нам необходимо ее заполнить уже имеющимися данными, 2) применить не метод create (как при создании), а присвоить атрибуты напрямую и сохранить.

1
2
3
4

get '/admin/edit/:id' do
@page = Page.get(params[:id])
erb :edit_form
end

Если пользователь нажал на ссылку из списка страниц (/admin/edit/1, к примеру) и мы допускаем, что запись в таблице с таким id содержится (проверка на корректность «раздула» бы код и усложнила бы его понимание, поэтому данный момент я оставлю на вашей совести).
@page = Page.get(params[:id]) — получаем запись из таблицы с заданным id, дальше нам остается отрендерить страницу ./views/edit-form.erb и ждать пока пользователь нажмет на кнопку submit.
А пока ./views/edit_form.erb:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

<h3>Форма страницы</h3>
<form method="post" action="/admin/edit/<%= @page.id %>">
<label for="name">Имя страницы:</label>
<input id="name" type="text" name="name" value="<%= @page.name %>">
<br>

<label for="alias">Псевдоним:</label>
<input id="alias" type="text" name="alias" value="<%= @page.alias %>">
<br>

<label for="short">Краткое описание:</label>
<input id="short" type="text" name="short" value="<%= @page.short %>">
<br>

<label for="full">Контент:</label>
<textarea id="full" class="wysiwyg" name="full"><%= @page.full %></textarea>
<br>

<label for="seo_title">SEO заголовок:</label>
<input id="seo_title" type="text" name="seo_title" value="<%= @page.seo_title %>">
<br>

<label for="seo_keywords">SEO ключевые слова:</label>
<input id="seo_keywords" type="text" name="seo_keywords" value="<%= @page.seo_keywords %>">
<br>

<label for="seo_description">SEO описание:</label>
<textarea name="seo_description" id="seo_description" rows="2"><%= @page.seo_description %></textarea>
<br>

<input type="submit" name="submit" value="Сохранить" class="btn btn-primary">

</form>

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

1
2
3
4
5
6
7
8
9
10
11

post '/admin/edit/:id' do
@page = Page.get(params[:id])
params.delete 'submit'
params.delete 'id'
params.delete 'splat'
params.delete 'captures'
params[:updated_at] = Time.now
@page.attributes = params
@page.save
redirect '/admin/pages'
end

Он у меня получился самым раздутым, скорее всего, из-за не знания языка, но я только учусь, а как говорится лучшее — враг хорошего, поэтому не обращаем на это внимание и продолжаем двигаться дальше.
После первой строки @page = Page.get(params[:id]), @page — является строкой в таблице, следующие 4 строки удаляют ненужные параметры, пришедшие к нам из формы, или из фреймворка (последние 2 подсовывает нам Sinatra).
params[:updated_at] = Time.now — обновляет временную метку, почти не отличается от строки в создании новой странице, только тут мы не трогаем дату и время создания, потому что она остается неизменной на протяжении всей жизни записи.
Строки @page.attributes = params и @page.save обновляют свойства и записывают уже измененную модель в базу данных. Последняя строка вам уже известна, она перенаправляет пользователя на страницу списка записей. Тут, по-хорошему, нужно было добавить проверку на успешность записи и вслывающее сообщение после редиректа, пусть будет это для вас как домашнее задание, кому интересно.

Удаление страницы:

1
2
3
4

get '/admin/delete/:id' do
Page.get(params[:id]).destroy
redirect '/admin/pages'
end

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

Сейчас разберем список страниц, который отбражается на странице /admin/pages

1
2
3
4

get '/admin/pages' do
@pages = Page.all
erb :pages
end

После этих панипуляций @pages содержит все записи из таблицы, и эта переменная доступна нам в шаблоне, а шаблон, как вы, наверное, уже успели догадаться, называться будет ./views/pages.erb, вот его код:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

<h6>Список страниц</h6>
<table class="table-striped table">
<thead>
<tr>
<th>Имя</th>
<th>Псевдоним</th>
<th>Заголовок</th>
<th>Создана</th>
<th>Изменена</th>
<th> </th>
</tr>
</thead>
<tbody>
<% @pages.each do |page| %>
<tr>
<td><a href="/admin/edit/<%= page.id %>"><%= page.name %></a></td>
<td><%= page.alias %></td>
<td><%= page.seo_title %></td>
<td><%= page.created_at.strftime("%d.%m.%Y %H:%M") %></td>
<td><%= page.updated_at.strftime("%d.%m.%Y %H:%M") %></td>
<td><a href="/admin/delete/<%= page.id %>" onclick="javascript: return confirm('Вы уверены в этом?')"><i class="icon-remove"></i></a></td>
</tr>
<% end %>
</tbody>
</table>

<h5><a href="/admin/create">Создать новую страницу</a></h5>

По сути это проста таблица, каждая строка которой является строкой в таблице в базе данных. Строкой @pages.each do |page| мы начинаем цикл по всем записям переменной @pages, помните, которую мы объявили немногим ранее? Прозорливые умы, наверное, догадались, что означает конструкция

1	page.created_at.strftime("%d.%m.%Y %H:%M")

Вы правы, этой строкой мы превращаем дату и время из формата, в котором она хранится в базе данных в удобочитаемый формат понятный и приятный глазу человеческому.

1	onclick="javascript: return confirm('Вы уверены в этом?')"

Отображает стандартное браузерное окошко с вопросом, если пользователь отвечает на него утвердительно, то строка из таблицы удаляется, иначе же ничего не происходит (примитивная защита от дурака).

С backend’ом почти разобрались, остались небольшие штришки, давайте перейдем к frontend’у, чтобы можно было посмотреть на результат своей нелегкой деятельности.

Отображаем главную страницу

1
2
3
4
5

get '/' do
@page = Page.first(:alias => 'mainpage')
@pages = Page.all(:alias.not => 'mainpage')
erb :page
end

Небольшое отступление: Поиск страниц у нас будет осуществляться по полю alias, т.е. псевдоним, в базе данных он будет храниться в виде строки, к примеру, mainpage, contacts, about и т.д. Mainpage с маленькой буквы я буду использовать для задания главной страницы, которая и будет отбражаться по адресу ‘/’.

1	@page = Page.first(:alias => 'mainpage')

находит первую попавшуюся страницу, в поле alias которой стоит значение ‘mainpage’ (по-хорошему, нужно было на это поле поставить индекс и сделать его уникальным, но не об этом речь). Следующая строка получает все страницы, кроме mainpage (будем строить простейшее меню на сайте).

И отображаем страницу ./views/page.erb:

1
2
3
4
5
6

Где все остальное спросите вы, не торопитесь, отвечу я, все будет .
Что за странные классы с непонятными именами предчувствую вопрос и сразу отвечу на него. Т.к. из меня верстальшик, тем более дизайнер, некудышний (я уже смирился с этим), приходится использовать готовые решения, такие как css-фреймворки, в данном проект используется twitter bootstrap — аккуратный, легкий, приятный глазу, что несказанно облегчает жизнь таким как я разработчикам, которые хотят разрабатывать проекты, но «верстальным» талантом их обделили высшие силы . Twitter, с тебя $10 за рекламу .

Давайте сначала разберем последний на стороне backend’а экшн и перейдем непосредственно к шаблонам. Итак,

1
2
3
4
5
6
7
8
9
10
11

get '/:alias.html' do
@page = Page.first(:alias => params[:alias])
not_found 'Страница не найдена' if @page.nil?
@pages = Page.all(:alias.not => 'mainpage')
erb :page
end

not_found do
erb :'404', {:layout => false}
end

Получилось сразу два: первый почти ничем не отличается от предыдущего, рассмотренного нами, кроме вызова not_found, если @page.nil? (если страница не найдена), второй является хелпером, который вызывается, если страница не найдена.

1	erb :'404', {:layout => false}

рендерит ./views/404.erb с отключенным шаблоном.

Пару слов о шаблонах

Шаблон представляет собой двухуровневый рендеринг: сначала рендерится непосредственно сама страница экшна, указанного нами в конструкции erb :page, дальше, если не указано обратное, рендерится файл ./views/layout.erb и в часть, где указано =yield, вставляется первый кусок, что заметно облегчает жизнь, сокращая код представлений экшнов. Самое главное в этом моменте правильно вычленить повторяющиеся во всех страницах элементы от изменяющихся.
Раз уж коснулись шаблонов, приведу шаблон, который рендерится на стороне frontend’а, ./views/layout.erb:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

<html lang="en">
<head>
<meta charset="utf-8">
<meta name="description" content="<%= @page.seo_description %>">
<meta name="keywords" content="<%= @page.seo_keywords %>">
<meta name="author" content="@vredniy">
<title><%= @page.seo_title %></title>
<link rel="stylesheet" href="/css/bootstrap.css">
</head>
<body>
<div class="container-fluid">
<div class="row-fluid">
<div class="span2">
<h3>Главное меню</h3>
<ul>
<li><a href="/">Главная</a></li>
<% @pages.each do |page| %>
<li><a href="/<%= page.alias %>.html"><%= page.name %></a></li>
<% end %>
</ul>
</div>
<div class="span10">
<%= yield %>
</div>
</div>
</div>
</body>
</html>

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

Шаблон для административной части я не буду приводить здесь, для экономии места, в конце будет ссылка на работающий репозиторий, который вы можете склонировать и запустить у себя локально или задеплоить на heroku.

Осталось еще пара недосказанных моментов: аутентификация и изменения шаблона для закрытой (backend) части.
Что касается первого, то тут все предельно просто, будем использовать базовую аутентификацию, которую нам представляет прослойка в виде Rack. Реализуем, как рекомендуют на сайте документации Sinatra, через хелперы, вот и сам код:

1
2
3
4
5
6
7
8
9
10
11
12
13

helpers do
def protected!
unless authorized?
response['WWW-Authenticate'] = %(Basic realm="Cms's restricted area")
throw(:halt, [401, "Not authorized\n"])
end
end

def authorized?
@auth ||= Rack::Auth::Basic::Request.new(request.env)
@auth.provided? && @auth.basic? && @auth.username && @auth.credentials == ['admin', 'password']
end
end

В экшне, который мы хотим закрыть от посторонних глаз нужно будет написать protected!, тем самым вызвать хелпер, который проверит, авторизован пользователь или нет, если нет, отобразит стандартное окно браузера с полями для ввода логина и пароля.

Т.к., мы, программисты, люди ленивые, нам сложно писать для каждого экшна /admin* слово protected!, поэтому мы пойдем другим путем, а именно используя фильтр before, который вызывается перед каждым запросом, напишем две строки кода.

1
2
3
4

before '/admin/*' do
protected!
@default_layout = :admin
end

Первая строка, как и упоминали «защищает» от посторонних глаз все закрытые части приложения, вторая же для всех закрытых частей меняет шаблон по умолчанию на admin, т.е. ./views/admin.erb

5. Наведения марафета

Чтобы придать немного эстетичности нашему простому приложению мы будем использовать сторонние инструменты, в частности twitter bootstrap и redactor от imperavi. Все эти файлы уже имеются в репозитории на github, тут они будут лишь занимать ценное место. Еще приведу структуру папок данного приложения, чтобы вы не путались что и куда.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

.
├── bootstrap.rb
├── config.ru
├── db
│   └── page.db
├── Gemfile
├── Gemfile.lock
├── public
│   ├── css
│   ├── favicon.ico
│   ├── img
│   └── js
├── README
└── views
├── 404.erb
├── admin.erb
├── create_form.erb
├── edit_form.erb
├── layout.erb
├── page.erb
└── pages.erb

6. Деплой на хероку

Деплой почти ни чем не отличается от деплоя из предыдущей заметки, кроме переноса локальной базы данных на удаленный сервер heroku.

1	heroku db:push sqlite://db/page.db

Молодцы heroku и эту возможность предусмотрели, после успешного выполнения данной команды, локальная база данных из sqlite3 скопируется в удаленную postgres.

если у вас на локальной машине стоял ruby 1.9.3, как у меня, то придется откатиться до версии 1.9.2. Это нужно для того, чтобы запушить локальную базу данных на хероку. Если вам это не нужно, то пропустите это шаг.

Заключение

Этой заметкой я закрпеляю небольшой логический этап в освоении мною нового для меня языка ruby. Язык мне очень нравится, но сразу переключиться на него попросту не могу. Синтаксис приятный глазу, легкие конструкции, шустрые фреймворки, работающие из коробки. Осталось только поделиться ссылкой на репозиторий на github и работающий проект на heroku. Оставляйте комментарии, задавайте вопросы, поправляйте, если найдете неточности — я открыт для обсуждений, на этом я прощаюсь с вами и до новых встреч
P.S.: вот так должно выглядеть приложение в конце

Деплой ruby приложения на heroku

Вредный — Fri, 03 Feb 2012 19:51:25 +0000

Здравствуйте, уважаемые программисты или те, кто попал сюда случайно, сегодня речь пойдет о деплои ruby приложения на heroku. Бесплатный для небольших приложений хостинг, полюбившийся многим ruby, python разработчикам.

Почему heroku?

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

Инструментарий для деплоя

*nix система, куда без нее? ) установленный ruby, git, если вы знаете слово деплой, значит, для вас это до боли знакомые слова )

Итак, начнем

Регистрируемся на сайте heroku (куда в наши дни без регистрации? ). Создаем папку где будем размещать наше sinatra-приложение (почему именно sinatra? потому что мне нравится этот фреймворк — он легкий, несложный и позволяет сосредоточиться на изучении языка) на локальной машине, пусть это будет ~/projects/heroku-sinatra.
Далее создаем (как и для всех Rack-подобных приложений) файлы в корне config.ru и Gemfile
config.ru будет содержать следующее:

1
2
3

require './app/bootstrap.rb'

run Sinatra::Application

этим самым мы подключаем файл приложения и запускаем оное.

Далее Gemfile для управления зависимостями, т.к. наше приложение простое и создано специально для ознакомления, нам достаточно написать пару строк:

1
2
3

source :rubygems

gem 'sinatra'

Далее создадим файл ./app/bootstrap.rb, который и будет являться нашим несложным приложением для экспериментов.

1
2
3
4
5
6

require 'rubygems'
require 'sinatra'

get '/' do
erb "Hello, world, from Heroku at #{Time.now}"
end

Осталось несколько команд до деплоя. Тут вступает в дело gem heroku

gem install heroku — устанавливаем необходимый гем, если вы еще не сделали этого ранее.

Далее нужно рассказать heroku кто же собирается деплоить (или попросту представиться, воспитанные ведь мы), для этого пишем в консоли

heroku login

и вписываем почту, которую вы указали в первом шаге (мы ведь ее еще помним, правда?) и пароль, который придет на email.

Половина дела сделана, остались сущие пустяки.

git init — инициализируем git репозиторй
git add . — добавляем в него все файлы (рекурсивно)
git commit -am ‘hello heroku’ — сохраняем изменения в локальном репозитории
heroku create %желаемое имя приложения% — мы ведь хотим чтобы наше первое приложение имело благозвучное имя, если нет, то последний параметр можно опустить, heroku тоже умеет придумывать неплохие имена )

git push -u heroku master — отправляем приложение на сервер

После успешного деплоя

Если все прошло гладко, такое разве бывает спросите вы, бывает — отвечу я.
heroku open запустит нам наше приложение в браузере (нам ведь сложно оторваться от так полюбившейся консоли и взять в руки мышку, чтобы запустить браузер)

Возможные проблемы

Здесь небольшой список проблем, с которыми вы можете столкнуться (с которыми столкнулся я) при деплое.

Проблема с ключами — «Permission denied (publickey)», то
heroku keys::add ~/.ssh/id_rsa.pub — отправляем наши публичные ключики на сервер, чтобы heroku знал с кем имеет дело. Если нет ключа, то генерируем его

ssh-keygen -t rsa — и клацаем несколько раз Enter.

В приложение закралась ошибка, то
heroku logs — отобразит логи, в которых можно будет отыскать «косячное» место, исправить его и попробовать снова. Нам, разработчикам, сдаваться никак нельзя

Теперь ваше ‘Hello, world’ на Ruby, можно показывать друзьям/подругам/бабушке, да вообще кому захотите. Удачи вам в кодинге и меньше коварных ошибок в приложениях.
В комментариях жду вопросов, если таковые появятся или предложения от руби-гуру, где накосячил я, я исправлюсь, чесслово

Sinatra и Whois gem: маленькое приложение

Вредный — Thu, 17 Nov 2011 22:26:34 +0000

Здравствуйте, уважаемые коллеги и те, кто может случайно забрел на мой блог. Сегодня речь пойдет о Ruby, но я не буду вдаваться в подробное описание языка, поэтому ограничимся базовой функциональностью замечательного фреймворка Sinatra.

Вступление

Мой отпуск подходит плавно к концу, но чтобы не зря тратить время решил я посвятить его изучению нового для меня языка программирования. Почему Ruby, возможно назреет у вас вопрос. Отвечу так: я долго шел к смене языка программировани, нет, это не из-за того, что мне не нравится PHP, отнюдь, но захотелось чего-то другого во время отпуска, тем более, что время позволяет. Прежде чем остановиться на Ruby, мною было прочитано много килобайт материала, просмотрено много мегабайт видео презентаций и скринкастов, и я решил более не задаваться глупыми вопросами, а может Python, может еще что-нибудь, решил просто попробовать.

Почему Sinatra, а не Rails? Все просто: чтобы понять как работает такой большой веб-фреймворк, как Rails, понадобится намного больше времени, да и понять его без хорошего знания Ruby, я не рискну, а Sinatra в этом отношении в разы полегче, можно сказать, что это чистый Ruby.

Постановка задачи

Задача будет проста до безумия: у нас будет иметься одна страница с одним текстовым полем. Если мы введем туда корректное имя домена, приложение ответит нам доступен ли домен для регистрации и срок истечения, если домен зарегистрирован.

Используемый инструментарий

В первую очередь нам, конечно же, понадобится сервер с установленным на нем Ruby, локальный вполне подойдет. В этой короткой заметке я не буду рассказывать как его [сервер] установить, в интернете полным-полно подобных мануалов и раскрывают они тему исчерпывающе. В дополнение к гему sinatra, нам также понадобятся: whois (http://goo.gl/0jEJA) и гем json (им мы будем отдавать ответ).

Реализация

Приложение у нас будет состоять из двух экшнов: первый это главная страница, на которой и будет отображаться текстовый элемент и экшн, который будет отвечать за прием данных по средством AJAX, отправку запроса серверу whois и возвращению ответ в формате JSON.
Шаблонизатором у нас будет выступать HAML, очень удобная и простая штука, так что приведу код шаблона главной страницы в формате haml.

1
2
3
4
5
6
7
8
9
10
11
12
13

!!!
%html
%head
%meta{:content => "text/html; charset=UTF-8", "http-equiv" => "content-type"}/
%script{:type => 'text/javascript', :src => 'http://yandex.st/jquery/1.7.0/jquery.min.js'}
%script{:type => 'text/javascript', :src => '/javascripts/default.js'}
%title Маленькое приложение на Руби (Sinatra, Whois, Json)
%body
%div
%p Впишите какой-нибудь, желательно, корректный домен и нажмите Enter
%form{:method => 'post', :action => '/ajax.json'}
%input{:type => "text", :name => "domain"}
%ul{:id => 'info'}

Также приведу исходных код экшна главной страницы, который занимает всего 1 строчку. Его задача только отобразить шаблон.

1
2
3

get '/' do
haml :index
end

Наш AJAX экшн будет срабатывать по POST запросу при отсылке данных по адресу /ajax.json

1
2
3
4
5
6
7
8
9
10
11

post '/ajax.json' do
domain = params[:domain]

begin
info = Whois.query(domain)
rescue Whois::ServerNotFound
end
content_type :json

{ :domain => domain, :info => {:available => info.available?, :registered => info.registered?, :expires => info.expires_on} }.to_json unless info.nil?
end

В первой строке которого мы получаем имя домена через форму. Далее получаем необходимую информацию о домене, для того чтобы не сыпались в приложении исключения я оборачиваю вызов кода, который легко может выбросить исключения в обертку аля PHP try-catch. content_type json, как вы догадались, устанавливает формат ответа. В последней строке мы формируем JSON. Что удобно в Ruby, так это то, что не нужно возвращать значения, данный язык делает это сам, т.е. последняя строка в методе возвращает значение.

Осталось только связать нашу форму на главной странице и AJAX экшн. Для этих целей очень хорошо подойдет несколько строк на замечательном JavaScript-фреймворке jQuery. Задача — отправить AJAX запрос методом POST, дождаться ответа от сервера и заполнить список полями из полученного JSON.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

$(function() {
$('form').submit(function() {
$.post('/ajax.json', $(this).serialize(), function(data) {
if (!data) {
alert('Что-то пошло не так (');
return;
}
$('ul#info > *').remove();
$.each(data.info, function(field, value) {
$('ul#info').append('

' + field + ' ' + value + '

')
});
console.log(data);
}, 'json');
return false;
});
});

Исходный код

Исходный код вы можете посмотреть на гитхабе, здесь.

Заключение

Это была моя первая заметка на тему Ruby, надеюсь, мой блог и дальше будет пополняться подобными постами, потому что язык мне очень нравится, нравится своей гибкостью и необычностью (как программист на PHP говорю). Спасибо зв внимание и до новых встреч.

Здоровый образ жизни и я

Вредный — Tue, 27 Sep 2011 19:34:39 +0000

Здравствуйте, уважаемые читатели моего техничесого блога. Сегодня занимательный для моего блога день — день, когда я решил разбавлять свои технические заметки заметками о спорте, книгаж, жизни и просто интересных вещах, в моей жизни которые происходят.

Сегодня немного о спорте: в тренажерный зал записался два с половиной месяца назад и за это время (выполнял только базовые упражнения, чтобы мыщцы после долгой пассивно-сидячей жизни привести в тонус) достиг кое-каких результатов. Веса может быть и стали намного больше, может и вообще больше не стали, но чувствовать я себя стал заметно лучше: ремень на джинсах стал застегиваться на одну-две дырки меньше, чем раньше. Футболки стали немного малы в основании рук — бицепсы и трицепсы дают о себе знать. От живота, конечно, я полносью не исправился, оказывается, сложно это сделать после многолетнего опыта пивопития, неправильного питания и пассивного образа жизни. Но живот стал меньше, хоть и кубиков пока не видать.

Сегодня забрал у тренера свою новую программу, по которой отзанимался шестое занятие. Тренировка расписана на 4 дня тренировки и 3 дня отдыха, т.к. тренажерный зал находится недалеко от места моей работы, поэтому посещение его в выходные дни для меня нецелесообразно.

Теперь подробнее о тренировках: первое что я делаю после того, как вступил в «тренажерку», так это встаю на беговую дорожку и прохожу иногда и пробегаю 10-15 минут, дальше обязательная разминка, чтобы для мыщц упражнения не были большим стрессом. Дальше сам комплекс упражнений, после которого обязательные три подхода упражнений для пресса (3 вида упражнений). Завершает все пробежка 10-15 минутная.

Упражнения:

Понедельник (ноги, спина, бицепс)

Сгибание ног
Жим ногами
Разгибание ног
Тяга вертикального блока к груди руками
Тяга Т-образного грифа
Тяга гантелей одной рукой
Сгибание рук со штангой стоя
Попеременный подъем гантелей стоя.

Вторник (грудь, плечи, трицепс)

Жим штанги на скамье под углом 45 градусов
Жим штанги на горизонтальной скамье
Жим гантелей на скамье под углом 45 градусов
Жим сидя
Задняя дельта
Махи гантелями в стороны сидя
Брусья
Разгибание «канатом»

Среда (отдых)

Четверг (ноги, спина, бицепс)

Жим ногами
Сведение ног
Тяга вертикального блока к груди широким хватом
Тяга горизонтального блока
Сгибание рук через пюпитр
Сгибание рук («молот» или «блок»

Пятница (грудь, плечи, трицепс)

Разводка гантелей (30 градусов)
Сведение рук в тренажере
Жим гантелей сидя
«Протяжка»
«Французский жим» лежа
Разгибание одной рукой.

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

PHP замыкания и немного рефлексии

Вредный — Fri, 26 Aug 2011 12:29:19 +0000

Это будет очень короткая заметка и больше экспериментальная. Вчера вечером смотрел Sinatra (фреймворк на базе Ruby) и меня он покорил своей легкостью. Да вообще мне очень нравится Ruby, обязательно его в скором будущем выучу, а сейчас поговорим о PHP. Заметка сводится к тому, что я попытался реализовать функционал Sinatra на PHP. Таких велосипедов, скажите вы, превеликое множество и несомненно будете правы. Но я нашел в сегодняшнем велосипедостроение очень много для себя полезного. Да и «фреймворк» (фреймворком пока назвать его очень сложно, но начало положено) получился очень маленьким — около 40 строк.

Описание фреймворка

Фреймворк может обрабатывать GET запросы, учитывая маршрутизацию, которая задется регулярным выражением с любым количеством параметров. С выходом 5.3 версии PHP нам стали доступны так называемые замыкания или анонимные функции (кому как нравится). Вот именно и благодаря замыканиям фреймворк получился очень маленьким. Когда придумывал ему название (ведь каждый программист должен назвать свое детище), в интернете натолкнулся на картинку жирафа, так и обрел название мой фреймворк (Jirafa на испанский манер).

Использование

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

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

1
2
3
4
5
6

$app = new Jirafa();

$app->setRegistry(array(
'viewObject' => 'may be smarty',
'dbObject' => new PDO('sqlite:./db/db.db') //'may be pdo or something else'
));

Метод setRegistry() используется мною для того, чтобы передать во все функции необходимые параметры, это могут быть и шаблонизаторы, и PDO объекты, да вообще все что угодно можно передать. А дальше несколько строк кода для демонстрации.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

$app->get('/', function() use ($registry) { // показываем главную
return '
1hi ';
})
->get('404', function($registry) { // отображается, если ни один маршрут не подошел
var_dump($registry);
return '

Error 404

';
})
->get('(\w+).html', function ($alias, $registry) { // example.com/static.html
$pdo = $registry['dbObject'];
$html = 'Error';
try {
$row = $pdo->query("SELECT * FROM content WHERE alias='{$alias}'")->fetch();
$html = "

{$row['title']}

{$row['content']}

";
} catch (PDOException $e) {
return $e->getMessage();
}
return $html;
})

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

Исходный код фреймворка

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

class Jirafa
{
protected $_app = array();
protected $_registry;

public function get() {
$args = func_get_args();
$this->_app[array_shift($args)] = array_shift($args);

return $this;
}

public function render() {
$uri = ($_SERVER['REQUEST_URI'] === '/') ? '/' : substr($_SERVER['REQUEST_URI'], 1);
// iterate over all paths
foreach($this->_app as $path => $func) {
// if $uri and regular expression are matched
if (preg_match('@^' . $path . '\/*$@', $uri, $matches)) {
var_dump($path);
array_shift($matches);
$countInPath = count($matches);

$reflection = new ReflectionFunction($func);
$params = $reflection->getParameters();

$array = array();
foreach($params as $param)
$array[$param->getName()] = array_shift($matches);

//if (count($array) !== $countInPath + 1)
//goto error;

echo call_user_func_array($func, array_merge($array, array('registry' => $this->_registry)));
return;
}
}
//error:
echo call_user_func_array($this->_app['404'], array('registry' => $this->_registry));
}

public function setRegistry($registry) {
$this->_registry = $registry;
}
}

Метод get() в нем очень простой, он записывает обрабатываемый маршрут и параметры, с которыми данный метод был вызван (понадобится нам в дальнейшем для заполнения параметров в функции). Для удобство возвращаем свой же объект, чтобы сократить код приложения.

Метод render() находит соответствие сохраненных методом get() маршрутов и $_SERVER['REQUEST_URI']. Если соответствие найдено, то мы с помощью рефлексии (Reflection) получаем данные нашего замыкания (как называются переменные и их количество). Далее с помощью замечательного метода call_user_func_array(), позволяющего вызывать функцию или метод с переменным количество аргументов, мы вызываем функцию нашего исключения, передавая ей в качестве параметров, помимо запрашиваемых, еще и переменную $this->_registry, которая, как я уже упоминал выше, может содержать вспомогательную информацию, необходимую для работы приложения.

Заключение

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

MongoDb и PHP

Вредный — Fri, 19 Aug 2011 21:46:43 +0000

NoSQL — что за странная аббревиатура?

Наверное, какждый из вас уже слышал эту аббревиатуру, может даже вы «щупали» ее на зубок, а может и используете ее в своих проектах на продакшн серверах. Данная технология в момент ее появления наделала много шуму, легко втиснувшись и отобрав кусок хлеба у реляционных баз данных. NoSQL термин означает что это не только (not only) SQL, хотя на первый взгляд кажется, что это не SQL (no). Термин означает множество технологий работы с базами данных в обход стандартной реляционной модели. Данные могут храниться в виде пар ключ-значение, деревьев или документов. Мы с вами рассмотрим последнее.

Описание документо-ориентированных хранилищ

В данной системе управления базами данных единицей хранения информации является некий документ, хранящийся в виде пар ключ-значние и имеющих некие связи.

Что же такое MongoDB?

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

Концепция базы данных не отличима от понятий базы данных в реляционных СУБД. MongoDB также может содержать ноль или более баз данных, которые являются контейнером верхнего уровня.
База данных может содрежать ноль или более коллекций. Коллекциями в контексте СУРБД (здесь и далее система управления реляционными базами данных) являются таблицы.
Коллекция может содрежать в себе документы. В СУРБД это строки.
Документ может состоять из разного количества полей. Если проводить аналогию с реляционной моделью, то это конечно же столбец.
Индексы есть и в MongoDB, и в СУРБД, функции их почти неотлимы.
Курсоры есть в MongoDB, но прямого аналога в реляционной модели нет. Важно понять, что, когда вы запрашиваете MongoDB вернуть вам определенные данные, Mongo возвращает курсор, с помощью которого мы можем подсчитать или пропустить некоторые документы, без нагрузки на сервер.

Установка MongoDB

Подробная информация об установке широко представлена на официальном сайте, поэтому не будем заострять внимание на этом разделе. Я затрону лишь основные моменты, чтобы начать работу.
Пройдемся по шагам, чтобы ее завершить:

Заходим на официальную страницу загрузки, скачиваем подходящую скомпилированную версию.
Распаковываем архив куда угодно и заходим в папку bin. mongod — сервер, mongo — клиентская оболочка — с этими двумя исходниками мы и будем проводить большую часть времени.
Создаем текстовый файл в папке bin, пусть называться он будет mongod.conf
Записываем одну строку во вновь созданный файл dbpath=ПУТЬ-ГДЕ-ВЫ-ХОТИТЕ-ЧТОБЫ-ЛЕЖАЛА-БАЗА-ДАННЫХ. К примеру, на Windows вы можете написать dbpath=c:\mongodb\data, под Линуксом dbpath=/etc/mongodb/data. Указанный путь должен сущестовать (позаботьтесь об этом).
Запустите из папки bin файл mongod с параметром **—config /путь/к/конфигу/mongodb.conf.

Установка завершена. Чтобы это проверить запустите в командной строке клиент (mongo), которые должен автоматически соединиться с запущенным сервером и отобразить приглашение. Попробуйте ввести **help** или db.version(). Пока оставим наш клиент и перейдем к PHP.

PHP и MongoDB

MongoDB на данный момент имеет поддержку почти всех популярных языков программирования, таких как C++, Erlang, Java, Javascript, Perl, Python и PHP. На последнем мы и остановимся.

Описание расширения

Я не буду приводить пример установки раширений для PHP. В нем нет ничего нетривиального. Лучше заострю внимание на чем-нибуь более интересным, чтобы вы после прочтения данной заметки легко написать свое первое приложение с использованием MongoDB. Полное описание расширения вы можете на странице официального руководства (http://www.php.net/manual/en/book.mongo.php).

Соединение

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

1
2
3

$mongo = new Mongo(); // соединяемся с сервером
$db = $mongo->database; // выбираем базу данных

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

$options = array(
'db' => array(
'host' => 'mongodb.example.com',
'port' => '27017',
'username' => 'mongodb-user',
'password' => 'SECRET-PASSWORD',
'dbname' => 'DATABASE-NAME'
)
);

$collectionName = 'COLLECTION-NAME';

$mongo = new Mongo(
"mongodb://{$options['db']['username']}:{$options['db']['password']}@{$options['db']['host']}:{$options['db']['port']}/{$options['db']['dbname']}"
);

$collection = $mongo->$options['db']['dbname']->$collectionName;

Данные пляски очень похожи на DSN, которые повсеместно используется с PDO.

Запись

Соединяться с сервером мы уже научились, также как и выбирать коллекцию. Кстати, если нет коллекции, ничего страшного, если вы будете вносить данные в несуществующую коллекцию, то заботливый Mongo ее для вас создаст. Еще раз убеждаюь, что MongoDB создана для лентяев, которые хотят сосредоточиться только на важных вещах, а на не плясках с бубном.

1
2
3
4
5
6
7

$collection->insert(
array(
'title' => 'Simple Title',
'alias' => 'about',
'content' => 'Lorem Ipsum',
'images' => array('image1.jpg', 'image2.jpg')), // вставляем какие угодно данные, хоть массивы
array("safe" => 1)); // данный параметро сообщает MongoDB проследить за успешностью вставки, обычно этот параметр отключен

Выборка

1 2	$content = $collection->findOne(array('alias' => 'about')); // находим одну запись, удоволетворяющая условию {alias: 'about'} var_dump($content);

Выборка происходит почти также как в реляционных базах данных после слова WHERE (select * from COLLECTION-NAME WHERE alias = ‘about’ LIMIT 1)
Разработчики предусмотрели множество плюшек при выборке, но всех их рассмотреть в данной вводной заметке не представляется возможным, поэтому расскажу еще о выборке с участием регулярных выражений и отклоняюсь.

1
2
3
4
5
6

$cursor = $collection->find(array('word' => new MongoRegex("/{$mask}/ig")))->limit(50);

$words = array();

foreach ($cursor as $o)
$words[] = $o;

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

Изменение

Изменение данных в документах чуть более обширный раздел, заключающий в себе и выборку и запись новых данных. Но не все так сложно, как я малюю. Начну с примера.

1	$collection->update(array('alias' => 'about'), array('$set' => array("title" => 'In MongoDB we trust')));

Данная запутанная с первого взляда запись на самом деле проста, если разбить ее на составляющие. Первый параметр в методе update() отвечая за выборку, т.е. критерии выборки, второй параметр, как будем менять. В данном случае мы установим ($set) заголовок в новый. Отличные от $set параметры вы можете найти в документации к MongoDB. Аналог в виде SQL мог бы выглядеть так

1	UPDATE COLLECTION-NAME SET title = 'In MongoDB we trust' WHERE alias = 'about'

Данного минимума, как я уже упоминал ранее, должно хватить для реализации несложного приложения. Все информацию помимо упомянутого мною в данной заметке, можно получить на официальном сайте MongoDB

Заключение

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

Покерный класс на PHP

Вредный — Thu, 11 Aug 2011 09:52:41 +0000

Приветствую тебя, разработчик или случайно зашедший на огонег в этот уютный технический бложек. Сегодня речь пойдет о несколько математической задаче, хоть и немного там математики, да и она понятна школьнику 5го класса. Сегодня мы научимся распознавать комбинации в Техасском холдеме, именно в такую разновидность покера я играю (играл). Т.к. это очень простой класс на PHP, он не будет иметь определять старшинство одинаковых по названию комбинаций, но разнящихся по номиналу, к примеру стрит до 10 и стрит до 8 будут трактоваться этим классом, как просто стрит. В Техасском холдеме всего 10 комбинаций и мы с вами пройдемся от самой старшей из них — флеш рояль до самой младшей — старшая карта.

Флеш рояль

Высшая кобинация в покере — это стрит (стрейт) флеш до туза.

1
2
3
4

protected function _isRoyalFlush()
{
return ($this->_isFlush() && $this->_isStraight() && array_search(14, $this->_ranks) && array_search('13', $this->_ranks));
}

Немного костыльный способ проверки на флеш рояль: проверяем на наличие стрита, флеша и чтобы наличствовали туз и кароль.

Каре или Quad

Тут проще некуда, нужно наличие четырех одинаковых карт.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

protected function _isQuad()
{

$test = $this->_ranks;

$uniqueElementsCount = array();

foreach($this->_ranks as $key => $card) {
$test = $this->_ranks;
unset($test[$key]);
$uniqueElementsCount[] = count(array_unique($test));
}

return 1 === min($uniqueElementsCount);
}

Стрит флеш

Тот же самый флешрояль, только необязательно, чтобы стрит был до туза (10-валет-дама-кароль-туз).

1
2
3
4

protected function _isStraightFlush()
{
return ($this->_isFlush() && $this->_isStraight());
}

Фул хаус

Это когда три карты одного достоинства и две другого. Не самая удачная реализация

1
2
3
4
5
6
7
8
9
10
11

protected function _isFullHouse()
{
$ranks = $this->_ranks;
sort($ranks);

if ((($ranks[0] == $ranks[1] && $ranks[1] == $ranks[2]) && ($ranks[3] == $ranks[4])) // 1=2=3 and 4=5
|| ($ranks[0] == $ranks[1]) && ($ranks[2] == $ranks[3] and $ranks[3] == $ranks[4])) // 1=2 and 3=4=5
return true;

return false;
}

Флеш

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

1
2
3
4
5
6
7
8
9

protected function _isFlush()
{
$suits = $this->_suits;
sort($suits);
if ($suits[0] === $suits[4])
return true;

return false;
}

Стрит

Вне зависимости от масти, достоинство карт должно быть по старшенству (5 подряд). Из-за того, что туз может в зависимости от ситуации быть и самой старшей, и самой младшей картой, пришлось сделать две проверки.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

protected function _isStraight()
{

$ranks = $this->_ranks;
sort($ranks);

// if Ace is low card in straight
if ($key = array_search(14, $ranks)) {
$tempRanks = $ranks;
unset($tempRanks[$key]);
if (array(2, 3, 4, 5) == $tempRanks) {
return true;
}
unset($tempRanks);
}

// if Ace is high card - default algorithm
$min = $ranks[0];
foreach($ranks as $key => $value) {
$ranks[$key] -= $min;
if ($key != $ranks[$key])
return false;
}
return true;
}

Сет, трипс или тройка

Нужно наличие трех одинаковых карт. Алгоритм опять же далек от совершенства, но он выполняет свою работу.

1
2
3
4
5
6
7
8
9
10
11

protected function _isThreeOfKind()
{
$ranks = $this->_ranks;
sort($ranks);

if (($ranks[0] == $ranks[1] and $ranks[1] == $ranks[2])
|| ($ranks[1] == $ranks[2] and $ranks[2] == $ranks[3])
|| ($ranks[2] == $ranks[3] and $ranks[3] == $ranks[4]))
return true;
return false;
}

Две пары

Из название алгоритма должно быть понятно что к чему.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

protected function _isTwoPairs()
{
$ranks = $this->_ranks;

foreach($ranks as $key => $rank) {
$testRanks = $ranks;
unset($testRanks[$key]);
sort($testRanks);
if (($testRanks[0] == $testRanks[1])
and ($testRanks[2] == $testRanks[3])
and ($testRanks[0] != $testRanks[2])
// exclude full house
and ($testRanks[0] != $ranks[$key])
and ($testRanks[2] != $ranks[$key])
)
return true;
}
return false;
}

Пара

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

1
2
3
4

protected function _isPair()
{
return 4 === count(array_unique($this->_ranks));
}

Старшая карта

Последний абзаци больше для красоты, потому что если ни одна комбинация не подошла, значит комбинация — старшая карта.

1
2
3
4

protected function _isHighCard()
{
return true;
}

Исходный код класса для опеределения покерных комбинаций на PHP

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258

/**
* @author vredniy.ru
*
**/
class Poker
{

protected $_cards = array();
//
protected $_ranks = array();
protected $_suits = array();

public function __construct(array $cards)
{
$this->_cards = $cards;

$rank = null;

foreach($cards as $card) {
switch (strtolower($card['rank'])) {
case 't':
$rank = 10;
break;
case 'j':
$rank = '11';
break;
case 'q':
$rank = '12';
break;
case 'k':
$rank = '13';
break;
case 'a':
$rank = '14';
break;
;
default:
$rank = $card['rank'];
break;
}
$this->_ranks[] = $rank;
$this->_suits[] = $card['suit'];
}
}

public function checkCombination()
{
// is Royal Flush
echo $this->_isRoyalFlush() ? 'royal flush' : 'not royal flush';
echo '
';

// is Quad (four of kind)
echo $this->_isQuad() ? 'quad' : 'not quad';
echo '
';

// is StraightFlush
echo $this->_isStraightFlush() ? 'straight flush' : 'not straight flush';
echo '
';

// is Full House
echo $this->_isFullHouse() ? 'full house' : 'not full house';
echo '
';

// is Flush
echo $this->_isFlush() ? 'flush' : 'not flush';
echo '
';

// is Straight
echo $this->_isStraight() ? 'straight' : 'not straigt';
echo '
';

// is Three of Kind
echo $this->_isThreeOfKind() ? 'three of kind' : 'not three of kind';
echo '
';

// is Two Pairs
echo $this->_isTwoPairs() ? 'two pairs' : 'not two pairs';
echo '
';

// is one Pair
echo $this->_isPair() ? 'pair' : 'not pair';
echo '
';

// is High Card
echo $this->_isHighCard() ? 'high card' : 'not high card';
echo '
';
}

/**
* chech that combination is flush and straight and contains ace and king (exclude straight flush "ace-5")
*
* @return bool
*/
protected function _isRoyalFlush()
{
return ($this->_isFlush() && $this->_isStraight() && array_search(14, $this->_ranks) && array_search('13', $this->_ranks));
}

/**
* check combination is quad (four of kind)
*
* @return bool
*/
protected function _isQuad()
{

$test = $this->_ranks;

$uniqueElementsCount = array();

foreach($this->_ranks as $key => $card) {
$test = $this->_ranks;
unset($test[$key]);
$uniqueElementsCount[] = count(array_unique($test));
}

return 1 === min($uniqueElementsCount);
}

/**
* is a straight and a flush?
*
* @return bool
*/
protected function _isStraightFlush()
{
return ($this->_isFlush() && $this->_isStraight());
}

/**
* is full house?
* (1=2=3 and 4=5) or (1=2 and 3=4=5)
*
* @return bool
*/
protected function _isFullHouse()
{
$ranks = $this->_ranks;
sort($ranks);

if ((($ranks[0] == $ranks[1] && $ranks[1] == $ranks[2]) && ($ranks[3] == $ranks[4])) // 1=2=3 and 4=5
|| ($ranks[0] == $ranks[1]) && ($ranks[2] == $ranks[3] and $ranks[3] == $ranks[4])) // 1=2 and 3=4=5
return true;

return false;
}

/**
* is flush?
*
* @return bool
*/
protected function _isFlush()
{
$suits = $this->_suits;
sort($suits);
if ($suits[0] === $suits[4])
return true;

return false;
}

/**
* check straight. 2 attempt, 'cause ace may be high card, or low.
*
* @return bool
*/
protected function _isStraight()
{

$ranks = $this->_ranks;
sort($ranks);

// if Ace is low card in straight
if ($key = array_search(14, $ranks)) {
$tempRanks = $ranks;
unset($tempRanks[$key]);
if (array(2, 3, 4, 5) == $tempRanks) {
return true;
}
unset($tempRanks);
}

// if Ace is high card - default algorithm
$min = $ranks[0];
foreach($ranks as $key => $value) {
$ranks[$key] -= $min;
if ($key != $ranks[$key])
return false;
}
return true;
}

/**
* is Three of kind
*
* @return bool
*/
protected function _isThreeOfKind()
{
$ranks = $this->_ranks;
sort($ranks);

if (($ranks[0] == $ranks[1] and $ranks[1] == $ranks[2])
|| ($ranks[1] == $ranks[2] and $ranks[2] == $ranks[3])
|| ($ranks[2] == $ranks[3] and $ranks[3] == $ranks[4]))
return true;
return false;
}

/**
* is two pairs
*
* @return bool
*/
protected function _isTwoPairs()
{
$ranks = $this->_ranks;

foreach($ranks as $key => $rank) {
$testRanks = $ranks;
unset($testRanks[$key]);
sort($testRanks);
if (($testRanks[0] == $testRanks[1])
and ($testRanks[2] == $testRanks[3])
and ($testRanks[0] != $testRanks[2])
// exclude full house
and ($testRanks[0] != $ranks[$key])
and ($testRanks[2] != $ranks[$key])
)
return true;
}
return false;
}

/**
* is single Pair
*
* @return bool
*/
protected function _isPair()
{
return 4 === count(array_unique($this->_ranks));
}

/**
* is High Card
*
* @return bool true
*/
protected function _isHighCard()
{
return true;
}

}

Небольшой пример использования

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

require_once 'Poker.php';

$cards = array(
array('suit' => 's', 'rank' => '3'),
array('suit' => 's', 'rank' => '7'),
array('suit' => 's', 'rank' => 'a'),
array('suit' => 's', 'rank' => 't'),
array('suit' => 's', 'rank' => 't')
);

$poker = new Poker($cards);

$poker->checkCombination();

Комбинация из 5 карт для данного класса задается массивом из 5 элементов, которые в свою очередь явлеются ассоциативными массивами (suit — это масть, rank — достоинство карты).
Эпилог
Данный класс можно немного доработать, чтобы вместо название комбинаций, он выводил какой-нибудь балл комбинации, чтобы имелась возможность сравнивать две одинаковых комбинации, но это по желанию и выходит за пределы данной заметки. Также вы можете допилить проверку на корректность заданной комбинации. На этом на сегодня все. Удачи вам в любых начинаниях и продолжениях.

Пишем свой первый фреймворк на PHP

Вредный — Sat, 11 Jun 2011 16:15:56 +0000

Привет тебе, коллега-разработчик или просто случайно зашедший на мой блог посетитель. В сегодняшней заметке я хочу рассказать вам о том, как прошел у меня вчерашний вечер (нет, нет, тут не будет ничего личного, аля покатался на роликах, попил пивка в парке). Как и у каждого веб-программиста рано или поздно возникает идея создать свой велосипед, пусть и с квадратными колесами и вместо руля торчащий штырь. Вчерашним велосипедом для меня стал легкий простой фреймворк, хотя с натяжкой его можно так назвать, но есть несколько моментов в нем, которые могут послужить отправной точкой для создание нечто большего. Ну обо всем по порядку.

Структура папок

Так как на меня большое влияние в последнее время оказал Zend Framework, структура папок, а также несколько еще штук будут очень похожи.

В корне мы имеем две папки app и library. Также в корне есть два файла (опять же все как у ZF) .htaccess (будет перенаправлять все запросы в index.php) и сам index.php, который эти самые запросы принимать будет.

.htaccess и index.php

.htaccess полностью взял с ZF

1
2
3
4
5
6

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]
RewriteRule ^.*$ index.php [NC,L]

Мне этого было более, чем достаточно. По сути этот .htaccess перенаправляет все запросы, если они не ведут на существующую директорию или файл нашему index.php.

index.php

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

// объявляем нужные константы
define('APPLICATION_PATH', realpath(dirname(__FILE__) . DIRECTORY_SEPARATOR . 'app'));
define('LIBRARY_PATH', realpath(dirname(__FILE__) . DIRECTORY_SEPARATOR . 'library'));
// добавляем путь к library к indlude path
set_include_path(implode(DIRECTORY_SEPARATOR, array(
realpath(dirname(__FILE__) . DIRECTORY_SEPARATOR . 'library'),
get_include_path()
)));

// подключаем Автолоадер
require_once 'MVC/Autoload/Autoloader.php';

// регистрируем наш автолоадер
spl_autoload_register(array('MVC_Autoload_Autoloader', 'autoload'));

// создаем инстант нашего "Фронт Контроллера"
// в кавычках он потому, что это вовсе не паттерн Фронт Контроллер )
$frontController = new MVC_FrontController($_SERVER);
// запускаем наше приложение
$frontController->run();

папка library

В данной папке будет пока две директории MVC и Smarty, первая — это наш фреймворк, вторая как вы уже догадались — шаблонизатор

Рассмотрим поподробнее папку MVC
MVC_Autoload_Autoloader

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

class MVC_Autoload_Autoloader
{

public static function autoload($className)
{
// все как в ZF, чтобы отыскать класс заменяем в нем
// '_' на '/'
$className = str_replace('_', '/', $className);
$classPath = LIBRARY_PATH . DIRECTORY_SEPARATOR . $className . '.php';
if (file_exists($classPath) && is_readable($classPath)) {
// подключаем его, если файл имеется и мы имеем к нему доступ
require_once $classPath;
} else {
//throw new MVC_Exception("Class name '{$className}' not found");
}
//echo $classPath;
}

// тут я планировал указывать какие еще префиксы загружать автоматически
public static function registerAutoload()
{

}

}

Класс MVC_Autoload_Resource — будет отвечать за подгрузку контроллеров, правда получился он не особо гибким и пути были жестко прописаны в код (очень не хорошо получилось).

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

class MVC_Autoload_Resource
{
// думал будет у меня несколько ресурсов
// аля контроллеры, модели и прочие штуки
protected static $_resources = array(
'controller' => '@App_Controller_(\w+)Controller@',
);

// метод без проверок, т.к. фреймворк создавался для ознакомительных целей
public static function autoload($className)
{
// пробегаемся по всем ресурсам
// и смотрим на что заканчивает класс
foreach(self::$_resources as $resource => $path) {
// если на то, что нужно подгружаем его
if (ucfirst($resource) == substr($className, -strlen($resource))) {
if (preg_match(self::$_resources[$resource], $className, $matches)) {
self::load($matches[1], $resource);
}
}
}
}

protected static function load($name, $resourceType)
{
switch ($resourceType) {
case 'controller':
require_once APPLICATION_PATH . DIRECTORY_SEPARATOR
. 'controllers' . DIRECTORY_SEPARATOR
. "{$name}Controller.php";

break;

default:
break;
}
}

}

Стукрутра папок в приложении (App)

3 папки: config, controllers, views
config — содержит на данный момент всего один файл с настройками приложения application.php

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

$settings = array(
'application' => array(
'applicationName' => 'first application'
),
// самое интересное, наверное, в этом фреймворке
'routes' => array(
// все рауты имеют имя, шаблон или регулярное выражение
// контроллер, экшн и параметры
'static' => array(
'template' => '^(\w+)\.html$',
'controller' => 'static',
'action' => 'show',
'params' => array(
'name' => 1
)
),
'main' => array(
'template' => null,
'controller' => 'index',
'action' => 'index'
),
'dynamic' => array(
'template' => '^(\w+)\/(\w+)$',
'controller' => 'dynamic',
'action' => 'show',
'params' => array(
'category' => 1,
'article' => 2
)
)
),
'view' => array(
// где будут лежать наши шаблоны (views)
'viewPath' => APPLICATION_PATH . DIRECTORY_SEPARATOR . 'views',
// имя нашего шаблона (layout)
'template' => 'template.tpl'
)
);

Вскользь хочу упоминуть лишь некоторые классы
MVC_Registry — стандартный паттерн Registry без излишеств, нужен нам для того, чтобы хранить данные и предоставлять доступ к ним из любого места в приложении.

MVC_Request — класс запроса, который мы строим в нашем «Фронт контроллере» и передаем в контроллеры приложения. Содержит параметры в запросе, активный контроллер и экшн.

MVC_View — класс, который просто инициализует Smarty и устанавливает все нужные нам значения путей для шаблонов.

«Front Controller»

Этот класс — точка входа для нашего приложение, хоть и должен был он реализован быть как Одиночка (Singleton)

MVC_FrontController

class MVC_FrontController
{

protected $_routes;
protected $_settings;
protected $_controller;
protected $_action;
protected $_params;

public function __construct($request)
{
$this->_initConfigs();
$this->_initResources();
$this->_initRoutes();
}

protected function _parseRequest()
{
return $_SERVER['REQUEST_URI'];
}

public function run()
{
$uri = $this->_parseRequest();

$activeRoute = $this->_checkActiveRoute($uri);
if (null === $activeRoute)
throw new MVC_Exception('Cannot find active route');
$this->_dispatch($activeRoute);

$controllerName = sprintf('App_Controller_%sController', ucfirst($this->_controller));
$controllerObj = new $controllerName(
new MVC_Request(
array('params' => $this->_params,
'controller' => $this->_controller,
'action' => $this->_action)
)
);
$methodName = $this->_action . 'Action';
if (method_exists($controllerObj, $methodName)) {
$controllerObj->$methodName();
$controllerObj->render();
} else {
throw new MVC_Exception('action not found');
}
}

protected function _initConfigs()
{

require_once APPLICATION_PATH . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'application.php';

MVC_Registry::getInstance()->set('settings', $settings);
$this->_settings = $settings;
}

/**
* init resource autoloading
*/
protected function _initResources()
{
spl_autoload_register(array('MVC_Autoload_Resource', 'autoload'));
}

/**
* init routes
*/
protected function _initRoutes()
{
if (isset($this->_settings['routes'])) {
$this->_routes = $this->_settings['routes'];
} else {
throw new MVC_Exception('Routes must be specified');
}
}

/**
* get active route name
*
* @param string $uri
* @return string active route name
*/
protected function _checkActiveRoute($uri)
{
$uri = substr($uri, 1);
if (trim($uri)) {
$activeRoute = null;

foreach($this->_routes as $name => $routeSettings) {
if (!$routeSettings['template'])
continue;
if (preg_match('@' . $routeSettings['template'] . '@', $uri, $matches)) {
if (isset($routeSettings['params'])) {
foreach($routeSettings['params'] as $paramName => $param) {
$this->_params[$paramName] = $matches[$param];
}
}
$activeRoute = $name;
}
}
} else {
$activeRoute = 'main';
}

return $activeRoute;
}

/**
* dispatch
*
* @param string $activeRoute active route name
*/
protected function _dispatch($activeRoute)
{
if (isset($this->_routes[$activeRoute])) {
$this->_controller = $this->_routes[$activeRoute]['controller'];
$this->_action = $this->_routes[$activeRoute]['action'];
}
}

}

Я старался комментировать не особо очевидные места, но если возникнут вопросы, обязательно задавайте их в комментериях внизу заметки. Метод _checkActiveRoute() определяет в зависимости от REQUEST_URI активный раут. И заполняет параметры для контроллера нашего приложения.

Метод _dispatch() по активному рауту определяет нужный в данный момент контроллер и экшн.

Метод run() запускает наш контроллер, передавая ему объект запроса с нужными нам параметрами. После запуска нужного экшна мы запускаем метод контроллера render() который и выводит контент.

MVC_Controller_Abstract

Этот класс раширяют все контроллеры нашего приложения, единственный метод, на котором стоит заостроить внимание это render()

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

public function render()
{
$templatePath = $this->_view->template_dir . DIRECTORY_SEPARATOR;
$templatePath .= strtolower(
$this->getRequest()->getController()
. DIRECTORY_SEPARATOR
. $this->getRequest()->getAction() . '.tpl'
);
if (file_exists($templatePath) && is_readable($templatePath)) {
$this->getView()->assign('tplName', $templatePath);

if (null === $this->_view->template)
$this->getView()->display('template.tpl');
else {
$this->getView()->display($this->getView()->template);
}
} else {
throw new MVC_Exception("Template '{$templatePath}' not found");
}
}

Допустим мы прошли по адресу example.com/ нашего приложения. Наш «Фронт Контроллер» запустит app/controllers/IndexController.php и метод indexAction(). В нем, к примеру, мы присвоим переменной name значение vredniy

1
2
3
4

public function indexAction()
{
$this->getView()->assign('name', 'Vredniy');
}

Дальше метод MVC_Controller_Abstract::render() отыщет наш шаблон (layout). В данном случает это, находящийся в папке app/views, файл template.tpl. Приведу его содержимое

1
2
3
4
5
6
7
8
9
10

<html>
<head>
<title>title</title>
</head>
<body>
<h1>template</h1>
{include file="$tplName"}
<h2>footer</h2>
</body>
</html>

Это и есть основной шаблон для нашего приложения. Вы спросите, а как же тогда выводится переменная name, значение которой мы присваивали в IndexController::indexAction(). Все просто: встроенная конструкция Smarty {include file=»$tplName»} заменяется содержимым соответствующего экшна видом.
Метода render() в MVC_Controller_Abstract

1	$this->getView()->assign('tplName', $templatePath);

Сам же вид экшна имеет вид

1 2	<b>{$name\|upper}</b> <h2>MAin page</h2>

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

Спасибо всем за внимание, надеюсь, хоть часть мною написанного вам пригодится. Ах да, чуть не забыл прилагаю к заметке ссылку на репозиторий, чтобы вы смогли скачать данный фреймворк и запустить у себя.

UPDATE: Сегодня решил, что в связке MVC не может не быть модели, поэтому решил я ее сегодня дописать.

Модель в MVC

Добавил я два класса: первый это MVC_Db_Exception, чтобы выбрасывать эксепшны не просто MVC_Exception. Второй — освновной MVC_Db_Abstract, который мы будем расширять в модели. Приведу его код:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

class MVC_Db_Abstract
{

/**
* PDO object
*
* @var Pdo
*/
private $_connection;
/**
* PDO options
*
* @var array
*/
protected $_options = array(PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES 'UTF8'");

/**
* PDO attributes
*
* @param array|string $attribs
*/
public function __construct()
{
$this->_initConnection();
}

// инициализуем соединение, если его еще нет
private function _initConnection()
{
if (!$this->_connection instanceof PDO) {
$settings = MVC_Registry::get('settings');
$dbSettings = $settings['database'];
$dsn = sprintf('%s:host=%s;dbname=%s', $dbSettings['adapter'], $dbSettings['params']['host'], $dbSettings['params']['dbname']);
try {
$this->_connection = new PDO($dsn, $dbSettings['params']['username'], $dbSettings['params']['password'],
$this->_options);
} catch (PDOException $e) {
echo 'Connection failed: ' . $e->getMessage();
}
}
}

// возвращаем соединение, которое и будем использовать в моделях
public function getConnection()
{
return $this->_connection;
}

}

И внимание, кто пробует это проделать по заметке, будьте внимательны, потому что я чуть дописал MVC_Autoload_Resource, чтобы он помимо контроллеров мог подгружать еще и наши модельки. Самая актуальная версия в репозитории.

Использование модели

Создадим папку app/models, где и будут лежать наши модели. В ней создадим файл PageModel.php с таким содержимым

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

class App_Model_PageModel extends MVC_Db_Abstract
{

/**
* get page id
*
* @param int
*/
public function getPage($id)
{
$statementString = 'SELECT id, alias, content FROM pages WHERE %s = ?';
if (is_int($id)) {
$statementString = sprintf($statementString, 'id');
} else {
throw new MVC_Db_Exception('id must be int');
}
$statement = $this->getConnection()->prepare($statementString);
$statement->execute(array($id));
return $statement->fetch();
}

}

Данная модель умеет извлекать из таблицы pages нужные нам данные с помощью PHP Data Object (PHP) по id. Дамп базы данных я выложил в репозитории в папке data/dumps

Теперь в контроллере попробуем использовать нашу модель. Я взял для примера IndexController, в index экшн которого я дописал следующее.

1
2
3
4
5
6
7
8
9

public function indexAction()
{
// создаем нашу модель
$model = new App_Model_PageModel();
// извлекаем из нее нужные нам данные и
// отдаем их Smarty, т.е. во View
$this->getView()->assign('data', $model->getPage(1));
$this->getView()->assign('name', 'Vredniy');
}

В шаблоне views/index/index.tpl я добавил три строчки, которые и будут выводить содержимое:

1
2
3

<b>{$name|upper}</b>
<h2>{$data.alias}</h2>
{$data.content}

Вот вроде и все, еще раз удачи вам

Общие заблуждения о jQuery (часть 1) parent, parents, closest

Вредный — Tue, 07 Jun 2011 07:43:34 +0000

Быстрый рост JavaScript библиотек и разнообразных фреймворков, таких как jQuery, для программирования на стороне клиента, предоставил всю мощь языка JavaScript для широкой аудитории. jQuery предоставляет свой собственный API, методы и синтаксические особенности. Порой которые похожи друг на друга, но отличающиеся в чем-то. Это заметка должна избавить вас от путаницы

.parent(), .parents() .closest()

Все три эти метода предоставляют доступ вверх над элементами по дереву DOM, но они тем временем все-таки отличаются

parent(selector)

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

1 2	$('span.my').parent().css('border', '1px solid red'); $('p').parent('div.sidebar').css('border', '1px solid red');

В первой строке мы получаем родителя с классом my. Во второй же получает родителей для всех элементов

, при условии, что родитель его

с классом .sidebar.

Возможность ограничить выборку метода как во второй строке в примере выше — стандартная «плюшка» jQuery. Большинство методов для DOM-манипуляций позволяют указать селектор.

parents(selector)

Работает по тому же принципу, что и .parent() за исключением того, что данный метод не ограничен одним уровнем и может возвращать несколько предков. К примеру:

1	$('li.naivgation').parents('li');

Для каждого элемента

который содержит в себе класс navigation, возвращает всех родителей и предков, который в свою очередь тоже элементы списка

. Данный метод может быть полезен с многоуровнемым меню.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

<ul class="navigation">
<li>Catalog
<ul>
<li>Electronics</li>
<li>Animals</li>
<li>Birds</li>
</ul>
</li>
<li>About...
<ul>
<li>me</li>
<li>company</li>
</ul>
</li>
</ul>

Допустим нам нужно поменять цвет фона только для третьего уровня вложенности:

1
2
3
4

$('.navigation li').each(function() {
if (2 == $(this).parents('.navigation li').length)
$(this).css('background-color', 'cyan');
});

Для каждого элемента

, найденного в классе navigation находим количество

-предков. Если это два, значит раскрашиваем его.

closest(selector)

Это больше магия, но очень полезная. Данный метод работает также как и .parents(), исключая то, что возвращает только одного родителя или предка. Бывают ситуации, когда вам не нужны все родители, возвращаемые методом .parents(), тогда в дело вступает метод .closest(). Допустим, нам нужно узнать явлвется ли один элемент непосредственным наследником другого:

1
2
3
4

if (1 == $('.elem1').closest('.elem2').length)
console.log('Непосредственный предок');
else
console.log('Дальний родственник :)');

Метод .closest() легко сэмулировать методом .parents(), ограничив количество возвращаемых элементов:

1	$($('.elem1').parents('.elem2').get(0)).css('border', '1px solid red');

И еще метод .closest() начинает обход, начиная с элемента, удовлетворяющему селектору, а не с его родителя.

Zend Framework: вставляем viewHelper куда душе угодно

Вредный — Mon, 16 May 2011 11:02:21 +0000

Здравствуйте, уважаемые коллеги-разработчики, в сегодняшней заметке я поделюсь с вами своим костылем-решением. Пишу в свободное время свою модульную CMS (ведь каждый разработчик должен написать в своей жизни хотя бы одну) на базе Zend Framework’а и возникла необходимость вставлять в контент форму обратной связи и еще что-нибудь в произвольное место. Для создания стратичных страниц я использую свой модуль Static, который ничего не умеет, кроме создания стратичных страниц WYSIWYG’ом и прикрепления к уже имеющимся.

Первое, что пришло в голову это заменять какой-нибудь placeholder аля {placeholder_feedback_form(0)} на содержимое. Сказано-сделано, приведу кусок view Helper’а, который отображает нестандартную форму и валидирут посредстом отправления AJAX запросов на сервер.

View_Helper: на что будем менять

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

class Feedback_View_Helper_Form extends Zend_View_Helper_Abstract
{
// form with ajax validation
public function form($form = null)
{
$html = <<< karamba

karamba;
$view = Zend_Controller_Action_HelperBroker::getStaticHelper('viewRenderer')->view;
$view->headScript()->captureStart() ?>
$().ready(function() {
$('form').submit(function() {
$.get('/feedback', $(this).serialize(), function(response) {
if ('ok' == response.code) {
// transmission completed
$(':input', 'form')
.not(':button, :submit, :reset, :hidden')
.val('')
$('p.spasibo span').text('Спасибо! Обязательно отвечу!');
} else {
// print error message
$('p.spasibo span').text('Ошибка при заполнении');
}
}, 'json');
return false;
});
});
$view->headScript()->captureEnd();
return $html;
}

}

данный view Helper у меня располагается в папке application/modules/feedback/view/helpers/Form.php

Action_Helper: замена placeholder’ов

Более или менее универсальное решение по замене placeholder’ов вида {placeholder_%moduleName%_%viewHelper(%param%)} реализовал в виде Action Helper’а, вот его код

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

/**
* content replacer
*
* replace {placeholder_moduleName_helperName(param)} with
* Modulename_View_Helper_HelperName::helperName($param) return
*/
class Vredniy_Controller_Action_Helper_ContentReplacer extends Zend_Controller_Action_Helper_Abstract
{

public function postDispatch()
{
//$this->getResponse()->setBody('replaced');
// label {placeholder_image_gallery(param)}
//call_user_func_array($function, $param_arrarray);
// \{placeholder_(\w+)_(\w+)$(((\w+)?,?)*)$\}
if ('admin' === substr($this->getRequest()->getControllerName(), 0, 5))
return;
$regExp = '@\{placeholder_(\w+)_(\w+)$(\d+)$\}@';
if (preg_match_all($regExp, $this->getResponse()->getBody(), $matches)) {
//var_dump($matches);
$matchesFound = count($matches[0]);
$allMatches = array();
for($i = 0; $i < $matchesFound; $i++)
$allMatches[] = array(
'module' => $matches[1][$i],
'helper' => $matches[2][$i],
'param' => $matches[3][$i],
'assembledString' => "{placeholder_{$matches[1][$i]}_{$matches[2][$i]}({$matches[3][$i]})}"
);
foreach($allMatches as $currentMatch) {
$className = ucfirst($currentMatch['module']) . '_View_Helper_' . ucfirst($currentMatch['helper']);

if (class_exists($className)) {
$viewHelper = new $className;
if (method_exists($viewHelper, ucfirst($currentMatch['helper']))) {
$this->getResponse()->setBody(
str_replace(
$currentMatch['assembledString'], // assembled regexp
call_user_func(array($viewHelper, ucfirst($currentMatch['helper'])), $currentMatch['param']), // call it
$this->getResponse()->getBody() // old body
)
);
}
}
}
}
}

}

Регистрируем наш ActionHelper

Осталось только подключить наш Action Helper, я делаю это в основном application/Bootstrap.php

1
2
3
4

protected function _initActionHelpers()
{
Zend_Controller_Action_HelperBroker::addHelper(new Vredniy_Controller_Action_Helper_ContentReplacer());
}

Данное решение не претендует на абсолютную правильность, но меня оно пока устраиивает и всем спасибо за внимание, надеюсь, что данное решение вам когда-нибудь пригодится