インストール - Laravel

概要

Composerは、依存性管理ツールである。
依存性管理とは、任意のライブラリは、特定のライブラリが存在しないと動作しないということを管理する。

したがって、Composerを使用してLaravelをインストールすることで、Laravelが正常に動作する環境になる。

ここでは、ComposerとLaravelのインストール手順について記載する。

前提条件

PHPおよびPHPモジュールをインストールする。

sudo zypper install php7 php apache2-mod_php7 php7-curl php7-xmlreader php7-zip php7-pdo php7-gd php7-json php7-mysql php7-mbstring \
                    php7-openssl php7-pecl php7-devel php7-fpm apache2-mod_php7 php7-fileinfo php7-phar

Composerのインストール

以下に、Composerの公式Webサイトを示す。
https://getcomposer.org/download

任意の場所にComposerのインストールディレクトリを作成する。

mkdir -p ~/InstallSoftware/Composer
cd ~/InstallSoftware/Composer

Composerをダウンロードする。

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

インストーラのSHA-384を確認する。

php -r "if (hash_file('sha384', 'composer-setup.php') === '756890a4488ce9024fc62c56153228907f1545c228516cbf63f885e036d37e9a59d27d63f46af1d4d07ee0f76181c7d3') \
       { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Composerをインストールする。
composer.pharファイルが生成される。

php composer-setup.php --install-dir=/home/<ユーザ名>/InstallSoftware/Composer

composer.pharファイルのシンボリックリンクを作成する。

ln -s composer.phar composer

.profileファイル等に、Composerのインストールディレクトリを環境変数PATHに追加する。

vi ~/.profile

~/.profileファイル

export PATH="$HOME/InstallSoftware/Composer:$PATH"

また、Composerをアンインストールする場合は、以下のコマンドを実行する。

php -r "unlink('composer-setup.php');"

Laravelのインストール

Composerを使用して、Laravelをインストールする。

まず、Laravelを使用したプロジェクトを作成するため、以下のコマンドを実行する。

mkdir ~/htdocs
cd ~/htdocs

composer create-project laravel/laravel --prefer-dist <Laravelを使用するプロジェクト名>

仮想ホストを構築しない場合(非推奨)

作成したLaravelのプロジェクトディレクトリに移動する。

cd <Laravelを使用するプロジェクトディレクトリ>

プロジェクトのトップディレクトリで、以下のコマンドを実行する。

php -S localhost:8000 -t public

仮想ホストを構築する場合 (推奨)

外部のクライアントPCからLaravelのプロジェクトに接続する場合、仮想ホストを構築する必要がある。

SUSEの場合、/etc/apache2/vhosts.dディレクトリに、以下のような仮想ホスト向けの設定ファイルを作成する。
ここでは、仮想ホスト名をlaravel01、ドキュメントルートを~/htdocs/laravel01/publicディレクトリとしている。

※注意
Laravelのプロジェクトディレクトリにあるpublicディレクトリがドキュメントルートであるため、このディレクトリをアクセスするように設定する。

sudo vi /etc/apache2/vhosts.d/vhost-laravel01.conf

# /etc/apache2/vhosts.d/vhost-laravel01.confファイル

# VirtualHost template
# Note: to use the template, rename it to /etc/apache2/vhost.d/yourvhost.conf. 
# Files must have the .conf suffix to be loaded.
#
# See /usr/share/doc/packages/apache2/README.QUICKSTART for further hints 
# about virtual hosts.
#
# Almost any Apache directive may go into a VirtualHost container.
# The first VirtualHost section is used for requests without a known
# server name.
#
<VirtualHost *:80>
   ServerAdmin webmaster@laravel01
   ServerName laravel01

   # DocumentRoot: The directory out of which you will serve your
   # documents. By default, all requests are taken from this directory, but
   # symbolic links and aliases may be used to point to other locations.
   DocumentRoot /home/<ユーザ名>/htdocs/laravel01/public

   # if not specified, the global error log is used
   ErrorLog /home/<ユーザ名>/htdocs/log/laravel01-error_log
   CustomLog /home/<ユーザ名>/htdocs/log/laravel01-access_log combined

   # don't loose time with IP address lookups
   HostnameLookups Off

   # needed for named virtual hosts
   UseCanonicalName Off

   # configures the footer on server-generated documents
   ServerSignature On

   # Optionally, include *.conf files from /etc/apache2/conf.d/
   #
   # For example, to allow execution of PHP scripts:
   #
   # Include /etc/apache2/conf.d/php5.conf
   #
   # or, to include all configuration snippets added by packages:
   # Include /etc/apache2/conf.d/*.conf

   # ScriptAlias: This controls which directories contain server scripts.
   # ScriptAliases are essentially the same as Aliases, except that
   # documents in the realname directory are treated as applications and
   # run by the server when requested rather than as documents sent to the client.
   # The same rules about trailing "/" apply to ScriptAlias directives as to
   # Alias.
   #
   ScriptAlias /cgi-bin/ "/home/<ユーザ名>/htdocs/cgi-bin/"

   # "/srv/www/cgi-bin" should be changed to whatever your ScriptAliased
   # CGI directory exists, if you have one, and where ScriptAlias points to.
   #
   <Directory "/home/<ユーザ名>/htdocs/cgi-bin">
       AllowOverride None
       Options +ExecCGI -Includes
       AddHandler cgi-script .cgi .pl .py .sh
       <IfModule !mod_access_compat.c>
           Require all granted
       </IfModule>
       <IfModule mod_access_compat.c>
           Order allow,deny
           Allow from all
       </IfModule>
   </Directory>

   # UserDir: The name of the directory that is appended onto a user's home
   # directory if a ~user request is received.
   #
   # To disable it, simply remove userdir from the list of modules in APACHE_MODULES
   # in /etc/sysconfig/apache2.
   #
   <IfModule mod_userdir.c>
       # Note that the name of the user directory ("public_html") cannot simply be
       # changed here, since it is a compile time setting. The apache package
       # would have to be rebuilt. You could work around by deleting
       # /usr/sbin/suexec, but then all scripts from the directories would be
       # executed with the UID of the webserver.
       UserDir public_html
       # The actual configuration of the directory is in
       # /etc/apache2/mod_userdir.conf.
       Include /etc/apache2/mod_userdir.conf
       # You can, however, change the ~ if you find it awkward, by mapping e.g.
       # http://www.example.com/users/karl-heinz/ --> /home/karl-heinz/public_html/
       #AliasMatch ^/users/([a-zA-Z0-9-_.]*)/?(.*) /home/$1/public_html/$2
   </IfModule>

   #
   # This should be changed to whatever you set DocumentRoot to.
   #
   <Directory "/home/<ユーザ名>/htdocs/laravel01/public">
       #
       # Possible values for the Options directive are "None", "All",
       # or any combination of:
       #   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
       #
       # Note that "MultiViews" must be named *explicitly* --- "Options All"
       # doesn't give it to you.
       #
       # The Options directive is both complicated and important.  Please see
       # http://httpd.apache.org/docs/2.4/mod/core.html#options
       # for more information.
       #
       Options Indexes FollowSymLinks

       #
       # AllowOverride controls what directives may be placed in .htaccess files.
       # It can be "All", "None", or any combination of the keywords:
       #   Options FileInfo AuthConfig Limit
       #
       AllowOverride None

       #
       # Controls who can get stuff from this server.
       #
       <IfModule !mod_access_compat.c>
           Require all granted
       </IfModule>
       <IfModule mod_access_compat.c>
           Order allow,deny
           Allow from all
       </IfModule>
   </Directory>
