インターネットのスケッチ

Done is better than perfect.

画像アップローダー設置で参考にしたリンクまとめ

環境

  • Rails 5.2
  • CarrierWave 1.2.2
  • MiniMagick 4.8.0

本番環境への設定はまだ。開発環境のみ。

全般

Ruby on Rails チュートリアル:実例を使って Rails を学ぼう

Rails5とCarrierWaveを使って画像アップロード機能を作る - write ahead log

[Rails5] Carrierwave + S3 + CloudFrontで画像アップロードを実装する方法

CarrierWave

Rails CarrierWaveのファイル名を変更する方法 – KeruuWeb

CarrierWaveのファイル名変換(original_filename)の挙動 - 備忘録。

Carrierwaveで画像をリサイズする - 49hack

MiniMagick

RubyでImageMagick使うにはMiniMagickの方がよい - 動かざることバグの如し
→これ「tiff対応のimagemagickでないとダメらしい」のエラー出るかと思ったけど、普通にimagemagickをDockerfileに追加するだけで大丈夫だった。Dockerだからか?

Docker

Docker for MacでRails5, MySQLとVue.jsの開発環境を作る | mn-memo

GitHub

GitHub - carrierwaveuploader/carrierwave: Classier solution for file uploads for Rails, Sinatra and other Ruby web frameworks

GitHub - minimagick/minimagick: mini replacement for RMagick

その他

Ruby の private と protected 。歴史と使い分け

HerokuにRailsアプリの検証環境を立てる

開発中他の人に動作を確認してもらいたいときや、スマホ実機確認をするとき用に、Herokuに検証環境を作りました。

ちなみにステージング兼本番環境にはAWSを使う予定です。

環境

Herokuのアカウント新規登録

こちらから。 jp.heroku.com

Heroku CLIのインストール&SSHキーの登録

ターミナルなどでherokuコマンドを使えるようにCLIをインストールします。私はhomebrewで入れました。 devcenter.heroku.com

インストールできたらHerokuにログインして、SSHキーを登録します。

SSHキーの作成

$ ssh-keygen -t rsa -b 4096 -C "Herokuで使うメールアドレス"

キーの保存先はユーザーディレクトリの .ssh/id_heroku_rsa など パスフレーズも入力

Herokuにログインしてキー登録

$ heroku login

Enter your Heroku credentials:
Email: メールアドレス
Password: *************
Logged in as メールアドレス

$ heroku keys:add ~/.ssh/id_heroku_rsa.pub

heroku keys:add で引数を指定しなければデフォルトで ~/.ssh/id_rsa.pub か ~/.ssh/id_dsa.pub を探しに行くらしい。

アプリをHerokuにデプロイ

準備

アプリのディレクトリをどこかにまるごとコピーして以下のファイルを削除するか、ディレクト外に移動。

  • Dockerfile
  • docker-compose.yml
  • .git
  • .gitignore
  • .env

私はDockerで開発していてそのままHerokuに上げてもいいんですが、Dockerなしでデプロイする方法も知っておきたいので、今回はDocker関連のファイルは除去して上げました。

そしたらHerokuへのデプロイはgitを経由して行うので、 git init をしてもう一度gitの管理対象にします。

$ cd コピーしたアプリのディレクトリ
$ git init
$ git add .
$ git commit -m "feat: Initial commit"

デプロイ

コピーしたアプリのディレクトリにいる状態で、herokuコマンドでデプロイします。

// Herokuにアプリを作成する
$ heroku create アプリの名前

// デプロイ
$ git push heroku master

MySQLの設定

// MySQLを利用するためClearDBアドオンを入れる
$ heroku addons:create cleardb:ignite

Creating cleardb:ignite on ⬢ アプリ名... free
Created cleardb-cylindrical-85040 as CLEARDB_DATABASE_URL
Use heroku addons:docs cleardb to view documentation

// 設定確認
$ heroku config

=== アプリ名 Config Vars
CLEARDB_DATABASE_URL:     mysql://b2a3d6180457c6:be3c12f5@us-cdbr-iron-east-04.cleardb.net/heroku_b44817e2b39c626?reconnect=true
LANG:                     en_US.UTF-8
RACK_ENV:                 production
RAILS_ENV:                production
RAILS_LOG_TO_STDOUT:      enabled
RAILS_SERVE_STATIC_FILES: enabled
SECRET_KEY_BASE: ***

