トラブルシューティング・よくある質問
設置時や運用中に画面が表示されない、保存できないなどのエラーが発生した際の対処法一覧です。
トラブルシューティング・よくある質問
CMSへログインできない
確認すること:
- Basic認証を通過しているか
- ユーザー名とパスワードが正しいか
- 5回失敗して15分間のロック中ではないか
- DBへ接続できるか
- セッションを保存できるか
管理者パスワードの再設定とロック解除:
cd /サーバー上のドメインルート/aihp/cms
php bin/create_admin.php ユーザー名
DBへ接続できない
config.phpのDB_HOST、DB_USER、DB_PASS、DB_NAMEを確認します。レンタルサーバーでは、DBホスト名がlocalhostではない場合があります。
接続情報を画面、メール、公開ログへ貼り付けないでください。
公開URLやsitemap.xmlのドメインが違う
config.phpのBASE_URLを確認します。
define('BASE_URL', 'https://example.jp');
- ドメインルートを指定します。
/aihp/cmsを付けません。- 末尾の
/を付けません。 - 修正後に再構築します。
記事詳細HTMLが生成されない
- 記事が公開状態か確認します。
src/{type.path}/_entry.htmlがあるか確認します。- コンテンツタイプのpathとディレクトリ名が一致するか確認します。
- slug、カテゴリ、公開パスのエラーを確認します。
- PHPが公開先へ書き込めるか確認します。
_entry.htmlがないタイプは、一覧専用として扱い、詳細HTMLを生成しません。
一覧へ新しい記事が出ない
記事保存ではトップ・一覧・アーカイブを更新しません。記事が公開状態であることを確認し、左メニューの未反映通知から関連ページを再構築してください。
カテゴリ一覧の場合は、記事がdata-aihp-categoryで指定したカテゴリへ直接所属しているか確認します。親カテゴリを指定しても子カテゴリの記事は含みません。
画像やPDFが表示されない
投稿画面からのアップロード:
- 実ファイルがドメインルートの
uploads/にあるか - DBの値が
/uploads/{ランダム名}か - HTMLが
data-aihp-src="fields.xxx"を使用しているか - Webサーバーから
/uploads/を読めるか
デザイン画像:
- CSS・JavaScript・デザイン画像はCMSがコピーしません。
- 制作者が公開ルートの
assets/などへ配置します。 - HTMLの参照パスと実ファイルを一致させます。
includeや一覧部品が表示されない
正しい例:
<header data-aihp-include="parts/_header.html"></header>
確認すること:
src/を起点にした相対パスか- 指定値に
src/を書いていないか ..、.、絶対パス、バックスラッシュを使っていないか- 拡張子が
.htmlか - 実体が
src/内にあるか
再構築が停止した
画面に表示された最初の失敗対象と原因を確認します。よくある原因は次です。
_entry.htmlやinclude部品がない- type path、カテゴリ、slugが不正
- schemaとfields JSONが一致しない
- PHPが公開ルートへ書き込めない
srcにアーカイブ生成先と同名のindex_2.htmlなどがある- archive manifestが壊れている
BASE_URLやDB接続が間違っている
原因を直し、ユーザーが同じ再構築をもう一度実行します。途中まで更新されたファイルは自動で元へ戻りません。
古いURLのHTMLが残る
slug、カテゴリ、type pathを変更した場合、旧記事HTMLは自動削除されません。変更前URLのファイルを特定し、必要性を確認してから手動で整理します。
アーカイブのindex_3.htmlなどは、CMSが以前生成した記録がある場合だけ自動整理します。
解決しない場合に記録する情報
- 実行した管理画面と操作
- 表示されたエラーメッセージ全文
- 対象のコンテンツタイプ、記事ID、URL
- 対象の
src相対パス - 発生日時
- PHPエラーログの該当箇所
- 直前に変更したファイル、設定、schema
DBパスワード、Basic認証パスワード、個人情報は共有しないでください。