インストール - Laravelのソースを表示

== 概要 ==
Composerは、依存性管理ツールである。<br>
依存性管理とは、<u>任意のライブラリは、特定のライブラリが存在しないと動作しない</u>ということを管理する。<br>
<br>
したがって、Composerを使用してLaravelをインストールすることで、Laravelが正常に動作する環境になる。<br>
<br>
ここでは、ComposerとLaravelのインストール手順について記載する。<br>
<br><br>

== 前提条件 ==
PHPおよびPHPモジュールをインストールする。<br>
 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
<br><br>

== Composerのインストール ==
以下に、Composerの公式Webサイトを示す。<br>
https://getcomposer.org/download<br>
<br>
任意の場所にComposerのインストールディレクトリを作成する。<br>
 mkdir -p ~/InstallSoftware/Composer
 cd ~/InstallSoftware/Composer
<br>
Composerをダウンロードする。<br>
 php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
<br>
インストーラのSHA-384を確認する。<br>
 php -r "if (hash_file('sha384', 'composer-setup.php') === '756890a4488ce9024fc62c56153228907f1545c228516cbf63f885e036d37e9a59d27d63f46af1d4d07ee0f76181c7d3') \
        { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
<br>
Composerをインストールする。<br>
composer.pharファイルが生成される。<br>
 php composer-setup.php --install-dir=/home/<ユーザ名>/InstallSoftware/Composer
<br>
composer.pharファイルのシンボリックリンクを作成する。<br>
 ln -s composer.phar composer
<br>
.profileファイル等に、Composerのインストールディレクトリを環境変数<code>PATH</code>に追加する。<br>
 vi ~/.profile
<br>
 ~/.profileファイル
 
 export PATH="$HOME/InstallSoftware/Composer:$PATH"
<br>
また、Composerをアンインストールする場合は、以下のコマンドを実行する。<br>
 php -r "unlink('composer-setup.php');"
<br><br>

== Laravelのインストール ==
Composerを使用して、Laravelをインストールする。<br>
<br>
まず、Laravelを使用したプロジェクトを作成するため、以下のコマンドを実行する。<br>
 mkdir ~/htdocs
 cd ~/htdocs
 
 composer create-project laravel/laravel --prefer-dist <Laravelを使用するプロジェクト名>
<br><br>

== 仮想ホストを構築しない場合(非推奨) ==
作成したLaravelのプロジェクトディレクトリに移動する。<br>
 cd <Laravelを使用するプロジェクトディレクトリ>
<br>
プロジェクトのトップディレクトリで、以下のコマンドを実行する。<br>
 php -S localhost:8000 -t public
<br><br>

== 仮想ホストを構築する場合 (推奨) ==
外部のクライアントPCからLaravelのプロジェクトに接続する場合、仮想ホストを構築する必要がある。<br>
<br>
SUSEの場合、/etc/apache2/vhosts.dディレクトリに、以下のような仮想ホスト向けの設定ファイルを作成する。<br>
ここでは、仮想ホスト名を<u>laravel01</u>、ドキュメントルートを<u>~/htdocs/laravel01/public</u>ディレクトリとしている。<br>
<br>
<u>※注意</u><br>
<u>Laravelのプロジェクトディレクトリにあるpublicディレクトリがドキュメントルートであるため、このディレクトリをアクセスするように設定する。</u><br>
 sudo vi /etc/apache2/vhosts.d/vhost-laravel01.conf
<br>
 # /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>
<br>
次に、Laravelのプロジェクトディレクトリに存在するstorageディレクトリにおいて、パーミッションを変更する。<br>
 sudo chmod o+w <Laravelのプロジェクトディレクトリ>/storage
<br>
もし、Laravelのプロジェクトディレクトリに対して、ユーザ名とグループ名をApache2のものに変更する時、<br>
SUSEの場合、Apache2のユーザ名およびグループ名は<code>wwwrun</code>である。<br>
<u>ただし、以下の設定は不要の可能性がある。</u>(調査中)<br>
 sudo chown -R wwwrun:wwwrun <Laravelのプロジェクトディレクトリ>/storage
 または
 sudo chown -R wwwrun:wwwrun <Laravelのプロジェクトディレクトリ>
<br>
最後に、外部のクライアントPCの/etc/hostsファイルにおいて、以下の設定を追記する。<br>
 sudo vi /etc/hosts
<br>
 # /etc/hostsファイル
 
 <サーバのIPアドレス>     laravel01
<br><br>

== 動作確認 ==
Webブラウザから、設定したルートドキュメントにアクセスする。<br>
Laravelが正常に動作している場合、ページの中央にLaravelのロゴが表示されるデモページが表示される。<br>
<br>
==== 仮想ホストを構築していない場合 ====
Webブラウザから、以下のURLを入力する。<br>
http://localhost:8000<br>
<br>
==== 仮想ホストを構築している場合 ====
Webブラウザから、以下のURLを入力する。<br>
http://仮想ホスト名<br>
<br>
デモページが表示されない場合、以下の点を確認する。<br>
* publicディレクトリにある.htaccessファイルの<code>Options -MultiViews</code>を、<code>Options -MultiViews +FollowSymLinks</code>に変更してみる。
*: <br>
* 仮想ホストの設定で、ドキュメントルートがLaravelのプロジェクトのpublicディレクトリかどうか確認する。
*: <br>
* 仮想ホストの設定で、publicディレクトリへの<code>Directory</code>ディレクティブで、<code>-MultiViews</code>を許可しているかどうか確認する。<br>(学習目的であれば、<code>AllowOverride all</code>を指定すると、動作させやすい)
*: <br>
* <Laravelのプロジェクトディレクトリ>/storageディレクトリのパーミッションが正しく設定されているかどうか確認する。
*: <br>
* MCrypt PHP拡張モジュールは動作可能かどうか確認する。
<br><br>

__FORCETOC__
[[カテゴリ:Web]]