// RailsのGemの mysql2 に合わせてDBURLを追加 or 変更する。
$ heroku config:set DATABASE_URL=mysql2://b2a3d6180457c6:be3c12f5@us-cdbr-iron-east-04.cleardb.net/heroku_b44817e2b39c626?reconnect=true

Setting DATABASE_URL and restarting ⬢ アプリ名... done, v9
DATABASE_URL: mysql2://b2a3d6180457c6:be3c12f5@us-cdbr-iron-east-04.cleardb.net/heroku_b44817e2b39c626?reconnect=true

// 設定確認
$ heroku config

=== アプリ名 Config Vars
CLEARDB_DATABASE_URL:     mysql://b2a3d6180457c6:be3c12f5@us-cdbr-iron-east-04.cleardb.net/heroku_b44817e2b39c626?reconnect=true
DATABASE_URL:             mysql2://b2a3d6180457c6:be3c12f5@us-cdbr-iron-east-04.cleardb.net/heroku_b44817e2b39c626?reconnect=true
〜省略〜

ちなみにDATABASE_URLをセットするところで、「zsh: no matches found: DATABASE_URL=mysql2: 省略」というエラーが私は出ました。zshのエラーのようなので.zshrcに以下を追記したら通りました。

$ setopt nonomatch

// 変更を反映
$ source ~/.zshrc

shirusu-ni-tarazu.hatenablog.jp

環境変数の設定

環境変数はHerokuのサイトからか、コマンドで設定できます。
サイトからは アプリのダッシュボード>Settings>Config Vars
コマンドは以下

// heroku config:add 変数名="値" の形式
$ heroku config:add DB_NAME="DB名"
$ heroku config:add DB_USERNAME="DBユーザー名"
$ heroku config:add DB_PASSWORD="パスワード"

ここには書きませんが、ついでにベーシック認証の変数なども設定しました。

テーブルの作成

あとはマイグレーションをしてテーブルを作成するだけです。

$ heroku run rails db:migrate

作成できたらアクセスできるか確認します。
下のコマンドのWeb URLがアプリのURLです。ちゃんとアクセスできたらOKです。

// アプリの情報を見る
$ heroku apps:info
=== アプリ名
Addons:         cleardb:ignite
Auto Cert Mgmt: false
Dynos:          web: 1
Git URL:        https://git.heroku.com/アプリ名.git
Owner:          メールアドレス
Region:         us
Repo Size:      16 MB
Slug Size:      64 MB
Stack:          heroku-16
Web URL:        https://アプリ名.herokuapp.com/

まとめ

あとは機能の実装ができたら git add してHerokuにプッシュしていけば検証環境でサイトの動作をチェックできます。デプロイツールいれたい。


参考

ステージング環境とは?開発環境、検証環境との違いと役割 | WWWクリエイターズ

お前らのSSH Keysの作り方は間違っている - Qiita

Managing Your SSH Keys | Heroku Dev Center

Rails5 x MySQL を Herokuにデプロイする手順 | tackeyy.com

mysqlを使ったRailsアプリをHerokuにデプロイする流れ - Qiita

HerokuでMySQLを使おうとして詰まったところ - Qiita

Heroku データベースの管理(ClearDB アドオンによる MySQL の利用) - 君の瞳はまるでルビー - Ruby 関連まとめサイト

Herokuで本番環境の環境変数(config vars)を.envファイルで設定する - dackdive's blog

初めてのプライベート開発 その2

ローカル開発環境を作っていきます。

基本的には以前自分であげたこちらの記事に沿って、Dockerで立てます。

khanamoto.hatenablog.com

技術スタック

現時点での最新バージョンを使います。

MySQL 8.0は正式版が数日前にリリースされたばかりですが、出たばかりの技術に触れることに慣れるいい機会なので8.0を使ってみようと思います(開発中にどうしても行き詰まった場合や深刻な脆弱性が出てきたら5.7にするかもしれません…)。

Amazon RDSで使えるバージョンに合わせてMySQL 5.7にします。

