【最新】PHPフレームワークLaravelのインストール入門編[5.6/5.5]

検証環境

Laravelのインストール作業を行う為の環境は以下の通りです。

ver 5.6/5.5

• Linux CentOS 7
• apache 2.4
• PHP 7.1

Laravelについて

インストールはいわゆる入門編、最初の一歩という事でまずは以下おさらいです。

Laravel 公式サイト[日本]

http://laravel.jp

Laravel とは？（以下引用）

• Laravel は、MVCのWebアプリケーション開発用の無料・オープンソースのPHPで書かれたWebアプリケーションフレームワークである。LaravelはMITライセンスの下でリリースされており、そのソースコードはGitHubにホスティングされている。マイクロソフトの.NETの開発に関わっていたTaylor Otwell が開発した。
• githubでのスター獲得数がPHPフレームワークの中で最も多いなど、人気のフレームワークの1つとなっている。
• Laravelの名前は『ナルニア国物語』に登場するナルニア国の王都、ケア・パラベルにちなむ。

引用 - Wikipedia「Laravel」

名前の由来、本当なんですかね笑 テイラーさんナルニア好きだったのかな。

サーバ要件を確認する

Laravelをインストールする為には、サーバのミドルウェアが要件を満たしていないといけません。
各バージョンごとのサーバ要件は以下の通りです。

Laravel 5.6

• PHP >= 7.1.3
• OpenSSL PHP Extension
• PDO PHP Extension
• Mbstring PHP Extension
• Tokenizer PHP Extension
• XML PHP Extension
• Ctype PHP Extension
• JSON PHP Extension

Laravel 5.5

• PHP >= 7.0.0
• OpenSSL PHP Extension
• PDO PHP Extension
• Mbstring PHP Extension
• Tokenizer PHP Extension
• XML PHP Extension

ExtensionはPHPの拡張モジュールになります。拡張モジュールというのは、PHPの特定の機能をモジュール化する事でコアソースから分離させ、必要に応じてそれらを組み込んで使う事でPHP自体のソースの肥大化を防ぐ仕組みの事です。
[php.net]拡張モジュールの一覧/分類

という事で、簡単にまとめると

• PHPのバージョンが指定以上である事
• 指定のPHP拡張モジュールが入っている事

上記２点を満たす事でインストールが可能になります。

PHPのバージョンを調べるには、以下のコマンドを叩きます。

# PHPのバージョンを確認する
php -v

# 実行結果
[demo@localhost ~]# php -v
PHP 7.1.3 (cli) (built: Jan  3 2018 11:00:58) ( NTS )
Copyright (c) 1997-2017 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2017 Zend Technologies
    with Zend OPcache v7.1.3, Copyright (c) 1999-2017, by Zend Technologies
    with Xdebug v2.5.5, Copyright (c) 2002-2017, by Derick Rethans

該当のPHP拡張が入っているか確認するには、以下のコマンドを叩きます。

ver 5.6

# PHPのエクステンションを確認
php -m | grep -e openssl -e PDO -e mbstring -e tokenizer -e ^xml$ -e ctype -e json

# 実行結果
[demo@localhost ~]# php -m | grep -e openssl -e PDO -e mbstring -e tokenizer -e ^xml$ -e ctype -e json
ctype
json
mbstring
openssl
PDO
tokenizer
xml 

ver 5.5

# PHP拡張「OpenSSL」「PDO」「Mbstring」「Tokenizer」「XML」が入っているか確認
php -m | grep -e openssl -e PDO -e mbstring -e tokenizer -e xml

# 実行結果
[demo@localhost ~]# php -m | grep -e openssl -e PDO -e mbstring -e tokenizer -e ^xml$
mbstring
openssl
PDO
tokenizer
xml

指定のExtensionが入っていれば表示されます。不足している場合はそれぞれの環境に合わせてインストールします。

Composerインストール

Laravelは基本的にcomposerでインストールするので、まずはcomposerをインストールします。ちなみにこのセクションは、Laravelのバージョン関係なく共通の作業手順で行えます。

# yumコマンドでcomposerをインストール
yum -y install composer

# tmpディレクトリへ移動
cd /tmp

# composerのインストーラーをダウンロードする
curl -sS https://getcomposer.org/installer | php

# composerを移動させる
mv /tmp/composer.phar /usr/local/bin/composer

インストールが終わったら、以下のcomposerコマンドで、composerがインストールされた事を確認します。バージョン確認のコマンドを叩き、バージョンが表示されればインストールは成功です。

# composerがインストールされているか確認
composer -v

# 実行結果
[demo@localhost ~]# composer -v
   ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                    /_/
Composer version 1.5.5 2018-00-00 00:00:00

上記のような表示が出たらcomposerのインストールは完了です。composerの場合は上記のように結構ド派手なアスキーアートが出るのでわかりやすいです。

Laravelインストール

それでは下準備も終わったので、早速Laravelのインストールを行います。インストールには「laravelコマンド」または「composerコマンド」の２通りの方法で行う事が出来ます。

# ディレクトリ移動
cd /root/.config/composer

# Composerを使用し、Laravelインストーラをダウンロード
composer global require "laravel/installer"

# パスを通す
export PATH="~/.config/composer/vendor/bin:$PATH"

# laravelをインストールしたい場所へ移動する
cd /path/to/projrct_root

# laravelプロジェクトを作成する
laravel new project_name

# laravelディレクトリへ移動
cd /path/to/project_root/laravel

# storageのパーミッションを変更
chmod -R 777 storage

# bootstrap/cacheのパーミッションを変更
chmod -R 777 bootstrap/cache