1. введение в devise
2. настройка devise

Все нижепроделанное относиться к RoR версии выше 3.0.1.

установка

Сначала, как обычно, дописываем в Gemfile:

gem 'devise'

и далее опять же:

bundle install

Теперь надо сгенерировать/интегрировать/спарить/инсталировать/и т.д. rails-приложение и devise:

rails generate devise:install

После этого devise напишет мол надо настроить mailer и домашнюю страницу (root_url). Для режима development настроить mailer можно прописав в config/environments/development.rb опцию:

config.action_mailer.default_url_options ={ :host => 'localhost:3000' }

Далее надо сгенерировать модель пользователей для Devise и выполнить созданные миграции:

rails generate devise User
rake db:migrate

настройка и эксплуатация

маршрутизация

После установки devise пропишет свои особые маршруты. Строка в config/routes.rb вида:

devise_for :users

мало о чем скажет, поэтому посмотреть маршруты devise можно так:

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

rake routes
        new_user_session GET    /users/sign_in(.:format)
            user_session POST   /users/sign_in(.:format)
    destroy_user_session DELETE /users/sign_out(.:format)
           user_password POST   /users/password(.:format)
       new_user_password GET    /users/password/new(.:format)
      edit_user_password GET    /users/password/edit(.:format)
                         PUT    /users/password(.:format)
cancel_user_registration GET    /users/cancel(.:format)
       user_registration POST   /users(.:format)
   new_user_registration GET    /users/sign_up(.:format)
  edit_user_registration GET    /users/edit(.:format)
                         PUT    /users(.:format)
                         DELETE /users(.:format)
...

Соответственно в представлении, например, ссылка на регистрацию будет выглядеть как:

1

<%=link_to 'Регистрация', new_user_registration_path %>

а на вход:

1

<%=link_to 'Войти', new_user_session_path%>

Стандартные пути можно изменить подкорректировав config/routes.rb, используя опцию path_names, например, для изменения пути регистрации изменения будут выглядеть так:

1

devise_for :users, :path_names=>{sign_up: 'register'}

методы

Также в первом видео еще рассказали метод, как узнать авторизован ли пользователь:

user_signed_in?

и, видимо, экземпляр класса модели User для текущего пользователя current_user, которая работает также как и экземпляр любой другой модели, например, узнать E-mail текущего авторизованного пользователя можно так:

current_user.email

фильтр

Еще один важный момент в начале второго видео про before_filter. Чтобы узнать недопустить неавторизованного посетителя до экшенов, нужно использовать фильтр:

before_filter :authenticate_user!

Он будет перенаправлять на страницу входа.

настройка представлений

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

rails g devise:views
      create  app/views/devise/_links.erb
      invoke  form_for
      create    app/views/devise/confirmations
      create    app/views/devise/confirmations/new.html.erb
      create    app/views/devise/passwords
      create    app/views/devise/passwords/edit.html.erb
      create    app/views/devise/passwords/new.html.erb
      create    app/views/devise/registrations
      create    app/views/devise/registrations/edit.html.erb
      create    app/views/devise/registrations/new.html.erb
      create    app/views/devise/sessions
      create    app/views/devise/sessions/new.html.erb
      create    app/views/devise/unlocks
      create    app/views/devise/unlocks/new.html.erb
      invoke  erb
      create    app/views/devise/mailer
      create    app/views/devise/mailer/confirmation_instructions.html.erb
      create    app/views/devise/mailer/reset_password_instructions.html.erb
      create    app/views/devise/mailer/unlock_instructions.html.erb

сообщения об ошибках

Все сообщения devise храняться в YML-файлах локалей, по умолчанию это config/locales/devise.en.yml. Для добавления своей локали нужно создать файл с аналогичным именем, например, config/locales/devise.ru.yml.
Скачать переведенные на другие языки (в т.ч. русский) локали devise можно тут: https://github.com/plataformatec/devise/wiki/I18n

валидация и прочие настройки

Настройки валидации, как и все остальные для этого гема, находятся в config/initializers/devise.rb. Отключить стандартную валидацию devise можно убрав модуль :validatable из модели, в данном случае User.
А вообще в devise вагон других настроек, например, теже ключи аутентификации, а которых говорят в конце второго видео, настраиваются все в том же config/initializers/devise.rb.
Подробнее о настройках и прочих заморочках этого гема:

1. офстраница
2. вики
3. rubydoc

экспорт БД с sqlite3

Прежде всего надо как-то сдампить старую БД на SQLite и хотелось бы это сделать без писания дополнительных скриптов. Для этого делаем нижеизложенное.
Закидываем в Gemfile следующую строку:

gem 'yaml_db'

И далее установим этот гем через bundle:

# cd rails_app && bundle install

Этот гем даст некоторые новые rake’и для работы с БД:

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

