Ruby on Rails框架（1）-安装全攻略

序

• 关于Rails的三句箴言

  • （1）DRY：Don’t Repeat Yourself（不要重复你本身）

    • rails的开发理念，不要用你的代码不停的重复，rails框架给开发者提供了一套很是完善的支持，让你在不少地方，只须要短短几行代码，就能实现很是强大的功能；

  • （2）约定大于配置（约定优先原则）Convention Over Configuration

    • rails框架并不会出现传统框架里面例如xml这样的配置文件，而将你们已经知道并已经成为习惯的内容，不进行显示的配置，只要咱们去默认使用就能够了，这样一来就极大的简化了框架的配置工做，能实现咱们用更少的代码来实现应用的程序变为可能；

  • （3）对于web应用来讲，REST是最好的

（一） 开发环境的选择

• 给初学者的建议

  • 若是咱们没有至少5年以上的rails开发经验，咱们务必不要使用windows操做系统去进行rails框架的开发，不然你会浪费很是多的时间在解决各类奇奇怪怪的问题上，好比说ruby的问题，gem的问题等等，很是的不值得，这些时间咱们彻底能够拿来学习rails框架

1.1 为何不使用windows

• rails框架对windows很是不友好，各类的学习资料和问题解答，还有库的支持都很是的有限，而且对于不少rails推荐使用的工具，好比说命令行，windows的命令行是不强大的；

1.2 选择适合本身的开发环境

• Mac OS

• Linux

这里jacky使用的centos7开发环境，多年的经验告诉jacky ，centos系统仍是很不错的，生产环境咱们确定是用云服务器了，非生产环境咱们用VMware Workstation软件在windonw上安装一个centos7系统，具体如何安装虚拟机，网上百度便可，红帽的镜像网上下载便可；

（二）安装 ruby

jacky说，ruby可不如java和python好安装，不一样系统，不一样版本，均可能会遇到这样那样的问题，这里jacky就只跟你们分享centos7的安装，若是信得过jacky的人，jacky也建议你们使用centos7系统，这样也能够跟着jacky一步一步来安装；

• 网上安装的方法方式太多，这里jacky建议你们仍是下载ruby官网的安装包到本地，解压，编译，安装，一步一步老老实实的安装

（1）ruby官网下载最新ruby安装包

http://www.ruby-lang.org/en/downloads/

（2）源码安装

$ tar -xvzf ruby-2.5.3.tgz    
$ cd ruby-2.5.3
$ ./configure
$ make
$ sudo make install
$ruby -v
ruby 2.5.3……

大部分朋友安装到./configure命令后可能会报错，那是由于linux系统下的ruby安装是要依赖gcc编译器（什么是gcc自行百度），因此咱们要执行下面的命令：yum -y install gcc 而后在从新执行命令就能够了

（三）RubyGem的安装和使用

3.1 Gem源

Gem 是管理相关软件库的东西，能够给rails框架提供软件包，用gem 安装 rails 有可能会出现问题，发生超时或链接错误等等，90%安装不成功的缘由都是gem源的问题

• Gem源是什么

  • Gem将全部的软件包放置的平台叫作Gem源，咱们更新或者安装各类Gem包的时候，都须要去链接这个Gem源，Gems源的网站为：rubygems.org ，咱们下载rails的时候，也是去这个网站去查找和下载的，由于这个网站不是国内的，咱们国内用户在访问这个gem源的时候会很是慢，有的时候会连不上，会致使安装的时候出现问题，那么解决的办法就是更换Gem源

  • 咱们在国内使用最稳定的是ruby-china镜像源，网站是 https://gems.ruby-china.com/

3.2 更改Gem源

• （1）第1步：用l命令看一下咱们目前有的Gem源；

gem sources --l

-（2）第2步：安装ruby-china镜像源

这里jacky强调的是，新建镜像源必定要移除原有的镜像源

gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

（四）Rails的安装

