VPS,オンプレでEvolutionCMSを動かす

「Evolution CMS」というCMS（コンテンツ・マネジメント・システム）があります。
「MODX」の発展形（？）の位置付けなのでしょうか、MODXと同様に非常に扱いやすいCMSです。
「Evolution CMS」としては2017年に1.3.0がリリースされたように比較的新しいCMSに位置付けられます。

また、Evolution CMSには2021年8月現在「1系(バージョン1.x.x.)」と「3系(バージョン3.x.x.)」があります。
「1系」は「MODX Evolution」の流れから発展してきたもの、「3系」はLaravelフレームワークをベースとした新しい構成のもののようです。

今回はEvolution CMS「1系」の基本的なインストール〜セットアップ方法を紹介します。
（以降に表記している「Evolution CMS」はすべて「Evolution CMS 1系」を指しています。）
インストール自体はMODXとほとんど同様ですので、MODXをインストールしたことがある方であれば戸惑う箇所はないでしょう。

本章ではオンプレミスサーバ、仮想マシン、VPSなどにCentOS7をOSとしてLAMPサーバを構築し、その上にEvolution CMSをセットアップしていくことを前提とします。

ベースLAMPサーバのセットアップ

次のページを参考に、CentOS7 をOSとしたLAMPサーバ（Linux, Apache, MySQL, PHP）を構成します。

CMS用にLAMPサーバを構築する（CentOS7編）

上記でセットアップしたPHPに加え、オプションとして下記を追加インストールしておきます。

# yum install php-gmp php-curl php-intl php-xmlrpc php-zip

================================================================================
 Package           アーキテクチャー
                               バージョン                 リポジトリー     容量
================================================================================
インストール中:
 php-gmp           x86_64      7.4.22-1.el7.remi          remi-php74       79 k
 php-intl          x86_64      7.4.22-1.el7.remi          remi-php74      237 k
 php-pecl-zip      x86_64      1.19.3-2.el7.remi.7.4      remi-php74       62 k
 php-xmlrpc        x86_64      7.4.22-1.el7.remi          remi-php74       90 k
依存性関連でのインストールをします:
 libicu65          x86_64      65.1-1.el7.remi            remi-safe       9.2 M
 libzip5           x86_64      1.8.0-2.el7.remi           remi-safe        64 k
 libzstd           x86_64      1.5.0-1.el7                epel            370 k

トランザクションの要約
================================================================================
インストール  4 パッケージ (+3 個の依存関係のパッケージ)

総ダウンロード容量: 10 M
インストール容量: 34 M
Is this ok [y/d/N]: y

Dockerの「php:7.4-apache」を利用する場合、次のようにGDとZIPのオプションを追加するようにDockerfileに追記しておきます。

　：
RUN apt-get update \
  && apt-get install -y less wget \
  libmcrypt-dev openssl \
  mariadb-client \
  libonig-dev \
  iputils-ping net-tools dnsutils \
  libzip-dev \
  # Install GD
  libfreetype6-dev libjpeg62-turbo-dev libwebp-dev \
  && docker-php-ext-install pdo_mysql mysqli iconv zip
RUN pecl install mcrypt-1.0.3
RUN docker-php-ext-enable mcrypt
RUN docker-php-ext-configure gd --with-freetype=/usr/include/ --with-jpeg=/usr/include/ --with-webp
RUN docker-php-ext-install -j$(nproc) gd
　：

MySQLのSQLモードの確認・変更

MySQLの設定によってはEvolution CMSのインストール時にエラーとなることがあります。この原因の1つに、MySQLのSQLモード(strict mode)の設定状態があります。以下の手順で使用するMySQLの状態を事前に確認してみます。

ターミナルよりMySQLにログインし、以下を実行します。

mysql> SELECT @@GLOBAL.sql_mode;
+-----------------------------------------------------------------------------------------------------------------------+
| @@GLOBAL.sql_mode                                                                                                     |
+-----------------------------------------------------------------------------------------------------------------------+
| ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION |
+-----------------------------------------------------------------------------------------------------------------------+
1 row in set (0.00 sec)

