CHAPTER 01

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/

画面の指示に従って進めると、次がすべて完了します。

  1. CMSを使うか、Updaterだけを使うかを選ぶ
  2. データベースの情報とサイトのURLを入力する
  3. config.phpへ書き込む
  4. テーブルを作る(install.sqlが自動で実行されます)
  5. 管理者の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を初期設定する

  1. CMSへログインします。設定画面の最後にリンクがあります。
  2. サイト設定を確認します。
  3. コンテンツタイプとカスタムフィールドschemaを作成します。
  4. 必要なカテゴリを作成します。
  5. 記事詳細が必要ならsrc/{type.path}/_entry.htmlを配置します。ファイル名は_entry.htmlに限ります。別名にすると詳細ページが生成されず、そのHTML自体が公開されます。
  6. テスト記事を保存してプレビューします。
  7. サイト管理から全体再構築します。
  8. 公開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のバックアップ方法を決めた。