それと本番ではサーバーにnginxを使うつもりですが、開発環境ではしばらくpumaを使っていく予定です。

Railsアプリ&DB新規作成

以下のファイルを作って、

.
├── Dockerfile
├── Gemfile
├── Gemfile.lock
├── docker-compose.yml
└── .env

$ docker-compose run web rails new . --force --database=mysql
$ docker-compose build
$ docker-compose run web rake db:create
を順に実行します。ファイルの中身など詳細は前掲の記事参照。

注意点はGemfileでrailsのバージョンを5.2にすること。

source 'https://rubygems.org'
gem 'rails', '~> 5.2'

もし古いバージョンで作成してバージョンアップしたいときは、コンテナとイメージを両方削除してからもう一度rails newしてください。
ちなみに-sオプションで既存ファイルをスキップするとGemfileもスキップされるので注意。

テーブル作成

新規にテーブルを作成するので、rails generate modelコマンドでモデルとマイグレーションファイルをあわせて生成します。すでに存在するテーブルの変更の場合はmigrationコマンドを使います。

モデルクラス新規作成

docker-compose run web rails generate model tag tag_name:string
docker-compose run web rails generate model film user:references title:string staff:string comment:text favorite_scene:text watch_day:date cinema:string film_image:binary
docker-compose run web rails generate model film_tag film:references tag:references
docker-compose run web rails generate model user user_name:string profile_name:string email:string password:string profile:text user_image:binary
docker-compose run web rails generate model comment film:references user:references body:text
docker-compose run web rails generate model like film:references user:references
docker-compose run web rails generate model contact user:references body:text
docker-compose run web rails generate model follow user:references follow:references

マイグレーションファイル編集

NOT NULLやユニークなど列制約をつけます。
ユニーク制約はエラーが出たときの発生箇所を特定しやすくするために、アプリケーション側(モデル)とDB側(マイグレーション)の両方で設定しました。

マイグレーション実行

マイグレーションファイルを実行し、テーブルを作成します。

$ docker-compose run web rails db:migrate

アソシエーション(関連付け)設定

あとから開発で変更するかもしれませんが、テーブル設計にもとづいてアソシエーションをモデルに書いておきます。

フロントエンド整備

SlimとBootstrapをgemに追加します。jquery-railsはbootstrapのために必要です。

gem 'slim-rails'
gem 'bootstrap'
gem 'jquery-rails'

そしてerbファイルはslimファイルに変更し、中身もslim記法に書き換えます。

さらにapp/assets/javascripts/application.jsに以下を追加

//= require jquery3
//= require popper
//= require bootstrap-sprockets

application.cssをapplication.scssに変更し、以下を追加。

@import "bootstrap"

まとめ

開発環境の準備ができたのでここから開発に入っていきます。
まずは会員登録とログインから実装していきます。ここがしっかりできればあとはフォロー以外はそんなに難しくないかなと思います。

フォローはたぶん一番の山場になりそう。

余談

MySQL 8.0を使った場合のmysql 認証エラー。一応将来のためのログとしてここに残しておきます。

$ docker-compose run web rake db:create
Starting films-app_db_1 ... done
#<Mysql2::Error: Authentication plugin 'caching_sha2_password' cannot be loaded: /usr/lib/x86_64-linux-gnu/mariadb18/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory>
Couldn't create database for {"adapter"=>"mysql2", "encoding"=>"utf8", "pool"=>5, "username"=>"root", "password"=>"root", "host"=>"db", "database"=>"films_development"}, {:charset=>"utf8"}
(If you set the charset manually, make sure you have a matching collation)
Created database 'films_development'
#<Mysql2::Error: Authentication plugin 'caching_sha2_password' cannot be loaded: /usr/lib/x86_64-linux-gnu/mariadb18/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory>
Couldn't create database for {"adapter"=>"mysql2", "encoding"=>"utf8", "pool"=>5, "username"=>"root", "password"=>"root", "host"=>"db", "database"=>"films_test"}, {:charset=>"utf8"}
(If you set the charset manually, make sure you have a matching collation)
Created database 'films_test'

参考

