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」は何?
-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。現在いるディレクトリを表示します。
📘 なぜpwdで確認する?
別のサイトのディレクトリにいる状態でファイルを作ると、 間違ったサイトを変更する可能性があります。

移動 → 現在地確認 → 作業

の順番にすることで、操作ミスを減らします。

STEP 5|最小のPHPファイルを作る

nano index.php

次のPHPを書きます。

<?php

echo 'musikyun';
📘 PHPを読む
<?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 -lで確認できるのはPHPの構文です。

構文が正しくても、 nginxの設定やDNS、PHP-FPMなどに問題があればブラウザでは表示できません。

→ 構文チェックとブラウザでの動作確認は別々に行います。

STEP 7|DuckDNSでドメインを作る

今回はミュージキュン用に新しいDuckDNSのサブドメインを作成し、 VPSのIPアドレスを登録しました。

musikyun-v2.duckdns.org
↓
DNS
↓
VPSのIPアドレス
📘 DNSとは?
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 = 今回確認するドメインです。
📘 なぜnginxより先にDNSを確認する?
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;
    }
}
📘 nginx設定を読む
listen 80 = HTTPの80番ポートで接続を待ちます。
server_name = この設定で扱うドメイン名。
root = Webサイトのファイルを探すDocumentRoot。
index index.php = ディレクトリへアクセスしたとき最初に探すファイルです。
📘 nginxはPHPを実行しない
nginx自身がPHPコードを実行するわけではありません。

nginx
↓
PHPファイルだと判断
↓
PHP-FPMへ渡す
↓
PHPを実行
↓
実行結果をnginxへ返す
📘 PHP-FPMとは?
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-available/musikyun
↓
シンボリックリンク
↓
sites-enabled/musikyun
↓
nginxが設定を読み込む

STEP 11|nginxの設定をテストする

sudo nginx -t
📘 「-t」は何?
-t = test。nginxの設定ファイルをテストします。

設定を書いた直後にいきなり反映するのではなく、 先に構文や設定を確認します。
📘 エラーとwarningは分けて読む
今回は別サイトのserver_nameに関するwarningが表示されましたが、 nginxの設定テスト自体は成功しました。

warningが出た場合も内容を確認し、 今回変更した設定が原因なのか、既存設定の問題なのかを切り分けます。

STEP 12|nginxをreloadする

sudo systemctl reload nginx
📘 コマンドを読む
systemctl = systemdが管理するserviceなどを操作します。
reload = nginxを停止せず、設定を再読み込みします。
nginx = 操作するservice名です。
📘 reloadとrestart
reloadは動作中のnginxに設定を再読み込みさせます。
restartはnginxをいったん停止して起動し直します。

今回は既存サイトも動いているため、 設定反映だけならreloadを使います。

STEP 13|まずHTTPで表示を確認する

ブラウザからHTTPでアクセスし、 musikyunと表示されることを確認しました。

📘 なぜ最初からHTTPSにしない?
最初から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。証明書を取得するドメインを指定します。
Certbot
↓
ドメインを確認
↓
TLS証明書を取得
↓
nginxへ証明書を設定
↓
HTTPSで通信可能
📘 HTTPSとは?
HTTPSではTLSを使ってブラウザとWebサーバー間の通信を保護します。

主に、

・通信相手の確認
・通信内容の暗号化
・通信内容が途中で改ざんされていないことの確認

に利用されます。

ただしHTTPSだからといって、 Webサイトの内容そのものが安全・正確であることまで保証するわけではありません。

STEP 16|HTTPSで最終確認する

ブラウザからHTTPSでアクセスし、 musikyunが表示されることを確認しました。

🎉 musikyun PHP版の公開基盤 完成

ミュージキュンを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段階ずつ確認することで、 問題が発生したときに原因を切り分けやすくしています。

📘 科目Bとして見ると
今回も処理を順番に分解できます。

入力 → URLを入力する。
処理 → DNSがIPアドレスを調べる。
処理 → nginxがリクエストを受け取る。
処理 → PHP-FPMがPHPを実行する。
出力 → ブラウザへ結果を返す。

→ Webサイトの公開も、 「入力 → 処理 → 出力」という処理の流れとして考えられます。
タグ: PHP / VPS / Linux / SSH / DuckDNS / DNS / nginx / PHP-FPM / Certbot / HTTPS / TLS / Webサーバー