Ruby on Rails网站项目构建简单指南
创建Rails项目
创建一个普通的Rails项目,可以直接使用以下命令:
railsnewblog
但在国内因为连接RubyGems的速度太慢,而Rails默认在构建完项目结构后,会使用bundle命令从RubyGems下载安装依赖包。最后会因为网络问题而卡死。所以需要使用--skip-bundle参数跳过执行bundle这一步。然后使用国内的Gems镜像源来完成后面依赖包的安装。国内推荐的源是RubyChina提供的:https://gems.ruby-china.org/。
最后整理步骤如下:
创建项目:
railsnewblog--skip-bundle
修改项目目录中的Gemfile文件,修改第一行中source后面引号中的内容值为:https://gems.ruby-china.org/
最后在项目目录中执行:bundleinstall完成安装依赖包。
至此,一个标准的Rails项目骨架创建完成。
配置Rails项目
默认情况下,已经可以使用生成好的项目骨架来开始开发项目,但根据实际需求,还是需要对一些配置进行调整。比如时区,或使用MySQL等。
设置时区
默认Rails使用的是UTC时区,如果项目只是在国内使用,这会导致数据跟时间相关的值都会比国内的时间晚8个小时。所以如果非国际性项目,可以把时区固定到国内。
打开项目目录中config/application.rb文件。去掉config.time_zone配置项前的注释,然后修改配置项的值为Beijing,最后添加一行新的配置:
config.active_record.default_timezone=:local
使用MySQL
默认Rails使用的是sqlite数据库,如果要使用MySQL,还需要安装MySQL的程序包。并修改数据库默认配置。
打开项目目录中的Gemfile文件,添加一个全局的依赖包mysql2,格式如下:
gem'mysql2'
然后执行:bundleinstall安装依赖包。
接下来打开config/database.yml文件,修改development区块的配置如下格式:
development: adapter:mysql2 database:blog username:root password: host:127.0.0.1
创建Rails文档
对于已经熟练掌握了Rails的老手来说,这一步并不是必须的。但对于像我这样的新手,经常会需要去翻翻手册来寻求帮助,把文档搬到本地,省去了在没有网络或网速太慢时的烦恼。Rails提供了命令,可以在项目中生成Rails的本地手册和API文档。
首先需要添加一个依赖包:redcarpet。打开项目中的Gemfile文件,因为只是在本地环境下使用,所以不用加入到全局依赖,找到文件底部的development配置块,添加到这里就行了,格式如下:
gem'redcarpet','~>3.1.2'
然后执行:bundleinstall安装包。
使用如下命令生成Rails帮助文档和API文档:
rakedoc:guides rakedoc:rails
命令完成后,文档会生成到doc目录。
在Rails中创建自定义命令
开发Web应用时,难免会遇到需要编写在终端执行的命令脚本。比如说要从一个很大的文本中导入数据。在Rails中完成这个事情相当简单,下面是一个示例。
首先是创建脚本文件。在Rails项目的lib/tasks目录中创建一个hello.rake的文件。文件内容如下:
namespace:hellodo task:worlddo puts"Hello,World!" end end
这样就完成了一个简单的打招呼脚本,要运行这个脚本,需要使用rake命令:
rakehello:world
默认情况下,脚本命令并没有引入Rails的项目模块。如果需要引入也很简单!比如我想要和项目中的所有客户打个招呼:
namespace:hellodo #... task:customers=>:environmentdo forcustomerinCustomer.all putssprintf("hello,%s",customer.name) end end end
如果你的项目中刚好有Customer模块,而刚好又存在name字段,那就可以执行rakehello:customers来验证效果了。对比第一个任务,这里添加了=>:environment这段代码,正是它实现了引入项目环境依赖的功能。是不是很简单?