大部分的教程或者网络上的资料告诉你们rails的安装是很是简单的，只要使用一条命令就能够了（gem install rails）,若是有报错，那咱们就在命令前面加一个sudo就能够了（sudo gem install rails)就能够了（若是有些朋友不能用sudo命令能够试一下这个代码：alias sudo=‘sudo env PATH=$PATH’），但jacky说实际上真让咱们安装rails的时候，必定会遇到这样或者那样的问题，可是为何教程和资料上说的就是这样的简单呢；jacky认为是两个缘由：第一个缘由是rails安装的问题太多，有些人也讲不清或者不想讲；第二个缘由是用rails的人，必定不会是第一次就选择rails框架，你们都会有其余编程语言框架的基础，在安装其余编程语言框架的时候，有些rails框架

• 咱们的最终目的是用一条命令，就完美安装rails （gem install rails或者sudo gem install rails），但使用这条命令咱们会遇到这样或者那样的问题，出现的问题都是咱们缺乏依赖包或者依赖配置，这里jacky给你们规整一下出现的问题，并给出解决方案；

对下面的依赖包的特别说明（必看）：下面的依赖包不是必需要安装的，若是咱们sudo gem install rails 不报错，咱们就不用安装下面的安装包了，若是咱们遇到了报错，大几率是jacky总结的下面的几个或者所有安装包没有安装

4.1 依赖包1：安装build essentials

yum groupinstall "Development Tools"
yum install -y gcc g++ kernel-devel
sudo yum install build-essential libopenssl-ruby ruby2.5.3-dev

上述这一条命令，咱们就把许许多多rails的依赖包打包安装了

4.2 依赖包2：安装libxml2

yum -y install python-devel
yum install libxml2（若是不成功，咱们要选择手动安装，就是下载安装包安装，这里略，你们自行百度）

4.3 依赖包3：安装openssl和zlib

这里要说就篇幅过长，能够参考下面这篇文章：
http://www.javashuo.com/article/p-qgokppuc-cb.html

• 以上咱们就能够安装rails框架了

sudo gem install nokogiri
gem install rails

（五）使用Rails框架建立应用

5.1 开发环境的选择

• 对于应用程序开发来讲，有一个好的IDE（集成开发环境），会大大提高咱们的开发效率，这里jacky推荐的IDE是 rubymine；

如何在linux系统安装rubymine你们自行百度

5.2 建立Rails应用程序

5.2.1 使用系统自带的终端进行操做

cd Documents
rails new 你的项目名（工程名） --skip-bundle
bundle install

• 在运行bundle install命令以前，要修改Gemfile文件，bundle install的做用是让bundle根据gemfile的内容安装全部配置好的gem包，至关于一个命令就将rails所须要的配置包根据相应的版本安装好了
  

• 这里你们在运行bundle install 时可能会报错：An error occurred while installing sqlite3 (1.3.13), and Bundler cannot continue.这时咱们运行下面的这条命令就能够了： yum -y install sqlite*

5.2.2 Rails框架的目录结构

• app：它是rails框架的核心文件，包括模型、控制器、视图，已经前端等等的核心代码都在这个文件夹里，很是的重要，以后的学习过程咱们的开发90%的时间都是在app文件夹里进行操做的；

  • app下的assets文件夹：它是rails的应用资源文件夹，好比工程使用的一些静态文件都在这个文件夹里

• config：它是应用的配置目录，包含好比数据库的配置、运行环境的配置、以及路由的配置等，咱们在开发的过程也会常常的使用；

• test：它存放了全部rails应用的测试代码，那关于rails的测试是rails开发一个比较重要的内容

• lib和vendor：存放项目须要的第三方库，好比咱们本身写的项目内部公用的接口，或javascripts接口等等均可以放在这个文件夹里

• Gemfile：它配置了这个项目全部依赖的gem包

5.2.3 启动Rails框架

rails server

• 这时，咱们用命令运行rails服务时可能会报错，Could not find a JavaScript runtime. See https://github.com/rails/execjs for a list of available runtimes.(ExecJS::RuntimeUnavailable)，咱们只要安装node.js便可

1.下载node.js
curl --silent --location https://rpm.nodesource.com/setup_7.x | bash -
2.yum安装node.js
yum install -y nodejs
3.查看node.js版本
node -v

• 如何判断rails工程是否运行正常

  • 浏览器显示以下页面