インストール

Zittme をインストールする手順を案内します。環境は大きく二つに分かれます。

Web ホスティング：ホスティング会社に申し込んで使う環境です。DB と Web サーバーがすでに用意されているので、ファイルをアップロードするだけです。
個人サーバー（VPS）：サーバーを自分で運用する環境です。Web サーバー・DB を自分で用意します。

ご自身の環境に合う方だけを進めれば大丈夫です。インストールウィザードからは両方の環境で同じです。

インストール環境

項目	要件
PHP	7.4 以上（8.2 以上を推奨）
データベース	MySQL 5.7 以上または MariaDB 10.6 以上（utf8mb4）
Web サーバー	nginx または Apache
必須 PHP 拡張	curl, gd, iconv または mbstring, json, openssl, PDO_MySQL, SimpleXML, Zend OPcache
推奨 PHP 拡張	apcu（性能）、exif（画像の自動回転）、fileinfo（添付ファイルのセキュリティ検査）、intl, zip
PHP 設定	`session.auto_start=off`、`memory_limit` 128MB 以上、`upload_max_filesize` 10MB 以上

韓国国内の Web ホスティング（Cafe24、Dothome、Gabia など）の PHP ホスティング商品であれば、ほとんど要件を満たします。申し込み時に PHP のバージョンを選べる場合は 8.2 以上を選んでください。いずれにしても、インストールウィザードの環境確認ステップで不足している項目を指摘してくれます。

配布版のダウンロード（共通）

zitt.me リリースページから最新の配布版をダウンロードします。現在のベータ期間中は、テスターとして登録された会員のみダウンロードできます。

---

A. Web ホスティングにインストールする

A-1. DB 情報の確認

Web ホスティングでは、申し込み時に DB も一緒に作成されます。ホスティングの管理ページ（サービス管理など）で次の値を確認しておいてください。インストールウィザードでそのまま入力します。

DB ホスト（通常は localhost）
DB 名
DB ユーザー名
DB パスワード（申し込み時に決めた値）

A-2. ファイルのアップロード

ダウンロードした配布版はまず自分のパソコンで解凍し、FTP ソフト（FileZilla など）でホスティングの Web ルートにアップロードします。Web ルートのフォルダ名は会社によって異なります（www、public_html、html など）。

ファイル数が数万個あるため FTP アップロードには時間がかかり、FTP ソフトは数千個のファイルをアップロードする際に一部を取りこぼすことがあります。 ホスティング会社が解凍機能（Web ファイルマネージャー）を提供している場合は、tgz/zip をアップロードしてからサーバー上で解凍する方が速く安全です。
アップロード後、index.php が Web ルートの直下にあるか確認してください。zittme/index.php のように一段階内側に入っている場合は、フォルダの中身を Web ルートへ移動する必要があります。このとき .htaccess のような隠しファイルも一緒に移動してください。
Web ルートに files フォルダを作成し、ファイルマネージャーで権限を 707（または 777）に設定してください。サイトのすべてのアップロード・キャッシュがこのフォルダに保存されます。

A-3. アクセス

ブラウザで自分のドメイン（またはホスティングから提供された仮アドレス）にアクセスすると、インストールウィザードが始まります。下の「インストールウィザード」の節へ進んでください。

ほとんどの Web ホスティングは Apache なので、配布版に含まれる .htaccess が短縮 URL を自動で処理します。別途の設定は必要ありません。

---

B. 個人サーバー（VPS）にインストールする

シェル（SSH）でアクセスできるサーバーを前提とします。

B-1. ファイルのアップロード

tar xzf zittme-0.0.01.tgz -C /var/www/mysite
mkdir -p /var/www/mysite/files
chown -R www-data:www-data /var/www/mysite

Web サーバーのアカウント（上の例では www-data）が files フォルダに書き込めないとインストールは進みません。サイトのすべてのアップロード・キャッシュ・設定がこのフォルダに保存されます。

B-2. データベースの作成

CREATE DATABASE mysite DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'mysite'@'localhost' IDENTIFIED BY '비밀번호';
GRANT ALL PRIVILEGES ON mysite.* TO 'mysite'@'localhost';
FLUSH PRIVILEGES;

B-3. Web サーバーの設定（nginx）

Zittme は nginx 設定ヘルパーを提供しています。

インストールウィザードの環境確認画面：サーバー環境を検出し、環境に合わせた設定と適用コマンドを作成してくれます。
配布版の common/scripts/setup-nginx.sh：一度に適用するスクリプトです。
設定例：common/manual/server_config/zittme-nginx.conf

Apache の場合は配布版の .htaccess が処理するので、mod_rewrite が有効になっていれば十分です。

---

インストールウィザード（共通）

ブラウザでサイトのアドレスにアクセスすると、インストールウィザードが始まります。画面上部のステップ表示に従って進めます。

環境確認：サーバーが要件を満たしているか自動でチェックします。問題があれば項目ごとに案内が表示されます。
ライセンスへの同意：Zittme は GPL v2 のフリーソフトウェアです。
DB 情報の入力：Web ホスティングの場合は A-1 で確認した値を、個人サーバーの場合は B-2 で作成した値を入力します。
管理者アカウントの作成：サイトの最高管理者のメールアドレス・パスワードを決めます。

インストールが完了すると、基本メニュー（ホーム・掲示板）とともにサイトが開き、基本エディターは zittEditor に設定されます。

インストール直後に確認すること

管理画面へのアクセス：your-site/admin
システム設定 > 基本設定：サイトタイトル・基本言語・タイムゾーン
管理画面の設定：管理メニューの位置（上部・左側・右側）、管理者ロゴの登録
ファイルアップロードの確認：掲示板に投稿を一つ書き、画像を添付してみます。失敗する場合は files/ フォルダの書き込み権限を確認してください。Web ホスティングではファイルマネージャーで権限を 707 または 755 に調整できます。

アップデート

管理者ダッシュボードに新バージョンの案内が表示されたら、リリースページから新しい配布版をダウンロードして上書きします。上書き後に管理画面へアクセスすると、必要な DB の変更が自動で適用されます。アップデートの前には必ず files/ と DB をバックアップしてください。