Padrino 博客开发示例

安装

为了开发Padrino应用，咱们得先有点儿准备吧。显然，咱们得先把Ruby和RubyGems装了；而后，再来安装Padrino框架：

$ gem install padrino

点击这里了解关于安装的详细信息。安装流程一旦完成，全部必需的依赖项也都自动准备就绪，咱们如今就能够开始开发本身的博客了。

生成项目

原汤化原食。建立Padrino程序的最佳方式采用Padrino生成器。相似 于Rails，Padrino也有一个用来建立包含项目全部必备程序和资源的生成器。Padrino是一个混合型框架（agnostic framework）并支持大量不一样的模板、测试、JavaScript和数据库组件。推荐阅读《生成器指南》来获取更详细信息。

就这个示例程序而言，咱们将采用ActiveRecord ORM、Haml模板语言、Shoulda测试框架和jQuery类库。基于这些考虑，咱们如今来建立这个新项目：

$ padrino g project sample_blog -t shoulda -e haml -c sass -s jquery -d activerecord -b

这行命令将为咱们生成Padrino项目的基础文件并打印出生成报告。能够从这里查看这条生成命令的输出信息示例。须要注意的是，-b参数自动指引bundler安装相关的依赖项。如今咱们进入新项目文件夹：

$ cd sample_blog

如今，咱们已经从终端中进入到项目文件目录了，让咱们更近距离地看一下这些可爱的文件吧：

• Gemfile：确保项目全部gem包依赖项都包含在该文件中！
• app/app.rb：核心应用程序主要配置文件；
• config/apps.rb：该文件定义项目要挂载的应用；
• config/database.rb：顾名思义，定义数据库适配器信息。

除此以外，还生成了一些重要的目录：

• app/controllers：声明Padrino的路由定义；
• app/helpers：定义应用的帮助方法；
• app/views：包含由控制器输出的模板视图；
• lib：包含项目用到的全部扩展、类库和其它代码；
• public：保存图片、样式和JavaScript代码文件；
• test：保存模型和控制器的测试代码；

如今，咱们来检查config/database.rb文件以确保数据库链接配置是正确的。截至目前，默认配置对于示例指导来讲是可用的。项目将采用存储在db/sample_blog_development.db中Sqlite3数据库。

咱们再建立一些简单的路由来演示Padrino的路由系统。进入app/app.rb文件并输入：

 

# app/app.rb class SampleBlog::App register Padrino::Rendering register Padrino::Helpers # Add these routes below to the app file... get "/" do "Hello World!" end get :about, :map => '/about_us' do render :haml, "%p Padrino 博客开发示例" end end

能够看到：第一条路由建立一个字符用来返回应用的根URL；第二条路由将"/about_us"显式映射到由Haml输出的“关于”页面；符号:about用来引用这条路由。

强烈建议亲查看《控制器指南》来对路由系统有一个综合的了解哟！

建立后台管理界面

接下来，为了方便对项目中的数据进行增删改查，咱们来创建Padrino后台管理面板。在终端程序中输入：

sample_blog $ padrino g admin
sample_blog $ bundle install

这两行命令将为项目创建管理子程序，并在config/apps.rb文件中声明对本身的挂载。经过这里能够查看该命令的输出结果。

而后，输入下面的指令来建立数据库、运行迁移并运行db/seeds.rb里的种子（seed）任务：

sample_blog $ padrino rake ar:create sample_blog $ padrino rake ar:migrate sample_blog $ padrino rake seed

在这个过程当中，系统将提示你输入登陆管理系统所用的电子邮箱和密码。

若是你想要了解更多关于管理面板的功能和特性，欢迎阅读《管理面板指南》。

启动Padrino

Padrino项目创建了、数据库也配置了、管理系统也搭好了，轮到启动Padrino应用服务器的时候了！用内建的Padrino任务来作其实很是简单，只要在终端里执行下面这条命令：

sample_blog $ padrino start

不出意外你应该从终端看到以下输出：

