ドキュメント

動作環境

項目	要件	ステータス
PHP	8.0 以上	必須
JSON Extension	標準搭載	必須
Apache	2.4 以上	推奨
Nginx	対応	対応
MySQL / PostgreSQL	不要	不要

インストール

Git Clone

git clone https://github.com/SU-tr4/Raptio.git
cd Raptio

ファイルパーミッション設定

Linux / macOS 環境では以下のコマンドで書き込み権限を付与してください。

# 方法 1: chmodで設定
chmod -R 755 data
chmod -R 755 uploads

# 方法 2: Apache実行ユーザーに変更
chown -R www-data:www-data data uploads

初期設定

ファイルをWebサーバーのドキュメントルートに配置後、ブラウザで管理画面にアクセスしてください。

# ローカル環境
http://localhost/raptio/admin/

# 本番環境
https://your-domain.com/admin/

初回アクセス時にセットアップウィザードが起動します。サイト名・管理者アカウントを設定してください。

ディレクトリ構成

raptio/
├── index.php          # フロントエンドエントリポイント
├── setup.php          # 初期セットアップ
│
├── admin/             # 管理画面
│   ├── index.php
│   ├── editor.php
│   ├── api.php
│   └── ...
│
├── data/              # コンテンツデータ (要書き込み権限)
│   ├── posts/         # 記事JSONファイル
│   ├── posts_index.json
│   └── site_config.json
│
├── themes/            # テーマディレクトリ
│   └── lux/
│
├── plugins/           # プラグインディレクトリ
│
└── uploads/           # メディアファイル (要書き込み権限)

データフロー

記事の作成から表示までの流れは以下のとおりです。

editor.php  →  api.php  →  data/posts/{id}.json
                                    ↓
                          posts_index.json (更新)
                                    ↓
                          index.php (フロントエンド表示)

テーマ開発

テーマは themes/ 以下に独自ディレクトリを作成して開発します。最低限必要なファイルは以下のとおりです。

themes/
└── your-theme/
    ├── header.php
    ├── footer.php
    ├── sidebar.php
    ├── index.php      # 記事一覧テンプレート
    ├── single.php     # 記事詳細テンプレート
    └── style.css

プラグイン開発

プラグインは plugins/ 以下に独自ディレクトリを作成します。

plugins/
└── my-plugin/
    ├── plugin.php     # エントリポイント
    ├── config.json    # プラグイン設定
    └── assets/