MySQL 8.0正式版がリリース。性能が最大で2倍、JSONデータや地理情報などサポート。ロールによるユーザー権限の管理も可能に - Publickey

Docker で MySQL 8.0.4 を使う - Qiita

MySQL :: MySQL 8.0 Reference Manual :: 6.5.1.3 Caching SHA-2 Pluggable Authentication

Ruby on Rails 5.2正式版発表。Active Storageによるクラウドストレージ対応、Redisでのキャッシュ対応など - Publickey

マイグレーションファイル編集

Ruby - RailsでUserIDに一意制約を設けたい(121938)|teratail

Rails 複数のカラムに 一意制約 (ユニーク)を設ける - yamarkz's blog

Active Record バリデーション | Rails ガイド

初めてのプライベート開発 その1

仕事で途中からの開発に参加した経験はあるのですが、要件定義からの開発をしてみたくてプライベートでWebアプリ制作に挑戦しています。

4月初頭にrails newしたはいいものの、要件定義やDB設計を調べたり、仕事でバタバタしたりして間が空いてしまい、rubyrailsのコマンドを少し忘れているので、もう一度開発環境準備から始めてここに備忘録を残していきたいと思います。

ちなみにプロジェクトは要件定義も含めてすべてBacklogで管理しています。仕事でも使っていて使いやすいので。

要件定義

まず作りたいと思っているのは、見た映画を登録して管理できる、映画のアルバムみたいなアプリです。
で、それにフォローやいいねとかできて他の人とシェアできるといいなと。

そのうえで、ざっくりとどういう仕様にしたいかというのをリストアップしていきました。

必要な機能を考える

要件を出してアプリの方向性が固まってきたら、最低限必要な機能を洗い出します。
こんな感じになりました。

  • 会員登録
    • ユーザー名
    • メールアドレス
    • パスワード
  • ログイン
    • ユーザー名またはメールアドレス
    • パスワード
  • ユーザー情報編集
    • ユーザー名
    • アカウント名
    • メールアドレス
    • パスワード変更
    • 自己紹介文
    • アカウント削除
  • 見た映画管理
    • 作品登録
      • タイトル
      • 作品画像(自動or手動)
      • 監督、出演者など(手動)
      • コメント(公開or非公開)
      • 好きなシーン(公開or非公開)
      • タグ
      • 鑑賞した映画館
      • 鑑賞した日
    • 閲覧
    • 編集
    • 削除
  • タイムライン
    • フォローする
    • フォローした人の最新投稿を表示
      • 投稿者のアイコンとユーザー名
      • 作品画像
      • タイトル
      • コメント
        • コメントのやり取りでコミュニケーションができる
      • 何分前に投稿したか
      • いいね
  • 検索
    • キーワード検索
      • タイトル、監督など、コメント、好きなシーンからマッチ
    • タグ検索
  • お問い合わせ
  • プライバシーポリシー
  • 利用規約

ワイヤーフレーム作成

出した機能をもとにワイヤーフレームを作り、実際の画面のイメージを膨らませていきます。
これはBacklogを開発しているヌーラボのサービスである、Cacooを使いました。
Cacooって4,5年前に使った頃はかなり動作が重くて保存がしにくかったので使わなくなっていたんですが、久しぶりに触ってみたら結構改善されていました。
FlashからHTML5に移行したからかな。なにはともあれサクッと図を作るには重宝するサービスです。

PCとスマホ用のワイヤーフレームを作って、スマホはProttでリンクを貼ったときのページ遷移も確認してなるべくページに漏れがないように作っていきました。
Prottずっと使ってみたくて、初めて使ってみましたが、ページ漏れがないか確認するにはとても便利です。リンクのアニメーションも選べて動作も軽いので使いやすいです。

画面遷移図作成

ワイヤーフレームでページのイメージができたので、Railsのクラス名、アクション名を意識しながらURLパスを決めていきます。
こんな感じにしました。

f:id:khanamoto:20180426174749p:plain

デザイン

デザインは同僚のデザイナーにお願いしました。
開発と同時進行でページのデザインとロゴ作成をしてもらいます。

データベース設計

次はたぶん最初の肝になるデータベース(DB)の設計です。
DBの本を数冊読んだり、仕事の開発でDBからデータ取ってきたり、テーブル構造みたりしてたのでRDBMSの基本は理解できてましたが、1から設計となるとまた少し違いました。