</VirtualHost>

次に、サーバ側のPCの/etc/hostsファイルにおいて、以下の設定を追記する。

sudo vi /etc/hosts

# サーバ側の/etc/hostsファイル

127.0.0.1     laravel01

次いで、外部のクライアントPCの/etc/hostsファイルにおいて、以下の設定を追記する。

sudo vi /etc/hosts

# 外部のクライアントPC側の/etc/hostsファイル

<サーバのIPアドレス>     laravel01

最後に、Laravelのプロジェクトディレクトリにあるstorageディレクトリにおいて、グループ名またはパーミッションを変更する。

※注意
もし、Laravelのプロジェクトディレクトリに対して、ユーザ名やグループ名をApache2のものに変更する時、
SUSEの場合、Apache2のユーザ名およびグループ名はwwwである。

変更方法は、以下に示す2種類ある。

• 方法 1 (推奨)

  まず、ユーザをwwwグループに追加する。

  sudo usermod -aG www "${USER}"

  
  

  次に、Laravelのプロジェクトディレクトリにあるstorageディレクトリのグループ名を変更する。

  cd <Laravelのプロジェクト>

  sudo chown -R "${USER}":www storage bootstrap/cache

  
  

  ユーザとWebサーバの両方に対して、パーミッションを変更する。

  この設定は、不要の可能性がある。(要調査)

  find <Laravelのプロジェクトディレクトリ> -type f -exec chmod 664 {} \;

  find <Laravelのプロジェクトディレクトリ> -type d -exec chmod 775 {} \;

  
  

  Laravelのプロジェクトディレクトリにあるstorageディレクトリのパーミッションを変更する。

  sudo chmod -R ug+rwx storage bootstrap/cache

  
  

• 方法 2

  まず、ユーザをwwwrunグループに追加する。

  sudo usermod -aG www "${USER}"

  
  

  次に、Laravelのプロジェクトディレクトリにあるstorageディレクトリのグループ名を変更する。

  sudo chown -R "${USER}":www <Laravelのプロジェクトディレクトリ>

  
  

  LaravelのプロジェクトディレクトリにあるLaravelのプロジェクトディレクトリのパーミッションを変更する。

  sudo chmod -R 775 <Laravelのプロジェクトディレクトリ>

動作確認

Webブラウザから、設定したルートドキュメントにアクセスする。
Laravelが正常に動作している場合、ページの中央にLaravelのロゴが表示されるデモページが表示される。

仮想ホストを構築していない場合

Webブラウザから、以下のURLを入力する。
http://localhost:8000

仮想ホストを構築している場合

Webブラウザから、以下のURLを入力する。
http://仮想ホスト名

デモページが表示されない場合、以下の点を確認する。

• publicディレクトリにある.htaccessファイルのOptions -MultiViewsを、Options -MultiViews +FollowSymLinksに変更してみる。

  
  

• 仮想ホストの設定で、ドキュメントルートがLaravelのプロジェクトのpublicディレクトリかどうか確認する。

  
  

• 仮想ホストの設定で、publicディレクトリへのDirectoryディレクティブで、-MultiViewsを許可しているかどうか確認する。
  (学習目的であれば、AllowOverride allを指定すると、動作させやすい)

  
  

• <Laravelのプロジェクトディレクトリ>/storageディレクトリのパーミッションが正しく設定されているかどうか確認する。

  
  

• MCrypt PHP拡張モジュールは動作可能かどうか確認する。