Ubuntu 18.04 LTSにPico CMSをインストールする方法

Picoは、PHPで書かれたオープンソースのシンプルで高速なフラットファイルCMSです。これは、管理バックエンドやデータベースを扱う必要がないことを意味します。コンテンツフォルダに.mdファイルを作成するだけで、それがページになります。Picoは、強力で柔軟なテーマのためにTwigテンプレートエンジンを使用しています。PicoのソースコードはGithubで入手可能です。このチュートリアルでは、Ubuntu 18.04 LTSシステムにNginxを使用してPico CMSをインストールします。

要件

Picoを実行するための要件は以下の通りです：

Nginx
PHPバージョン5.3.6以上
Composer

前提条件

Ubuntu 18.04 LTSオペレーティングシステム。
sudo権限を持つ非ルートユーザー。

初期ステップ

Ubuntuのバージョンを確認します：

lsb_release -ds  
# Ubuntu 18.04.2 LTS

タイムゾーンを設定します：

sudo dpkg-reconfigure tzdata

オペレーティングシステムのパッケージ（ソフトウェア）を更新します。これは、オペレーティングシステムのデフォルトのソフトウェアパッケージに最新の更新とセキュリティ修正があることを保証する重要な最初のステップです：

sudo apt update && sudo apt upgrade -y

Ubuntuオペレーティングシステムの基本管理に必要な重要なパッケージをいくつかインストールします：

sudo apt install -y curl wget vim git unzip socat bash-completion apt-transport-https

ステップ1 - PHPをインストール

必要なPHP拡張機能とともにPHPをインストールします：

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-curl php7.2-gd php7.2-json php7.2-zip php7.2-xml php7.2-mbstring

コンパイルされたPHPモジュールを表示するには、次のコマンドを実行できます：

php -m  
  ctype  
  curl  
  exif  
  fileinfo  
  . . .  
  . . .

PHPのバージョンを確認します：

php --version  
  # PHP 7.2.17-0ubuntu0.18.04.1 (cli) (built: Apr 18 2019 14:12:38) ( NTS )  
  # Copyright (c) 1997-2018 The PHP Group  
  # Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies  
  #     with Zend OPcache v7.2.10-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies

PHP-FPMサービスは、Ubuntu 18.04システムで自動的に起動し、再起動時に有効になりますので、手動で起動および有効にする必要はありません。次のステップ、つまりデータベースのインストールと設定に進むことができます。

ステップ2 - `acme.sh`クライアントをインストールし、Let’s Encrypt証明書を取得する（オプション）

HTTPSでフォーラムを保護することは必須ではありませんが、サイトのトラフィックを保護するための良いプラクティスです。Let’s EncryptからTLS証明書を取得するために、acme.shクライアントを使用します。Acme.shは、依存関係ゼロでLet’s EncryptからTLS証明書を取得するための純粋なUNIXシェルソフトウェアです。

acme.shをダウンロードしてインストールします：

sudo su - root  
git clone https://github.com/Neilpang/acme.sh.git  
cd acme.sh  
./acme.sh --install --accountemail [email protected]  
source ~/.bashrc  
cd ~

acme.shのバージョンを確認します：

acme.sh --version  
# v2.8.0

RSAおよびECC/ECDSA証明書をドメイン/ホスト名のために取得します：

# RSA 2048  
acme.sh --issue --standalone -d example.com --keylength 2048  
# ECDSA  
acme.sh --issue --standalone -d example.com --keylength ec-256

テスト用の偽の証明書が必要な場合は、上記のコマンドに--stagingフラグを追加できます。

上記のコマンドを実行した後、証明書とキーは以下の場所に保存されます：

RSAの場合：/home/username/example.comディレクトリ。
ECC/ECDSAの場合：/home/username/example.com_eccディレクトリ。

発行された証明書を一覧表示するには、次のコマンドを実行できます：

acme.sh --list

証明書を保存するためのディレクトリを作成します。/etc/letsencryptディレクトリを使用します。

mkdir -p /etc/letsecnrypt/example.com  
sudo mkdir -p /etc/letsencrypt/example.com_ecc

証明書を/etc/letsencryptディレクトリにインストール/コピーします。

# RSA  
acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"  
# ECC/ECDSA  
acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"

すべての証明書は60日ごとに自動的に更新されます。

証明書を取得した後、rootユーザーからログアウトし、通常のsudoユーザーに戻ります：

exit

ステップ3 - NGINXをインストールおよび構成

NGINXをインストールします：

sudo apt install -y nginx

NGINXのバージョンを確認します：

sudo nginx -v  
# nginx version: nginx/1.14.0 (Ubuntu)

次に、Pico CMSのためにNGINXを構成します。sudo vim /etc/nginx/sites-available/pico.confを実行し、以下の構成を追加します。

server {
  
  listen 80;
  listen 443 ssl;
  server_name example.com;
  root /var/www/pico;  

  ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;  
  ssl_certificate_key /etc/letsencrypt/example.com/private.key;  
  ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;  
  ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;  

  index index.php;

  location ~ ^/((config|content|vendor|composer\.(json|lock|phar))(/|$)|(.+/)?\.(?!well-known(/|$))) {
    deny all;
  }

  location / {
    index index.php;
    try_files $uri $uri/ /index.php$is_args$args;
  }

  location ~ \.php$ {
    try_files $uri =404;
    fastcgi_index index.php;
    fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
    fastcgi_param PICO_URL_REWRITING 1;
  }

}

新しいpico.conf構成を有効にするために、ファイルをsites-enabledディレクトリにリンクします：

sudo ln -s /etc/nginx/sites-available/pico.conf /etc/nginx/sites-enabled

NGINX構成の構文エラーを確認します：

sudo nginx -t

NGINXサービスを再読み込みします：

sudo systemctl reload nginx.service

ステップ4 - Composerをインストール

PHP依存関係マネージャーであるComposerをグローバルにインストールします：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"  
  
php -r "if (hash_file('sha384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"  
  
php composer-setup.php  
  
php -r "unlink('composer-setup.php');"  
  
sudo mv composer.phar /usr/local/bin/composer

Composerのバージョンを確認します：

composer --version  
# Composer version 1.8.5 2019-04-09 17:46:47

注意： Composerのインストールコマンドは将来的に変更されるため、上記のコマンドが機能しない場合は、最新のコマンドについてhttps://getcomposer.org/download/を確認してください。

ステップ5 - Pico CMSをインストール

Pico CMSのためのドキュメントルートディレクトリを作成します：

sudo mkdir -p /var/www/pico

/var/www/picoディレクトリの所有権を[your_username]に変更します：

sudo chown -R [your_username]:[your_username] /var/www/pico

ドキュメントルートディレクトリに移動します：

cd /var/www/pico

Composerを使用してPicoをダウンロードします：

composer create-project picocms/pico-composer .

/var/www/picoディレクトリの所有権をwww-data:に変更します。

sudo chown -R www-data:www-data /var/www/pico

Ubuntu 18.04サーバーにPico CMSを正常にインストールしました。これで、Picoのルートディレクトリに自分のコンテンツフォルダを作成し、コンテンツディレクトリに.mdファイルを作成するだけで、それらのファイルがページになります。

要件