carrierwave是一款经典的图片上传套件，本篇的目标是先在本地端（development）的rails项目试成功gem。

（预计中集的进度会练习怎么利用Amazone S3架设图片上传Host，

并再下集远端（production）实作上传，敬请期待！）

https://ithelp.ithome.com.tw/upload/images/20180904/20111177jA3W9YiK5l.png

在阅读任何Github上的README.md，有一点很重要的是知道因为环境设定的不同，必须渐渐了解哪些步骤可以跳过、哪些变数需要修改成符合自己项目性质的名称，这点身为新手的我，将会靠练习活用各式各样的gem来进步。：）

这次我们会更动的档案/文件夹如下：

Rails的构架说明

Gemfile设定Rails应用程序使用了哪些Gems套件

app放Controllers、Models和Views档案

接下来就按造步骤来实作吧(leafor)！

A.在gemfile加入套件，重启rails server：

首先我们按照carrierwave在githhub上说明档的指示，前往/项目名称/gemfile，新增代码：

gem 'carrierwave'，'~> 1.0'

README.md告诉我们CarrierWave的版本需求：Rails 4.0 or higher and Ruby 2.0，我的ruby 2.4.2 Rails 5.1.6，所以没有问题～

每次新增任何新的Gem到Gemfile，就要在Terminal输入bundle install处理相依性，然后rails s重启服务器。

tingdeMacBook-Air:yelpdemo tingtinghsu$ bundle install

tingdeMacBook-Air:yelpdemo tingtinghsu$ bundle info carrierwave

* carrierwave（1.2.3）

Summary: Ruby file upload library

Homepage: https://github.com/carrierwaveuploader/carrierwave

Path: /Users/tingtinghsu/.rvm/gems/ruby-2.4.2/gems/carrierwave-1.2.3

B.用rails g指令，新增Image uploader功能

接下来就可以看到carrierwave的厉害之处了，在此我需要将自己的餐厅（restaurants）数据库建立新的图片（image）字段，所以把carrier的指令客制化成自己的项目。

指令rails g uploader Image帮助我们在此路径：app/uploaders/image_uploader.rb新增了档案。

打开image_uploader.rb看看里面的类别写法：

class ImageUploader < CarrierWave:：Uploader:：Base

storage：file

#storage：fog

# Override the directory where uploaded files will be stored.

# def store_dir

“uploads/#{model.class.to_s.underscore}/#{mounted_as}/#{model.id}”

end

这个部分指的是：

如果我把储存档案的地方放在本地端（localhost），就要把storage：file前的#注释拿掉

相对的，想要把储存档案的地方放在远端（Heroku），把storage：fog前的#注释拿掉

在本篇里，CarrierWave会把我上传的图片将会放在/public/uploads/restaurant/image。

C.建立数据库上传Image所需字段

建立迁移档（migration，修改数据库结构）

rails g migration add_image_to_restaurants image:string

并在数据库增加上传图片的字段：

rake db:migrate

然后重启服务器：rails s

顺利的在db/migrate跑出了add_image_to_restaurants.rb档案。打开来瞧瞧：

class AddImageToRestaurants < ActiveRecord:：Migration[5.1]

def change

add_column：restaurants，：image，：string

end

end

D.修改Models，让数据库准备好存取图片的功能

接下来我们修改跟ActiveRecord有关的Models。mount Model里面，这个名为uploader上传功能小帮手，未来它会帮我们翻译数据库语言（SQL）跟数据库要数据（餐厅图片）。：

Models: app/models/restaurant.rb

class User < ActiveRecord:：Base

mount_uploader：image，ImageUploader

end

在rails官网提到：

Active Record是MVC的M（Model）表现商业逻辑与数据的层级，负责新增与操作需要持久存在数据库里的数据。Active Record本身是ORM（Object Relational Mapping，物件关联映像）系统的描述。

E.修改Views

数据库的上传功能已经准备好了，接下来到Views跟表单沟通，请让表单能够接受上传的图片。

到app/views/restaurants/_form.html.erb，修改成可以上传照片的form type（表单型态）。

<%= form_with（model: restaurant，local: true，：html => { multipart: true }）do |form| %>

我们来增加：「上传图片」字段，让使用者能在视觉上看得见新字段，并修改上传图片的档案（file）类型为form.file_field，不同于其他纯文字（text）字段如地址、电话的form.text_field。

<div class=“form-group”>

<%= form.label：name %>

<%= form.text_field：name，id:：restaurant_name，class:“form-control”%>

</div>

…

<div class=“form-group”>

<%= form.label：image %>

<%= form.file_field：image，id:：restaurant_image，class:“form-control”%>

</div>

告诉rails何时取得image。我们来到app/views/restaurants/show.html.erb，在餐厅数据前面加上代码：

<p id=“notice”><%= notice %></p>

<%= image_tag @restaurant.image_url if @restaurant.image_url.present？%>

<p>

…

<p>

<strong>Name:</strong>

<%= @restaurant.name %>

</p>

image_tag:Rails内置的Helper静态辅助方法，可以让我们建构HTML更为容易。参考这里

@restaurant.image_url：显示目前这笔餐厅数据的图片位置。

[新手常见Bug！]检查图片为nil写法：if @restaurant.image_url.present？。可以防止当某位使用者新增一笔餐厅数据、但没有附上图片的时候，show.html.erb这页网页直接当掉给你看…

F.修改Controllers

最后，我们在Controllers: app/controllers/restaurants.controller.rb加上允许上传至字段的参数，告诉rails，新的image字段是安全的(gdgfpy)。

def restaurant_params

params.require（：restaurant）.permit（：name，：address，：phone，：website，：image）

end

**大功告成**