論理設計

エンティティの抽出と定義をして、テーブル形式で表現していきます。
一通りできたら正規化をしてテーブルを分割します。
それができたらER図にして、リレーションにおかしいところや漏れがないか確認します。
こんな感じになりました。

f:id:khanamoto:20180426175653p:plain

物理設計

パフォーマンス等の詳しい部分は正直まだ時間がかかりそうなので、とりあえず以下を行いました。

  • データ型の決定
  • 制約条件の決定


ここまでで要件定義、画面設計、DB設計が一通りできたので、開発環境を整備して開発に入っていきます。
次回は開発環境について書こうと思います。


参考

初めての個人WEBサービスを作り始める前にやるべき設計

Ruby on Rails実践講座 - Twitterの簡易クローンを開発する - シラバス(Cyllabus)

STEP2-9.データベースを設計してみる / チームラボ オンラインスキルアップ課題

若手プログラマー必読!5分で理解できるER図の書き方5ステップ

XAMPPでサクッとWordPressローカル環境を立てる

社内のデザイナーがWordPressの勉強したいというので、ローカル環境の立て方教えました。いきなりDockerやVagrantは学習コストが高いので、手軽に開発環境を作れるXAMPPを使いました。
ということで自分の復習も兼ねて、XAMPPで一からWordPressのローカル環境を作る方法をここにまとめておきます。

Windows 10 中心での説明ですが、macOS の場合も併記しています。

予備知識

設定の説明に入る前にまずXAMPPがどういう仕組みで動いているのかを少し解説します。

XAMPPとは?

X - WindowsLinuxmacOSSolarisクロスプラットフォーム
A - ApacheのA
M - MySQLまたはMariaDBのM
P - PHPのP
P - PerlのP

Wikipediaより引用

Webアプリケーションの実行に必要なソフトウェアをまとめたパッケージのことです。言葉としてはLAMPLinux, Apache, MySQL, PHP)のほうが有名だと思いますが、XAMPPもLAMP環境と同じことができます。

ちなみに最新のXAMPPのデータベースはMySQLを改良して作られたMariaDBというものをパッケージングしています。ですが、表示はほとんどMySQLと同じです(コマンドもmysql)。

XAMPPの仕組み

WordPressはWebアプリケーションです。

Webアプリケーション(以下アプリ)を動かすために必要なのは、ブラウザ、サーバー、データベースです。
アプリのプログラムはサーバーに配置します。そしてWebページを表示するときは、ブラウザ(クライアントとも言います)がサーバーに実行してほしいファイルをリクエストし、サーバーは必要なデータをデータベースから取得し、サーバーからブラウザに結果がレスポンスされます。
クライアントclient(お客)とサーバーserver(給仕人)という名前からよく例えられるのは、レストランでのお客さんとウェイターの関係ですね。お客さんが料理を要求(リクエスト)し、ウェイターが料理を運ぶ(レスポンス)という関係です。

XAMPPの中のApacheがサーバー、MariaDBがデータベース、PHPがアプリのプログラムの役割をします。これらは自分のPCの中(ローカル)に設置するので、特別な設定をしない限り自分のPCからしかアクセスできません。そしてブラウザでローカルアドレスを指定することで、ローカル環境のサーバーやデータベースにアクセスして、自分のPC内だけでアプリを動作させることができます。

このようにして自分のPCの中だけでWordPressなどの動作環境を作ることができるのがXAMPPです。

XAMPPでWordPressローカル環境を立てる

ではローカル環境を作っていきましょう(開発環境を作ったりすることをエンジニアは「立てる」とも言います)。

1.XAMPPのインストール

Windowsの場合

まず下記から各OS向けXAMPPのインストーラーをダウンロードします。Windows版は32bit版しかありませんが、64bitのマシンでも使えるので大丈夫です。

XAMPP Installers and Downloads for Apache Friends

PHPバージョンは特に気にしなくていいのなら最新の7.2.2を選択します。古いバージョンが必要なら下記からダウンロードしてください。

Download XAMPP

