AIHP CMS 新規導入ガイド
AIHP CMSの必要動作環境、ファイルの配置、Basic認証設定、ブラウザでの初期セットアップ手順を解説します。
AIHP CMS 新規導入ガイド
1. 必要な環境
- PHP 8.2以降
- MySQLとPDO MySQL
- PHP拡張: DOM、mbstring、fileinfo、JSON、session
- HTTPSを使用できるWebサーバー
- PHP実行ユーザーが公開ルート、
uploads/、aihp/cms/src/、aihp/cms/runtime/、aihp/sitebackup/へ書き込めること - 設置のときだけ、
aihp/cms/config.phpへ書き込めること(書き込めない場合は画面で案内します) .htaccessが読まれるWebサーバー(プレビューの表示に使います)
CLIは不要です。設置はブラウザだけで完了します。
2. ファイルを配置する
配布ZIPをドメインルートへ展開します。
ドメインルート/
├── aihp/
│ ├── index.php 設置直後の入口
│ ├── setup.php 初期設定の画面
│ ├── cms/
│ └── updater/
└── uploads/
CMSは必ずドメインルート/aihp/cms/へ置きます。公開HTMLの出力先は、この配置を前提にCMSが自動計算します。
3. Basic認証を設定する
Webサーバー側で/aihp/全体へBasic認証を設定します。設定を先に済ませてください。 設置が終わるまでの間、URLを知っている人なら誰でも設定画面を開けてしまいます。
CMSログインとは別に、srcやsqlなどの直接アクセスを保護する目的もあります。
4. 設定画面を開く
ブラウザで次を開きます。
https://お客様のドメイン/aihp/
画面の指示に従って進めると、次がすべて完了します。
- CMSを使うか、Updaterだけを使うかを選ぶ
- データベースの情報とサイトのURLを入力する
config.phpへ書き込む- テーブルを作る(
install.sqlが自動で実行されます) - 管理者のIDとパスワードを作る
ご用意いただくのは、空のMySQLデータベース1つと、その接続情報4つ(データベース名・ユーザー名・パスワード・ホスト名)だけです。設定ファイルを手で書き換える必要はありません。
「アクセス制限がかかっていません」と表示される場合
サーバーの構成によっては、Basic認証の設定を自動で確認できないことがあります。故障ではありません。次のURLを直接開いてください。
https://お客様のドメイン/aihp/setup.php
config.phpへ書き込めない場合
画面に貼り付け用のテキストが表示されます。その内容をaihp/cms/config.phpへ貼り付け、FTPでアップロードし直してから、画面を再読み込みしてください。
CLIから設置する場合
CLIが使える環境では、従来どおりの手順も使えます。
# テーブルを作る
mysql -u ユーザー名 -p DB名 < aihp/cms/sql/install.sql
# 管理者を作る
cd /サーバー上のドメインルート/aihp/cms
php bin/create_admin.php manager
ユーザー名は3〜100文字の半角英数、.、-、_。パスワードは12文字以上です。同じユーザー名で再実行すると、パスワード再設定とロック解除ができます。
5. 設定を確認する
aihp/cms/config.phpの値は、設定画面が書き込みます。あとから変えたい場合だけ、直接編集してください。
define('DB_HOST', 'DBホスト');
define('DB_USER', 'DBユーザー');
define('DB_PASS', 'DBパスワード');
define('DB_NAME', 'DB名');
define('BASE_URL', 'https://example.jp');
BASE_URLは末尾スラッシュなしのドメインルートです。https://example.jp/aihp/cmsではありません。
ほかのPHPシステムや手動管理ディレクトリと公開パスが衝突する場合は、RESERVED_PATHSへ追加します。aihpとaihp/*は削除しないでください。
aihp/updater/config.phpは編集不要です。
6. HTMLとアセットを配置する
- 固定HTML、一覧HTML、記事テンプレート、共通部品を
aihp/cms/src/へ配置します。 - CSS、JavaScript、デザイン画像は制作者がドメインルートへ配置します。
- CMSはCSS、JavaScript、デザイン画像を
src/からコピーしません。 - 投稿画面からアップロードする画像・PDFだけは、CMSが
/uploads/へ保存します。
詳しくはテンプレート制作ガイドを参照してください。
7. CMSを初期設定する
- CMSへログインします。設定画面の最後にリンクがあります。
- サイト設定を確認します。
- コンテンツタイプとカスタムフィールドschemaを作成します。
- 必要なカテゴリを作成します。
- 記事詳細が必要なら
src/{type.path}/_entry.htmlを配置します。ファイル名は_entry.htmlに限ります。別名にすると詳細ページが生成されず、そのHTML自体が公開されます。 - テスト記事を保存してプレビューします。
- サイト管理から全体再構築します。
- 公開HTML、CSS、JavaScript、画像、
sitemap.xmlを確認します。
8. 導入確認
- CMSが
ドメインルート/aihp/cms/にある。 -
/aihp/全体がBasic認証で保護されている。 - 本番DB情報とドメインルートの
BASE_URLが設定されている。 - 管理者を作成し、ログインできた。
- 公開ルート、
uploads/、src/、runtime/、aihp/sitebackup/への書込みを確認した。 -
aihp/cms/src/.htaccessがある(プレビューの表示に使います)。 - 記事の作成、編集、プレビュー、公開停止を確認した。
- 固定HTMLと一覧を確認した。
- 全体再構築が最後まで成功した。
-
sitemap.xmlが本番ドメインを使用している。 - CSS、JavaScript、画像にリンク切れがない。
- DB、
src/、uploads/、config.phpのバックアップ方法を決めた。