このような表示になっていたらMySQLが厳格な制限モードになっています。他のシステムへの影響も考慮して適切な状態に変更する必要があります。

他のシステムへの影響がなければ、MySQLの設定ファイル（/etc/my.cnf など）を次のように変更します。

sql_mode='' <---- この行を追加する

MySQLを再起動します。

systemctl restart mysqld

再度MySQLにログインし、SQLモードの状態を確認します。

mysql> select @@GLOBAL.sql_mode;
+-------------------+
| @@GLOBAL.sql_mode |
+-------------------+
|                   | <---- 反映されている
+-------------------+
1 row in set (0.00 sec)

Evolution CMS用データベースの作成

Evolution CMSで使用するデータベースを作成します。
以下の例では、MySQLにEvolution CMS用データベースを「evocms_db」の名前で作成します。
Evolution CMS用データベースを作成する前に、専用のMySQLユーザを「evouser」の名前で事前に作成しておきます。

ターミナルよりMySQLに接続します。
今回はMySQLユーザ「root」で接続します。
下の例のように「mysql>」のプロンプトが返ってきたら接続完了です。

• 下の例で入力するrootユーザのパスワードはMySQLのrootユーザのものです。OSのrootユーザのパスワードではないので注意しましょう。

# mysql -u root -p
Enter password: <------------------- MySQLユーザ「root」のパスワードを入力
Welcome to the MySQL monitor.  Commands end with ; or \g.
　：
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> 

Evolution CMSデータベースを操作するためのMySQLユーザを作成します。
次の例ではユーザ名を「evouser」パスワードを「userevo」としていますが名前・パスワードはお好みで。

mysql> create user 'evouser'@'localhost' identified by 'userevo';
Query OK, 0 rows affected (0.03 sec)

Evolution CMSデータベースを作成します。
次の例ではデータベース名は「evocms_db」としています（名前は任意で可）。
デフォルトの文字コード「utf8mb4」とソート順「utf8mb4_general_ci」を指定しておきます。

mysql> create database evocms_db default character set utf8mb4 COLLATE utf8mb4_general_ci;
Query OK, 1 row affected (0.03 sec)

Evolution CMSデータベースを操作できるユーザへ権限を付与します。
権限は厳密に設定しても良いでしょうが、「all」でも大丈夫です。

mysql> grant all on evocms_db.* to 'evouser'@'localhost' with grant option;
Query OK, 0 rows affected (0.02 sec)

正しく設定されているか確認してみます。

mysql> show databases;
+------------------------+
| Database               |
+------------------------+
| information_schema     |
| evocms_db              | <------ 表示されること
| mysql                  |
| performance_schema     |
| sys                    |
+------------------------+
5 rows in set (0.00 sec)

mysql> select user,host from mysql.user;
+------------------+-----------+
| user             | host      |
+------------------+-----------+
| evouser          | localhost | <---- 表示されること
| mysql.infoschema | localhost |
| mysql.session    | localhost |
| mysql.sys        | localhost |
| root             | localhost |
+------------------+-----------+
5 rows in set (0.00 sec)

mysql> show grants for 'evouser'@'localhost';
+---------------------------------------------------------------------------------+
| Grants for evouser@localhost                                                    |
+---------------------------------------------------------------------------------+
| GRANT USAGE ON *.* TO `evouser`@`localhost`                                     |
| GRANT ALL PRIVILEGES ON `evocms_db`.* TO `evoser`@`localhost` WITH GRANT OPTION |
+---------------------------------------------------------------------------------+
2 rows in set (0.00 sec)

一旦MySQLを切断して、作成したEvolution CMSユーザで再度接続してみます。

mysql> quit <------------------------------ 切断する
Bye