次に、ダウンロードしたインストーラー(xampp-win32-7.2.2-0-VC15-installer.exe)を実行してセットアップをします。

途中 Select Components というダイアログでインストールする構成ファイルを選択できますが、今回はWordPress環境を作るため FileZilla FTP Server、Mercury Mail Server、Tomcat は使わないと思うので、チェックを外しても大丈夫です。

f:id:khanamoto:20180308122156j:plain

インストールする場所も基本的にデフォルトの C:\xampp でいいです。途中でWindows Defenderなどの警告が出ますが、問題ないので「アクセスを許可する」などを押して進めます。

セットアップが完了すると、XAMPPのコントロールパネル(管理画面)を立ち上げるかのチェックボックスがあります。とりあえず立ち上げてみましょう。英語とドイツ語どっちで設定するか聞いてきますが、好きな方を選んで下さい。

f:id:khanamoto:20180308123327j:plain

上のような画面が立ち上がればOKです。一旦閉じましょう。

macの場合

macの場合はトップページからダウンロードすると XAMPP-VM という仮想マシンをインストールすることになり初心者には使いづらいので、その他のバージョンから「7.2.2 / PHP 7.2.2」をダウンロードしてください。そうすると従来のネイティブ・インストーラーがダウンロードできます。「XAMPP-VM / PHP 7.2.2」じゃないです。

Download XAMPP

セットアップはWindowsとだいたい同じですが、Select Componentsのときは注意してください。
XAMPP Core Files と XAMPP Developer Files の両方にチェックを入れます。そうしないと、必要なファイルがダウンロードできずにApacheなどの起動ができなくなります。

f:id:khanamoto:20180308191736j:plain

セットアップができたら、macでも管理画面を起動してみます。

アプリケーションフォルダの中にXAMPPというフォルダができているので、その中の「manager-osx.app」を実行してください。管理者権限のパスワードを求められたら入力してOKです。

起動できたら、「Manage Servers」タグのMySQLApacheをStartして緑になれば成功です。

2.WordPressのダウンロード

次は下記からWordPressのソースファイルをダウンロードします。これも問題なければ最新版でいいです。

日本語 « ダウンロード — WordPress

ダウンロードしたフォルダを解凍すると wordpress というフォルダが展開されます。中身は下記のような構成です。

f:id:khanamoto:20180308123908j:plain

3.XAMPPでWordPressを起動してみる

XAMPPでWordPressを起動するための設定をしていきます。

  • xamppフォルダにwordpressファイルを配置

インストールしたXAMPPファイルは C:\xampp (mac: アプリケーションフォルダ直下)にあると思うので、そこに移動します。
その中に「htdocs」というフォルダがあるので、htdocs配下にダウンロードしたwordpressフォルダを配置します。
配置した後のパスで言うと C:\xampp\htdocs\wordpressmac: /Applications/XAMPP/xamppfiles/htdocs/wordpress)ですね。

配置できたら、 C:\xampp の中の xampp-control.exe (mac: /Applications/XAMPP/manager-osx.app)を起動します。これがXAMPPコントロールパネルの実行ファイルです。
起動するとさっきみたコントロールパネルが立ち上がります。
そしたらApacheMySQLをstartします。下記のようにApacheMySQLの部分が緑色になれば、ApacheMySQLの起動に成功しています。もし黄色になっていると失敗しているということなので、トラブルシューティングなどを参考に問題を解決してみてください。

ApacheMySQLの起動に成功したら、ブラウザで localhost/wordpress127.0.0.1/wordpress にアクセスします(パスの「wordpress」部分は C:\xampp\htdocs\ 配下に設置したWordPressのフォルダ名なので、もしフォルダ名を wp など好きなものに変えている場合は、パスも wp などに変えて localhost/wp などにしてください)。

localhostというのは今自分が使っているコンピュータのことを指します。これを指定することでブラウザからXAMPPのサーバーにアクセスします。その後に /wordpress とパスを指定すると、xamppのサーバーはルート(htdocs)のwordpressフォルダを探し、ブラウザに返すことでWordPressの画面がブラウザで表示されるようになります。
127.0.0.1は自分自身を指すIPアドレスであり、「ローカル・ループバック・アドレス」などと呼ばれます。localhostというのは127.0.0.1の別名のようなものだと考えてください。ちなみに127.0.0.1IPv4という規格でのアドレスであり、IPv6アドレスでは「::1」になります。
というわけで、以下に出てくるブラウザのアドレスに入力する localhost127.0.0.1 でもアクセスできます。

