CHAPTER 08

トラブルシューティング・よくある質問

設置時や運用中に画面が表示されない、保存できないなどのエラーが発生した際の対処法一覧です。

トラブルシューティング・よくある質問

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認証パスワード、個人情報は共有しないでください。