# mysql -u evouser -p <-------------------- 「evouser」で接続
Enter password: <-------------------------- 「evouser」のパスワードを入力
Welcome to the MySQL monitor.  Commands end with ; or \g.
　：
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> show databases;
+--------------------+
| Database           | <------------------- 利用できるデータベースのみ表示される
+--------------------+
| information_schema |
| evocms_db          | <------------------- Evolution CMS用データベースが表示されること
+--------------------+
2 rows in set (0.00 sec)

mysql> quit <------------------------------ 切断

さくらのサーバでEvolution CMS用データベースを作成する場合、「レンタルサーバコントロールパネル」にて次のように作成することができます。
その際、データベース文字コードには「UTF-8(utf8mb4)」を指定します。

最新版Evolution CMSの入手

次のページから最新のEvolution CMSのプログラムファイルを入手します。

HOME / Evolution CMS

入手したEvolution CMSのプログラムファイルをサーバに送る方法は省略します。
ローカルでzipファイルを取得〜展開し、FTP/SFTPを利用してサーバへアップロードしても、サーバにSSHでログインしてzipファイルを取得〜展開してもどちらでも構いません。

入手したEvolution CMSのプログラムファイルをウェブサーバの公開ディレクトリへ移動します。

CentOS7 のApacheの初期設定状態であれば、「/var/www/html」がドキュメントルートですが、今回は「/var/www」ディレクトリ直下に「evo」ディレクトリを作成し、その直下にEvolution CMSのファイル類を配置し、「/var/www/evo」を新たなドキュメントルートとします。

VPS,オンプレサーバの場合、「/var/www/evo」ディレクトリの所有者とグループを共に「apache」に変更します。

# chown -R apache:apache /var/www/evo

.htaccessの設定

Evolution CMSのディレクトリに入り、サンプルとして入っている.htaccessファイル「ht.access」を正規の名前に変更します。

# mv ht.access .htaccess

• Evolution CMSをドキュメントルートにインストールするのではなく、サブディレクトリにインストールする場合、.htaccessファイルに「RewriteBase /サブディレクトリ名」を設定する必要があります。

SELinuxの設定

CentOS 7 ではSELinuxがデフォルトで有効になっています。このままではコピーしたRevolution CMSファイルへのSELinuxの書き込み権限がないためインストールがうまくいきません。
次の例では、「var/www/evo」ディレクトリにSELinuxの書き込み権限を付与する例を示します。

• ファイルの書き込み権限は上記手順で「apache」ユーザ・グループに付与済みです。
• セキュリティ上SELinuxを無効にすることはなるべく避けましょう。

 semanageコマンドがインストールされているかどうかを確認。
インストールされていなければ「CentOS 7 の基本設定：基本ソフトウェアのインストール」を参考にインストールしておきます。

# which semanage
/usr/sbin/semanage

現在の「/var/www/evo」のSELinuxファイル権限を確認します。
操作前は「/var/www/evo」ディレクトリのファイル権限は「httpd_sys_content_t:s0」になっているはずです。

# ls -Z /var/www
　：
drwxr-xr-x. apache apache system_u:object_r:httpd_sys_content_t:s0 evo