=> Located unlocked Gemfile for development => Padrino/0.10.2 has taken the stage development on port 3000 >> Thin web server (v1.2.7 codename This Is Not A Web Server) >> Maximum connections set to 1024 >> Listening on localhost:3000, CTRL+C to stop

要想了解操做Padrino的终端命令，那就阅读《开发与终端命令》指南。

你的程序如今已经在http://localhost:3000（楼主：Mac和Linux用户能够无比优越地直接简写为0:3000）恭候你的大驾光临了。在浏览器中访问该网址，你能够看到著名的“Hello World!”咱们还能够经过下面这行网址进入管理界面：

http://localhost:3000/admin

固然须要登陆啰，还记得在执行rake seed命令时写的登陆邮箱和密码吧。登陆后，你能够尽情探索Padrino的后台管理功能，不过咱们将晚一点儿再来介绍更详细的信息。若是你想获取更多关于这方面的资料，能够阅读《管理面板指南》。

顺便说一下，Padrino在开发模式中彻底支持代码重装。啥，你问这是啥？这就是说你可让Padrino服务器一边跑一边修改源代码，只须要刷新一下浏览器，光彩立现！建议你专门开一个终端程序来跑Padrino服务器程序。

建立博文

好，程序OK了、布局也定好了，如今咱们来实现建立和展现博文的功能。

首先在应用目录中生成模型。和版本0.10.0同样，模型将默认生成到项目的models目录下。若是你以为不爽，能够用-a参数来自定义你想要存储模型的子目录。

sample_blog $ padrino g model post title:string body:text -a app => Located unlocked Gemfile for development create app/models/post.rb create test/models/post_test.rb create db/migrate/002_create_posts.rb

而后在迁移中给博文模型增长一个时间戳：

# db/migrate/002_create_posts.rb class CreatePosts < ActiveRecord::Migration def self.up create_table :posts do |t| t.string :title t.text :body t.timestamps end end def self.down drop_table :posts end end

而后迁移到数据库：

sample_blog $ padrino rake ar:migrate => Executing Rake ar:migrate ... == CreatePosts: migrating ==================================================== -- create_table("posts", {}) == CreatePosts: migrated (0.0016s) ===========================================

博文模型便建立好了。而后来建立提供基本展现功能的控制器：

sample_blog $ padrino g controller posts get:index get:show
=> Located unlocked Gemfile for development create app/controllers/posts.rb create app/helpers/posts_helper.rb create app/views/posts create test/controllers/posts_controller_test.rb

咱们再来添加一些标准路由到控制器里面，好比:index和:show神马的：

# app/controllers/posts.rb SampleBlog.controllers :posts do get :index do @posts = Post.all(:order => 'created_at desc') render 'posts/index' end get :show, :with => :id do @post = Post.find_by_id(params[:id]) render 'posts/show' end end

上面这个控制器定义了能够经过咱们的应用来访问的路由。声明以Http方法get开始，接上一个符号表示动做（Action），放置在一个保存了获取必要对象的变量以及输出视图模板的代码块当中。看上去跟Rails和Sinatra没啥两样，是吧？（博主：好像是吧……）

下一步，为index和show控制器动做分别建立视图：

# app/views/posts/index.haml - @title = "Welcome" #posts= partial 'posts/post', :collection => @posts

# app/views/posts/_post.haml .post .title= link_to post.title, url_for(:posts, :show, :id => post) .date= time_ago_in_words(post.created_at || Time.now) + '之前' .body= simple_format(post.body)

# app/views/posts/show.haml - @title = @post.title #show  .post .title= @post.title .date= time_ago_in_words(@post.created_at || Time.now) + '之前' .body= simple_format(@post.body) %p= link_to '显式所有博文', url_for(:posts, :index)

Padrino管理系统使得数据记录的增删改查至关简便自动。经过Padrino管理系统管理博文，只需输入下面这行命令：

sample_blog $ padrino g admin_page post
=> Located unlocked Gemfile for development create admin/controllers/posts.rb create admin/views/posts/_form.haml create admin/views/posts/edit.haml create admin/views/posts/index.haml create admin/views/posts/new.haml inject admin/app.rb