$ rake -T
...
rake db:create          # Create the database from ...
rake db:data:dump       # Dump contents of database ...
rake db:data:dump_dir   # Dump contents of database ...
rake db:data:load       # Load contents of db/data...
rake db:data:load_dir   # Load contents of db/data_dir ...
rake db:drop            # Drops the database for the ...
rake db:dump            # Dump schema and data to db/...
rake db:fixtures:load   # Load fixtures into the current...
rake db:load            # Load schema and data from ...
rake db:migrate         # Migrate the database (options:...
rake db:migrate:status  # Display status of migrations
rake db:rollback        # Rolls the schema back to ...
rake db:schema:dump     # Create a db/schema.rb file ...
rake db:schema:load     # Load a schema.rb file into...
rake db:seed            # Load the seed data from...
rake db:setup           # Create the database, load...
rake db:structure:dump  # Dump the database structure...
rake db:version
...

Далее нижеприведенной командой экспортируем схему и содержание БД в db/data.yml.

$ rake db:dump

Если БД слишком разрослась, можно попробывать вариант с rake db:data:dump_dir.

поднимаем и настраиваем MySQL

MySQL

Сразу же устанавливаем пакеты:

# yum install mysql mysql-server mysql-devel ruby-mysql -y

Далее прописываем во все тот же Gemfile:

gem 'mysql2'

И опять бандлим:

# bundle install

Стартуем сервер MySQL.

# service mysqld start

Заходим под рутом в MySQL:

mysql -uroot -p

Если до этого руту был задан пароль, то его надо будет ввести, если это первый заход рута, то пароль пустой.
А теперь создаем базу

mysql> CREATE DATABASE railsdb CHARACTER SET utf8 COLLATE utf8_general_ci;

и пользователя, попутно назначая ему права на эту БД.

mysql> GRANT ALL PRIVILEGES ON railsdb.* TO 'railsuser'@'localhost' IDENTIFIED BY 'railspass' WITH GRANT OPTION;

Команда выше дает права пользователю railsuser с паролем railspass на полный доступ к БД railsdb c локального хоста. Подробнее о правах и как их назначить читаем на оффсайте.

настройка rails-приложения

Открываем config/database.yml и заменяем настройки БД нужной секции на подобные (в моем случае это development):

1
2
3
4
5
6
7
8
9

development:
  adapter: mysql2
  encoding: utf8
  reconnect: false
  database: railsdb
  pool: 5
  username: railsuser
  password: railspass
  host: localhost

Хочу предупредить, что табуляция перед параметрами, видимо, очень важна т.к. без этих табов сервер не стартанул, а с ними запустился на ура.
Теперь импортируем схему и данные в БД.

$ rake db:load

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

1

yum install httpd

Для полноценности apache’а можно еще установить PHP:

1

yum install php

Но я бы этого не делал, на всякий случай, чтобы не один web-shell там не работал т.к. я не видел вебшеллов под unix’ы кроме как на PHP и CGI Perl.

установка passenger

Далее нужно установить такую штуку как Passenger. Этот gem поможет связать Apache с ROR’ом. Оффициальная инструкция установки Passenger есть тут – http://wiki.rubyonrails.org/deployment/apache-passenger. В принципе до определенного момента я буду ей следовать.
Устанавливаем сам гем:

1

# gem install passenger

Запускаем скрипт:

1

# passenger-install-apache2-module

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

настройка apache

Теперь самое сложное – надо настроить апач. Отворяем /etc/httpd/httpd.conf и колдуем.
В подгружаемые модули дописываем, то что порекомендовал скрипт passenger’а:

1
2
3
4
5
6
7
8
9
10

...bla-bla-bla...
LoadModule disk_cache_module modules/mod_disk_cache.so
LoadModule cgi_module modules/mod_cgi.so
 
<span style="color: #3366ff;">LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1
/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems
/passenger-3.0.2
PassengerRuby /usr/local/bin/ruby
</span><span style="color: #0000ff;">PassengerDefaultUser root</span>

Чтобы наверняка, можно дописать еще строку выделенную темносиним.

Далее надо будет поколдовать с директивой NameVirtualHost. Возможно она и не понадобиться, а быть может и поможет. Раскомментируйте ее:

1

NameVirtualHost *:80

настройка виртуального хостинга

Для каждого сайта(домена) следует дописать в конец конфига что-то типа:

1
2
3
4
5
6
7
8
9
10
11

<VirtualHost *:80>
    ServerName <span style="color: #800080;">mysuperrubyonrailsunderapachesite.ru
</span>    ServerAlias <span style="color: #800080;">www.mysuperrubyonrailsunderapachesite.ru
</span>    DocumentRoot <span style="color: #3366ff;">/var/www/rails<strong>/public</strong></span>
    <Directory <span style="color: #3366ff;">/var/www/rails/</span><strong><span style="color: #3366ff;">public/</span></strong>>
        Allow from all
    </Directory>
    RailsEnv development
    RailsBaseURI /
    ErrorLog logs/mysuperrubyonrailsunderapachesite.ru.log