「/var/www/evo」ディレクトリのファイル権限を「httpd_sys_rw_content_t」(httpdデーモンが当該コンテンツの読み書きを可能にする）に変更します。

# semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/evo(/.*)?"

設定を反映します。反映結果が以下に表示されます。

# restorecon -RFv /var/www/evo*
　：
pd_sys_content_t:s0->system_u:object_r:httpd_sys_rw_content_t:s0

再度「/var/www/evo」のSELinuxファイル権限を確認。
今度は「httpd_sys_rw_content_t:s0」になっていることを確認。

# ls -Z /var/www
　：
drwxr-xr-x. apache apache system_u:object_r:httpd_sys_rw_content_t:s0 evo

DocumentRootの変更

今回、「http://サーバ名/」でアクセスすることでEvolution CMSのコンテンツが参照できるように設定しますので、ApacheのDocumentRootをEvolution CMSをインストールしたディレクトリに変更します。

• 「http://サーバ名/evo/」でアクセスできるようにしたい場合は、現在のドキュメントルート（初期設定では「/var/www/html」）以下にEvolution CMSプログラムファイルを配置するか、Apacheでエイリアスを設定します。

以下の例では。Apacheの設定ファイル「/etc/httpd/conf/httpd.conf」を編集してDocumentRootを「/var/www/evo」に変更します。
※．変更箇所は４箇所あります。

# vi /etc/httpd/conf/httpd.conf
----------------------------------------------------------------------
　：
#
# 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 "/var/www/html" <---------------- 先頭に「#」をつけてコメントアウト
DocumentRoot "/var/www/evo" <----------------- 「/var/www/modx」に設定
　：
# Further relax access to the default document root:
#>>> Edited by K'z Style
#<Directory "/var/www/html"> <----------------- 先頭に「#」をつけてコメントアウト
<Directory "/var/www/evo"> <------------------ 「/var/www/modx」に設定
　：
    #AllowOverride None <------------------------------ 先頭に「#」をつけてコメントアウト
    AllowOverride AuthConfig Limit Options FileInfo <-- 追記（AllowOverreide Allでも可）
　：
<IfModule dir_module>
    #DirectoryIndex index.html <----------------------- 先頭に「#」をつけてコメントアウト
    DirectoryIndex index.php index.html <-------------- 追記（index.phpを追加）
</IfModule>
　：
----------------------------------------------------------------------

設定ファイルをチェックします

# httpd -t
Syntax OK <------------------------- これが返ってきたらOK

Apacheをリロードします（再起動でも可）。

# systemctl reload httpd

セットアップの実行

ブラウザで「http://サーバ名/」にアクセスしてみます。

次のページが表示されればOKです。
「install now?」をクリックしてEvolution CMS自体のセットアップを開始しましょう。

言語が「Japanese」であることを確認し、[進む]をクリックします。

[進む]をクリックします。

データベースサーバの情報を入力し、「ここをクリックして、接続テストを行ってください。」のリンクをクリックします。

「DBホストとの接続テストの結果：」欄に「接続できます」が返ってきたら、作成しておいたデータベースの情報を入力し、「ここをクリックして、データベースのテストを行ってください。〜」のリンクをクリックします。
※照合順序は作成したデータベースに合わせます。

「...データベースとのマッチング：」欄に「問題ありません」と返ってきたら、管理アカウントの情報（ログイン名、email、パスワード）を入力し、[進む]をクリック。

インストールオプションの選択情報が表示されるので、「インストール - サンプルサイト」のチェックを外し、その他はチェックをつけた状態で[進む]をクリックします。

インストール前の状態確認が表示されるので、「問題なし」であることを確認し、「このライセンス(GPL2)で規定される諸条件に同意します」のチェックをつけ、[インストール]をクリックします。

ここで下記のようにエラーが出る場合、ディレクトリ／ファイルのパーミッションが適切か、ディレクトリ／ファイルの所有者が「apache」になっているか、SELinuxの設定が正しく反映されているかを再度確認してみます。

「インストールは無事に終了しました。」の表示を確認し、「インストールディレクトリを自動的に削除する」のチェックをつけて[インストール終了]をクリックします。

ログインページが表示されるので、インストール時に設定したログイン名、パスワードでログインします。

初回ログイン時には下記のメッセージが表示されるので、右上の[保存]ボタンをクリックします。

管理画面を操作する準備ができました。

管理画面を終了する場合は、右上のユーザ名（例の場合「admin」）をクリックし、[ログアウト]をクリックします。

Dockerの場合、「GDライブラリが読み込まれてません。」のメッセージが表示されることがあります。しかしGDは有効になっている様子。原因調査中。→解決しました。libzip-devをインストールして「docker-php-ext-install zip」をしないと下記メッセージが表示されるようです。

ページの確認

トップページの確認

改めてブラウザより「http://サーバ名/」にアクセスします。
下図のようなページが表示されればOKです。

管理画面ページへのアクセス

Evolution CMSの管理画面のページには

「http://サーバ名/manager/」

でアクセスできます。