導入ガイド（初心者向け）

動作要件

VetCare Proは非常にシンプルな構成のため、ほとんどのPHPサーバーで動作します。

ダウンロード方法

2つの方法でダウンロードできます。初心者の方はZIPダウンロードがおすすめです。

方法1：ZIPダウンロード（初心者向け）

1. GitHubのリポジトリページ https://github.com/boris15413-jpg/VetCare-Pro-ver-3 にアクセス
2. 緑色の「Code」ボタンをクリック
3. 「Download ZIP」をクリック
4. ダウンロードされたZIPファイルを解凍
5. 解凍されたフォルダ（VetCare-Pro-ver-3-main）の中身をサーバーにアップロード

方法2：git clone（経験者向け）

# リポジトリをクローン
git clone https://github.com/boris15413-jpg/VetCare-Pro-ver-3.git

# ディレクトリに移動
cd VetCare-Pro-ver-3

レンタルサーバーでの導入

最も簡単な方法です。Xserver、さくらインターネット、ロリポップ、ConoHa WING などの日本の主要レンタルサーバーで動作します。

前提条件の確認

• レンタルサーバーの契約が済んでいること
• FTPソフト（FileZilla推奨）またはサーバーのファイルマネージャーが使えること
• レンタルサーバーのPHPバージョンが8.0以上であること（サーバーのコントロールパネルで確認・変更可能）

PHPバージョンの確認・変更方法

ファイルのアップロード

FTPソフト（FileZilla推奨）またはサーバーのファイルマネージャーを使って、ファイルをアップロードします。

# ドメイン直下に設置する場合
/home/ユーザー名/public_html/

# サブディレクトリに設置する場合（例：/vetcare/）
/home/ユーザー名/public_html/vetcare/

# さくらインターネットの場合
/home/ユーザー名/www/

パーミッション（権限）の設定

以下のディレクトリに書き込み権限が必要です。FTPソフトで右クリック→「ファイルのパーミッション」で変更できます。

ブラウザでアクセス

ブラウザで https://あなたのドメイン/（またはサブディレクトリ）にアクセスすると、 セットアップウィザードが自動的に起動します。 詳細はセットアップウィザードの説明をご覧ください。

自前サーバー (VPS / 専用サーバー)

VPS（ConoHa VPS、さくらVPS、AWS EC2、DigitalOcean等）や自宅サーバーに導入する方法です。

方法A：Apache + PHP（推奨）

# ====== Ubuntu / Debian の場合 ======

# 1. システムを最新にする
sudo apt update && sudo apt upgrade -y

# 2. Apache と PHP をインストール
sudo apt install -y apache2 php8.1 php8.1-sqlite3 php8.1-mbstring php8.1-gd php8.1-curl libapache2-mod-php8.1

# 3. Apache の mod_rewrite を有効化
sudo a2enmod rewrite

# 4. VetCare Pro をダウンロード
cd /var/www/html
sudo git clone https://github.com/boris15413-jpg/VetCare-Pro-ver-3.git vetcare
cd vetcare

# 5. ディレクトリの権限を設定
sudo chown -R www-data:www-data data/ uploads/ backups/
sudo chmod -R 775 data/ uploads/ backups/

# 6. Apache を再起動
sudo systemctl restart apache2

# 7. ブラウザで http://サーバーのIP/vetcare/ にアクセス

方法B：Nginx + PHP-FPM

# ====== Ubuntu / Debian の場合 ======

# 1. Nginx と PHP-FPM をインストール
sudo apt install -y nginx php8.1-fpm php8.1-sqlite3 php8.1-mbstring php8.1-gd

# 2. VetCare Pro をダウンロード
cd /var/www
sudo git clone https://github.com/boris15413-jpg/VetCare-Pro-ver-3.git vetcare
cd vetcare
sudo chown -R www-data:www-data data/ uploads/ backups/

# 3. Nginx の設定ファイルを作成
sudo nano /etc/nginx/sites-available/vetcare

Nginx設定ファイルの内容：

server {
    listen 80;
    server_name あなたのドメイン;
    root /var/www/vetcare;
    index index.php;

    # 予約ゲートウェイのルーティング
    location /booking/ {
        try_files $uri /booking/index.php?$query_string;
    }

    # APIのルーティング
    location /api/ {
        try_files $uri $uri/ =404;
    }

    # 静的ファイルのキャッシュ
    location ~* \.(css|js|png|jpg|jpeg|gif|svg|ico|woff|woff2)$ {
        expires 7d;
        add_header Cache-Control "public, immutable";
    }

    # data/backups ディレクトリへのアクセスを禁止
    location ~ ^/(data|backups)/ {
        deny all;
        return 403;
    }

    # PHPの処理
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
}

# 4. サイトを有効化して再起動
sudo ln -s /etc/nginx/sites-available/vetcare /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

方法C：PHPビルトインサーバー（テスト用）

開発やテスト目的で手軽に起動したい場合は、PHP内蔵サーバーが使えます。 本番環境では使用しないでください。

# VetCare Pro のディレクトリに移動
cd VetCare-Pro-ver-3

# PHP ビルトインサーバーを起動（ポート3000）
php -S 0.0.0.0:3000 router.php

# ブラウザで http://localhost:3000 にアクセス

XAMPP / MAMP（ローカル環境）

自分のPC上で動かす方法です。インターネットに公開せず、ローカル環境で試したい方向け。

セットアップウィザード

ファイルを配置してブラウザでアクセスすると、自動的にセットアップウィザードが起動します。 6つのステップで初期設定が完了します。

導入後にやること

セットアップ完了後、以下の設定を確認・変更することをおすすめします。

• config.php の編集（任意） - デバッグモードのOFF（DEBUG_MODE を false に変更）。本番環境では必ずOFFにしてください。
• ロゴ・角印のアップロード - 設定画面 → 画像設定から病院のロゴと角印画像をアップロード。書類に自動反映されます。
• スタッフアカウントの追加 - 管理画面 → スタッフ管理から獣医師・看護師・受付スタッフのアカウントを作成。
• マスタデータの確認・修正 - 薬品マスタ、検査マスタ、処置マスタのサンプルデータを確認し、自院の内容に合わせて修正してください。
• 予約設定の確認 - 予約時間帯、昼休み時間、枠数、定休日が自院の実態と合っているか確認。
• バックアップの確認 - data/ ディレクトリのバックアップ方法を確認。SQLiteファイルのコピーだけでバックアップ完了です。
• SSL/TLSの設定（本番環境必須） - 個人情報を扱うため、HTTPS通信は必須です。Let's Encryptで無料のSSL証明書を取得できます。
• IPホワイトリストの検討 - 設定画面 → セキュリティから、EMRへのアクセスを特定IPに制限できます。

トラブルシューティング

よくある問題と解決方法をまとめました。

アップデート方法

新しいバージョンがリリースされた際の更新手順です。

git cloneで導入した場合

# 1. データベースのバックアップ
cp data/vetcare.db data/vetcare.db.backup

# 2. 最新版を取得
git pull origin main

# 3. ブラウザでアクセスして動作確認

ZIPダウンロードで導入した場合

1. data/vetcare.db をPCにダウンロード（バックアップ）
2. uploads/ フォルダをPCにダウンロード（アップロード画像のバックアップ）
3. 新バージョンのZIPをダウンロードして解凍
4. サーバー上のファイルを新バージョンで上書き（data/ と uploads/ は上書きしない）
5. ブラウザでアクセスして動作確認