</VirtualHost>

mysuperrubyonrailsunderapachesite.ru

Эта конфа обозначает, что содержимое директории с рельсовым приложением лежит в /var/www/rails, а папка public – та самая публичная папка рельсов где лежат CSS, JS, картинки и прочее.

Внимательно посмотрите какие права у каталогов. Признаком нехватки прав у апача, помимо логов,  является Apache Test Page.
Помните, что апач по умолчанию работает под ущербным пользователем apache, поэтому следует дать ему права на чтение и исполнение в каталоге /var/www/rails/.
Вторая типовая, по крайне мере моя, ошибка проявляется в том случае если в /var/www/rails/ лежит не само рельсовое приложение а только ссылка на public. Здесь, если сами рельсы лежат допустим в /home/username/rails, даже если вы настроите права ко всем и всякому 0777 в браузере все равно может появиться Test Page. Виновником тому, например в RH-линуксах, может стать SELinux.
Отключить SELinux можно установив значение параметра SELINUX=disabled в файле /etc/selinux/config, после чего надо перезагрузиться.

На этом грубая настройка Apache под Ruby on Rails закончена. Запускайте Apache как умеете, у меня, например, в Fedora это выглядит так:

1

# service httpd start

Не забудьте настроить iptables, выключить же его можно так:

1

# service iptables stop

установка плагина paperclip

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

Насколько я понил, в ROR 3 плагины устанавливаются не так как в предыдущих версиях, соответсвенно в старых рельсах будет немного иначе. Ну а для ROR 3 вот так:

1

rails plugin install git://github.com/thoughtbot/paperclip

Подробнее о плагине можно прочитать здесь, там же можно и прочитать инструкцию по плагину на английском, однако, для последнего ROR’а она немного устарела.

настройка приложения

модель

Открываем модель, того где нужна загрузка файлов и дописываем (здесь показано напримере модели User, где поле с загружаемой картинкой – avatar):

1
2
3
4

class User < ActiveRecord::Base
    <span style="color: #3366ff;">has_attached_file</span> <strong>:avatar</strong>, 
    <strong>:styles</strong> => { :medium => "300x300>", :thumb => "100x100>" }
  end

Если вы вдруг решили что в БД должно быть поле :avatar, то оно не должно там быть. Все необходимые поля мы добавим дальше в миграции. Так что если вы сделали поле с таким именем (в данном случае :avatar), то удалите его миграцией.

миграции

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

1

rails generate migration AddAvatarColumnsToUser

и пишем в созданной миграции, опять же для модели User с полем :avatar:

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

class AddAvatarColumnsToUser < ActiveRecord::Migration
    def self.up
      add_column :<span style="color: #808000;">users</span>, :<span style="color: #ff6600;">avatar</span>_file_name,    :string
      add_column :<span style="color: #808000;">users</span>, :<span style="color: #ff6600;">avatar</span>_content_type, :string
      add_column :<span style="color: #808000;">users</span>, :<span style="color: #ff6600;">avatar</span>_file_size,    :integer
      add_column :<span style="color: #808000;">users</span>, :<span style="color: #ff6600;">avatar</span>_updated_at,   :datetime
    end
 
    def self.down
      remove_column :<span style="color: #808000;">users</span>, :<span style="color: #ff6600;">avatar</span>_file_name
      remove_column :<span style="color: #808000;">users</span>, :<span style="color: #ff6600;">avatar</span>_content_type
      remove_column :<span style="color: #808000;">users</span>, :<span style="color: #ff6600;">avatar</span>_file_size
      remove_column :<span style="color: #808000;">users</span>, :<span style="color: #ff6600;">avatar</span>_updated_at
    end
  end

представления

И здесь нужно сделать немного не так как в руководстве. Открываем частицу (partial) формы (_form.html.erb) и исправляем помощника (helper) form_for:

1
2

<% form_for(@user, :as=>:user, :url => user_path,
:html => { :multipart => true } do |f| %>

и в самой форме, где уже должно сверкать это поле с загрузкой файла пишем помощника (helper):

1

<%= form.file_field :avatar %>

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

1
2
3

<%= image_tag @user.avatar.url %>
  <%= image_tag @user.avatar.url(:medium) %>
  <%= image_tag @user.avatar.url(:thumb) %>

контроллер

Открываем контроллер нашей модели и добавляем в метод create (в случае если этого там нет):

1
2
3
4
5

 def create
    ...
    <span style="color: #666699;"><strong>@user</strong> = User.create( params[<strong>:user</strong>] )</span>
    ...
 end

директории

Теперь создаем директорию system и даем в ней права на запись:

1

mkdir public/system && chmod a+w public/system

Все. Теперь файлы будут грузится в public/system/<имя поля (avatar)>/<вариант картинки/файла>/<имя файла>.