VPSにPHPサイトを作ってHTTPSで公開する
音楽CMS「ミュージキュン」は、もともとReact+Supabaseを使って制作しました。今回はその仕組みをもとに、PHP+MariaDBで作りかえます。まずはVPSに新しい公開領域を作り、DuckDNS、nginx、PHP-FPM、Certbotを使ってHTTPSで公開します。
- 既存サイトとは別にミュージキュン用の公開領域を作る
- PHPファイルを作成して構文を確認する
- DuckDNSでドメインを用意する
- DNSがVPSを指していることを確認する
- nginxからPHP-FPMへPHPの処理を渡す
- HTTPでPHPページを表示する
- CertbotでTLS証明書を取得する
- HTTPSで公開する
今回の流れ
↓
PHPファイルを作る
↓
DuckDNSでドメインを作る
↓
DNSをVPSへ向ける
↓
nginxを設定する
↓
PHP-FPMでPHPを実行する
↓
HTTPで表示確認
↓
Certbotで証明書を取得
↓
HTTPSで公開
STEP 1|VPSへSSH接続する
ssh ubuntu@VPSのIPアドレス
ssh = Secure Shell。ネットワーク経由で別のコンピュータへ安全に接続するための仕組みです。ubuntu = 接続先VPSのLinuxユーザー名。@ = 「ユーザー名」と「接続先」を区切ります。VPSのIPアドレス = 接続するVPSを識別するIPアドレスです。
手順書などにある
ユーザー名は説明用のplaceholderです。実際には、
ユーザー名 → ubuntu
のように、自分の環境の値へ置き換えます。
STEP 2|既存サイトと分けてディレクトリを作る
ls -la /var/www
ls = list。ファイルやディレクトリの一覧を表示します。-l = long format。所有者や権限などの詳細を表示します。-a = all。隠しファイルも含めて表示します。/var/www = Webサイトのファイルを置いているディレクトリです。
既存サイトとは分離して、ミュージキュン専用のディレクトリを作ります。
sudo mkdir /var/www/musikyun
sudo = 管理者権限でコマンドを実行します。mkdir = make directory。新しいディレクトリを作ります。/var/www/musikyun = 今回作るミュージキュンの公開領域です。
1つのディレクトリに複数のサイトを混ぜるのではなく、 サイトごとに公開領域を分離します。
→ ミュージキュンを変更しても、別のサイトへ影響しにくい構成にします。
STEP 3|ディレクトリの所有者を変更する
ls -ld /var/www/musikyun
-dを付けると、ディレクトリの中身ではなく、
ディレクトリそのものの情報を確認できます。
sudo mkdirで作成したため、
最初はrootが所有者になっています。
sudo chown -R ubuntu:ubuntu /var/www/musikyun
chown = change owner。所有者を変更します。-R = recursive。指定したディレクトリの中も再帰的に対象にします。ubuntu:ubuntu = 所有者とグループをubuntuへ変更します。
root所有のままだと、通常ユーザーでファイルを作成・編集するときにも 管理者権限が必要になる場合があります。
今回は開発するプロジェクトディレクトリだけをubuntu所有にして、 通常の開発作業を分かりやすくします。
STEP 4|作業場所を確認する
cd /var/www/musikyun
pwd
cd = change directory。作業するディレクトリを移動します。pwd = print working directory。現在いるディレクトリを表示します。
別のサイトのディレクトリにいる状態でファイルを作ると、 間違ったサイトを変更する可能性があります。
移動 → 現在地確認 → 作業
の順番にすることで、操作ミスを減らします。
STEP 5|最小のPHPファイルを作る
nano index.php
次のPHPを書きます。
<?php
echo 'musikyun';
<?php = ここからPHPコードが始まることを示します。echo = 文字列などを出力します。'musikyun' = 出力する文字列。; = PHPの文の終わりです。
最初からCMS全体を作ると、表示されなかったときに原因を特定しにくくなります。
まず最小のPHPを表示することで、 WebサーバーとPHPが動くかだけを確認します。
STEP 6|PHPの構文を確認する
php -l index.php
php = PHPをコマンドラインから実行します。-l = lint。PHPの構文エラーを確認します。index.php = 確認するPHPファイルです。
php -lで確認できるのはPHPの構文です。構文が正しくても、 nginxの設定やDNS、PHP-FPMなどに問題があればブラウザでは表示できません。
→ 構文チェックとブラウザでの動作確認は別々に行います。
STEP 7|DuckDNSでドメインを作る
今回はミュージキュン用に新しいDuckDNSのサブドメインを作成し、 VPSのIPアドレスを登録しました。
↓
DNS
↓
VPSのIPアドレス
DNS = Domain Name System。
人が扱いやすいドメイン名と、 コンピュータが通信に使うIPアドレスを対応させる仕組みです。
DuckDNSのtokenはDNS設定を変更するための重要な認証情報です。
→ 教材、GitHub、スクリーンショットなどへ公開しません。
STEP 8|DNSがVPSを指しているか確認する
getent hosts musikyun-v2.duckdns.org
getent = get entries。システムが利用する名前解決情報などを取得します。hosts = ホスト名とIPアドレスの情報を調べます。musikyun-v2.duckdns.org = 今回確認するドメインです。
DNSが間違っている状態でnginxを調べても、 ブラウザから正しいVPSへ到達しません。
DNS
↓
nginx
↓
PHP
のように、通信経路を順番に確認すると原因を切り分けやすくなります。
STEP 9|nginxを設定する
sudo nano /etc/nginx/sites-available/musikyun
まずHTTPで確認するため、最小構成から始めます。
server {
listen 80;
server_name musikyun-v2.duckdns.org;
root /var/www/musikyun;
index index.php;
location / {
try_files $uri $uri/ =404;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
}
listen 80 = HTTPの80番ポートで接続を待ちます。server_name = この設定で扱うドメイン名。root = Webサイトのファイルを探すDocumentRoot。index index.php = ディレクトリへアクセスしたとき最初に探すファイルです。
nginx自身がPHPコードを実行するわけではありません。
nginx
↓
PHPファイルだと判断
↓
PHP-FPMへ渡す
↓
PHPを実行
↓
実行結果をnginxへ返す
PHP-FPM = PHP FastCGI Process Manager。
nginxから渡されたPHPの処理を実行する仕組みです。
STEP 10|nginxの設定を有効にする
sudo ln -s /etc/nginx/sites-available/musikyun /etc/nginx/sites-enabled/musikyun
ln = link。ファイルへのリンクを作ります。-s = symbolic。シンボリックリンクを作ります。sites-available = 利用可能なサイト設定を置く場所。sites-enabled = 実際に有効にするサイト設定を参照する場所です。
↓
シンボリックリンク
↓
sites-enabled/musikyun
↓
nginxが設定を読み込む
STEP 11|nginxの設定をテストする
sudo nginx -t
-t = test。nginxの設定ファイルをテストします。設定を書いた直後にいきなり反映するのではなく、 先に構文や設定を確認します。
今回は別サイトの
server_nameに関するwarningが表示されましたが、
nginxの設定テスト自体は成功しました。warningが出た場合も内容を確認し、 今回変更した設定が原因なのか、既存設定の問題なのかを切り分けます。
STEP 12|nginxをreloadする
sudo systemctl reload nginx
systemctl = systemdが管理するserviceなどを操作します。reload = nginxを停止せず、設定を再読み込みします。nginx = 操作するservice名です。
reloadは動作中のnginxに設定を再読み込みさせます。restartはnginxをいったん停止して起動し直します。今回は既存サイトも動いているため、 設定反映だけなら
reloadを使います。
STEP 13|まずHTTPで表示を確認する
ブラウザからHTTPでアクセスし、
musikyunと表示されることを確認しました。
最初からDNS、nginx、PHP、HTTPSをすべて設定すると、 表示できなかったときに原因候補が増えます。
まずHTTPで、
DNS → nginx → PHP-FPM → PHP
が動くことを確認し、その後HTTPSを追加します。
→ 1段階ずつ確認することでエラーの原因を切り分けやすくします。
STEP 14|Certbotが入っているか確認する
certbot --version
今回の環境では次のバージョンが確認できました。
certbot 2.9.0
certbot = TLS証明書の取得や更新を支援するツール。--version = インストールされているバージョンを表示します。→ このコマンドはバージョン確認だけなので、証明書やnginx設定は変更しません。
STEP 15|HTTPSを有効にする
sudo certbot --nginx -d musikyun-v2.duckdns.org
sudo = 管理者権限で実行。certbot = 証明書を取得・管理するツール。--nginx = nginxと連携して証明書を設定します。-d = domain。証明書を取得するドメインを指定します。
↓
ドメインを確認
↓
TLS証明書を取得
↓
nginxへ証明書を設定
↓
HTTPSで通信可能
HTTPSではTLSを使ってブラウザとWebサーバー間の通信を保護します。
主に、
・通信相手の確認
・通信内容の暗号化
・通信内容が途中で改ざんされていないことの確認
に利用されます。
ただしHTTPSだからといって、 Webサイトの内容そのものが安全・正確であることまで保証するわけではありません。
STEP 16|HTTPSで最終確認する
ブラウザからHTTPSでアクセスし、
musikyunが表示されることを確認しました。
ミュージキュンをPHP+MariaDBで作りかえるための 最初の公開環境が完成しました。
この時点ではまだ音楽CMSの機能はありません。 しかし、今後PHPで実装する機能を HTTPSでブラウザへ公開できる土台ができました。
📘 全体を「入力 → 処理 → 出力」で読む
ブラウザでURLを入力
↓
DNS
ドメイン名からVPSのIPアドレスを調べる
↓
nginx
HTTP / HTTPSリクエストを受け取る
↓
PHP-FPM
PHPの実行を担当
↓
PHP
index.phpを実行
↓
nginx
実行結果を返す
↓
HTTPS
TLSで保護して通信
↓
出力
ブラウザに「musikyun」と表示
DuckDNS / DNS = ドメイン名とIPアドレスを対応させる。
nginx = Webリクエストを受け取るWebサーバー。
PHP-FPM = PHPコードを実行する。
PHP = サーバー側の処理を書く言語。
Certbot = TLS証明書の取得・設定・更新を支援する。
HTTPS = TLSで保護されたHTTP通信。
まとめ
今回は、既存サイトとは別にミュージキュン用の公開領域を作り、 DuckDNS、nginx、PHP-FPM、Certbotをつないで、 最小のPHPページをHTTPSで公開しました。
最初からCMSを実装するのではなく、 ディレクトリ → PHP → DNS → nginx → HTTP → HTTPSと 1段階ずつ確認することで、 問題が発生したときに原因を切り分けやすくしています。
今回も処理を順番に分解できます。
入力 → URLを入力する。
処理 → DNSがIPアドレスを調べる。
処理 → nginxがリクエストを受け取る。
処理 → PHP-FPMがPHPを実行する。
出力 → ブラウザへ結果を返す。
→ Webサイトの公開も、 「入力 → 処理 → 出力」という処理の流れとして考えられます。