你没关Padrino服务器吧（CTRL + C）？没关就好，来看看管理界面。

用你以前输入的邮箱和密码登陆http://localhost:3000/admin。

你能够看到有两个Tab，一个是博文，另外一个是帐户。点击博文那个分页。

只需轻轻点击一下“New”，你即可以开始建立新的记录，页面会罗列出你先前在建立博文模型时设置的全部字段。

注意：确保在建立模型和迁移后运行padrino g admin_page命令。

如今你已经经过管理界面添加了一些博文，访问http://localhost:3000/posts并注意到你建立的博文都会在index动做中显示出来。

你能够经过padrino rake routes命令来显示当前全部定义过的路由：

$ padrino rake routes
    URL                 REQUEST  PATH
    (:about)              GET    /about_us (:posts, :index) GET /posts (:posts, :show) GET /posts/show/:id

这对理解控制器和url之间的映射关系颇有帮助哦！

在博文中添加帐户信息

至此，博文尚未关联上做者信息，这像什么话，不行不行！再来看看博文模型，咱们将开始经过增长新的迁移来将做者帐户添加到博文中：

sample_blog $ padrino g migration AddAccountToPost account_id:integer
=> Located unlocked Gemfile for development create db/migrate/003_add_account_to_post.rb

上述指令建立了一个包含了指望字段的迁移，将account_id附加到博文中。

修改一下迁移文件，将现有博文都指派给系统的第一位用户（如今也就一个用户噻）：

# db/migrate/003_add_account_to_post.rb class AddAccountToPost < ActiveRecord::Migration def self.up change_table :posts do |t| t.integer :account_id end # and assigns a user to all existing posts first_account = Account.first Post.all.each { |p| p.update_attribute(:account, first_account) } end # ... end

如今，咱们回到博文模型来建立帐户关联并增长点儿验证：

# app/models/post.rb class Post < ActiveRecord::Base belongs_to :account validates_presence_of :title validates_presence_of :body end

亲，每次修改数据库都要记得迁移人家哦：

sample_blog $ padrino rake ar:migrate == AddAccountToPost: migrating =============================================== -- change_table(:posts) == AddAccountToPost: migrated (0.0009s) ====================================== 7:04 => Executing Rake ar:migrate ...

咱们的博文如今已经有了适当的关联和验证，接下来咱们须要进入Padrino管理系统作一点儿改动来包含帐户和博文。

直奔admin/controllers/posts.rb，将current_account添加到新博文的建立中：

# admin/controllers/posts.rb Admin.controllers :posts do # ...  post :create do @post = Post.new(params[:post]) @post.account = current_account if @post.save flash[:notice] = '恭喜，博文已成功建立！' redirect url(:posts, :edit, :id => @post.id) else render 'posts/new' end end # ... end

同时还要更新博文的视图来显示做者信息和其它改动：

# app/views/posts/show.haml - @title = @post.title #show  .post .title= @post.title .date= time_ago_in_words(@post.created_at || Time.now) + ' ago' .body= simple_format(@post.body) .details .author Posted by #{@post.account.email} %p= link_to '查看所有博文', url_for(:posts, :index)

# app/views/posts/_post.haml .post .title= link_to post.title, url_for(:posts, :show, :id => post) .date= time_ago_in_words(post.created_at || Time.now) + ' ago' .body= simple_format(post.body) .details .author 由#{post.account.email}发布

如今来增长一个新用户。到http://localhost:3000/admin，切换到Account分页并建立一条新的帐户记录。一旦你有了新的帐户，尝试用它登陆并添加一些新的博文。猜猜这样会发生什么？这样你就有了多个用户和多篇博文:D

到http://localhost:3000/posts看看效果，博文和做者分别全都连接上了。

站点布局

如今，应用已经正确配置而且服务器也跑起来了，咱们继续来建立一些基本的样式和布局。

首先，咱们为应用建立一个布局。布局是在其路由上扮演内容模板容器角色的文件，它会被用来为应用建立各个结构一致的页面。要想建立布局，只须要简单地想app/views/layouts目录添加文件：