さてうまくアクセスできると、下記のようにWordPressのセットアップ画面が表示されます。

f:id:khanamoto:20180308132255j:plain

ここで冒頭の文章を読んでください。

作業を始める前にデータベースに関するいくつかの情報が必要となります。以下の項目を準備してください。

セットアップにはデータベースの情報が必要になるので、WordPressのセットアップに進む前に、学習用のデータベース(以下DB)を用意します。

DBとはブログ記事や画像などWordPressで入力して保存するデータを格納しておく場所のことです。DBにデータを格納することで、いろいろなデータの検索や抽出、表示などができるようになります。つまり、上で言われていることはそのデータの置き場所を先に作ってね、ということです。

4.データベースを用意する

ApacheMySQLを起動したまま、ブラウザで localhost にアクセスします。
するとXAMPPのダッシュボード画面が表示されます。そしてグロナビの一番右にある「phpMyAdmin」をクリックします。

そして下記のようにphpMyAdminの管理画面が表示されたらDBを作成していきます。

f:id:khanamoto:20180308141036j:plain

4-1.MySQL接続の照合順序の設定

phpMyAdminトップページの一般設定で、サーバー接続の照合順序を「utf8_general_ci」にする。

照合順序とは、「簡単に言うと文字列の比較方法の指定」のことで、「文字コード言語名比較法」という指定方法で、並び順に一致するものを比較します。
ここは正直明確にはわかってないのでまた調べたいと思う。

4-2.DB新規作成

グロナビの「データベース」か、サイドメニューの上にある「New」をクリックします。
デフォルトでいくつかDBがありますが、特に気にしないでそのままにしておきます。下記を入力してDBを新規作成してください。

「データベース名」:好きなDB名(英語始まりの小文字、スネークケースにしましょう。)
照合順序:utf8_general_ci

名前が決められなかったら wordpress とでもしてください。

できたら上にあるパンくずリストの「サーバ: 127.0.0.1 »」をクリックしてトップページに戻り、「データベース」をクリックして、自分で作成したDBが設定通りにできているか確認してください。
下記のようになっていたらOKです。

f:id:khanamoto:20180308144745j:plain

4-3.DBのrootのパスワードを設定

XAMPPのDBにはデフォルトでrootという特権ユーザー名が設定されていますが、パスワードは空になっています。
ローカル環境ですが、セキュリティ対策のためにrootにパスワードを設定しておきましょう。

DBのrootユーザーのパスワード設定

Windowsの場合

これはコマンドプロンプトで設定します。コマンドプロンプトを起動したら、以下のコマンドを順に叩いて設定します。
説明用のコメントは書かないでいいです。

# mysqlの実行ファイルの場所までディレクトリ移動
cd C:\xampp\mysql\bin

# パスワード設定をする(コマンドを叩くとパスワードの入力を2回求められるので入力)
mysqladmin -u root password
macの場合

macはターミナルで設定します。
必ずサーバーとDBを起動させた状態で行ってください。でないと下記のようなエラーが出ます。
「error: 'Can't connect to local MySQL server through socket '/Applications/XAMPP/xamppfiles/var/mysql/mysql.sock' (2 "No such file or directory")'」

cd /Applications/XAMPP/xamppfiles/bin

mysqladmin -u root password

phpMyAdminにも設定

このままだとphpMyAdminにアクセスしたとき下記のようにエラーになるので、phpMyAdminにもrootユーザーのパスワードを認識させる必要があります。

f:id:khanamoto:20180308153332j:plain

C:\xampp\phpMyAdmin\config.inc.phpファイル(mac: /Applications/XAMPP/xamppfiles/phpmyadmin/config.inc.php) をテキストエディタで開き、「$cfg['Servers'][$i]['password']」で検索し、さっきコマンドプロンプトで設定したrootユーザーのパスワードを書いて保存します。

$cfg['Servers'][$i]['password'] = 'rootユーザーのパスワード';

