インストール - 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を使用するプロジェクト名>

インストールが完了した後、作成したプロジェクトに移動する。

cd <Laravelを使用するプロジェクト名>

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

php -S localhost:8000 -t public

Webブラウザにおいて、以下のURLを入力して、LaravelのWebサイトが表示されるかどうか確認する。
http://localhost:8000

外部から接続する場合

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

/etc/apache2/vhosts.dディレクトリに、以下のようなファイルを作成する。
ここでは、仮想ホスト名をlaravel01、ドキュメントルートを~/htdocs/laravel01/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>

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

sudo chmod -R 775 <Laravelのプロジェクトディレクトリ>  # 不要の可能性がある(要調査)

sudo chown -R wwwrun:wwwrun <Laravelのプロジェクトディレクトリ>
または
sudo chown -R wwwrun:wwwrun <Laravelのプロジェクトディレクトリ>/storage

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

sudo vi /etc/hosts

# /etc/hostsファイル

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