# app/views/layouts/application.haml !!! Strict %html %head %title= [@title, "Padrino 示例博客"].compact.join(" | ") = stylesheet_link_tag 'reset', 'application' = javascript_include_tag 'jquery', 'application' = yield_content :include %body #header %h1 Sample Padrino Blog %ul.menu %li= link_to '博客', url_for(:posts, :index) %li= link_to '关于', url_for(:about) #container #main= yield #sidebar - form_tag url_for(:posts, :index), :method => 'get' do Search for: = text_field_tag 'query', :value => params[:query] = submit_tag 'Search' %p Recent Posts %ul.bulleted %li Item 1 - Lorem ipsum dolorum itsum estem %li Item 2 - Lorem ipsum dolorum itsum estem %li Item 3 - Lorem ipsum dolorum itsum estem %p Categories %ul.bulleted %li Item 1 - Lorem ipsum dolorum itsum estem %li Item 2 - Lorem ipsum dolorum itsum estem %li Item 3 - Lorem ipsum dolorum itsum estem %p Latest Comments %ul.bulleted %li Item 1 - Lorem ipsum dolorum itsum estem %li Item 2 - Lorem ipsum dolorum itsum estem %li Item 3 - Lorem ipsum dolorum itsum estem #footer Copyright (c) 2009-2013 Padrino

这个布局为博客建立了一个基本结构，并引用了对控制行为和显示而言必要的样式表和JavaScript文件。这个布局应该包含一些假元素，好比假的搜索框和列表项。

而后，咱们仅仅须要为演示创建两张样式表。第一张是被艾里克·迈耶斯（Eric Meyers）重置的通用CSS，能够在示例博客仓库找到完整的样式表重置并放到public/stylesheets/reset.css。

第二张是为了博客更酷一点儿的应用样式表，能够从示例博客仓库找到该样式表的完整内容并放置到app/stylesheets/application.sass。

有了布局和样式表，博客终于拿得出手了！让咱们访问http://localhost:3000/posts来看看新的界面。

创建RSS订阅功能

在部署应用之前，是否是还漏了点儿啥？对，RSS和Atom订阅。只准用户说他不想看，不许他他看不到！要实现订阅，咱们得在博文控制器中为index块添加一个provides选项。下面的代码指定路由须要响应的HTML、RSS和Atom格式：

# app/controllers/posts.rb SampleBlog.controllers :posts do ... get :index, :provides => [:html, :rss, :atom] do @posts = Post.all(:order => 'created_at desc') render 'posts/index' end ... end

须要注意的是，这条路由同时也指定渲染引擎（rendering engine）在使用RSS或Atom格式时避免输出。

回到index.haml文件，咱们将采用auto_discovery_link_tag帮助方法来生成RSS订阅引用建立器（the RSS feed using builder）。

# app/views/posts/index.haml - @title = "欢迎" - content_for :include do = feed_tag(:rss, url(:posts, :index, :format => :rss),:title => "RSS") = feed_tag(:atom, url(:posts, :index, :format => :atom),:title => "ATOM") #posts= partial 'posts/post', :collection => @posts

而后添加Atom引用建立器模板：

# app/views/posts/index.atom.builder xml.instruct! xml.feed "xmlns" => "http://www.w3.org/2005/Atom" do xml.title "Padrino 示例博客" xml.link "rel" => "self", "href" => url_for(:posts, :index) xml.id url_for(:posts, :index) xml.updated @posts.first.updated_at.strftime "%Y-%m-%dT%H:%M:%SZ" if @posts.any? xml.author { xml.name "Padrino Team" } @posts.each do |post| xml.entry do xml.title post.title xml.link "rel" => "alternate", "href" => url_for(:posts, :show, :id => post) xml.id url_for(:posts, :show, :id => post) xml.updated post.updated_at.strftime "%Y-%m-%dT%H:%M:%SZ" xml.author { xml.name post.account.email } xml.summary post.body end end end

还有RSS引用建立器的模板：