これでDBの用意はできたので、改めて localhost/wordpress にアクセスします。

5.WordPressセットアップ

DB設定

「さぁ、始めましょう」ボタンで移動したら以下のように設定します。

データベース名:自分で作ったDB名
ユーザー名:root(デフォルトのまま)
パスワード:さっき設定したrootユーザーのパスワード
データベースのホスト名:localhost(デフォルトのまま)
テーブル接頭辞:wp_(デフォルトのまま)

できたら「送信」ボタンを押して、「インストール実行」してください。

WordPress設定

ここではDBではなく、WordPressのユーザー名などを設定します。
最低限以下は設定してください。ミスっても後で変えられます。

サイトのタイトル:好きに
ユーザー名:好きに
パスワード:好きに

入力できたら「WordPressをインストール」ボタンを押してください。

成功画面が出たら、設定したWordPressのユーザー名とパスワードでログインしてみます。

ログインできました!

f:id:khanamoto:20180308155620j:plain

6.PHPの設定

最後に言語や標準時の設定などを日本語環境にするために、PHPファイルをいくつか編集します。

C:\xampp\php\php.iniファイル(mac: /Applications/XAMPP/xamppfiles/etc/php.ini)を開いて、以下のように編集します。

date.timezone=Europe/Berlin
↓
date.timezone=Asia/Tokyo
  • マルチバイト
;mbstring.language = Japanese
↓
mbstring.language = Japanese
;mbstring.internal_encoding =
↓
mbstring.internal_encoding = UTF-8
  • エラー表示レベル
error_reporting=E_ALL & ~E_DEPRECATED & ~E_STRICT
↓
; E_NOTICE(注意メッセージ)以外の全てのエラーを表示する
error_reporting=E_ALL & ~E_NOTICE

以上の設定ができたらApacheを再起動してください。
そして localhost にアクセスし、グロナビの「PHPInfo」から変更内容が反映されているか確認します。
例えばタイムゾーンを確認すると、 Asia/Tokyo になっていればOKです。

f:id:khanamoto:20180308172434j:plain

まとめ

お疲れ様でした。以上でXAMPPを使ったWordPressローカル環境の構築は終わりです。

開発環境1つにしても、Webの基礎知識がいろいろ必要なので、いい復習になりました。

あとは問題が起きたときなど、都度調べて学習していってください。

トラブルシューティング

Apacheが起動できない

XAMPPではApacheを起動するためポートの80番を使っています。ですが、他のアプリケーションでも80番を使っていると起動できません。なので他のアプリケーションかXAMPPのポート番号を変える必要があります。
例えばよくあるのが、Skypeで「ポート80と443を使用」している場合です。その場合はSkypeの接続設定を変えてみてください。

XAMPPのポート番号を変える場合は下記を参考にしてください。

XAMPPでインストールしたApacheが起動しないとき | PHPプログラミングの教科書 [php1st.com]

ApacheMySQLのファイルを編集したのに、変更内容が反映されない

コントロールパネルでStop→Startをして再起動してみてください。起動時にしか読み込まれないファイルがあるので、その場合は再起動が必要です。

参考

予備知識

Webアプリケーションの仕組み

レンタルサーバーとは?契約からできることを初心者にもわかりやすく解説します | カゴヤのサーバー研究室

XAMPP for OS Xからかなり変わったXAMPP-VM for OS X のメモ - uzullaがブログ

サーバー

今更聞けない!Webサーバーの仕組みと構築方法

ローカルホストとは - IT用語辞典

localhost - Wikipedia

ローカル・ループバック・アドレス(127.0.0.1)とは?:Tech TIPS - @IT

データベース

XAMPPを使ってWordPress用にローカル環境構築する方法【初心者向け】 | TechAcademyマガジン

MySQLのCollationを理解するためにまとめてみた。 - 6VOX

MySQL :: MySQL 5.6 リファレンスマニュアル :: 10.1.2 MySQL での文字セットと照合順序

MySQLでデータベース作成する「CREATE DATABASE」 | UX MILK

最新のXAMPPでのMySQLのパスワードの変更方法などについて | ゆうそうとITブログ

mysqlが起動できない - Qiita