# app/views/posts/index.rss.builder xml.instruct! xml.rss "version" => "2.0", "xmlns:dc" => "http://purl.org/dc/elements/1.1/" do xml.channel do xml.title "Padrino Blog" xml.description "The fantastic padrino sample blog" xml.link url_for(:posts, :index) for post in @posts xml.item do xml.title post.title xml.description post.body xml.pubDate post.created_at.to_s(:rfc822) xml.link url_for(:posts, :show, :id => post) end end end end

检查一下改动，看看http://localhost:3000/posts是否是已经提供了RSS和Atom订阅。是的，对吧？那就能够开张啦！

部署

丑媳妇终于要见公婆了！用Heroku服务神马的来部署Padrino应用最简单老。

参照《Heroku快速入门指南》，确认你此时已经安装了Git并创建了Heroku帐户以及安装了Heroku gem。

要部署到Heroku，须要先将应用建立为Git仓库：

sample_blog $ git init
sample_blog $ git add .
sample_blog $ git commit -m "initial commit for app"

以上命令是在初始化Git仓库，并将全部内容都提交进去。而后将应用建立到Heroku：

sample-blog $ heroku create --stack bamboo-ree-1.8.7 sample-blog $ git push heroku master

欧了，你的应用如今就运行在Heroku上了！

运行heroku open命令能够在你的系统默认浏览器里打开网站。

眼目前儿，Padrino默认使用SQLite，但Heroku只认PostgreSQL，咋整？只能将pg添加为依赖项啰：

# Gemfile group :production do gem 'pg' end

执行下面的命令能够避免在你本地计算机上安装pg gem：

sample-blog $ bundle install --without production

并且有必要为生产配置一下config/database.rb：

# config/database.rb postgres = URI.parse(ENV['DATABASE_URL'] || '') ActiveRecord::Base.configurations[:production] = { :adapter => 'postgresql', :encoding => 'utf8', :database => postgres.path[1..-1], :username => postgres.user, :password => postgres.password, :host => postgres.host }

将Rakefile改成：

# Rakefile require File.dirname(__FILE__) + '/config/boot.rb' require 'thor' require 'padrino-core/cli/rake' PadrinoTasks.init

最后还得调整一下seed.rb：

# db/seeds.rb email = "info@padrinorb.com" password = "admin" shell.say "" account = Account.create(:email => email, :name => "Foo", :surname => "Bar", :password => password, :password_confirmation => password, :role => "admin") if account.valid? shell.say "=================================================================" shell.say "Account has been successfully created, now you can login with:" shell.say "=================================================================" shell.say " email: #{email}" shell.say " password: #{password}" shell.say "=================================================================" else shell.say "Sorry but some thing went worng!" shell.say "" account.errors.full_messages.each { |m| shell.say " - #{m}" } end shell.say ""

上面seed的值你想咋改就咋改，谁也拦不住的。

而后在终端中运行下面的命令：

sample_blog $ git add .
sample_blog $ git commit -m "Added Postgres support" sample_blog $ git push heroku master

再执行migrations/seeds：

sample_blog $ heroku run rake ar:migrate sample_blog $ heroku run rake seed

当当当当，你就看到了：

sample_blog $ heroku run rake ar:migrate (in /disk1/home/slugs/151491_a295681_03f1/mnt) => Located locked Gemfile for production == CreateAccounts: migrating ================================================= -- create_table("accounts", {}) -> 0.0185s == CreateAccounts: migrated (0.0229s) ======================================== == CreatePosts: migrating ==================================================== -- create_table("posts", {}) -> 0.0178s == CreatePosts: migrated (0.0218s) =========================================== == AddAccountToPost: migrating =============================================== -- change_table(:posts) -> 0.0026s == AddAccountToPost: migrated (0.0028s) ====================================== MacBook:sample_blog DAddYE$ heroku rake seed (in /disk1/home/slugs/151491_7576c59_03f1/mnt) => Located locked Gemfile for production ================================================================= Account has been successfully created, now you can login with: ================================================================= email: info@padrinorb.com password: admin =================================================================

而后就能够打开咱们部署的应用了：

sample_blog $ heroku open

go！